Mapowania jednostek reklamowych

Mapowania jednostek reklamowych to ustawienia konfiguracyjne innych firm, które są mapowane na jednostkę reklamową AdMob i umożliwiają jej wysyłanie żądań reklam do zewnętrznej sieci reklamowej.

Podczas tworzenia grupy zapośredniczenia mapowania jednostek reklamowych są używane jako parametr każdego wiersza grupy zapośredniczenia jako ustawienia określonej jednostki reklamowej do wysyłania żądań do zewnętrznych sieci reklamowych. W przeciwieństwie do interfejsu AdMob mapowania jednostek reklamowych muszą być tworzone niezależnie od grup zapośredniczenia i elementów zamówienia w grupach zapośredniczenia. Po utworzeniu możesz wyświetlić wszystkie mapowania jednostek reklamowych i użyć ich jako parametru podczas tworzenia lub aktualizowania wierszy grup zapośredniczenia z nowymi mapowaniami jednostek reklamowych.

menedżerem konta.

Przykłady

Po utworzeniu danych logowania OAuth 2.0 możesz zacząć korzystać z interfejsu AdMob API. Aby poprosić o dostęp przy użyciu protokołu OAuth 2.0, aplikacja potrzebuje też danych z zakresu.

Oto informacje o zakresie protokołu OAuth 2.0:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.monetization Wyświetlanie, tworzenie i edytowanie ustawień zarabiania w AdMob.
https://www.googleapis.com/auth/admob.readonly wyświetlać wszystkie dane AdMob; Mogą to być informacje o koncie, ustawienia dotyczące zasobów reklamowych i mediacji, raporty i inne dane. Nie obejmuje to danych wrażliwych, takich jak informacje o płatnościach czy szczegóły kampanii.

Aby rozpocząć tworzenie pierwszego mapowania jednostki reklamowej:

curl (wiersz poleceń)

Żądania za pomocą narzędzia curl

  1. Wczytaj plik tajnych kluczy klienta i wygeneruj dane uwierzytelniające.

    Gdy wykonasz ten krok po raz pierwszy, w przeglądarce pojawi się prośba o zaakceptowanie autoryzacji. Zanim zaakceptujesz zaproszenie, upewnij się, że logujesz się za pomocą konta Google, które ma dostęp do interfejsu AdMob API. Twoja aplikacja będzie mieć uprawnienia dostępu do danych w imieniu konta, na którym jest obecnie zalogowany użytkownik.

    Do uwierzytelniania i autoryzacji zalecamy używanie oauth2l, prostego narzędzia wiersza poleceń do pracy z protokołem Google OAuth 2.0. Zainstaluj oauth2l i uruchom poniższe polecenie, zastępując path_to_credentials_json ścieżką do pliku credentials.json, który pobierzesz podczas rejestrowania aplikacji w chmurze. Przy pierwszym uruchomieniu polecenie przeprowadzi Cię przez proces autoryzacji OAuth 2.0. Kolejne uruchomienia automatycznie odświeżają token.

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

  2. Wyświetl listę źródeł reklam.

    Uzyskaj informacje o źródle reklam AdMob, zastępując pub-XXXXXXXXXXXXXXXX identyfikatorem wydawcy. Zapoznaj się z instrukcjami, jak znaleźć identyfikator wydawcy.

    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)"

    Przykładowa odpowiedź:

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

  3. Wyświetl listę adapterów.

    Zastąp SSSSSSSSSSSSSSSSSSSS identyfikatorem źródła reklam w przypadku interesujących Cię adapterów.

    Aby uzyskać listę adapterów, użyj tego polecenia:

    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)"

    Przykładowa odpowiedź dla źródła reklam Sieć AdMob o identyfikatorze 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. Utwórz mapowanie jednostki reklamowej.

    Zastąp YYYYYYYYYY fragmentem identyfikatora jednostki reklamowej. Fragment identyfikatora jednostki reklamowej to ostatnie 10 cyfr identyfikatora jednostki reklamowej, który ma format „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”. Zapoznaj się z instrukcjami, jak znaleźć identyfikator jednostki reklamowej.

    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. Wyświetl listę wszystkich mapowań jednostek reklamowych.

    Zastąp YYYYYYYYYY fragmentem identyfikatora jednostki reklamowej. Fragment identyfikatora jednostki reklamowej to ostatnie 10 cyfr identyfikatora jednostki reklamowej w formacie „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”. Zapoznaj się z instrukcjami, jak znaleźć identyfikator jednostki reklamowej.

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