Alpha-API des Berichts zur Anzeigenaktivität

Der Bericht zur Anzeigenaktivität eine zentrale Ansicht Ihrer Anzeigenleistung. Es kombiniert die Daten, Metriken und Dimensionen aus der Network Report API und der Mediation Report API sowie in einem einheitlichen Bericht zusammengefasst.

Die Ads Activity Report API bietet zusätzliche Verbesserungen gegenüber der Vermittlung. Report API und Network Report API, wie in der folgenden Tabelle dargestellt:

Netzwerkbericht-API Mediation Report API Ads Activity Report API
Netzwerkleistung ✅ ✅ ✅
Leistung der Abfolge ✅ ✅
Gebotsleistung ✅
Leistung des A/B-Tests mit Vermittlung ✅
Stündliche Berichterstellung ✅
Berichtsgröße 100.000 100.000 500.000

Messwerte, Dimensionen und Dimensionsfilter

Die folgenden Messwerte wurden der Ads Activity Report API in zusätzlich zu vielen der in der Network Report API verfügbaren Messwerte Mediation Report API

Messwert Beschreibung
BID_REQUEST Die Anzahl der Anfragen an die Bidding-Anzeigenquelle.
BIDS_IN_AUCTION Die Anzahl der Gebote der Anzeigenquelle, die an Bidding-Auktionen teilgenommen haben.
WINNING_BIDS Die Anzahl der Gebote, die eine Bidding-Auktion gewonnen haben.

Die folgenden neuen Dimensionen sind in der Ads Activity Report API enthalten.

Dimension Beschreibung
WOCHE Das Datum des ersten Tags einer Woche (in der Sprache des der in den Lokalisierungseinstellungen angegeben ist, im Format JJJJMMTT (für Beispiel: „20210701“). Für Anfragen kann nur DATE, WEEK oder MONTH angegeben werden. Zeitdimension enthalten.
HOUR Die Stunde im HH-Format in PST (Pacific Standard Time). Beispiel: „05“ für 5:00 Uhr PST: „13“ für 13:00 Uhr PST. In der Anfrage muss auch die Dimension DATE angegeben werden. A Bei Angabe der Dimension STUNDE werden maximal Daten von 28 Tagen zurückgegeben. Startdatum des Zeitraums, die mehr als 28 Tage vor dem aktuellen Datum liegen gibt einen Fehler zurück.
MEDIATION_AB_TEST (Testname) Zeigt die Leistung nach A/B-Test mit Vermittlungsgruppen an. Dies muss angegeben werden. wenn die VARIANT-Dimension angegeben ist.
MEDIATION_AB_TEST_VARIANT (Variante A, Variante B) Zeigt die Leistung nach Variante für A/B-Test mit Vermittlungsgruppen an.
Dimensionsname in der Mediation Report API Dimensionsname in der Ads Activity Report API Beschreibung
AD_UNIT1 AD_UNIT_ID Die eindeutige ID des Anzeigenblocks, z. B. „123456789“.
AD_UNIT_NAME Der Name des Anzeigenblocks.
APP1 APP_ID Die eindeutige ID der App, z. B. „1234567890“.
APP_NAME Der Name der Anwendung
AD_SOURCE1 AD_SOURCE_ID Die eindeutige ID der Anzeigenquelle, z. B. „1234567890123456789“.
AD_SOURCE_NAME Der Name der Anzeigenquelle, z. B. „AdMob-Werbenetzwerk“.
AD_SOURCE_INSTANCE1 AD_SOURCE_INSTANCE_ID Die eindeutige ID der Anzeigenquelleninstanz, z. B. „123456789012“.
AD_SOURCE_INSTANCE_NAME Der Name der Anzeigenquelleninstanz, z. B. „AdMob (Standardeinstellung)“.
MEDIATION_GROUP1 MEDIATION_GROUP_ID Die eindeutige ID der Vermittlungsgruppe, z. B. „1234567890“.
MEDIATION_GROUP_NAME Die eindeutige ID der Vermittlungsgruppe, z. B. „AdMob (Standardeinstellung)“.

1: Weitere Informationen finden Sie unter Scalars.

Die folgenden Dimensionen haben ein aktualisiertes Format.

Dimensionsname in der Mediation Report API Beschreibung in der Mediation Report API Beschreibung in der Ads Activity Report API
ESTIMATED_EARNINGS Die geschätzten Einnahmen des AdMob-Publishers. Die Währungseinheit (USD, Euro oder andere) der Messwerte zu Einnahmen werden durch die Lokalisierung bestimmt. für die Währung. Der Betrag wird in Mikros angegeben. 6, 50 € würden beispielsweise dargestellt als 6500000.

Die geschätzten Einnahmen pro Vermittlungsgruppe und Anzeigenquelleninstanzebene betragen ab dem 20. Oktober 2019 unterstützt. Geschätzte Einnahmen von Drittanbietern Für Daten vor dem 20. Oktober 2019 wird 0 angezeigt.

Die geschätzten Einnahmen des AdMob-Publishers. Die Währungseinheit (USD, Euro oder andere) der Messwerte zu Einnahmen werden durch die Lokalisierung bestimmt. für die Währung.
OBSERVED_ECPM Geschätzter durchschnittlicher eCPM des Drittanbieter-Werbenetzwerks Währungseinheit (US-Dollar, Euro oder andere) der Messwerte zu Einnahmen werden durch die Lokalisierung bestimmt. für die Währung. Der Betrag wird in Mikros angegeben. 2, 30 € würden beispielsweise dargestellt als 2300000.

Der geschätzte durchschnittliche eCPM pro Vermittlungsgruppe und Anzeigenquelleninstanzebene wird seit dem 20. Oktober 2019 unterstützt. Geschätzter Durchschnitt durch Drittanbieter Für Daten vor dem 20. Oktober 2019 wird für den eCPM „0“ angezeigt.

Der durchschnittliche eCPM für alle Anzeigen. Währungseinheit (USD, EUR oder andere) von Die Messwerte zu Einnahmen werden durch die Lokalisierungseinstellung für die Währung bestimmt.

Der durchschnittliche eCPM pro Vermittlungsgruppe und Anzeigenquelleninstanzebene beträgt ab dem 20. Oktober 2019 unterstützt. Für OBSERVED_ECPM wird für Datumsangaben „0“ angezeigt. vor dem 20. Oktober 2019.

Skalare

Die folgenden Dimensionen wurden in der Ads Activity Report API aktualisiert: skalaren Werten anstelle von -Objekten. Dadurch wird die Antwort vereinfacht und Komplexität.

In der Mediation Report API und der Network Report API betroffene Dimensionen:

  • AD_UNIT
  • APP
  • AD_SOURCE
  • AD_SOURCE_INSTANCE
  • MEDIATION_GROUP
Beispielantwortdaten für einen Bericht
Dimensionsformat für Vermittlung / Network API 
"AD_UNIT": {
   "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY",
   "displayLabel": "Test ad unit name"
   }
AAR API-Dimensionsformat 
"AD_UNIT_NAME": "Test ad unit name",
"AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

Stündliche Berichterstellung

Sie können sich die Leistung in der AdMob API jetzt nach Stunden ansehen. Die stündliche Berichterstellung ist bis zu 28 Tage lang verfügbar.

Für den stündlichen Abruf muss auch die Dimension DATE in der Anfrage angegeben werden. Daten. Es werden Daten für einen Zeitraum von maximal 28 Tagen zurückgegeben, wenn für die Dimension STUNDE Folgendes gilt: angegeben ist. Startdatum des Zeitraums, die mehr als 28 Tage vor dem und das aktuelle Datum einen Fehler zurückgeben.

Größerer Bericht

Mit der Ads Activity Report API können Sie insgesamt 500.000 Zeilen abrufen. Für Weitere Informationen finden Sie im Leitfaden zu Kontingenten.

Anfrage stellen

Folgen Sie dieser Anleitung, um eine Anfrage zu stellen.

curl (Befehlszeile)

Anfragen mit curl

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, zur Autorisierung aufgefordert. Bevor Sie zustimmen, vergewissern Sie sich, dass Sie Sie müssen mit einem Google-Konto angemeldet sein, das Zugriff auf die AdMob API hat. Ihr wird die Anwendung autorisiert, im Namen des -Konto ist derzeit angemeldet.

    Zur Authentifizierung und Autorisierung empfehlen wir die Verwendung von oauth2l, einem einfachen Befehlszeilentool für mit Google OAuth 2.0. Installieren Sie oauth2l und führen Sie den Befehl unten, wobei path_to_credentials_json durch einen Pfad ersetzt wird in eine credentials.json-Datei, die Sie bei der Registrierung Ihres Cloud-Anwendung. Bei der ersten Ausführung führt der Befehl Sie durch die OAuth 2.0-Autorisierungsablauf. Bei nachfolgenden Ausführungen wird das Token aktualisiert automatisch.

    ~/go/bin/oauth2l header --json path_to_credentials_json \
        https://www.googleapis.com/auth/admob.readonly

  2. Generieren Sie einen Bericht zur Anzeigenaktivität.

    curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
     -H "Content-Type: application/json" \
     -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
      {
        "report_spec": {
        "date_range": {
          "start_date": {"year": 2023, "month": 1, "day": 1},
          "end_date": {"year": 2023, "month": 1, "day": 2}
        },
        "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
        "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
        "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
        "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
        "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
        }
      }
EOF

    Beispielantwort:

    {
"rows": [
  {
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant A"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 0
      },
      "BID_REQUEST": {
        "integerValue": "27"
      },
      "WINNING_BIDS": {
        "doubleValue": 0.1111111111111111
      },
      "IMPRESSIONS": {
        "integerValue": "2"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0
      }
    }
  },
{
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant B"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 1
      },
      "BID_REQUEST": {
        "integerValue": "6"
      },
      "WINNING_BIDS": {
        "doubleValue": 1
      },
      "IMPRESSIONS": {
        "integerValue": "3"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0.000427519
      }
    }
  }
]}