Сопоставления рекламных блоков

Сопоставления рекламных блоков — это сторонние настройки конфигурации, которые сопоставляются с рекламным блоком AdMob и позволяют ему отправлять запросы объявлений в стороннюю рекламную сеть.

При создании группы медиации сопоставления рекламных блоков используются в качестве параметра для каждой строки группы медиации в качестве настроек для указанного рекламного блока для выполнения запросов сторонней рекламной сети. В отличие от пользовательского интерфейса AdMob, сопоставления рекламных блоков необходимо создавать независимо за пределами групп медиации и строк группы медиации. После создания вы можете перечислить все сопоставления рекламных блоков и использовать их в качестве параметра при создании или обновлении строк группы медиации новыми сопоставлениями рекламных блоков.

Примеры

Создав учетные данные OAuth 2.0 , вы готовы начать использовать API AdMob. Чтобы запросить доступ с использованием OAuth 2.0, вашему приложению также потребуется информация об области.

Вот информация об области действия OAuth 2.0:

Объем Значение
https://www.googleapis.com/auth/admob.monetization Просматривайте, создавайте и редактируйте настройки монетизации AdMob.
https://www.googleapis.com/auth/admob.readonly Просмотреть все данные AdMob. Сюда может входить информация об аккаунте, настройки инвентаря и медиации, отчеты и другие данные. Сюда не входят конфиденциальные данные, такие как платежи или сведения о кампании.

Приступайте к созданию своего первого сопоставления рекламных блоков:

локон (командная строка)

Запросы с использованием Curl

  1. Загрузите файл секретов клиента и сгенерируйте учетные данные для авторизации.

    При первом выполнении этого шага вам будет предложено принять запрос на авторизацию в браузере. Прежде чем принять предложение, убедитесь, что вы вошли в аккаунт Google, у которого есть доступ к API AdMob. Вашему приложению будет разрешен доступ к данным от имени любой учетной записи, в которую вы в данный момент вошли.

    Для аутентификации и авторизации мы рекомендуем использовать oauth2l — простой инструмент командной строки для работы с Google OAuth 2.0. Установите oauth2l и выполните приведенную ниже команду, заменив path_to_credentials_json путем к файлу credentials.json , который вы загружаете при регистрации облачного приложения. При первом запуске команда проведет вас через процесс авторизации OAuth 2.0. Последующие запуски автоматически обновляют токен.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
    
  2. Перечислите источники рекламы.

    Получите информацию об источнике объявлений AdMob, заменив pub-XXXXXXXXXXXXXXXX на свой идентификатор издателя. См. инструкции по поиску идентификатора издателя.

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

    Пример ответа:

    {
     "adSources": [
       {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
         "adSourceId": "5450213213286189855",
         "title": "AdMob Network",
       }
     ]
    }
  3. Перечислите адаптеры.

    Замените SSSSSSSSSSSSSSSSSSSS на идентификатор источника объявления для интересующих адаптеров.

    Используйте следующую команду, чтобы получить список адаптеров:

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

    Пример ответа для источника объявлений сети AdMob с идентификатором 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. Создайте сопоставление рекламных блоков.

    Замените YYYYYYYYYY фрагментом идентификатора вашего рекламного блока. Фрагмент идентификатора рекламного блока – это последние 10 цифр идентификатора вашего рекламного блока, который имеет формат "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". См. инструкции по поиску идентификатора рекламного блока .

    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. Перечислите все сопоставления рекламных блоков.

    Замените YYYYYYYYYY фрагментом идентификатора вашего рекламного блока. Фрагмент идентификатора рекламного блока – это последние 10 цифр идентификатора вашего рекламного блока в формате "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYYY". См. инструкции по поиску идентификатора рекламного блока .

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