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

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

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

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

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

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

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

¹ Интеграция торгов находится на стадии закрытого бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.

² Объявления с вознаграждением поддерживаются только в каскадной медиации.

Требования

Цель развертывания iOS 12.0 или выше
[Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер DT Exchange 8.3.8.0 или выше ( рекомендуется последняя версия ).

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

Добавить новое приложение и место размещения рекламы

Зарегистрируйтесь или войдите в консоль DT Exchange.

Нажмите Добавить приложение .

Управление приложениями

Выберите платформу и места размещения, заполните остальную часть формы, а затем нажмите «Создать приложение» .

Введите названия и выберите типы мест размещения. Затем нажмите «Сохранить место размещения» .

Настраивать

Идентификатор приложения и идентификатор размещения

Наведите указатель мыши на левую панель навигации, чтобы открыть ее, затем нажмите «Управление приложениями» .

На странице управления приложениями обратите внимание на идентификатор приложения рядом с вашим приложением.

Выберите приложение и перейдите на вкладку «Места размещения» . Запишите идентификатор места размещения .

Идентификатор размещения

Идентификатор издателя, ключ потребителя и секрет потребителя

Нажмите на свое имя пользователя в левом меню и выберите Профиль пользователя .

Запишите идентификатор издателя , ключ потребителя и секрет потребителя , так как они понадобятся на следующем этапе.

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

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

Чтобы реализовать app-ads.txt для DT Exchange, добавьте DT в файл app-ads.txt .

Шаг 2: Настройте спрос DT Exchange в пользовательском интерфейсе Менеджера рекламы

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

Добавить DT Exchange в компании

Торги

Этот шаг не требуется для интеграции торгов.

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите DT Exchange (монетизация Fyber) и включите опцию «Включить интеграцию приложений» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройте торги DT Exchange

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите DT Exchange в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для DT Exchange.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор приложения и идентификатор места размещения, полученные в предыдущем разделе. Нажмите «Сохранить ».

Водопад

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

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

Выберите компанию, созданную для DT Exchange в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса .

Введите идентификаторы приложения и места размещения, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

Добавьте DT Exchange (монетизация Fyber) в список рекламных партнеров, соответствующих GDPR и государственным нормам США.

Следуйте инструкциям в настройках европейского законодательства и государственных нормативных актов США, чтобы добавить DT Exchange (Fyber Monetization) в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе Менеджера рекламы.

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

Использование CocoaPods (рекомендуется)

Добавьте следующую строку в Podfile вашего проекта:

pod 'GoogleMobileAdsMediationFyber'

В командной строке выполните:

pod install --repo-update

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

Загрузите последнюю версию DT SDK для iOS и привяжите IASDKCore.xcframework .
Загрузите последнюю версию адаптера DT Exchange по ссылке в журнале изменений и добавьте DTExchangeAdapter.xcframework в свой проект.

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

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

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

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

Быстрый

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

Более подробную информацию и значения, которые могут быть предоставлены в методе, можно найти в руководстве по внедрению GDPR от DT Exchange.

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

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

Быстрый

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

Более подробную информацию и значения, которые могут быть предоставлены в методе, можно найти в руководстве по внедрению CCPA от DT Exchange.

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

Интеграция SKAdNetwork

Следуйте документации DT Exchange , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.

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

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

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

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

Адаптер DT Exchange поддерживает дополнительные параметры запроса, которые можно передать адаптеру с помощью метода GADMAdapterFyberExtras() . Адаптер ищет в пакете следующие ключи:

Параметры и значения запроса
`setUserData` Возраст, пол и почтовый индекс пользователя.	`IAUserData`
`setMuteAudio`	Логическое значение . Отключить или включить звук видео.

Вот пример кода, показывающий, как задать эти параметры запроса рекламы:

Быстрый

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GAMRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GAMRequest *request = [GAMRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

Более подробную информацию можно найти в руководстве по интеграции DT Exchange .

Коды ошибок

Если адаптеру не удается получить рекламу от DT Exchange, вы можете проверить основную ошибку в ответе на рекламу, используя GADResponseInfo.adNetworkInfoArray в следующем классе:

GADMediationAdapterFyber

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

Код ошибки	Причина
0-10	DT SDK вернул ошибку. Подробнее см. в документации .
101	Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны.
102	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера DT Exchange.
103	Не удалось показать объявление, так как объект объявления уже используется.
104	Не удалось показать рекламу DT Exchange, так как объявление не готово.
105	DT SDK вернул ошибку инициализации.