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

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

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

Примеры

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

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

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

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

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

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

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

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

    Для аутентификации и авторизации мы рекомендуем использовать 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/YYYYYYYYYY. Подробнее о том, как найти идентификатор рекламного блока…

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