To link your Facebook account, you should complete all the steps from this article.

Before you start

  • Make sure you have a personal Facebook account.
  • You should be able to provide full details for the payout account that Facebook will pay to.

Step 1: Set up a Facebook developer account

Note: If you already have a Facebook developer account, skip this step.

Go to https://developers.facebook.com and press "Log in"

Fill in your personal information and create a Facebook account. After this, you can log in and continue linking your Facebook account to Appodeal.

Step 2: Create a new Facebook app

Go to "My Apps" -> "Create App" and fill display name and contact email for creating an App ID.

Once the Facebook app is created in the main menu, you will need to connect it (if not previously connected) via the Facebook Audience Network. Press Set Up on Audience Network section.

After creating the app, the new app will appear in the section on the Apps page (https://developers.facebook.com/apps/). Open it and go to Settings->Basic

You will need the following information from this page:

  • App ID
  • App Secret

Step 3: Configure the Monetization Manager account

Click on Set Up an Audience Network and create a Monetization Manager account. Skip this step if you already have one.

Create a new property on the Monetization manager's side.

Create a new app for the necessary platform in the created Property.

Organize your products with properties.

If your product has multiple versions based on operating systems or devices, you can group these versions together into a property for combined reporting and management.

Each property can contain one iOS app, one Android app, one website domain, one Instant Articles Page, and one Instant Game.

For each property, you can create 4 ad spaces. Ad space is a location for advertising.

You can create 4 placements for each ad space - a specific type of ad. Moreover, out of 4 placements, there are 3 placements with a specific CPM target — you need to specify a cost per 1000 impressions for each of those 3. For the last, fourth placement you need to set a CPM of 0.

Setting up a new property consists of 5 stages:

a) Submit your app information. If your app is already published, specify a link to the store.

b) Create your first placement.

You need to select the desired ad format. The most effective ad formats for Facebook are Interstitial and Rewarded video (for game apps only).

Add a description of when and where your ads will be triggered. It's best to be as detailed as possible, as this information will be used to find and review ad experiences in your app. Even though the video is optional, it is recommended to add it to help the review team approve your app faster. After you're done, click on "Create placement".

c) Confirm Audience Network SDK Integration.

Here you need to mark the "This app is using mediation" setting and click on "Generate Token".

You may also generate an access token via this instruction on the https://business.facebook.com/settings/system-users/ page and save it.

Note: You need to generate a new access token if you are adding your first app to your Facebook account.

If you have already created an app, then the token should already be generated, and you need to add the created Property and Application for it.

To do this, go to Monetization Manager Settings -> Users -> System Users and click Add Assets.

Then you should select all properties and set the Manage Property permission.

Select all apps and set the View Insights permission.

After generating the token, you will need the following data:

  • System user access token
  • Placement ID
    It must have the following format: FacebookAppID_xxxxxxxxxxxxxxx

Note: If the first part of the placement id does not match the app id, then you need to use the first part of the placement id as the app id.

Important! Save this data. You will need it to bind the app on the Appodeal side.

To complete point c), select the "The Audience Network SDK has been integrated into my app" option and click “Confirm Manually”.

d) Enter your business payment account information. You won't be able to receive Audience Network ads until you add payout details. You can add your payout info as soon as your account in Business Manager and Property is set up. Learn more about adding payout information.

e) Publish your updated app to the Play Store (AppStore).

Step 4: In case Facebook Audience Network and property are already created

Generate access token via this instruction on the https://business.facebook.com/settings/system-users/ page and save it.

Note: access token can only be generated once for the entire business manager and it will work for all Appodeal applications. It means that you need to generate a new access token if you are adding your first app to your Facebook account.

If you already have a created app, then the token should already be generated, and you need to add the created Property and Application for it.


To do this, go to Monetization Manager Settings -> Users -> System Users and click Add Assets.

By selecting the desired properties, you can create new ad spaces or placements, or edit existing ones.

Created placements can have the following statuses:

  • Ready to publish - when a placement is created for an unpublished app;
  • Requesting ads - when a placement is created for a published app and is waiting for an ad request (testing);
  • Receiving ads - when the placement works and successfully receives the ad;
  • Archived - when the placement is no longer used and has been deleted (hidden);
  • Idle - when a placement doesn't work or has been blocked.

As a result, you should have the following data:

  • App Id;
  • App Secret;
  • System user access token;
  • Placement Ids.

Step 5: Link Facebook to your Appodeal account

Go to the DCC https://www.appodeal.com/apps/linked_networks page and add a Facebook email address and access token.

Select the appropriate app on the https://www.appodeal.com/apps page, go to the desired ad type, select a Facebook account created in DCC and fill in the Facebook App ID and Facebook App Secret fields.

Next, click the Add Line Item button and fill in the Line Item’s label, default eCPM and Code:

Note: Code must have the following format: FacebookAppID_xxxxxxxxxxxxxxx.

If the first part of the placement ID does not match the app ID, then you need to use the first part of the placement ID as the app ID.

Step 6: Test your Facebook ads

After connecting Facebook to Appodeal, you need to test the ad's performance so that the placements enter the state of Receiving ads.

In order to do this, you need to send requests to Facebook placements. You can use segments and disable all networks except Facebook for a specific version of the app (where Facebook is being tested).

AppVersion is defined by the following parameters for various platforms:

  • For Android: the versionName field in build.gradle of the application module level.
  • For Unity: the Version field in the Build Settings->Player Settings->identification section.
  • For iOS: the version field in the General->Identify section.

Or you may set a high eCPM (for example, 1000 USD) for Facebook ad units in the Mediation Settings in the eCPM Priorities section so that requests are sent primarily to Facebook.

On the Facebook side, you should go to the Integration->Testing section in Monetization Manager and add a test device based on the ad identifier (IDFA).

Next, you should log in to your Facebook developer account (in the Facebook app) and launch your app that the SDK sends Facebook impression requests several times.

After that, the status of placements should change to Receiving ads and you will need to send the app to Facebook for approval. After that, the ad will be available to all your users.

You can see a list of common errors when requesting Facebook ads here.

If you have any additional questions or difficulties during the setup process, you can contact our support team.

Did this answer your question?