Yield-Leck Finder
Unsold-Inventory Audit mit Codex
Lass Codex ad units mit unfilled impressions, niedriger fill rate und relevantem Volumen finden.
"Codex, pruefe die letzten 7 Tage GAM Inventar. Sortiere ad units mit hohen unfilled impressions, fill rate unter 85% und relevantem Request-Volumen. Gib Fixes nach Prioritaet."
Eine priorisierte Inventarliste mit unverkauftem Volumen, fill rate, wahrscheinlicher Ursache und erster Massnahme.
Agentenablauf
- 01
Inventardaten fuer den gewaehlten Zeitraum abrufen.
- 02
Nach UNFILLED_IMPRESSIONS sortieren und Zeilen mit niedriger FILL_RATE filtern.
- 03
Checks zu Demand, Floors, ad unit oder Tagging empfehlen.
MCP-Funktionen
Parent-MCP-Aufruf mit reporting action.
| Funktion | Kosten | Zweck |
|---|---|---|
reporting(action="run_custom_report") | 0.5 cr | Fuehrt den vollstaendigen Unsold-Inventory Report mit AD_REQUESTS, UNFILLED_IMPRESSIONS und FILL_RATE aus. |
reporting(action="get_report_metrics") | 0 cr | Prueft, ob FILL_RATE und UNFILLED_IMPRESSIONS verfuegbar sind. |
reporting(action="fetch_inventory_report") | 0.5 cr | Fuehrt einen engeren ad-unit Inventarcheck aus, wenn das Problem bereits eingegrenzt ist. |
reporting(action="export_report_csv") | 0.5 cr | Exportiert die priorisierte Leckliste. |
JSON Payload
{
"tool": "reporting",
"arguments": {
"action": "run_custom_report",
"params": {
"api": "rest",
"dateRangeType": "FIXED",
"startDate": "2026-06-02",
"endDate": "2026-06-08",
"dimensions": [
"DATE",
"AD_UNIT_NAME",
"AD_UNIT_CODE",
"DEVICE_CATEGORY_NAME"
],
"metrics": [
"AD_REQUESTS",
"AD_SERVER_IMPRESSIONS",
"UNFILLED_IMPRESSIONS",
"FILL_RATE"
]
}
}
}Beispielausgabe
- Groesstes Leck: News/Article/Mobile hat 482.913 UNFILLED_IMPRESSIONS und 71,4% FILL_RATE.
- Wahrscheinliche Ursache: Demand-Luecke auf DEVICE_CATEGORY_NAME=Mobile, kein globaler Ausfall.
- Naechster Schritt: Floors und Bidder-Abdeckung fuer die Top-5 ad units vergleichen.
Dimensionen und Metrics
| Name | Quelle | Beschreibung |
|---|---|---|
| AD_UNIT_NAME | GAM | Inventarname |
| AD_UNIT_CODE | GAM | Tag Code |
| DATE | GAM | Tagessplit |
| DEVICE_CATEGORY_NAME | GAM | Device-Klasse |
| Name | Quelle | Beschreibung |
|---|---|---|
| AD_REQUESTS | GAM | Demand Opportunities |
| AD_SERVER_IMPRESSIONS | GAM | Gefuellte Impressions |
| UNFILLED_IMPRESSIONS | GAM | Unverkaufte Impressions |
| FILL_RATE | GAM | Fill Rate |
Grenzen
- run_custom_report kostet Credits, weil ein GAM Report ausgefuehrt wird.
- fetch_inventory_report nur fuer einen schnellen ad-unit Check nutzen; die vollstaendige Leckanalyse braucht AD_REQUESTS, UNFILLED_IMPRESSIONS und FILL_RATE.
- SOAP nur nutzen, wenn die benoetigte Legacy-Metric in REST fehlt.
- Jedes Feld gegen die Dimensions- und Metrics-Referenz pruefen, bevor der Prompt automatisiert wird.
Nutze den redaktionellen Guide fuer die Zielgruppenlogik und komme dann fuer exakte MCP Actions, Felder und Payloads hierher zurueck.