Anzeigenblockzuordnungen

Anzeigenblockzuordnungen sind Konfigurationseinstellungen von Drittanbietern, die einem AdMob-Anzeigenblock zugeordnet werden und es ihm ermöglichen, eine Anzeigenanfrage an ein Werbenetzwerk eines Drittanbieters zu senden.

Beim Erstellen einer Vermittlungsgruppe werden Anzeigenblockzuordnungen als Parameter für jede Zeile der Vermittlungsgruppe verwendet, um die Einstellungen für den angegebenen Anzeigenblock festzulegen, mit denen Anfragen an Werbenetzwerke von Drittanbietern gesendet werden. Anders als in der AdMob-Benutzeroberfläche müssen Anzeigenblockzuordnungen unabhängig von Vermittlungsgruppen und Zeilen von Vermittlungsgruppen erstellt werden. Nach der Erstellung können Sie alle Anzeigenblockzuordnungen auflisten und sie als Parameter verwenden, wenn Sie Zeilen von Vermittlungsgruppen mit neuen Anzeigenblockzuordnungen erstellen oder aktualisieren.

Beispiele

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, können Sie die AdMob API verwenden. Zur Anforderung eines Zugriffs mit OAuth 2.0 benötigt Ihre Anwendung auch die Bereichsinformationen.

Im Folgenden finden Sie die OAuth 2.0-Bereichsinformationen:

Umfang Bedeutung
https://www.googleapis.com/auth/admob.monetization AdMob-Monetarisierungseinstellungen abrufen, erstellen und bearbeiten
https://www.googleapis.com/auth/admob.readonly Alle AdMob-Daten ansehen Zu diesen Daten können Kontoinformationen Inventar- und Vermittlungseinstellungen, Berichte sowie andere Daten zählen. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.

So erstellen Sie Ihre erste Anzeigenblockzuordnung:

curl (Befehlszeile)

Anfragen mit curl

  1. Laden Sie die Secrets-Datei und generieren Sie Autorisierungsanmeldedaten.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Vergewissern Sie sich vor dem Akzeptieren, dass Sie mit einem Google-Konto angemeldet sind, das Zugriff auf die AdMob API hat. Ihre Anwendung wird autorisiert, im Namen des Kontos auf Daten zuzugreifen, mit dem Sie gerade angemeldet sind.

    Für die Authentifizierung und Autorisierung empfehlen wir die Verwendung von oauth2l, einem einfachen Befehlszeilentool für die Arbeit mit Google OAuth 2.0. Installieren Sie oauth2l und führen Sie den folgenden Befehl aus. Ersetzen Sie dabei path_to_credentials_json durch einen Pfad zu einer credentials.json Datei, die Sie beim Registrieren Ihrer Cloud-Anwendung herunterladen. Bei der ersten Ausführung führt der Befehl Sie durch den OAuth 2.0-Autorisierungsvorgang. Bei nachfolgenden Ausführungen wird das Token automatisch aktualisiert.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Anzeigenquellen auflisten

    Rufen Sie Informationen zur AdMob-Anzeigenquelle ab, indem Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID ersetzen. Eine Anleitung zum Ermitteln Ihrer Publisher-ID finden Sie hier. Eine Anleitung zum Ermitteln Ihrer Publisher-ID finden Sie hier.

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Beispielantwort:

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. Adapter auflisten

    Ersetzen Sie SSSSSSSSSSSSSSSSSSSS durch die Anzeigenquellen-ID für die gewünschten Adapter.

    Verwenden Sie den folgenden Befehl, um eine Liste der Adapter abzurufen:

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Beispielantwort für die Anzeigenquelle des AdMob-Werbenetzwerks mit der ID 5450213213286189855:

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. Anzeigenblockzuordnung erstellen

    Ersetzen Sie YYYYYYYYYY durch Ihr Anzeigenblock-ID-Fragment. Das Anzeigenblock-ID-Fragment besteht aus den letzten 10 Ziffern Ihrer Anzeigenblock-ID, die dem Format „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY“ folgt. Eine Anleitung zum Ermitteln Ihrer Anzeigenblock-ID finden Sie hier .

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. Alle Anzeigenblockzuordnungen auflisten

    Ersetzen Sie YYYYYYYYYY durch Ihr Anzeigenblock-ID-Fragment. Das Anzeigenblock-ID-Fragment besteht aus den letzten 10 Ziffern Ihrer Anzeigenblock-ID im Format „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY“. Eine Anleitung zum Ermitteln Ihrer Anzeigenblock-ID finden Sie hier .

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}