Skip to main content

Complete UA Setup

Step 3. UA Setup has three blocks that match its progress bar: Meta integration, AppsFlyer setup, Prepare the app for testing. You enter your Meta app values and authorize our ad account; Appodeal creates the Meta ad account ID and your AppsFlyer app; then Check SDK checks your build in a few minutes.

Before you start​

  • Complete Monetization Setup is done — otherwise Check SDK stays grey: "Please complete previous steps."
  • You have access to your app on Meta for Developers.
  • No Meta app yet? We can create one for you — write to us with your bundle ID (Get help).

1. Meta Integration​

Values you need​

ValueWhere it lives
App IDMeta for Developers, App settings → Basic
Client TokenApp settings → Advanced → Client Token
Install Referrer Decryption Key — Android apps only, 64 charactersApp settings → Basic → Android → Google Play Store

App ID and Decryption Key go into the dashboard fields in this block. App ID and Client Token go into your build (Put the App ID and Client Token in your build). The Decryption Key never goes into the build.

Enter the values and request UA​

  1. In 1.2. Provide input enter Facebook App ID and, for an Android app, Decryption Key. MMP Setup and Request UA become active once the App ID and, on Android, a 64-character key are entered.

  2. Click Request UA. The dashboard shows "Ad Account is now creating for you, please wait a bit so you can copy the ID". When Ad Account ID fills, copy it with the copy icon.

  3. In your Meta app open App settings → Advanced → Advertising accounts → Authorized ad account IDs — the wizard's 1.3 text calls it "Advertising ad accounts IDs" — paste the ID and click Save Changes.

  4. Make sure the Meta app is published — the left sidebar shows Published.

  5. Select Meta integrated.

Put the App ID and Client Token in your build​

The Meta SDK (facebook-core) is already inside the Appodeal SDK; there is nothing to install.

Add the com.facebook.sdk.ApplicationId and com.facebook.sdk.ClientToken meta-data entries to AndroidManifest.xml as shown in Configure Meta App.

Your app already ships its own Meta (Facebook) SDK
  1. Authorize the Ad Account ID from Request UA in your Meta app, as in step 3.
  2. Leave the Meta fields in Appodeal Settings → Meta Settings empty.
  3. Remove the Meta Analytics adapter from the Appodeal SDK dependencies — on Unity, clear it in Appodeal DM and click Generate.
  4. Send us the App ID, Client Token and, on Android, the Install Referrer Decryption Key (Get help).
  5. Make sure the Meta app is published.

We confirm coexistence per app.

2. AppsFlyer setup​

We use AppsFlyer. The AppsFlyer adapter ships inside the Appodeal SDK, and attribution for the test runs on Appodeal's own AppsFlyer account. You do not create an AppsFlyer account, enter a Dev Key or link an account anywhere in the dashboard. The "connect AppsFlyer" link inside the embedded Meta guide in block 1.1 is for publishers who link their own AppsFlyer account — ignore it.

Do exactly one of these:

Your situationDo this
You have no AppsFlyer appClick MMP Setup — active once block 1 has the App ID and, on Android, the 64-character key. We create the AppsFlyer app and the status turns Setup is done. Select AppsFlyer setup.
Your app already exists in AppsFlyerTransfer it to us: AppsFlyer → My Apps → row actions ⋮ → Start transfer → receiving account owner e-mail [email protected] (the AppsFlyer Help button opens AppsFlyer's own instructions for the dialog). Then select AppsFlyer setup. If Complete UA Setup still says "Complete MMP Setup", click MMP Setup as well — the step completes only once the MMP setup is done on our side. We transfer it back to you when the test is over; what happens to your historical data is confirmed per app (Get help).
You use Singular or another MMPKeep it: "Keep Singular — it's fine and already integrated. But the AppsFlyer adapter is still required for our BI. There's no conflict between the two." No Singular adapter or pod is needed. Then click MMP Setup as in the first row.

Do you still need the Appodeal SDK if you already have an MMP? Yes. "The SDK plus the AppsFlyer adapter is required — forwarding events to your own AppsFlyer instead isn't sufficient, because we need our adapters to track installs and metrics from the Facebook campaign."

Your app already ships its own AppsFlyer SDK (Unity)
  1. Keep it. Install it with UPM from https://github.com/AppsFlyerSDK/appsflyer-unity-plugin.git#upm; on build errors, match the AppsFlyer version the Appodeal adapter uses, 6.17.1 or higher, with #Strict-v*.*.* — or #v*.*.* if that errors.
  2. Install our GDPR and CCPA plugin (GDPR & CCPA).
  3. Initialize AppsFlyer before the Appodeal SDK: AppsFlyer.initSDK in Awake → the Appodeal consent flow → AppsFlyer.setConsentData → AppsFlyer.startSDK() → Appodeal.Initialize.
  4. Send us a screenshot of that code (Get help).

We confirm coexistence per app.

3. Prepare the app for testing​

You don't upload logs, an APK or a TestFlight build: Check SDK reads what the Appodeal SDK in your build sends to our servers.

  1. Complete the wizard's 3.1 guide, Prepare the App for Testing. Your build needs the Appodeal SDK with the AppsFlyer and Meta Analytics adapters (Import SDK) and the Meta values from step 1.

  2. Install the build on a phone, open the game with the internet on and wait 5 minutes.

  3. In 3.2. Check your build click Check SDK. Each row shows a check:

    You seeDo this
    ✅ Appodeal SDK started in your app · AppsFlyer is in your build · Meta is in your buildNothing
    ❌ Appodeal SDK hasn't started in your app in the last 7 daysInstall the build with this app's Appodeal app key, open the game with the internet on, wait 5 minutes and click Check again
    ❌ The AppsFlyer adapter isn't in your buildAdd the AppsFlyer adapter (Unity: the Default preset), rebuild and check again — Import SDK
    ❌ The Meta Analytics adapter isn't in your buildAdd the Meta Analytics adapter, rebuild and check again. Your app ships its own Meta SDK (step 1)? Contact us and we approve it by hand
    ❌ Meta App ID in your build is …, UA Setup has …Put the UA Setup Meta App ID in your Meta settings, rebuild and check again — Put the App ID and Client Token in your build
    "We couldn't check your build right now. Our team will check it by hand and open the next step for you."Nothing: we get notified and open the step for you

  4. When every check passes, the block says "Your SDK is checked. Press Complete UA Setup to continue." Click Complete UA Setup.

The check still fails after a few tries? We get notified and check your build by hand — you can also write to us.

If a button is grey​

You seeWhyDo this
MMP Setup and Request UA are disabledFacebook App ID is empty, or, for an Android app, Decryption Key is not exactly 64 characters. We do not enable them per appFill in 1.2. Provide input; the key is 64 characters
Check SDK is disabled"Please complete previous steps." — Monetization Setup, the Meta values (App ID, Ad Account ID, and on Android the Decryption Key) or MMP Setup is not doneFinish blocks 1 and 2
Complete UA Setup is disabled"Check your SDK first" · "Complete MMP Setup"Click Check SDK until every check passes, or click MMP Setup
The embedded Meta guide in 1.1 says "follow this guide for AppsFlyer"That note is for publishers who link their own AppsFlyer accountIgnore it; use MMP Setup or the transfer

Next you upload at least one vertical video and launch the campaign.

Next: 4. Creatives

Get help​

Write to [email protected] and [email protected] or [email protected]. Include your bundle ID, the platform (Android, iOS, Unity, Flutter or React Native) and what is blocking you: the wizard block and a screenshot, or the exact error or log text.