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 Zeile der Vermittlungsgruppe und als Einstellungen für den angegebenen Anzeigenblock verwendet, um Anfragen an Werbenetzwerke von Drittanbietern zu senden. Anders als in der AdMob-Benutzeroberfläche müssen Anzeigenblockzuordnungen unabhängig von Vermittlungsgruppen und Vermittlungsgruppenzeilen erstellt werden. Nach dem Erstellen können Sie alle Anzeigenblockzuordnungen auflisten und als Parameter verwenden, wenn Sie Zeilen für 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 außerdem die Bereichsinformationen.

Im Folgenden finden Sie die Informationen zum OAuth 2.0-Bereich:

Umfang Bedeutung
https://www.googleapis.com/auth/admob.monetization Ihre 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 Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie in Ihrem Browser aufgefordert, eine Autorisierungsanfrage zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf die AdMob API hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    Für die Authentifizierung und Autorisierung empfehlen wir oauth2l, ein einfaches 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 den Pfad zu einer credentials.json-Datei, die Sie beim Registrieren Ihrer Cloud-Anwendung herunterladen. Beim ersten Ausführen führt Sie der Befehl 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

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID, um Informationen zu AdMob-Anzeigenquellen abzurufen. Hier findest du eine Anleitung dazu, wie du deine Publisher-ID ermittelst.

    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. Listen Sie die Adapter auf.

    Ersetzen Sie SSSSSSSSSSSSSSSSSSSS durch die Anzeigenquellen-ID der 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 „AdMob-Werbenetzwerk“ 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 der Anzeigenblock-ID. Das Anzeigenblock-ID-Fragment besteht aus den letzten zehn Ziffern Ihrer Anzeigenblock-ID und hat das Format "ca-app-pub-XXXXXXXXXXXXXXXX/JJJJJJJJYY". 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. Hiermit werden alle Anzeigenblockzuordnungen aufgelistet.

    Ersetzen Sie YYYYYYYYYY durch das Anzeigenblock-ID-Fragment. Das Anzeigenblock-ID-Fragment besteht aus den letzten zehn Ziffern Ihrer Anzeigenblock-ID im Format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Hier erfahren Sie, wie Sie Ihre Anzeigenblock-ID ermitteln.

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