Таргетинг

В этом руководстве объясняется, как передать информацию о таргетинге в SDK Google Mobile Ads.

Предварительное условие

Прежде чем продолжить, установите GMA Next-Gen SDK .

RequestConfiguration

RequestConfiguration собирает информацию о таргетинге, применяемую глобально к каждому запросу объявления. Список доступных тегов таргетинга см. в документации RequestConfiguration.Builder .

Создайте объект RequestConfiguration с необходимыми тегами таргетинга, используя его конструктор, а затем установите конфигурацию, вызвав метод MobileAds.setRequestConfiguration() .

Важный момент: вызов метода MobileAds.setRequestConfiguration() заменяет любую существующую конфигурацию.

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Чтобы применить таргетинговые теги из первого запроса объявления, укажите конфигурацию запроса во время инициализации SDK:

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

Установить возраст лечения

To help you manage your compliance with applicable privacy regulations related to children and teens, GMA Next-Gen SDK provides an age treatment setting. The age treatment setting lets you indicate whether GMA Next-Gen SDK should apply specific ad serving protections for children, teens, or an unspecified age.

Вы можете установить возрастные ограничения для лечения с помощью метода setAgeRestrictedTreatment() , используемого в API RequestConfiguration.Builder .

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

Котлин

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

• TEEN
• UNSPECIFIED

When using the setting, GMA Next-Gen SDK includes a tfat parameter in ad requests. Consult your legal counsel to determine the applicable age treatment for your users based on your legal and regulatory obligations. For more information, see Tag an ad request for age treatment .

Переход от лечения TFCD и TFUA к лечению, ориентированному на возраст.

Параметр «Возрастная принадлежность» заменяет устаревшие параметры .setTagForChildDirectedTreatment() (TFCD) и .setTagForUnderAgeOfConsent() (TFUA).

В следующей таблице показаны параметры TFCD и TFUA, а также их эквиваленты для разных возрастных групп:

TFCD

TFCD	омоложение
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Значение не присвоено .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
Нет эквивалента	AgeRestrictedTreatment.TEEN

TFUA

TFUA	омоложение
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Значение не присвоено .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Нет эквивалента	AgeRestrictedTreatment.TEEN

Понимание взаимодействия возрастных изменений в лечении с TFCD и TFUA

Если вы зададите параметры лечения в зависимости от возраста, а также параметры TFCD или TFUA, Google применит наиболее консервативный подход.

Note: Apps in the Designed For Families Program as Primarily child-directed apps and users signed into Google Accounts managed with Family Link automatically have all content treated as child-directed for all ad requests.

Лечение старения с помощью медиации

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

В таблице ниже перечислены версии адаптеров посредничества, поддерживающие пересылку сигнала об ограничении по возрасту на сторонний SDK для посредничества:

Название адаптера медиации	Минимальная поддерживаемая версия
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Биго	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Монетизация Liftoff (Vungle)	7.7.4.2
LY (Линия)	3.1.1.1
майо	2.0.9.0
Мета (Фейсбук)	6.21.0.4
Минтеграл	17.1.61.1
Молоко	4.10.0.0
MyTarget	5.47.1.1
Пэнгл	8.1.0.3.1
PubMatic	5.1.2.2
Верве	3.9.0.0

обстановка, ориентированная на ребенка

Предупреждение: Метод setTagForChildDirectedTreatment() устарел. Вместо него используйте метод setAgeRestrictedTreatment() .

For purposes of the Children's Online Privacy Protection Act (COPPA) , there is a setting called "tag for child-directed treatment". By setting this tag, you certify that this notification is accurate and you are authorized to act on behalf of the owner of the app. You understand that abuse of this setting may result in termination of your Google Account.

As an app developer, you can indicate whether you want Google to treat your content as child-directed when you make an ad request. If you indicate that you want Google to treat your content as child-directed, we take steps to disable IBA and remarketing ads on that ad request.

Вы можете применить настройку, ориентированную на дочерние элементы, с помощью setTagForChildDirectedTreatment() :

• Call setTagForChildDirectedTreatment with TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE to indicate that you want your content treated as child-directed for purposes of COPPA. This prevents the transmission of the Android advertising identifier (AAID) .

• Вызовите setTagForChildDirectedTreatment с TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE чтобы указать, что вы не хотите, чтобы ваш контент обрабатывался как предназначенный для детей в соответствии с законом COPPA.

• Call setTagForChildDirectedTreatment with TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED if you don't want to indicate how you would like your content treated with respect to COPPA in ad requests.

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

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Note: Apps in the Designed For Families Program as Primarily child-directed apps and users signed into Google Accounts managed with Family Link automatically have all content treated as child-directed for all ad requests.

Пользователи, не достигшие возраста согласия

Предупреждение: Метод setTagForUnderAgeOfConsent() устарел. Вместо него используйте метод setAgeRestrictedTreatment() .

Вы можете пометить запросы на рекламу, требующие обработки данных от пользователей из Европейской экономической зоны (ЕЭЗ), не достигших возраста согласия. Эта функция разработана для облегчения соблюдения Общего регламента по защите данных (GDPR) . У вас могут быть и другие юридические обязательства в соответствии с GDPR. Ознакомьтесь с рекомендациями Европейского союза и проконсультируйтесь со своим юристом. Инструменты Google разработаны для облегчения соблюдения требований и не освобождают ни одного конкретного издателя от его обязательств в соответствии с законом. Узнайте больше о том, как GDPR влияет на издателей .

When using this feature, a Tag For Users under the Age of Consent in Europe (TFUA) parameter is included in the ad request. This parameter disables personalized advertising, including remarketing, for all ad requests. It also disables requests to third-party ad vendors, such as ad measurement pixels and third-party ad servers.

Подобно настройкам, управляемым дочерними элементами, в RequestConfiguration.Builder есть метод для установки параметра TFUA: setTagForUnderAgeOfConsent() со следующими параметрами.

• Call setTagForUnderAgeOfConsent() with TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE to indicate that you want the ad request to receive treatment for users in the European Economic Area (EEA) under the age of consent. This also prevents the transmission of the Android advertising identifier (AAID) .

• Call setTagForUnderAgeOfConsent() with TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE to indicate that you want the ad request to not receive treatment for users in the European Economic Area (EEA) under the age of consent.

• Call setTagForUnderAgeOfConsent() with TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED to indicate that you have not specified whether the ad request should receive treatment for users in the European Economic Area (EEA) under the age of consent.

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

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Не следует одновременно устанавливать значение true для параметров "Управление по дочерним процессам" и setTagForUnderAgeOfConsent() . В противном случае приоритет имеет параметр "Управление по дочерним процессам".

Фильтрация рекламного контента

To comply with Google Play's Inappropriate Ads Policy that includes associated offers within an ad, all ads and their associated offers shown within your app must be appropriate for the content rating of your app, even if the content by itself is otherwise compliant with Google Play's policies.

Tools like maximum ad content rating can help you have more control over the content of the ads shown to your users. You can set a maximum content rating to help compliance with platform policies.

Apps can set a maximum ad content rating for their ad requests using the setMaxAdContentRating method. AdMob ads returned when this is configured have a content rating at or lower than that level. The possible values for this network extra are based on digital content label classifications , and must be one of the following strings:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Следующий код настраивает объект RequestConfiguration , указывая, что возвращаемый рекламный контент должен соответствовать обозначению метки цифрового контента не выше G :

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Узнайте больше о настройке максимального рейтинга контента для каждого запроса рекламы .

Примечание: Настройки фильтра рейтинга контента, заданные через GMA Next-Gen SDK переопределяют любые настройки, заданные с помощью пользовательского интерфейса Ad Manager.

Обработка персональных данных издателя (бета-версия)

The Publisher Privacy Treatment (PPT) API is an optional tool that lets apps indicate whether to turn off ads personalization for all ad requests using the setPublisherPrivacyPersonalizationState() method. When using this feature, a publisher privacy treatment (PPT) parameter is included in all future ad requests for the remainder of the session.

По умолчанию запросы на показ рекламы в Google сопровождаются персонализированной рекламой. Следующий код отключает персонализацию рекламы для всех запросов:

Котлин

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

Запрос на рекламу

Объект AdRequest собирает информацию о таргетинге, которая будет отправлена ​​вместе с запросом на показ рекламы.

Добавить дополнительные сетевые функции

Дополнительные данные сети — это дополнительная информация, отправляемая вместе с запросом на показ рекламы и относящаяся к конкретному источнику рекламы.

Следующий фрагмент кода устанавливает дополнительный параметр key со значением collapsible и значением bottom для Google:

Котлин

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);

Настраиваемый таргетинг

Вы можете передавать пользовательские пары ключ-значение для таргетирования кампаний Google Ad Manager (позиций). В следующем примере в запросе объявления передается пользовательская пара ключ-значение:

Котлин

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

В качестве ключа можно передать несколько значений в виде списка строк. Например, чтобы нацелиться на людей в возрасте около двадцати пяти лет, а не только на 25-летних.

Котлин

.putCustomTargeting("age", listOf("24", "25", "26"))

Java

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

Исключения из категорий

Добавить уровень исключения категорий на уровне слота к запросу можно с помощью метода addCategoryExclusion() :

Котлин

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Для демонстрации возможности исключения категорий из рекламных кампаний в демонстрационном приложении Android API ознакомьтесь с примером использования исключений по категориям в Ad Manager .

Идентификаторы, предоставленные издателем

You can set a publisher provided identifier (PPID) for use in frequency capping, audience segmentation and targeting, sequential ad rotation, and other audience-based ad delivery controls across devices.

Примечание: Эта функция доступна не всем издателям. Подробную информацию см. в разделе «Об идентификаторах, предоставляемых издателем» .

Вот пример установки PPID:

Котлин

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

Java

AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID")
    .setPublisherProvidedId("AB123456789")
    .build();

Ознакомьтесь с примером использования идентификаторов, предоставляемых издателем (PPID), в демонстрационном приложении Android API в Ad Manager .

Сигналы, предоставленные издателем

Вы можете отправлять данные об аудитории и контекстные данные в виде сигналов, предоставляемых издателем (PPS), в запросах на показ рекламы. С помощью PPS вы можете использовать данные о пользователях для улучшения программной монетизации, передавая характеристики вашей аудитории участникам торгов во всех типах транзакций , используя стандартные таксономии, без необходимости делиться идентификаторами пользователей. Характеристики вашей аудитории могут включать поведенческие данные и данные об интересах ( IAB Audience Taxonomy 1.1 ), а также контекстные данные ( IAB Content Taxonomy 2.2 ).

Котлин

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

URL содержимого

Для указания URL-адреса контента в целях целевой рекламы и обеспечения безопасности бренда добавьте следующее:

Котлин

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

Безопасность бренда (бета-версия)

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

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

Котлин

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .setNeighboringContentUrls(urls)
  .build()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() отличается от .setContentUrl() тем, что используется исключительно для защиты бренда.

Примечание: setNeighboringContentUrls использует только первые четыре URL-адреса из списка. Остальные игнорируются.