Таргетинг

Таргетинг позволяет передавать в Google Mobile Ads SDK for React Native информацию о контексте и аудитории, чтобы показывать пользователям релевантные объявления.

Таргетинг можно настроить на следующих уровнях:

  • Глобальная конфигурация запросов. Применяйте настройки ко всем запросам объявлений в приложении, включая пометки для контента, предназначенного для детей и подростков, максимальные возрастные ограничения для рекламного контента, настройки конфиденциальности издателя и идентификаторы тестовых устройств.
  • Таргетинг на уровне запроса. Настраивайте отдельные запросы объявлений с помощью объектов запросов объявлений, включая URL контента и дополнительную информацию от сети.

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

Требования

Прежде чем продолжить, настройте Google Mobile Ads SDK for React Native.

Как настроить конфигурацию запроса

Объект RequestConfiguration собирает информацию о таргетинге, которая применяется ко всем запросам объявлений.

Чтобы применить настройки таргетинга из первого запроса объявления, задайте свойство requestConfiguration при вызове метода initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Замените TEST_DEVICE_HASHED_ID хешированным идентификатором тестового устройства. Этот идентификатор указывает устройство, на которое должны отправляться тестовые объявления.

Чтобы изменить настройки таргетинга после инициализации Google Mobile Ads SDK for React Native, вызовите метод setRequestConfiguration. Метод setRequestConfiguration заменяет существующую конфигурацию и применяется к последующим запросам объявлений.

В примере ниже показано, как изменить объект RequestConfiguration с обновленными настройками таргетинга и применить их к запросам объявлений.

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Как настроить обработку с учетом возраста

Чтобы вам было проще соблюдать действующие законы в отношении конфиденциальности детей и подростков, в Google Mobile Ads SDK for React Native предусмотрена настройка возрастных ограничений. Настройка обработки данных с учетом возраста позволяет указать, должен ли сервис Google Mobile Ads SDK for React Native применять определенные меры защиты при показе рекламы детям, подросткам или пользователям неуказанного возраста.

Вы можете задать возрастные ограничения с помощью свойства ageRestrictedTreatment в RequestConfiguration.

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

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

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

Если вы используете эту настройку, Google Mobile Ads SDK for React Native включает параметр tfat в запросы объявлений. Чтобы определить, какие настройки учета возраста подходят для ваших пользователей, проконсультируйтесь с юристом. Подробнее о том, как указать в запросе объявления, что приложение предназначено для детей…

Фильтрация содержания объявлений

Максимальные возрастные ограничения для рекламного контента позволяют оградить определенные аудитории от неподходящей рекламы. Это решение помогает соблюдать правила платформы.

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

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

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

А именно:

Как настроить PPT API (бета) – необязательно

Publisher Privacy Treatment API (PPT API) позволяет указать, нужно ли отключить персонализацию рекламы для всех запросов объявлений. Для этого используется свойство publisherPrivacyPersonalizationState объекта RequestConfiguration. Если вы используете эту функцию, Google Mobile Ads SDK for React Native включает параметр PPT (вариант защиты конфиденциальности издателем) во все запросы объявлений до конца сеанса.

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

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Настройте объект AdRequest

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

В отличие от глобальной конфигурации, заданной с помощью метода setRequestConfiguration, объект AdRequest передается методу load класса формата объявления, например InterstitialAd.load для межстраничных объявлений или BannerAd.load для баннеров.

Добавьте дополнительную информацию от сети

Чтобы передать в Google Mobile Ads SDK for React Native параметры, относящиеся к определенной сети, например параметры для сворачиваемых объявлений, используйте свойство extras.

В примере ниже задается дополнительный ключ параметра collapsible со значением bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Укажите URL контента

Чтобы указать URL контента для объявлений с таргетингом на контент и обеспечения безопасности бренда, добавьте свойство contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

URL контента должен содержать не более 512 символов.