В этом руководстве показано, как использовать 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.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей 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
- Поддерживает адаптер Tapjoy Android версии 13.2.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 13.2.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 3.1.1
- Поддерживает адаптер Tapjoy Android версии 13.1.2.0 .
- Поддерживает адаптер Tapjoy iOS версии 13.1.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.4.1.
Версия 3.1.0
- Поддерживает адаптер Tapjoy Android версии 13.1.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 13.1.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.4.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
- Поддерживает адаптер Tapjoy Android версии 12.11.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.11.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 2.10.0
- Поддерживает адаптер Tapjoy Android версии 12.11.0.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.11.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 2.9.1
- Добавлен метод
Tapjoy.SetUSPrivacy(string)
. - Поддерживает адаптер Tapjoy Android версии 12.10.0.1 .
- Поддерживает адаптер Tapjoy iOS версии 12.10.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.2.0.
Версия 2.9.0
- Поддерживает адаптер Tapjoy Android версии 12.10.0.1 .
- Поддерживает адаптер Tapjoy iOS версии 12.10.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 2.8.2
- Поддерживает адаптер Tapjoy Android версии 12.9.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.9.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.8.1
- Поддерживает адаптер Tapjoy Android версии 12.9.0.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.9.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 2.8.0
- Поддерживает адаптер Tapjoy Android версии 12.9.0.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.9.0.0 .
Версия 2.7.1
- Поддерживает адаптер Tapjoy Android версии 12.8.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.8.1.0 .
Версия 2.7.0
- Поддерживает адаптер Tapjoy Android версии 12.8.0.1 .
- Поддерживает адаптер Tapjoy iOS версии 12.8.0.1 .
Версия 2.6.1
- Поддерживает адаптер Tapjoy Android версии 12.7.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.7.1.0 .
Версия 2.6.0
- Поддерживает адаптер Tapjoy Android версии 12.7.0.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.7.0.0 .
Версия 2.5.1
- Поддерживает адаптер Tapjoy Android версии 12.6.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.6.1.0 .
Версия 2.5.0
- Поддерживает адаптер Tapjoy Android версии 12.6.0.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.6.0.0 .
Версия 2.4.2
- Поддерживает адаптер Tapjoy Android версии 12.4.2.1 .
- Поддерживает адаптер Tapjoy iOS версии 12.4.2.1 .
Версия 2.4.1
- Поддерживает адаптер Tapjoy Android версии 12.4.2.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.4.2.0 .
Версия 2.4.0
- Поддерживает адаптер Tapjoy Android версии 12.4.1.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.4.1.0 .
Версия 2.3.1
- Поддерживает адаптер Tapjoy Android версии 12.3.3.0 .
- Поддерживает адаптер Tapjoy iOS версии 12.3.3.0 .
Версия 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.