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

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

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

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

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

Требования

  • Юнити 4 или выше
  • Последняя версия Google Mobile Ads SDK
  • [Для ставок]: плагин медиации Google Mobile Ads для Tapjoy 2.3.0 или более поздней версии ( рекомендуется последняя версия ).
  • Развертывание на Android
    • Android API уровня 19 или выше
  • Развертывание на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Пройдите руководство по началу работы с медиацией

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

Зарегистрируйтесь или войдите в свою панель управления Tapjoy.

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

Добавьте свое приложение на панель управления Tapjoy , перейдя в список приложений в правом верхнем углу и нажав кнопку «Добавить приложение» . Затем вам будет предложено ввести сведения о вашем приложении.

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

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

Если ваше приложение поддерживает обе платформы, выберите «Обе» в качестве платформы.

Андроид

iOS

Размещение, виртуальная валюта и контент

Размещение

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

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

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

Виртуальная валюта

Перейдите в «Монетизация» > «Виртуальная валюта» и нажмите кнопку «Создать виртуальную валюту» в правом верхнем углу.

Заполните форму и нажмите «Создать сейчас» . Используйте NO_CALLBACK в качестве URL-адреса обратного вызова . Это гарантирует, что Tapjoy SDK избежит ненужных вызовов вашего сервера.

Значение и название валюты не пересылаются адаптером Tapjoy, поэтому для названия и суммы валюты можно выбрать любые общие значения.

Андроид

iOS

Содержание

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

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

Торги

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

Нажмите кнопку «Создать» для контента программного межстраничного видео . Укажите имя для контента и выберите платформу .* {Android} * {iOS} Выберите виртуальную валюту, созданную ранее, в качестве виртуальной валюты . Выберите межстраничное место размещения, созданное ранее. Когда закончите, нажмите кнопку «Сохранить» внизу, чтобы создать контент.

Награжден

Нажмите кнопку «Создать» для контента видео с алгоритмической продажей за вознаграждение . * {Android} * {iOS} Выберите виртуальную валюту, созданную ранее, в качестве виртуальной валюты . Выберите место размещения с вознаграждением, созданное ранее. Когда закончите, нажмите кнопку «Сохранить» внизу, чтобы создать контент.

Водопад

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

Нажмите кнопку «Создать» для содержимого межстраничного видео . Укажите имя для контента и выберите платформу .* {Android} * {iOS} Выберите виртуальную валюту, созданную ранее, в качестве виртуальной валюты . Выберите межстраничное место размещения, созданное ранее. Когда закончите, нажмите кнопку «Сохранить» внизу, чтобы создать контент.

Награжден

Нажмите кнопку «Создать» для контента видео с вознаграждением . Укажите имя для контента и выберите платформу .* {Android} * {iOS} Выберите виртуальную валюту, созданную ранее, в качестве виртуальной валюты . Выберите место размещения с вознаграждением, созданное ранее. Когда закончите, нажмите кнопку «Сохранить» внизу, чтобы создать контент.

Найдите ключ SDK

Помимо названия места размещения вам также понадобится ключ SDK для настройки рекламного блока AdMob .

Перейдите в «Настройки» > «Настройки приложения» . Ключ SDK можно получить в разделе «Информация о приложении» на вкладке «Платформы приложений» .

Андроид

iOS

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

Торги

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

Водопад

Для продолжения вам понадобится ключ OAuth издателя и ключ медиации . Ваш ключ OAuth издателя можно получить на той же странице на вкладке «Ключи API» .

Ваш ключ медиации можно получить на той же странице на вкладке «Ключи медиации» в столбце «Ключ API отчетности» . Ключ помечен как «AdMob».

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

Тестовую рекламу можно включить на панели управления Tapjoy в разделе «Настройки» > «Настройки приложения» > «Тестовые устройства» . Создайте новое тестовое устройство, используя рекламный идентификатор устройства:

Андроид

Рекламный идентификатор вашего устройства можно найти, перейдя в Google > Реклама в настройках вашего устройства.

iOS

Чтобы получить рекламный идентификатор вашего устройства, добавьте следующий код в свое приложение. Обязательно импортируйте платформу AdSupport в свое приложение, прежде чем использовать приведенный ниже код.

Быстрый

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Цель-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

Затем измените созданный ранее контент.

Чтобы изменить свой контент, сначала перейдите в раздел «Монетизация» > «Места размещения» и перейдите на вкладку «Инициировано пользователем» . Затем выберите раскрывающийся список содержимого, которое вы хотите отредактировать, и выберите «Редактировать» .

В разделе «Основное » содержимого установите флажок «Только для тестовых устройств» . Затем нажмите «Сохранить» внизу страницы. Вот и все! Теперь у вас есть работающая интеграция медиации с Tapjoy.

Андроид

iOS

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

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

Андроид

Инструкции см. в шаге 2 руководства дляAndroid .

iOS

Инструкции см. в шаге 2 руководства дляiOS .

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

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

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

Загрузите последнюю версию плагина-посредника Google Mobile Ads для Tapjoy по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsTapjoyMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и выберите загруженный файл GoogleMobileAdsTapjoyMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .

Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

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

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

Плагин посредничества Google Mobile Ads для Tapjoy версии 1.1.1 включает методы SetUserConsent() и SubjectToGDPR() . В следующем примере кода показано, как передать информацию о согласии в Tapjoy SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUserConsent("myUserConsent");

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

Tapjoy.SubjectToGDPR(true);

Дополнительную информацию и значения, которые можно указать в этом методе, см. в руководстве по конфиденциальности пользователей Tapjoy.

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

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

Плагин-посредник Google Mobile Ads для Tapjoy версии 2.9.1 включает метод SetUSPrivacy() . В следующем примере кода показано, как передать информацию о согласии в Tapjoy SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUSPrivacy("myUSPrivacyString");

Дополнительную информацию и значения, которые можно указать в этом методе, см. в руководстве по конфиденциальности пользователей Tapjoy.

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

Андроид

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

iOS

Интеграция со SKAdNetwork

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

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

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

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

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

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

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

Андроид

Разрешения

Для оптимальной производительности Tapjoy рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml вашего приложения. Измените файл AndroidManifest.xml , расположенный в папке Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation и включите следующие дополнительные разрешения:

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

iOS

Никаких дополнительных действий для интеграции с iOS.

Коды ошибок

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

Андроид

Формат Имя класса
Межстраничный TapjoyАдаптер
Награжден TapjoyMediationАдаптер

iOS

Формат Имя класса
Межстраничный GADMAdapterTapjoy
Награжден GADMAdapterTapjoy

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

Андроид

Код ошибки Причина
101 Параметры сервера Tapjoy, настроенные в пользовательском интерфейсе AdMob отсутствуют/недействительны.
103 Издатель должен запрашивать объявления с контекстом Activity .
104 Tapjoy SDK не удалось инициализировать.
105 Во время воспроизведения видео произошла ошибка презентации Tapjoy.
106 Tapjoy SDK не может загрузить два объявления для одного и того же идентификатора места размещения одновременно.
107 Приложение не запрашивало нативную рекламу.
108 Tapjoy SDK не имеет доступного рекламного контента.

iOS

Код ошибки Причина
101 Параметры сервера Tapjoy, настроенные в пользовательском интерфейсе AdMob отсутствуют/недействительны.
102 Tapjoy SDK не удалось инициализировать.
103 Адаптер Tapjoy не поддерживает запрошенный формат объявления.
104 Tapjoy отправил успешный обратный вызов при загрузке, но контент не был доступен.
105 Объявление для этой конфигурации сети уже загружено.
106 Tapjoy SDK вернул обратный вызов с ошибкой видео.

Журнал изменений плагина Tapjoy Unity Mediation

Версия 3.2.0

Версия 3.1.1

Версия 3.1.0

Версия 3.0.0

  • Содержимое адаптера перенесено в GoogleMobileAds/Mediation/Tapjoy/ .
  • Переработано пространство имен адаптера для использования GoogleMobileAds.Mediation.Tapjoy .
  • Поддерживает адаптер Tapjoy Android версии 13.0.1.0 .
  • Поддерживает адаптер Tapjoy iOS версии 13.0.1.0 .
  • Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.

Версия 2.10.1

Версия 2.10.0

Версия 2.9.1

Версия 2.9.0

Версия 2.8.2

Версия 2.8.1

Версия 2.8.0

Версия 2.7.1

Версия 2.7.0

Версия 2.6.1

Версия 2.6.0

Версия 2.5.1

Версия 2.5.0

Версия 2.4.2

Версия 2.4.1

Версия 2.4.0

Версия 2.3.1

Версия 2.3.0

  • Поддерживает адаптер Tapjoy Android версии 12.3.1.0.
  • Поддерживает адаптер Tapjoy iOS версии 12.3.1.0.

Версия 2.2.0

  • Обновлен плагин для поддержки нового Rewarded API.
  • Поддерживает адаптер Tapjoy Android версии 12.2.1.0.
  • Поддерживает адаптер Tapjoy iOS версии 12.2.1.0.

Версия 2.1.0

  • Поддерживает адаптер Tapjoy Android версии 12.2.0.0.
  • Поддерживает адаптер Tapjoy iOS версии 12.1.0.0.

Версия 2.0.1

  • Поддерживает адаптер Tapjoy Android версии 12.0.0.1.
  • Поддерживает адаптер Tapjoy iOS версии 12.0.0.0.

Версия 2.0.0

  • Поддерживает адаптер Tapjoy Android версии 12.0.0.0.
  • Поддерживает адаптер Tapjoy iOS версии 12.0.0.0.

Версия 1.1.1

  • Поддерживает Tapjoy Android SDK версии 11.12.2.
  • Поддерживает Tapjoy iOS SDK версии 11.12.2.
  • Добавлен метод Tapjoy.SetUserConsent() для пересылки статуса согласия пользователя в Tapjoy SDK в виде строки согласия.
  • Добавлен метод Tapjoy.SubjectToGDPR() , указывающий, применим ли GDPR к пользователю или нет.

Версия 1.1.0

  • Поддерживает Tapjoy Android SDK версии 11.12.1.
  • Поддерживает Tapjoy iOS SDK версии 11.12.1.

Версия 1.0.0

  • Первый выпуск!
  • Поддерживает Tapjoy Android SDK версии 11.11.1.
  • Поддерживает Tapjoy iOS SDK версии 11.11.1.