Настройте URL-адрес прозрачности рекламы

URL-адрес прозрачности рекламы позволяет настроить значок AdChoices , отображаемый в определенных объявлениях. По умолчанию этот значок отображается пользователям через интерфейс прозрачности и контроля рекламы (AT&C), созданный Google, который включает в себя информацию, такую ​​как рекламодатель и само объявление.

Получить URL-адрес для обеспечения прозрачности рекламы можно, отправив запрос на показ рекламы в Google Mobile Ads SDK и получив ответ с этим URL-адресом. После получения URL-адреса в вашем приложении вы можете интегрировать персонализированную иконку, которая будет соответствовать дизайну вашей рекламы и демонстрировать пользователям ваш собственный опыт взаимодействия с сервисом AT&C.

На этой странице описано, как запросить, проанализировать и проверить URL-адрес прозрачности рекламы.

Предварительные требования

Прежде чем продолжить, убедитесь, что вы выполнили следующие действия:

  • Настройте нативную рекламу в своем приложении. Подробную информацию о нативной рекламе см. в разделе «Нативная реклама» .
  • Запросите доступ к этой функции через список разрешенных пользователей. Для запроса доступа свяжитесь со своим менеджером по работе с клиентами.
    • Если у вас нет доступа, ваши ответы не будут возвращать URL-адрес прозрачности рекламы, и будет отображаться стандартная иконка, как и предполагалось.

Запросить URL-адрес

Чтобы GMA Next-Gen SDK возвращал URL-адрес для отображения прозрачности рекламы, необходимо добавить дополнительный параметр запроса в запросы к нативной рекламе. Этот параметр сигнализирует о готовности вашего приложения к обработке персонализированной иконки.

В вашем запросе необходимо добавить ключ "ad_transparency_url_requested" со значением "1" в пакет дополнительных рекламных объявлений вашей сети. Подробную информацию о дополнительных рекламных объявлениях сети см. в setGoogleExtrasBundle .

В следующем примере задаются этот ключ и значение для запроса URL-адреса прозрачности рекламы:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Котлин 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

Замените AD_UNIT_ID на идентификатор вашего рекламного блока. Например, ca-app-pub-3940256099942544/2247696110 для нативной рекламы.

Разберите URL-адрес

После запроса URL-адреса вы получите ответ с рекламным URL-адресом, содержащим информацию о прозрачности рекламы в объекте информации об ответе. Подробную информацию об объекте информации об ответе см. в разделе «Информация об ответе» .

Доступ к URL-адресу прозрачности рекламы можно получить по ключу "ad_transparency_url" из дополнительных данных ответа. В следующем примере URL-адрес прозрачности рекламы получен из объекта информации ответа:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Котлин 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

Проверьте URL-адрес

Чтобы проверить и подтвердить корректность URL-адреса прозрачности рекламы, убедитесь, что в вашей нативной рекламе отображается не стандартный значок, предоставленный Google, а ваш персонализированный значок. Щелкните значок, чтобы просмотреть интерфейс AT&C.

Кроме того, убедитесь, что в объекте информации ответа отображается URL-адрес прозрачности рекламы из дополнительных параметров ответа. Если вы его не видите, вместо вашей персонализированной иконки отображается стандартная иконка Google. Ниже приведен пример URL-адреса прозрачности рекламы:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID