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

Интегрируйте AdColony с посредником

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

Поддерживаемые интеграции и форматы объявлений

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

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

Требования

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

[Для ставок]: адаптер AdColony 3.3.10.1 или выше ( рекомендуется последняя версия )

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

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

Зарегистрируйтесь и войдите в свою учетную запись AdColony. Добавьте свое приложение на панель издателя AdColony , нажав кнопку «Настроить новое приложение» .

AdColony устанавливает новое приложение

Заполните форму и нажмите «Создать» внизу страницы, чтобы добавить свое приложение в AdColony.

AdColony создать приложение

После создания приложения вы можете получить свой идентификатор приложения , перейдя в раздел «Монетизация» > «Приложения» в разделе «Основная информация о приложении ».

Идентификатор приложения AdColony

Затем создайте новую рекламную зону, нажав кнопку «Настроить новую рекламную зону» в разделе «Рекламные зоны» на странице вашего приложения. Мы рекомендуем создать новую рекламную зону для медиации с помощью Ad Manager даже если она у вас уже есть.

Зона настройки AdColony

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

Установить зону активна? на Да .
Введите имя для своей рекламной зоны.
Выберите «Баннер» в качестве размера рекламной зоны .
Введите значение ограничения ежедневной игры .

Межстраничный

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

Награжден

Установить зону активна? на Да .
Введите имя для своей рекламной зоны.
В качестве типа зоны выберите Value Exchange/V4VC .
Установить только клиентскую сторону? выберите «Да» и введите имя виртуальной валюты , максимальное количество видео в день на пользователя и сумму вознаграждения .
Примечание. Указанное здесь значение вознаграждения пересылается адаптером, если значения вознаграждения не переопределены в пользовательском интерфейсе Ad Manager.
Введите значение ограничения ежедневной игры .

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

После создания рекламной зоны вы сможете найти свой идентификатор зоны в разделе «Интеграция» рекламной зоны. Идентификатор зоны будет использоваться на следующем этапе.

Идентификатор зоны AdColony

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

Торги

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

Водопад

Вам понадобится ключ API AdColony для настройки идентификатора рекламного блокаAd Manager . Перейдите к настройкам учетной записи на панели издателя AdColony , чтобы найти свой ключ API.

Настройки АдКолони

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

Чтобы включить тестовую рекламу в AdColony, перейдите на панель управления AdColony и выберите «Монетизация» > «Приложения» . Выберите свою зону, для которой вы хотите включить тестовые объявления, в разделе «Рекламные зоны» вашего приложения. Тестовые объявления можно включить, установив флажок Да для параметра Показывать только тестовые объявления? в разделе «Развитие» .

Тест AdColony

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

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

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

Настройка ставок AdColony

Торги

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

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

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

Нажмите Продолжить .

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

Водопад

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

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

Торги

Перейдите в раздел Доставка > Участники торгов и выберите компанию дляAdColony на вкладке SDK Bidding .

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

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

Водопад

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

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

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

Введите App ID and Zone IDполученный в предыдущем разделе, и значение цены за тысячу показов по умолчанию . Нажмите Сохранить .

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

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить AdColony в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:adcolony:4.8.0.2")
}

Перенос проекта на AndroidX

AdColony SDK зависит от библиотек поддержки Android, но последняя версия Google Mobile Ads SDK использует библиотеки Jetpack .

Чтобы обеспечить совместимость AdColony SDK и Google Mobile Ads SDK, создайте файл gradle.properties на верхнем уровне вашего проекта и добавьте следующий код:

android.useAndroidX=true
android.enableJetifier=true

Это приведет к перезаписи двоичного файла AdColony SDK для использования библиотек Jetpack. Дополнительную информацию об этих настройках см. в руководстве по миграции AndroidX .

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

Загрузите AdColony Android SDK , извлеките файл adcolony.jar из папки Library и добавьте его в свой проект.
AdColony SDK зависит от библиотеки поддержки аннотаций. Подробную информацию о том, как добавить библиотеку поддержки аннотаций в проект, см. в разделе «Улучшение проверки кода с помощью аннотаций» .
Перейдите к артефактам адаптера AdColony в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера AdColony и добавьте его в свой проект.

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

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

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

Адаптер AdColony предоставляет метод AdColonyMediationAdapter.getAppOptions() для настройки параметров, которые будут отправлены в SDK AdColony. Два метода, соответствующие GDPR для этих параметров, — это setPrivacyFrameworkRequired() и setPrivacyConsentString() . В следующем примере кода показано, как передать информацию о согласии адаптеру AdColony, которая затем используется в методе инициализации AdColony. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в SDK AdColony.

Джава

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1");

Котлин

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1")

Дополнительные сведения о том, какие значения могут быть предоставлены в этих методах, см. в подробностях реализации GDPR AdColony .

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

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

Адаптер AdColony предоставляет метод AdColonyMediationAdapter.getAppOptions() для настройки параметров, которые будут отправлены в SDK AdColony. Два метода, относящиеся к CCPA для этих параметров, — это setPrivacyFrameworkRequired() и setPrivacyConsentString() . В следующем примере кода показано, как передать информацию о согласии адаптеру AdColony, которая затем используется в методе инициализации AdColony. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в SDK AdColony.

Джава

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1");

Котлин

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1")

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

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

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

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

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

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

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

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

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

Разрешения

Для оптимальной производительности AdColony рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml вашего приложения:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

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

Сетевые параметры

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

setShowPrePopup(boolean) : Определяет, показывать ли всплывающее окно перед показом рекламы. Установите значение false, чтобы всплывающее окно не появлялось перед показом рекламы.
setShowPostPopup(boolean) : определяет, показывать ли всплывающее окно после показа рекламы. Установите значение false, чтобы всплывающие окна не появлялись после показа рекламы.

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

Джава

AdColonyBundleBuilder.setShowPrePopup(true);
AdColonyBundleBuilder.setShowPostPopup(true);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter.class, AdColonyBundleBuilder.build())
  .build();
rewardedInterstitialAd.loadAd(request);

Котлин

AdColonyBundleBuilder.setShowPrePopup(true)
AdColonyBundleBuilder.setShowPostPopup(true)

val request = AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter::class.java, AdColonyBundleBuilder.build())
  .build()
rewardedInterstitialAd.loadAd(request)

Проверьте версии адаптера и SDK.

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

AdColonyMediationAdapter adapter = new AdColonyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
    "Adapter version: %d.%d.%03d",
    adapterVersion.getMajorVersion(),
    adapterVersion.getMinorVersion(),
    adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
    "SDK version: %d.%d.%d",
    sdkVersion.getMajorVersion(),
    sdkVersion.getMinorVersion(),
    sdkVersion.getMicroVersion()));

Коды ошибок

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

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

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

Код ошибки	Причина
100	AdColony SDK возвратил ошибку.
101	Неверные параметры сервера (например, отсутствует идентификатор зоны).
102	Объявление уже было запрошено для того же идентификатора зоны.
103	AdColony SDK возвратил ошибку инициализации.
104	Запрошенный размер баннера не соответствует допустимому размеру объявления AdColony.
105	Ошибка презентации из-за того, что объявление не загружено.
106	Контекст, использованный для инициализации AdColony SDK, не был экземпляром `Activity` .

Журнал изменений адаптера AdColony для Android-агрегатора