Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

Интегрируйте MyTarget с медиацией

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из myTarget с помощью медиации , включая интеграцию по принципу водопада. В нем рассказывается, как добавить myTarget в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер myTarget в приложение Android.

Поддерживаемые интеграции и форматы рекламы

Адаптер посредничества для myTarget обладает следующими возможностями:

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

Android API уровня 23 или выше

Новейшая версия SDK для мобильной рекламы от Google.
Пройдите руководство по началу процесса медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе myTarget.

Войдите в свою учетную запись myTarget. Перейдите на страницу «Приложения», нажав на кнопку «ПРИЛОЖЕНИЯ» в заголовке. Добавьте свое приложение, нажав кнопку «ДОБАВИТЬ ПРИЛОЖЕНИЕ» .

Далее укажите URL-адрес вашего приложения в Google Play .

При добавлении приложения myTarget требует создания рекламного блока, прежде чем вы сможете завершить процесс.

Выберите формат рекламы «БАННЕР» , а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .

Интерстициальный

Выберите формат «МЕЖСТАНЦИОННАЯ РЕКЛАМА» из доступных, а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .

Награжден

Выберите «Вознаграждаемое видео» из доступных форматов рекламы, а затем нажмите кнопку «Добавить рекламный блок» .

Родной

Выберите формат нативной рекламы из доступных, а затем нажмите «Добавить рекламный блок» .

На странице сведений о вашем рекламном блоке запишите идентификатор слота, который можно найти в настройках рекламного блока как slot_id . Этот идентификатор слота будет использоваться для настройки рекламного блока в Ad Manager в следующем разделе.

Помимо slot_id , вам также понадобится ваш постоянный токен доступа myTarget для настройки идентификатора рекламного блока AdMob. Перейдите на вкладку «Профиль» и выберите «Токены доступа» . Нажмите «Создать токен» или «Показать токен» , чтобы просмотреть свой постоянный токен доступа myTarget.

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Чтобы внедрить app-ads.txt в myTarget, см. раздел «Как создать и опубликовать файл» .

Включите тестовый режим

Чтобы добавить и настроить тестовое устройство в пользовательском интерфейсе myTarget, следуйте инструкциям в документации myTarget .

Шаг 2: Настройте параметры целевого спроса myTarget в пользовательском интерфейсе Ad Manager.

Настройте параметры медиации для вашего рекламного блока.

Войдите в свой аккаунт в Ad Manager .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .

Введите уникальное имя для вашей группы доходности, установите статус «Активный» , выберите формат объявления и тип инвентаря «Мобильное приложение» . В разделе «Таргетинг > Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить медиацию.

Далее нажмите кнопку «Добавить партнера по доходности» .

Если у вас уже есть партнер по доходности для myTarget, вы можете его выбрать. В противном случае выберите «Создать нового партнера по доходности» .

Выберите myTarget в качестве рекламной сети , введите уникальное имя и включите медиацию .

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

После выбора партнера Yield выберите тип интеграции «Mobile SDK Mediation» , платформу «Android » и статус «Active» . Введите идентификатор слота , полученный в предыдущем разделе. Затем введите значение CPM по умолчанию .

После завершения нажмите кнопку «Сохранить» внизу страницы.

Добавьте Mail.ru в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

Чтобы добавить Mail.ru в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных актов.

Шаг 3: Импортируйте SDK и адаптер myTarget.

Интеграция с Android Studio (рекомендуется)

В файл build.gradle.kts на уровне приложения добавьте следующие зависимости реализации и конфигурации. Используйте последние версии SDK и адаптера myTarget:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.0")
    implementation("com.google.ads.mediation:mytarget:5.27.4.0")
}

Ручная интеграция

Для подключения SDK myTarget обратитесь к документации по Android SDK myTarget .
Перейдите к артефактам адаптера myTarget в репозитории Maven от Google. Выберите последнюю версию, загрузите файл .aar адаптера myTarget и добавьте его в свой проект.

Шаг 4: Внедрите настройки конфиденциальности в SDK myTarget.

Согласие ЕС и GDPR

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

В версии SDK 5.1.0 myTarget добавил API для получения согласия пользователя, чтобы обеспечить соблюдение требований конфиденциальности. Следующий пример кода показывает, как передать эту информацию о согласии в SDK myTarget. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через SDK Google Mobile Ads.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Котлин

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

Кроме того, если известно, что пользователь относится к возрастной категории, для передачи информации о согласии в SDK myTarget можно использовать следующий код.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Котлин

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

Дополнительную информацию, а также сведения о значениях, которые можно указать в методе, см. в руководстве myTarget по вопросам конфиденциальности и GDPR .

Законы штатов США о защите частной жизни

Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.

В версии SDK 5.9.0 myTarget добавил API для получения согласия пользователя, чтобы обеспечить соблюдение требований конфиденциальности. Следующий пример кода показывает, как передать эту информацию о согласии в SDK myTarget. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через SDK Google Mobile Ads.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Котлин

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

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

Шаг 5: Добавьте необходимый код

Для интеграции с myTarget дополнительный код не требуется.

Шаг 6: Протестируйте свою реализацию.

Включить тестовые объявления

Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе myTarget.

Проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от myTarget, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений myTarget (Waterfall) .

Дополнительные шаги

Использование нативной рекламы

Отображение рекламы

Адаптер myTarget возвращает нативные объявления в виде объектов NativeAd . Он заполняет следующие поля для объекта NativeAd .

Поле	Заполняется адаптером myTarget
Заголовок	Всегда
Изображение	Всегда
Тело	Всегда
значок приложения	Всегда
Призыв к действию	Всегда
Звездный рейтинг	Не гарантировано
Магазин	Не гарантировано
Цена	Не гарантировано
Логотип	Не гарантировано
Рекламодатель	Всегда

SDK myTarget всегда возвращает 0 для ширины и высоты mediaView , поэтому адаптер myTarget всегда возвращает 0 для getAspectRatio() . В будущих версиях SDK myTarget исправит эту проблему.

Отслеживание показов и кликов

Google Mobile Ads SDK использует обратные вызовы myTarget SDK для отслеживания показов и кликов, поэтому отчеты из обоих источников должны совпадать с минимальными расхождениями или вовсе без них.

коды ошибок

Если адаптер не получает объявление от myTarget, вы можете проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdapterResponses() в следующих классах:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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

Код ошибки	Причина
100	SDK myTarget вернул ошибку.
101	Параметры сервера myTarget, настроенные в пользовательском интерфейсе Ad Manager, отсутствуют/недействительны.
102	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому myTarget.
103	Запрос на показ рекламы не является запросом на показ нативной рекламы в рамках унифицированной системы.
104	Загруженная нативная реклама от myTarget отличается от запрошенной нативной рекламы.
105	В загруженной нативной рекламе от myTarget отсутствуют некоторые необходимые элементы (например, изображение или иконка).