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

Интегрируйте MyTarget с посредником

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

Поддерживаемые интеграции и форматы объявлений

Адаптер-посредник Ad Manager для myTarget имеет следующие возможности:

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

Требования

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

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

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

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

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

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

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

Межстраничный

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

Награжден

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

Родной

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

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

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

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

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

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

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

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

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

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . ВведитеSlot ID полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Когда закончите, нажмите «Сохранить» внизу страницы.

Добавить Mail.ru в список рекламных партнеров GDPR и правил штата США.

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Mail.ru в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

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

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

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

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

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

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

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

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

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

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

Джава

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

MyTargetPrivacy.setUserConsent(true);

Котлин

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

MyTargetPrivacy.setUserConsent(true)

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

Джава

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

MyTargetPrivacy.setUserAgeRestricted(true);

Котлин

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

MyTargetPrivacy.setUserAgeRestricted(true)

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

Законы о конфиденциальности штатов США

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

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

Джава

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
Заголовок	Всегда
Изображение	Всегда
Тело	Всегда
Значок приложения	Всегда
Призыв к действию	Всегда
Звездный рейтинг	Не гарантировано
Магазин	Не гарантировано
Цена	Не гарантировано
Логотип	Не гарантировано
Рекламодатель	Всегда

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

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

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

Коды ошибок

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

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

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

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