Anzeigenblockzuordnungen

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

Beim Erstellen einer Vermittlungsgruppe werden Anzeigenblockzuordnungen als Parameter für jede Vermittlungsgruppenzeile verwendet. Sie dienen als Einstellungen für den angegebenen Anzeigenblock, um Anfragen an Drittanbieter-Anzeigennetzwerke zu senden. Im Gegensatz zur AdMob-Benutzeroberfläche müssen Anzeigenblockzuordnungen unabhängig von Vermittlungsgruppen und Vermittlungsgruppenzeilen erstellt werden. Nach der Erstellung können Sie alle Anzeigenblockzuordnungen auflisten und als Parameter verwenden, wenn Sie Vermittlungsgruppenzeilen 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 Informationen zum Umfang.

Hier sind die OAuth 2.0-Bereichsinformationen:

Bereich 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 Dazu können Kontoinformationen, Inventar- und Vermittlungseinstellungen, Berichte und andere Daten gehören. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.

So erstellen Sie Ihre erste Anzeigenblockzuordnung:

curl (Befehlszeile)

Anfragen mit curl

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Autorisierungsanmeldedaten.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie die Einladung annehmen, müssen Sie sich mit einem Google-Konto anmelden, das Zugriff auf die AdMob API hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, das derzeit angemeldet ist, auf Daten zuzugreifen.

    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 Cloudanwendung herunterladen. Beim ersten Ausführen des Befehls werden Sie durch den OAuth 2.0-Autorisierungsvorgang geführt. 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. Hier finden Sie eine Anleitung zum Ermitteln Ihrer Publisher-ID.

    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 relevanten 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. Erstellen Sie eine Anzeigenblockzuordnung.

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

    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 das Fragment Ihrer Anzeigenblock-ID. Das Fragment der Anzeigenblock-ID sind die letzten 10 Ziffern Ihrer Anzeigenblock-ID im Format „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY“. Anleitung zum Ermitteln der Anzeigenblock-ID

     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",
     }
   }
}