Facebook

This Guideline will instruct you step-by-step on how to set Facebook Audience Network as an Ad Network on the AdTiming Mediation platform.

Before You Start

Make sure you have correctly integrated AdTiming's Native, Interstitial, Rewarded Video or Banner Ads

in your application.

Important! The ADAPTERS for ad networks are modularized, which means that you need to download Not Only the SDK of mediation networks  you choose to work with But Also the adapters for those ad networks. Be sure to follow this Guide to mediation Facebook's Ads.

 

Step 1. Create a Facebook Account

  • First Time Setup

    • Go to Facebook for Developers▶ and register with your Facebook account.

    • Follow the procedure and set your application name.

    • Click 'Register'.mceclip0.png

  • Registered Users

    • Sign into your Facebook account.

    • Click on Your app on the right sidebar mceclip1.png

Step 2. Create Business

A Business is the top entity through which you can manage your business on Facebook including Facebook advertising and Audience Network monetization. To create your business go to Monetization Manager▶

mceclip2.png

Step 3. Create Property

A Property in Monetization Manager is a group of products with the same brand. If you have different products for different operating systems, platforms or devices, you can group them into a Property for combined reporting and management in Monetization Manager. For example, if you have iOS and Android versions of the same app, you should put them into a single property. Read Facebook guidance on properties for more information.

  1. Go to Monetization Manager▶

  2. Choose your business

  3. Click Create Property +

mceclip3.png

  1. Name your Property based on the brand for the group of apps or websites you’ll be adding to it

  2. Click Create Property 

  mceclip4.png

Step 4. Add Your Platform

Add your Play Store or App Store link if your app is live. If your app isn't live you can skip this step and add it later.

mceclip5.png
  1. To create your first placement and placement ID, choose a display format and add a description of how the ad will be triggered. An Ad Space will be created automatically for you in the format First [platform] Ad Space. Read Facebook guidance on Ad Spaces▶ for more information.

mceclip6.png

  1. Follow the instructions provided for each display format to integrate the SDK. Find technical guidance for the Audience Network SDK▶ on the Facebook for Developers website.

Step 5. Create Ad Space

Ad Spaces help you organize ad placements in a way that accurately reflects what a person is doing when they see an ad in your app. To create an ad placement, you’ll need to create an Ad Space first. You can create up to 4 Ad Spaces per platform.

  1. Go to Monetization Manager▶.

  2. Search for your Property in the search bar using your property name or property ID, then click on Manage Property next to the Property you want to create an Ad Space for.

  3. Select the Platform for where you want to create an Ad Space. If the Platform you want to use does not exist, click on Add Platforms (located on the upper right hand corner) to create it.

  4. Add a video and description of when your ad would be triggered. Click Create Ad Space.

mceclip7.png

  1. Now that you’ve created your Ad Space, you can create ad placements by clicking on the edit icon and Create placement.

Step 6. Create a Placement

After create an Ad Space, you can use an existing Ad Space to create a new placement. Facebook Audience Network offers different types of ad units. Each ad unit in your app or mobile website is identified using a unique placement ID.

1. Go to Monetization Manager▶.

2. Find and select the Property for which you want to create an ad placement. Click Manage Property on the right.

3. Scroll down to the Placements section and click Create placement.

mceclip8.png

  • you can also create ad placements by clicking on the edit >Create placement. 

mceclip9.png

4. Type in your placement name, select the Ad Space, select the ad Display format and add an optional description.

mceclip10.png

5. Choose how you want to optimize your ad placement. The optimization determines how we run the auction for each impression on your app or site:

  • Accept any price: We'll try to balance fill rate and price, getting you the most money overall for your inventory. We recommend this for most Audience Network integration if you aren't working with other ad sources to fill your inventory. Previously optimize for fill.
  • Set a CPM target at the price you want: Set the price you want to get on average for a placement. A range of prices, higher and lower than the target CPM will be delivered to give you the price you set on average within 2 days. Recommended for finely tuning your CPMs if you use a mediation product. Learn more about upgrading to Monetization Manager or setting CPM targets▶.

6. Click Create placement to finish.

Please Note: An ad placement can only be used by one Ad Space and needs to match the same platform as the Ad Space.

 

Add Placements to Your App

  • Go to Monetization Manager▶.

  • Click on Managed property.

  • Click on Ad Spaces then scroll down to Placements, or filter to find the placement that you need.

    In the Placement ID column click Get Code or Copy ID.

mceclip11.png

  • You can also select multiple placements by ticking the box next to the placement name, then hover your mouse over the Get Code button at the bottom of the page to download a CSV file containing placement IDs, names and locations. With the placements selected, you can also Archive or Move them.

mceclip12.png

Please Note: Your app won’t be able to receive Audience Network ads until payout information has been added and it was sent for review.

 

Step 7. Retrieve Facebook Parameters

The following parameters from the Facebook Audience Network account need to be inserted into your AdTiming Network Setup Module.

 

1. App ID

  • This is the unique identifier of your app in Facebook Audience Network’s system. Hover over '≡' in the upper-left corner, and click on 'App Dashboard'.

mceclip3.png

  • Choose the application of which you want to see the App ID. this will navigate you to your Facebook Audience Network dashboard. there you should see the specific App ID located on the center of the upper bar.

mceclip4.png

 

2. System User Access Token

The user token is the most commonly used type of token. This kind of access token is needed any time the app calls an API to read, modify or write a specific person’s Facebook data on their behalf.

Please read System User Token Generation▶ to retrieve your System User Access Token.

Important! Please make sure you to check read_insights as well as read_audience_network_insights in Available Scopes on Step 3: Set System User as App Developer.

facebook_1.png

 

3. Placement ID

This is the unique identifier of a specific placement in your app in Facebook Audience Network’s system.

  • Click on 'Audience Network' on the left sidebar in the dashboard and you should be asked to navigate to 'Monetization Manager'.

facebook_2.png

  • Select your application review and retrieve PlacementID according to the steps in Add Placements to Your App as mentioned above.

facebook_3.png

 

Once you obtain the information, you must configure Facebook Audience Network’s Parameters in your AdTiming Account. By adding the above information correctly, you will be able to take full advantage of Facebook’s Rewarded Video, Interstitial or Native ad inventory and reporting data on AdTiming's Mediation platform.

Step 8. Configure Facebook’s Parameters into AdTiming Account

  • Once you have both of these parameters, log into your AdTiming account and go to Placement -> Instances-> Add Instance

 

  • Select Facebook from the list of Available Ad Network. Fill in the Facebook 'APP ID' and the 'System User Access Token' .
    ___39.jpg
  • Click on 'Save'
    ___40.jpg

 

Step 9. Add the Facebook SDK&Adapter to Your Build

Android

1. Add the Facebook SDK

  •   Add to your application-level build.gradle file.
 dependencies {
   ...
    implementation 'com.facebook.android:audience-network-sdk:5.9.1'
    // for using bid
    implementation(name: 'BiddingKit', ext: 'aar')
 }

2. Add the Facebook Adapter

     AdTiming supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your project-level build.gradle file.
...
 allprojects {
   repositories {
        ...

        jcenter()
        maven {
            url "https://dl.adtiming.com/android-sdk"
        }
   }
 }
  • Add the following in your application-level build.gradle file.
implementation 'com.adtiming.adapters:facebook:3.6.0@aar'

       Manual download

  • Download the Facebook Adapter from here.
  • Add the Facebook Adapter to Your Project
    Add the FacebookAdapter-x.x.x.aar to the libs folder in your Android Project.

mceclip0.png

  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'FacebookAdapter-x.x.x', ext:'aar'

 3. For Proguard Users Only

If you are using ProGuard with the Facebook adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

-keep class com.facebook.ads.** { *; }

 

Done!
You are now all set to deliver Facebook Audience Network Ads through the AdTiming Mediation platform!

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.