Aller au contenu principal
Reporting-Doku
Use Case GAM REST + Analytics link

Nur wenn der GAM Link aktiv ist

Verknuepfte Analytics-Felder in GAM REST

Nutze Google-Analytics-Felder, die Google Ad Manager in HISTORICAL Reports ausgibt, wenn die Verknuepfung in GAM aktiv ist.

User Prompt

"In GAM REST, wenn verknuepfte Analytics-Felder verfuegbar sind, zeige die letzten 30 Tage nach DATE, PAGE_PATH und PAGE_TITLE_AND_SCREEN_NAME. Nutze SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS und GOOGLE_ANALYTICS_REVENUE. Wenn ein Feld nicht verfuegbar ist, nenne es und fahre mit den uebrigen GAM-Feldern fort."

Erwartetes Ergebnis

Ein GAM REST Report fuer Page- und Session-Kontext mit Feldern aus Google Ad Manager, ohne GA4 Data API Call.

Agentenablauf

  1. 01

    get_report_dimensions und get_report_metrics fuer REST-Felder pruefen, die mit HISTORICAL kompatibel sind.

  2. 02

    run_custom_report mit api='rest' und report_type='HISTORICAL' ausfuehren.

  3. 03

    Fehlende oder leere verknuepfte Felder als GAM Link-/Datenverfuegbarkeit erklaeren, nicht als OrbiAds GA4 Connector.

MCP-Funktionen

Parent-MCP-Aufruf mit reporting action.

FunktionKostenZweck
reporting(action="get_report_dimensions")0 crPrueft GAM REST Dimensionen.
reporting(action="get_report_metrics")0 crPrueft verknuepfte Analytics Metrics aus GAM.
reporting(action="run_custom_report")0.5 crFuehrt den GAM REST HISTORICAL Report aus.

JSON Payload

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "report_type": "HISTORICAL",
      "date_range_type": "LAST_30_DAYS",
      "dimensions": [
        "DATE",
        "PAGE_PATH",
        "PAGE_TITLE_AND_SCREEN_NAME"
      ],
      "metrics": [
        "SESSIONS",
        "ACTIVE_USERS",
        "GOOGLE_ANALYTICS_VIEWS",
        "GOOGLE_ANALYTICS_REVENUE"
      ]
    }
  }
}

Beispielausgabe

  • DATE=2026-06-08 | PAGE_PATH=/sports/live | SESSIONS=18.420 | GOOGLE_ANALYTICS_REVENUE=642,80 EUR.
  • PAGE_TITLE_AND_SCREEN_NAME=Live scores | ACTIVE_USERS=12.940 | GOOGLE_ANALYTICS_VIEWS=31.220.
  • Hinweis: PAGE_PATH ist ein verknuepftes Analytics-Feld aus GAM REST; GA4 wurde nicht abgefragt.

Dimensionen und Metrics

Dimensionen
NameQuelleBeschreibung
DATEGAMBerichtstag
PAGE_PATHGAMVerknuepfter Analytics Page Path aus GAM
PAGE_TITLE_AND_SCREEN_NAMEGAMVerknuepfter Analytics Seitentitel aus GAM
Metrics
NameQuelleBeschreibung
SESSIONSGAMSessions aus GAM Reporting
ACTIVE_USERSGAMAktive Nutzer aus GAM Reporting
GOOGLE_ANALYTICS_VIEWSGAMViews aus GAM Reporting
GOOGLE_ANALYTICS_REVENUEGAMAnalytics Revenue aus GAM Reporting

Grenzen

  • Der Analytics Link muss in Google Ad Manager Reporting bereits aktiv und sichtbar sein.
  • OrbiAds ruft hier keine GA4 Data API auf und braucht keine GA4 Property ID.
  • Google Ads Kampagnenkosten, Bids, Keywords und native Klicks sind in diesem Workflow nicht verfuegbar.
  • get_report_result verwenden, um das vollstaendige gecachte Ergebnis zu lesen, wenn die Inline-Antwort gekuerzt ist.
Das sind GAM Reportspalten, deren Definitionen Google Analytics erwaehnen. OrbiAds ruft weiterhin nur GAM REST auf.
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