Завершите UA Setup
Шаг 3. UA Setup состоит из трёх блоков, которые совпадают с его прогресс-баром: Meta integration, AppsFlyer setup, Prepare the app for testing. Вы вводите значения своего приложения на Meta и авторизуете наш рекламный аккаунт; Appodeal создаёт Meta ad account ID и приложение в AppsFlyer; затем Check SDK за несколько минут проверяет ваш билд.
Прежде чем начать
- Шаг Complete Monetization Setup завершён — иначе кнопка Check SDK неактивна: "Please complete previous steps."
- У вас есть доступ к вашему приложению на Meta for Developers.
- Приложения на Meta ещё нет? Мы можем создать его за вас — напишите нам, указав bundle ID (Помощь).
1. Meta Integration
Какие значения нужны
| Значение | Где находится |
|---|---|
| App ID | Meta for Developers, App settings → Basic |
| Client Token | App settings → Advanced → Client Token |
| Install Referrer Decryption Key — только для Android-приложений, 64 символа | App settings → Basic → Android → Google Play Store |
App ID и Decryption Key вводятся в поля дашборда в этом блоке. App ID и Client Token добавляются в билд (Добавьте App ID и Client Token в билд). Decryption Key в билд не добавляется никогда.
Введите значения и запросите UA
-
В блоке 1.2. Provide input введите Facebook App ID и, для Android-приложения, Decryption Key. Кнопки MMP Setup и Request UA становятся активными, как только введён App ID и, на Android, ключ из 64 символов.
-
Нажмите Request UA. Дашборд покажет "Ad Account is now creating for you, please wait a bit so you can copy the ID". Когда поле Ad Account ID заполнится, скопируйте значение иконкой копирования.
-
В своём приложении на Meta откройте App settings → Advanced → Advertising accounts → Authorized ad account IDs — в тексте блока 1.3 визарда он назван "Advertising ad accounts IDs" — вставьте ID и нажмите Save Changes.
-
Убедитесь, что приложение на Meta опубликовано — в левом сайдбаре отображается Published.
-
Выберите Meta integrated.
Добавьте App ID и Client Token в билд
Meta SDK (facebook-core) уже входит в состав Appodeal SDK; устанавливать ничего не нужно.
- Android
- iOS
- Unity
- Flutter
- React Native
Добавьте записи meta-data com.facebook.sdk.ApplicationId и com.facebook.sdk.ClientToken в AndroidManifest.xml, как показано в Configure Meta App.
Добавьте FacebookAppID, FacebookClientToken, FacebookDisplayName и запись fbAPP-ID в CFBundleURLSchemes в Info.plist. Все четыре значения обязательны, даже если вы не показываете рекламу Meta. Подробнее: Configure Meta App.
Откройте Appodeal → Appodeal Settings → Meta Settings, выберите Enable auto configuration, затем введите Meta App ID (Android) / Meta App ID (iOS) и Meta Client Token (Android) / Meta Client Token (iOS) для тех платформ, под которые вы собираете билд. Оставьте включёнными Enable FacebookAutoLogAppEvents и Enable FacebookAdvertiserIDCollection. На странице, встроенной в визард, эта панель по-прежнему называется "Facebook Settings".
Примените вкладки Android и iOS к проектам android/ и ios/.
Примените вкладки Android и iOS к проектам android/ и ios/.
В приложении уже есть собственный Meta (Facebook) SDK
- Авторизуйте Ad Account ID из Request UA в своём приложении на Meta, как в шаге 3.
- Оставьте поля Meta в Appodeal Settings → Meta Settings пустыми.
- Удалите адаптер Meta Analytics из зависимостей Appodeal SDK — в Unity снимите его в Appodeal DM и нажмите Generate.
- Отправьте нам App ID, Client Token и, для Android, Install Referrer Decryption Key (Помощь).
- Убедитесь, что приложение на Meta опубликовано.
Совместимость мы подтверждаем по каждому приложению.
2. AppsFlyer setup
Мы используем AppsFlyer. Адаптер AppsFlyer входит в состав Appodeal SDK, а атрибуция для теста работает на собственном аккаунте AppsFlyer компании Appodeal. Вам не нужно создавать аккаунт AppsFlyer, вводить Dev Key или подключать аккаунт где-либо в дашборде. Ссылка "connect AppsFlyer" во встроенном гайде Meta в блоке 1.1 предназначена для паблишеров, которые подключают собственный аккаунт AppsFlyer, — игнорируйте её.
Сделайте ровно одно из перечисленного:
| Ваша ситуация | Что делать |
|---|---|
| Приложения в AppsFlyer у вас нет | Нажмите MMP Setup — кнопка активна, когда в блоке 1 указан App ID и, на Android, ключ из 64 символов. Мы создаём приложение в AppsFlyer, и статус меняется на Setup is done. Выберите AppsFlyer setup. |
| Приложение уже есть в AppsFlyer | Передайте его нам: AppsFlyer → My Apps → действия в строке ⋮ → Start transfer → e-mail владельца принимающего аккаунта p@appodeal.com (кнопка AppsFlyer Help открывает инструкции самого AppsFlyer по этому диалогу). Затем выберите AppsFlyer setup. Если на кнопке Complete UA Setup всё ещё показывается подсказка "Complete MMP Setup", нажмите ещё и MMP Setup — шаг завершается только после того, как настройка MMP выполнена на нашей стороне. После теста мы передаём приложение обратно вам; что будет с историческими данными, мы подтверждаем по каждому приложению (Помощь). |
| Вы используете Singular или другой MMP | Оставьте его: «Оставляйте Singular — это нормально, и он уже интегрирован. Но адаптер AppsFlyer всё равно нужен для нашей BI. Конфликта между ними нет». Ни адаптер, ни pod для Singular не нужны. Затем нажмите MMP Setup, как в первой строке. |
Нужен ли Appodeal SDK, если у вас уже есть MMP? Да. «SDK вместе с адаптером AppsFlyer обязателен — пересылать события в ваш собственный AppsFlyer недостаточно, потому что нам нужны наши адаптеры, чтобы отслеживать установки и метрики кампании на Facebook».
В приложении уже есть собственный AppsFlyer SDK (Unity)
- Оставьте его. Установите его через UPM из
https://github.com/AppsFlyerSDK/appsflyer-unity-plugin.git#upm; при ошибках сборки подберите ту версию AppsFlyer, которую использует адаптер Appodeal, 6.17.1 или выше, через#Strict-v*.*.*— либо через#v*.*.*, если вариант со#Strict-даёт ошибку. - Установите наш плагин GDPR и CCPA (GDPR & CCPA).
- Инициализируйте AppsFlyer до Appodeal SDK:
AppsFlyer.initSDKвAwake→ флоу согласия Appodeal →AppsFlyer.setConsentData→AppsFlyer.startSDK()→Appodeal.Initialize. - Отправьте нам скриншот этого кода (Помощь).
Совместимость мы подтверждаем по каждому приложению.
3. Prepare the app for testing
Логи, APK и билд TestFlight загружать не нужно: Check SDK читает то, что Appodeal SDK из вашего билда отправляет на наши серверы.
-
Выполните гайд 3.1 визарда, Prepare the App for Testing. В билде должен быть Appodeal SDK с адаптерами AppsFlyer и Meta Analytics (Import SDK) и значения Meta из шага 1.
-
Установите билд на телефон, откройте игру с включённым интернетом и подождите 5 минут.
-
В блоке 3.2. Check your build нажмите Check SDK. Каждая строка — отдельная проверка:
Что вы видите Что делать ✅ Appodeal SDK started in your app · AppsFlyer is in your build · Meta is in your build Ничего ❌ Appodeal SDK hasn't started in your app in the last 7 days Установите билд с app key этого приложения в Appodeal, откройте игру с интернетом, подождите 5 минут и нажмите Check again ❌ The AppsFlyer adapter isn't in your build Добавьте адаптер AppsFlyer (в Unity — пресет Default), пересоберите билд и проверьте снова — Import SDK ❌ The Meta Analytics adapter isn't in your build Добавьте адаптер Meta Analytics, пересоберите билд и проверьте снова. В игре свой Meta SDK (шаг 1)? Напишите нам — одобрим вручную ❌ Meta App ID in your build is …, UA Setup has … Укажите Meta App ID из UA Setup в настройках Meta, пересоберите билд и проверьте снова — App ID и Client Token в билде "We couldn't check your build right now. Our team will check it by hand and open the next step for you." Ничего: мы получаем уведомление и сами открываем шаг -
Когда все проверки пройдены, в блоке написано "Your SDK is checked. Press Complete UA Setup to continue." Нажмите Complete UA Setup.
Проверка не проходит после нескольких попыток? Мы получаем уведомление и проверяем билд вручную — можете и сами написать нам.
Если кнопка неактивна
| Что вы видите | Почему | Что делать |
|---|---|---|
| MMP Setup и Request UA неактивны | Поле Facebook App ID пустое или, для Android-приложения, Decryption Key содержит не ровно 64 символа. По отдельным приложениям мы эти кнопки не включаем | Заполните 1.2. Provide input; в ключе 64 символа |
| Check SDK неактивна | "Please complete previous steps." — не завершены Monetization Setup, значения Meta (App ID, Ad Account ID, а на Android — Decryption Key) или MMP Setup | Завершите блоки 1 и 2 |
| Complete UA Setup неактивна | "Check your SDK first" · "Complete MMP Setup" | Нажимайте Check SDK, пока все проверки не пройдут, или нажмите MMP Setup |
| Встроенный гайд Meta в блоке 1.1 говорит "follow this guide for AppsFlyer" | Это примечание для паблишеров, которые подключают собственный аккаунт AppsFlyer | Игнорируйте его; используйте MMP Setup или передачу приложения |
Дальше вы загружаете минимум одно вертикальное видео и запускаете кампанию.
Далее: 4. Creatives
Помощь
Напишите на support@appodeal.com и eduard.malkhasyan@appodeal.com или aleksandr.kolesnikov@appodeal.com. Укажите bundle ID, платформу (Android, iOS, Unity, Flutter или React Native) и что именно блокирует: блок визарда и скриншот либо точный текст ошибки или строки лога.