Перейти к основному содержимому

Интеграция Appodeal SDK (Full)

Appodeal SDK — это полная интеграция (в старых руководствах и письмах — «Full SDK»): все рекламные сети по умолчанию — в Unity это пресет Default — плюс адаптеры AppsFlyer и Meta Analytics, ваши форматы рекламы, менеджер согласий и политика конфиденциальности. Это тот билд, который используется, когда Appodeal монетизирует игру собственной медиацией. У шага шесть вех — Mediation, SDK, Ad Types, Ad Networks, GDPR/CMP, Add. req. — и разделы этой страницы повторяют его нумерованные блоки. Не уверены, что это ваш режим? См. Light SDK или Appodeal SDK.

Прежде чем начать​

Вам понадобится:

  • Завершённый шаг 1. Select Your App.
  • Ключ вашего приложения — Application Key.
  • Ответ на вопрос, есть ли у вас аккаунт AdMob. От него зависят два шага на этой странице — AdMob: подключить или убрать.
  • Со стороны Meta и AppsFlyer пока ничего не нужно — эти значения вводятся в UA Setup.

1. Mediation​

В блоке 1. Mediation нажмите Appodeal SDK; прогресс-бар переключается на шесть вех.

2. Import SDK​

Пройдите руководство Get Started для вашей платформы от начала до конца; здесь только то, что специфично для Accelerator.

  1. Сформируйте блок зависимостей на странице Configure Mediated Networks, выбрав все рекламные сети и, в разделе Services, AppsFlyer и Meta Analytics. Вставьте его в app/build.gradle.kts.
  2. Оставьте com.appodeal.ads.sdk.adapters:appsflyer и com.appodeal.ads.sdk.adapters:facebook_analytics — через них наша BI читает данные кампании.
  3. Инициализируйте SDK с теми форматами рекламы, которые вы реализуете (Шаг 3. Инициализация SDK).
  4. Примените правило AdMob.

Выберите SDK implemented.

AdMob: подключить или убрать​

AdMob не обязателен для Accelerator Test. Визард называет его галочки AdMob App ID added (optional) и AdMob has been successfully synced (optional), и ни одна из них не блокирует Complete Monetization Setup. Не создавайте аккаунт AdMob ради теста. Выберите подходящую вам ветку и выполните её целиком.

Если у вас есть аккаунт AdMob:

  1. Подключите его — AdMob.
  2. Синхронизируйте его кнопкой Download AdMob Sync Extension в блоке 4.2 — это расширение для Chrome, AdMob Sync.
  3. Пропишите свои AdMob App ID в проекте: Android — Configure Admob Meta-data; iOS — GADApplicationIdentifier (Other Feature Usage Descriptions); Unity — Appodeal → Appodeal Settings (AdMob Configuration).
  4. Добавьте app-ads.txt (App-ads.txt). Какие строки публиковать — полный экспорт Appodeal или вашу собственную строку AdMob — мы подтверждаем по каждому приложению (Помощь).
  5. Выберите AdMob App ID added (optional) в блоке 2 и AdMob has been successfully synced (optional) в блоке 4.2. Вторая галочка переключает блок 5 на сценарий с Google CMP.

Если аккаунта AdMob у вас нет:

  1. Уберите Google AdMob и Google Ad Manager из зависимостей — Unity: снимите обе галочки в Appodeal DM и нажмите Generate заново; Android и iOS: сформируйте блок зависимостей или Podfile заново со снятыми обеими галочками.
  2. Уберите AdMob App ID. Визард сообщает: "If you are not using Admob in your app - remove AdMob references from configuration files (AndroidManifest.xml, Info.plist)." В Unity очистите поля AdMob App ID в Appodeal → Appodeal Settings.
  3. Оставьте обе галочки AdMob невыбранными. (Адаптер AdMob в билде без App ID приводит к падению при запуске: GADInvalidInitializationException.)

3. Ad Types Implementation​

Визард сообщает: "Implement: Banner, Interstitial, Rewarded (as many ad types as your app affords)." Interstitial не обязателен для Accelerator Test — баннера и rewarded достаточно. Какие форматы должны показывать импрешены и можно ли закрыть формат за онбордингом, мы подтверждаем по каждому приложению (Помощь).

Выберите формат в списке Ad Type, чтобы прочитать встроенный сниппет; руководства по платформам — Android, iOS и Unity. Выберите Ad Formats implemented.

Лучшие практики создания рекламных плейсментов​

Ссылка "best practices guide" из визарда ведёт сюда. Само руководство — Best Practices For Creating Ad Placements.

4. Adding Ad Networks​

4.1. Ad Networks Setup — "Appodeal automatically connects all available ad networks for your application." Собственные аккаунты в сетях: Настройка сетей.

4.2. Admob and Meta setup — если у вас есть аккаунты AdMob или Meta Audience Network, подключите их (ветка AdMob, Meta Audience Network). Оставьте выбранной галочку Autoconnection (recommended for optimal monetization setup); она обязательна для завершения шага. Галочку Confirm Meta Audience Network has been connected (optional) выбирайте, только если действительно подключили, и выберите All desired ad networks have been connected — она обязательна.

5. GDPR / CMP Setup​

Если выбрана галочка AdMob has been successfully synced (optional), блок просит внедрить Google CMP — платформу согласий, сертифицированную Google (Google CMP и TCF v2). Без AdMob используйте наш менеджер согласий (Android, iOS, Unity) и уберите упоминания AdMob, как описано в ветке AdMob. Выберите CMP integrated.

6. Additional Requirements​

6.1. Add A Privacy Policy To Your Mobile App — политика конфиденциальности, которая раскрывает сбор IP-адреса и рекламного идентификатора и ссылается на нашу, в карточке приложения в сторе и в самом приложении (Android, iOS). Выберите Privacy policy updated — эта галочка обязательна.

6.2. Add App-ads.txt File — дополнительно: это часть ветки AdMob, и если пропустить этот пункт, кнопка Complete Monetization Setup всё равно сработает. Выберите Confirm app-ads.txt added (optional), если вы это сделали.

Complete Monetization Setup​

Кнопка активна, когда выбраны SDK implemented, Ad Formats implemented, All desired ad networks have been connected, CMP integrated и Privacy policy updated, а Autoconnection включена. Четыре галочки с пометкой (optional) не обязательны. Нажмите её. Билд проверяется на шаге 3 — 3. Подготовка приложения к тестированию, где наш инженер также проверяет, что показываются менеджер согласий и форматы рекламы.

Если что-то не так​

Что вы видитеПочемуЧто делать
Кнопка Complete Monetization Setup неактивнаНе выбрана одна из пяти обязательных галочек или выключена AutoconnectionСверьтесь со списком в разделе Complete Monetization Setup
Приложение падает при запуске с GADInvalidInitializationExceptionВ билде есть адаптер AdMob, но нет App IDДоведите до конца одну ветку AdMob: либо App ID на месте, либо обе сети Google убраны
Блок 5 требует Google CMP, хотя вы не используете AdMobВыбрана галочка AdMob has been successfully synced (optional)Снимите её; блок 5 переключится на текст без AdMob

Дальше вы вводите свои значения Meta, нажимаете Request UA и MMP Setup (или передаёте нам своё приложение в AppsFlyer) и отправляете билд на ревью.

Далее: 3. UA Setup

Помощь​

Напишите на [email protected] и [email protected] или [email protected]. Укажите bundle ID, платформу (Android, iOS, Unity, Flutter или React Native), какой режим вы выбрали — Light SDK или Appodeal SDK — и что именно блокирует: блок визарда и скриншот либо точный текст ошибки или строки лога.