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

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

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

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

Android iOS Unity Flutter

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Награжден

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

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

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

Родной

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

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

Баннер

Баннер 300x250

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

Награжден

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

Родной

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

Торги

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

Водопад

Помимо идентификатора приложения (App ID) и идентификатора ссылки (Reference ID ), вам также понадобится ключ API для отчетов Liftoff Monetize, чтобы настроить идентификатор рекламного блока в Ad Manager. Перейдите на панель управления отчетами Liftoff Monetize и нажмите кнопку «Ключ API для отчетов», чтобы просмотреть свой ключ API для отчетов .

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

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

Для интеграции файла app-ads.txt с Liftoff Monetize загрузите и добавьте записи из файла app-ads.txt Liftoff Monetize в существующий файл app-ads.txt . Для получения дополнительной информации см. app-ads.txt .

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

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

Торги

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

Водопад

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

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

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

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

Торги

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка Liftoff Монетизация ставок

Торги

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

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

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

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

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

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

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

Водопад

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

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

Выберите компанию, которую вы создали для Liftoff Monetize в предыдущем разделе. В качестве типа интеграции выберите «Посредничество Mobile SDK» , в качестве платформы — «Android» , а в качестве статуса — «Активный» .

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

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

Добавьте Liftoff в список рекламных партнеров, соблюдающих GDPR и правила штатов США.

Чтобы добавить Liftoff в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных актов.

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.0")
    implementation("com.google.ads.mediation:vungle:7.6.1.0")
}

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

Загрузите последнюю версию Vungle Android SDK , распакуйте файлы .aar и JAR в папку libs и добавьте их в свой проект.
Перейдите к артефактам адаптера Liftoff Monetize в репозитории Maven Google. Выберите последнюю версию, загрузите файл .aar адаптера Vungle и добавьте его в свой проект.

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

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

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

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

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

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

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

Java

VunglePrivacySettings.setCCPAStatus(true);LiftoffMonetizeMediationSnippets.java

Котлин

VunglePrivacySettings.setCCPAStatus(true)LiftoffMonetizeMediationSnippets.kt

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

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

Для интеграции Liftoff с Monetize дополнительный код не требуется.

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

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

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

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

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

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

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

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

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

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

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        .build();LiftoffMonetizeMediationSnippets.java

Котлин

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    .build()LiftoffMonetizeMediationSnippets.kt

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

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

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

^1. Адаптер Liftoff Monetize не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет MediaView видео или изображением.

коды ошибок

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

Формат	Название класса
Приложение открыто (торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Приложение открыто (водопад)	com.google.ads.mediation.vungle.VungleMediationAdapter
Баннер (Торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Баннер (Водопад)	com.vungle.mediation.VungleInterstitialAdapter
Интерстициальный (торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Межзернистый (водопад)	com.vungle.mediation.VungleInterstitialAdapter
Награждено (за участие в торгах)	com.google.ads.mediation.vungle.VungleMediationAdapter
Награда (Водопад)	com.vungle.mediation.VungleAdapter
Вознаграждаемая промежуточная реклама (торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Награждаемый промежуточный элемент (Водопад)	com.google.ads.mediation.vungle.VungleMediationAdapter
Нативный (Торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Родной (Водопад)	com.google.ads.mediation.vungle.VungleMediationAdapter

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

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

Для получения информации об ошибках, возникающих в Vungle SDK, обратитесь к разделу «Коды ошибок: Vungle SDK для iOS и Android» .