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

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

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

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

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

The mediation adapter for myTarget has the following capabilities:

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

Требования

Целевая версия iOS для развертывания — 13.0 или выше.

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

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

Log in to your myTarget account. Navigate to the Apps page by clicking on APPS on the header. Add your app by clicking ADD APP .

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

When adding an app, myTarget requires you to create an ad unit before you can complete the process.

Select BANNER from the available ad formats, and then click the ADD AD UNIT button.

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

Select INTERSTITIAL from the available ad formats, and then click the ADD AD UNIT button.

Награжден

Select REWARDED VIDEO from the available ad formats, and then click the ADD AD UNIT button.

Родной

Select NATIVE from the available ad formats, and then click on ADD AD UNIT .

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

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

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

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

To implement app-ads.txt for myTarget, see How to create and publish a file .

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

Follow the instructions in myTarget's documentation to add and configure a test device in myTarget UI.

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

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

You need to add myTarget to the mediation configuration for your ad unit.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить myTarget в качестве источника рекламы» .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

Присвойте вашей группе посредничества название и выберите регионы для таргетирования. Затем установите статус группы посредничества на «Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте myTarget в качестве источника рекламы.

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Выберите myTarget и включите переключатель «Оптимизировать» . Введите полученный в предыдущем разделе постоянный токен доступа , чтобы настроить оптимизацию источника рекламы для myTarget. Затем введите значение eCPM для myTarget и нажмите «Продолжить» .

If you already have a mapping for myTarget, you can select it. Otherwise, click Add mapping .

Next, enter the Slot ID obtained in the previous section. Then click Done .

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

Add Mail.ru to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Mail.ru to the European and US state regulations ad partners list in the AdMob UI.

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

Используйте менеджер пакетов Swift.

Before you continue, you must have the minimum supported adapter version 5.36.0.0.

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

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-mytarget.git
```
В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

Добавьте следующую строку в файл Podfile вашего проекта:
```
pod 'GoogleMobileAdsMediationMyTarget'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Download the latest version of the myTarget SDK .
Download the latest version of the myTarget adapter from the download link in the Changelog and link MyTargetAdapter.framework in your project.
Добавьте в свой проект следующие фреймворки:
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

Step 4: Implement privacy settings on myTarget SDK

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

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

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

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserConsent:YES];

Additionally, if the user is known to be in an age-restricted category, you can use the following code to pass this consent information to the myTarget SDK.

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserAgeRestricted:YES];

See myTarget's Privacy and GDPR guide for more information and the values that can be provided in the method.

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

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

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

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setCcpaUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setCcpaUserConsent:YES];

Contact myTarget support for more information and the values that can be provided in the method.

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

Внедрить SKAdNetwork

Follow myTarget's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

Make sure you register your test device for AdMob and enable test mode in myTarget UI.

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

To verify that you are receiving test ads from myTarget, enable single ad source testing in ad inspector using the myTarget (Waterfall) ad source(s).

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

Параметры, специфичные для сети

Адаптер myTarget поддерживает isDebugMode , необязательный параметр для включения логирования, значение по умолчанию которого — YES . Этот параметр можно передать адаптеру с помощью класса GADMAdapterMyTargetExtras , и его необходимо устанавливать при каждом запросе рекламы. Вот как это сделать:

Быстрый

let request = GADRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADMAdapterMyTargetExtras * extras = [[GADMAdapterMyTargetExtras alloc] init];
extras.isDebugMode = NO;
[request registerAdNetworkExtras:extras];

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

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

The myTarget adapter returns its native ads as GADNativeAd objects. It populates the following native ads field descriptions for a GADNativeAd .

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

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

Google Mobile Ads SDK uses the myTarget SDK's callbacks for impression and click tracking, so the reports from both sources should match up with few to no discrepancies.

коды ошибок

If the adapter fails to receive an ad from myTarget, you can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Here are the codes and accompanying messages thrown by the myTarget adapter when an ad fails to load:

Код ошибки	Причина
100	В myTarget SDK пока нет рекламы.
101	myTarget server parameters configured in the AdMob UI are missing/invalid.
102	myTarget Adapter does not support the ad format being requested.
103	Попытка показать рекламу myTarget, которая не загрузилась.
104	The requested ad size does not match a myTarget supported banner size.
105	Отсутствуют необходимые элементы нативной рекламы.