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

Ad unit mappings are third-party configuration settings that map to an AdMob ad unit and enable it to make an ad request to a third-party ad network.

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

Примеры

With OAuth 2.0 credentials created , you're ready to start using the AdMob API. To request access using OAuth 2.0, your application will also need the scope information.

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

Объем Значение
https://www.googleapis.com/auth/admob.monetization See, create, and edit your AdMob monetization settings.
https://www.googleapis.com/auth/admob.readonly See all AdMob data. This may include account information, inventory and mediation settings, reports, and other data. This doesn't include sensitive data, such as payments or campaign details.

Get started on creating your first ad unit mapping:

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

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

  1. Load the client secrets file and generate authorization credentials.

    При первом выполнении этого шага вам будет предложено принять авторизацию в браузере. Прежде чем принять, убедитесь, что вы вошли в систему с учетной записью 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. List ad sources.

    Get AdMob ad source information by replacing pub-XXXXXXXXXXXXXXXX with your publisher ID. See the instructions on how to find your publisher ID.

    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. Перечислите адаптеры.

    Replace SSSSSSSSSSSSSSSSSSSS with the ad source ID for the adapters of interest.

    Use the following command to get a list of adapters:

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

    Sample response for the AdMob Network ad source with ID 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",
     }
   }
}