Aller au contenu principal
Reporting-Doku
Use Case GAM REST + Demand links

Verknuepfte Nachfrage in GAM

AdSense- und Ad-Exchange-Felder in GAM REST

Nutze AdSense- und Ad-Exchange-Metrics, die Google Ad Manager in HISTORICAL Reports ausgibt, wenn diese Demand Sources verknuepft und aktiv sind.

User Prompt

"In GAM REST, vergleiche AdSense- und Ad-Exchange-Revenue der letzten 7 Tage nach DATE, AD_UNIT_NAME und DEMAND_CHANNEL_NAME. Nutze ADSENSE_IMPRESSIONS, ADSENSE_REVENUE, AD_EXCHANGE_IMPRESSIONS, AD_EXCHANGE_REVENUE und AD_EXCHANGE_AVERAGE_ECPM."

Erwartetes Ergebnis

Ein Demand-Source Readout aus GAM REST, der AdSense und Ad Exchange trennt, ohne Google Ads API zu nutzen.

Agentenablauf

  1. 01

    Pruefen, ob die angefragten AdSense- oder Ad-Exchange-Metrics in get_report_metrics fuer REST/HISTORICAL existieren.

  2. 02

    run_custom_report gegen GAM REST mit Demand-Channel-Dimensionen ausfuehren.

  3. 03

    Nicht verfuegbare Demand Metrics als GAM Link- oder Account-Permission-Grenze benennen.

MCP-Funktionen

Parent-MCP-Aufruf mit reporting action.

FunktionKostenZweck
reporting(action="get_report_dimensions")0 crPrueft GAM Demand-Dimensionen.
reporting(action="get_report_metrics")0 crPrueft AdSense- und Ad-Exchange-Metrics aus GAM.
reporting(action="run_custom_report")0.5 crFuehrt den GAM REST Demand Report aus.

JSON Payload

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "report_type": "HISTORICAL",
      "date_range_type": "LAST_7_DAYS",
      "dimensions": [
        "DATE",
        "AD_UNIT_NAME",
        "DEMAND_CHANNEL_NAME"
      ],
      "metrics": [
        "ADSENSE_IMPRESSIONS",
        "ADSENSE_REVENUE",
        "AD_EXCHANGE_IMPRESSIONS",
        "AD_EXCHANGE_REVENUE",
        "AD_EXCHANGE_AVERAGE_ECPM"
      ]
    }
  }
}

Beispielausgabe

  • DATE=2026-06-08 | AD_UNIT_NAME=Sports/Home | DEMAND_CHANNEL_NAME=Ad Exchange | AD_EXCHANGE_REVENUE=1.284,20 EUR.
  • DATE=2026-06-08 | AD_UNIT_NAME=Sports/Home | DEMAND_CHANNEL_NAME=AdSense | ADSENSE_REVENUE=342,10 EUR.
  • Aktion: Ad Units pruefen, bei denen Ad Exchange eCPM sinkt, waehrend GAM Requests stabil bleiben.

Dimensionen und Metrics

Dimensionen
NameQuelleBeschreibung
DATEGAMBerichtstag
AD_UNIT_NAMEGAMInventarplatzierung
DEMAND_CHANNEL_NAMEGAMDemand Channel aus GAM
Metrics
NameQuelleBeschreibung
ADSENSE_IMPRESSIONSGAMAdSense Impressions aus GAM Reporting
ADSENSE_REVENUEGAMAdSense Revenue aus GAM Reporting
AD_EXCHANGE_IMPRESSIONSGAMAd Exchange Impressions aus GAM Reporting
AD_EXCHANGE_REVENUEGAMAd Exchange Revenue aus GAM Reporting
AD_EXCHANGE_AVERAGE_ECPMGAMAd Exchange Durchschnitts-eCPM aus GAM Reporting

Grenzen

  • AdSense- und Ad-Exchange-Zeilen haengen von der Publisher-GAM-Konfiguration und verfuegbarer verknuepfter Nachfrage ab.
  • Das ist kein Google Ads Reporting: keine Kampagnenkosten, Keywords, Bids oder Google-Ads-Konto-Metrics.
  • Nur Felder nutzen, die GAM REST zurueckgibt; Felder wechseln, wenn das Network eines nicht ausgibt.
  • get_report_result verwenden, um das vollstaendige gecachte Ergebnis zu lesen, wenn die Inline-Antwort gekuerzt ist.
AdSense und Ad Exchange sind hier GAM Reporting-Familien; nicht als Google Ads API Abdeckung beschreiben.
Academy Guide lesen

Nutze den redaktionellen Guide fuer die Zielgruppenlogik und komme dann fuer exakte MCP Actions, Felder und Payloads hierher zurueck.

Academy Guide lesen
Feldreferenzen