Mapowania jednostek reklamowych

Mapowania jednostek reklamowych to ustawienia konfiguracji zewnętrznej, które są przypisane do jednostki reklamowej AdMob i umożliwiają jej wysyłanie żądania reklamy do zewnętrznej sieci reklamowej.

Podczas tworzenia grupy zapośredniczenia mapowania jednostek reklamowych są używane jako parametr każdej linii grupy zapośredniczenia jako ustawienia określonej jednostki reklamowej, aby wysyłać żądania do zewnętrznych sieci reklamowych. W przeciwieństwie do interfejsu AdMob mapowania jednostek reklamowych należy tworzyć niezależnie poza grupami zapośredniczenia i wierszami grupy zapośredniczenia. Po utworzeniu możesz wyświetlić wszystkie mapowania jednostek reklamowych i użyć ich jako parametru podczas tworzenia lub aktualizowania wierszy grupy zapośredniczenia z nowymi mapowaniami jednostek reklamowych.

Przykłady

Po utworzeniu danych uwierzytelniających 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ż informacji 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 Zobacz wszystkie dane 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.

Aby utworzyć pierwsze mapowanie jednostek reklamowych:

curl (wiersz poleceń)

Żądania z wykorzystaniem curl

  1. Wczytaj plik z tajnymi kluczami klienta i wygeneruj dane uwierzytelniające.

    Gdy wykonasz ten krok po raz pierwszy, w przeglądarce pojawi się prośba o autoryzację. Zanim zaakceptujesz, upewnij się, że korzystasz z konta Google, które ma dostęp do interfejsu AdMob API. Twoja aplikacja będzie miała dostęp do danych w imieniu konta, na którym jest obecnie zalogowany.

    Do uwierzytelniania i autoryzacji zalecamy użycie narzędzia oauth2l, czyli 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 pobranego przy rejestrowaniu aplikacji internetowej. Podczas pierwszego uruchomienia 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świetla listę źródeł reklam.

    Aby uzyskać informacje o źródle reklam AdMob, zastąp pub-XXXXXXXXXXXXXXXX identyfikatorem wydawcy. Zapoznaj się z instrukcjami, jak znaleźć swój 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 dla interesujących Cię adapterów.

    Aby uzyskać listę adapterów, użyj następującego 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 reklamy sieci AdMob o identyfikatorze5450213213286189855:

    {
 "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 ciąg YYYYYYYYYY fragmentem identyfikatora jednostki reklamowej. Fragment identyfikatora jednostki reklamowej to 10 ostatnich cyfr identyfikatora jednostki reklamowej w formacie „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”. Dowiedz się, 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świetla listę wszystkich mapowań jednostek reklamowych.

    Zastąp ciąg YYYYYYYYYY fragmentem identyfikatora jednostki reklamowej. Fragment identyfikatora jednostki reklamowej to 10 ostatnich cyfr identyfikatora jednostki reklamowej w formacie „ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY”. Zobacz instrukcje znajdowania identyfikatora 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",
     }
   }
}