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

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

Интегрируйте монетизацию Liftoff с медиацией

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

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

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

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

Требования

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

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

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

Зарегистрируйтесь или войдите в свою учетную запись Liftoff Monetize.

Добавьте свое приложение на панель управления Liftoff Monetize , нажав кнопку «Добавить приложение» .

Заполните форму, указав все необходимые данные.

После создания приложения выберите его на панели инструментов Liftoff Monetize Applications .

Запишите идентификатор приложения .

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

Чтобы создать новое место размещения для использования с посредничеством Менеджера рекламы, перейдите на панель управления Liftoff Monetize Placements , нажмите кнопку Добавить место размещения и выберите свое приложение из раскрывающегося списка.

Подробная информация о добавлении новых мест размещения приведена ниже:

Выберите «Баннер» , введите название места размещения и заполните остальную часть формы. [Только для ставок] В разделе «Монетизация» переведите переключатель « Торги внутри приложения» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Выберите MREC , введите название места размещения и заполните остальную часть формы. [Только для ставок] В разделе «Монетизация» переведите переключатель « Торги внутри приложения» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

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

Выберите «Интерстициальная реклама» , введите « Название места размещения» и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переведите переключатель « Торги внутри приложения» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Награжден

Выберите «С вознаграждением» , введите название места размещения и заполните остальную часть формы. [Только для ставок] В разделе «Монетизация» переведите переключатель « Торги внутри приложения» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Вознагражденный интерстициальный

Выберите «С вознаграждением» . Введите название места размещения , включите опцию «Пропускаемый» и заполните оставшуюся часть формы. [Только для ставок] В разделе «Монетизация» переведите переключатель « Торги внутри приложения» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Родной

Выберите «Native» , введите название плейсмент-площадки и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переведите переключатель « In-App Bidding» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать плейсмент-площадку.

Запишите идентификатор ссылки и нажмите «Звучит хорошо» .

Баннер

Баннер 300x250

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

Награжден

Вознагражденный интерстициальный

Родной

Найдите свой ключ API для отчетов

Торги

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

Водопад

Помимо идентификатора приложения и идентификатора ссылки , вам также понадобится ключ API отчётности Liftoff Monetize для настройки идентификатора рекламного блока Менеджера рекламы. Перейдите на панель управления отчётами Liftoff Monetize и нажмите кнопку «Ключ API отчётности», чтобы просмотреть свой ключ API отчётности .

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

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

Чтобы реализовать app-ads.txt для Liftoff Monetize, скачайте и добавьте записи из файла app-ads.txt Liftoff Monetize в существующий файл app-ads.txt . Подробнее см. в файле app-ads.txt .

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

Чтобы включить тестовую рекламу, перейдите на панель управления Liftoff Monetize и выберите Приложения .

В разделе «Идентификатор размещения» выберите приложение, для которого вы хотите включить тестовые объявления. Тестовые объявления можно включить, выбрав в разделе «Статус» в тестовом режиме « Показывать только тестовые объявления» .

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

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

Добавьте Liftoff Monetize в компании

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

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

Торги

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

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

Водопад

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

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

Торги

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

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

Водопад

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

Настройте торги Liftoff Monetize

Торги

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

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

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

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

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

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

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

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

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

Добавьте Liftoff в список рекламных партнеров GDPR и государственных органов США

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

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

CocoaPods (рекомендуется)

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

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

Загрузите последнюю версию Vungle iOS SDK и добавьте VungleAdsSDK.xcframework в свой проект.
Загрузите последнюю версию адаптера Liftoff Monetize по ссылке в журнале изменений и добавьте LiftoffMonetizeAdapter.xcframework в свой проект.
Добавьте в свой проект следующие фреймворки:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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

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

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

Начиная с версии Vungle SDK 7.4.1, Liftoff Monetize автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделе «Рекомендуемые инструкции по внедрению GDPR» .

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

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

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

Быстрый

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

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

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

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в пользовательском интерфейсе Liftoff Monetize.

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

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

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

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

Адаптер Liftoff Monetize поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса VungleAdNetworkExtras . Этот класс включает следующие свойства:

userId: Строка, представляющая идентификатор поощренного пользователя Liftoff Monetize.
nativeAdOptionPosition: Целое число, определяющее положение значка конфиденциальности для нативной рекламы.

Вот пример кода, как создать запрос объявления, который задает эти параметры:

Быстрый

#import "VungleAdapter.h"
// ...

let request = GAMRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

Objective-C

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

Рендеринг нативной рекламы

Адаптер Liftoff Monetize возвращает нативную рекламу в виде объектов GADNativeAd . Он заполняет следующие поля для объекта GADNativeAd .

Поле	Активы всегда включены в адаптер Liftoff Monetize
Заголовок
Изображение	1
Медиа-просмотр
Тело
Значок приложения
Призыв к действию
Звездный рейтинг
Магазин
Цена

¹ Адаптер Liftoff Monetize не предоставляет прямого доступа к основному изображению для нативной рекламы. Вместо этого адаптер заполняет GADMediaView видео или изображением.

Коды ошибок

Если адаптеру не удается получить рекламу от Liftoff Monetize, издатели могут проверить основную ошибку в ответе на рекламу, используя GADResponseInfo.adNetworkInfoArray в следующих классах:

Формат	Имя класса
Открытие приложения (торги)	GADMediationAdapterVungle
Открытие приложения (Водопад)	GADMediationAdapterVungle
Баннер (Торги)	GADMediationAdapterVungle
Баннер (Водопад)	GADMAdapterVungleInterstitial
Интерстициальный (торги)	GADMediationAdapterVungle
Интерстициальный (Водопад)	GADMAdapterVungleInterstitial
Награжден (торги)	GADMediationAdapterVungle
Награда (Водопад)	GADMAdapterVungleRewardBasedВидеообъявление
Вознагражденная межстраничная реклама (торги)	GADMediationAdapterVungle
Награда за межстраничный контент (водопад)	GADMediationAdapterVungle
Нативный (Торги)	GADMediationAdapterVungle
Родной (Водопад)	GADMediationAdapterVungle

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

Код ошибки	Домен	Причина
101	com.google.mediation.vungle	Неверные параметры сервера (например, идентификатор приложения или идентификатор размещения).
102	com.google.mediation.vungle	Объявление уже загружено для этой конфигурации сети. Vungle SDK не может загрузить второе объявление для того же идентификатора размещения.
103	com.google.mediation.vungle	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера Liftoff Monetize.
104	com.google.mediation.vungle	Vungle SDK не смог отобразить рекламный баннер.
105	com.google.mediation.vungle	Vungle SDK поддерживает загрузку только одного баннера за раз, независимо от идентификатора места размещения.
106	com.google.mediation.vungle	Vungle SDK отправил ответный вызов, в котором говорилось, что рекламу невозможно воспроизвести.
107	com.google.mediation.vungle	Vungle SDK не готов к воспроизведению рекламы.

Информацию об ошибках, возникающих в Vungle SDK, см. в разделе Коды ошибок: Vungle SDK для iOS и Android .