Set up an app in your Meta developer account

Before you set up Meta in Adjust, you need to create an app in your Meta developer account. This generates the App ID that you need to connect your app to Adjust.

Before you begin

Here's what you need to know before getting started.

Requirements

PlatformDetails
Android
  • Google Play package name
  • Class name
iOS
  • Bundle ID
  • iPhone Store ID
  • iPad Store ID

Register as a Meta developer

If you've already registered as a Meta developer, skip this step.

  1. Go to Meta for Developers.
  2. Log in to your account.
  3. Select Get Started to register as a Meta developer.

Create an app in Facebook

This section provides instructions on setting up an app in Facebook. If you've already set up an app, skip this section.

  1. Log in to your Meta developer account.
  2. Go to the My Apps section.
  3. Select Create App.
  4. Under What do you want your app to do, choose the use case for your app.
  5. Choose the type of app.
  6. Provide an app name, contact details, and select Create App.
    • Once you create the app, an App ID is assigned. You need this value while setting up Facebook in Adjust.
  7. Go to Settings > Basic, and select Add Platform.
  8. Choose your platform and enter additional platform-specific details:
Android
  1. Choose the Android store, and select Next.
  2. Enter the Package Names and Class Name. Meta uses this information to let users download your app from the Play Store if they don't have it installed.
  3. If you're importing events from Adjust, turn off the toggle for Log in-app events automatically.
  4. Select Save changes.
    • Once you save your changes, the Install Referrer Decryption Key is populated.
iOS
  1. Enter the Bundle ID, and the iPhone and iPad Store IDs. Meta uses this information to let users download your app from the App Store if they don't have it installed.
  2. If you're importing events from Adjust, turn off the toggle for Log in-app events automatically.
  3. Select Save changes.
  1. Go to Publish > Go live, and select Go live to publish your app.
  2. In the left navigation pane, under the Submit for review section, you need to go through the app review and business verification process with Meta.

Log in to your Meta developer account and select My Apps.

1/9

Important values

You need the following values from your app while setting up Meta in Adjust:

  • (Required) App ID - In your Meta developer account, go to your app. Make note of the App ID.
  • (Android only - Recommended) Decryption key - In your Meta developer account, go to Settings > Basic. Under the Android section, make note of the Decryption key. You need this only if you're exporting device-level data through raw data exports. This enriches campaign data for Android users. Ignore this setting for iOS.

App ID

1/2

Associate ad account IDs with your app

In this section, learn how to associate the ad accounts that use to run your campaign with your app. You can associate multiple ad accounts with your app.

  1. In Meta for Developers, select Apps and open your app dashboard.
  2. Go to App Settings > Advanced.
  3. Under the Advertising Accounts section, enter the Authorized Ad Account IDs that are used to run campaigns.

Set up a Meta App Ad campaign

In this section, learn how to promote your app across Facebook, Instagram, and Facebook Audience Network.

  1. In Meta Ads Manager, choose the ad account associated with your app.
  2. Select Create to create a new campaign.
  3. Choose App promotion as the campaign objective.
  4. Choose the appropriate campaign type.
  5. Go to 1 Ad set, and under the App section, enter the app name or exact store URL of the app you want to promote.
  6. Configure the remaining settings in this section. For detailed instructions, follow the steps in Meta's documentation.

Set up app events

In this section, learn how to send event activity to Meta from Adjust.

  1. In Meta Ads Manager, go to Events Manager, and select Partner Integrations.
  2. Search and select Adjust.
  3. Select Connect account.
  4. Select the app that you created.

Your setup in Meta Ads Manager is complete. Now, you need to go to Adjust, and map Adjust events to Meta events.

When your events are triggered, you'll be able to see event details under Data sources in Meta Events Manager.

Disable event logging in Meta

Important:
After you set up event mapping in Adjust, disable event logging in the Facebook SDK. This ensures that events are measured only once.

Instead of defining events in the Facebook SDK, you can define equivalent events on Adjust and link them to Meta. Defining events on Adjust also allows you to link the events to other networks.

To disable Facebook SDK event logging, follow these steps:

  1. Log in to your Meta developer account.
  2. Select your app.
  3. Go to Settings > Basic.
  4. For each of your platforms, ensure that you've turned off the toggle for Log In-App Events Automatically.

Additionally, you need to do the following in your app:

  1. Disable automatic event logging in the Facebook SDK - iOS | Android | Unity
  2. Remove manually logged events in the Facebook SDK - iOS | Android | Unity

(iOS apps only) Paste the Connection URL

You need to copy the Connection URL from the Conversion Hub in Adjust, and paste it in Meta Events Manager. This provides Meta with a link to your conversion value mappings.

  1. In Meta Ads Manager, go to Events Manager, and select Data sources.
  2. Choose the app that you created.
  3. Go to Settings.
  4. Under Configure App Events for SKAdNetwork, select Start Setting Up Events or Edit Events if you have configured it before.
  5. Select Import from Partner App, and select Next.
  6. Paste the Connection URL that you copied from Adjust's Conversion Hub, and select Connect.
  7. Review your imported configurations, and select Confirm.

In Events Manager, select Start Setting Up Events.

1/3

Great! Your app setup in Meta is complete. Now, go ahead and ensure that you complete all steps to set up Meta in Adjust.