Mapowania jednostek reklamowych

Mapowania jednostek reklamowych to ustawienia konfiguracyjne sieci zewnętrznych, 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 dla każdego wiersza grupy zapośredniczenia , czyli jako ustawienia określonej jednostki reklamowej, która ma wysyłać żądania do zewnętrznej sieci reklamowej. W przeciwieństwie do interfejsu AdMob mapowania jednostek reklamowych trzeba tworzyć niezależnie od grup zapośredniczenia i ich wierszy. Po utworzeniu możesz wyświetlić listę wszystkich mapowań jednostek reklamowych i używać ich jako parametru podczas tworzenia lub aktualizowania wierszy grupy zapośredniczenia za pomocą nowych mapowań jednostek reklamowych.

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 będzie też potrzebować informacji o zakresie.

Oto informacje o zakresie 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świetlanie wszystkich danych AdMob. Te dane mogą obejmować m.in. informacje o Twoim koncie , ustawienia zasobów i zapośredniczenia oraz raporty. Nie obejmuje to danych wrażliwych, takich jak informacje o płatnościach czy szczegóły kampanii.

Zacznij tworzyć pierwsze mapowanie jednostki reklamowej:

curl (wiersz poleceń)

Żądania za pomocą curl

  1. Wczytaj plik z hasłami klienta i wygeneruj dane logowania.

    Gdy wykonasz ten krok po raz pierwszy, zobaczysz w przeglądarce prośbę o zaakceptowanie autoryzacji. Zanim to zrobisz, upewnij się, że logujesz się na konto Google, które ma dostęp do interfejsu AdMob API. Twoja aplikacja będzie mieć dostęp do danych w imieniu konta, na które się zalogujesz.

    Do uwierzytelniania i autoryzacji zalecamy używanie oauth2l, prostego narzędzia wiersza poleceń do pracy z Google OAuth 2.0. Zainstaluj oauth2l i uruchom polecenie poniżej, zastępując path_to_credentials_json ścieżką do pliku credentials.json pobranego podczas rejestracji 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.

    Aby uzyskać informacje o źródle reklam AdMob, zastąp pub-XXXXXXXXXXXXXXXX swoim 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, którego adaptery Cię interesują.

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