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

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

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

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

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

Требования

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

• Новейшая версия GMA Next-Gen SDK .

• Пройдите руководство по началу процесса медиации.

Шаг 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 (рекомендуется)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

• Для подключения 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. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через GMA Next-Gen SDK .

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

MyTargetPrivacy.setUserConsent(true);

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

MyTargetPrivacy.setUserConsent(true)

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

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. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через GMA Next-Gen 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 .

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

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

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

коды ошибок

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

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

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