Meta Audience Network Mediation Integration Guide for SDK 6.4 and Below

This guide will instruct you step-by-step on how to set Meta Audience Network live as an Ad Network on Unity LevelPlay. The integration process is completed in a few simple steps:

1. Create a Meta Audience Network Account
   1. First Time Setup
   2. Registered Users
2. Add Application in Meta Audience Network
3. Create Ad Placement in Meta Audience Network
4. Activate Meta Audience Network in your ironSource Network Setup Module
5. Add the Meta Audience Network Adapter to your build

Step 1. Create a Meta Audience Network Account

1. First Time Setup
   1. Go to Meta for Developers and register with your Meta account.
   2. Accept the Meta Platform & Privacy Policy.
   3. Click ‘Register‘.
      
2. Registered Users
   1. Sign into your Meta account.
   2. On the left sidebar you will see a section called Developer. Click on ‘Manage Apps’.

Step 2. Add Application in Meta Audience Network

You must add the app you’d like to run Interstitial Mediation on to your Meta Audience Network account. If the app has already been added to your account, you may skip to Step 3.

1. Add the app you’d like to run Interstitial Mediation on to your account. As a new user, you will be redirected to the below screen. As a registered user, simply hover over My Apps in the upper-right corner and click on ‘Add a New App‘.
   
2. Select iOS or Android.
3. Fill in your app’s name (even if it is not currently live in an app store).
4. Click on “Create New Meta App ID“.
5. Choose the category most relevant to your app.
   
6. Click on “Create App ID“.

Step 3. Create Ad Placement in Meta Audience Network

1. To create ad placements for your app in your Meta account, go to the main dashboard and on the left sidebar under Products ➣ Audience Network, click on ‘Placements‘.
   Next, click on ‘Create Ad Placement’.
   
2. The below window will then open and you must fill in the following details:
   1. Status: Enabled
   2. Name: Choose a Name for this placement (for example, App Load iOS)
   3. Steps to Trigger Ad: You can omit this part as this will be handled through your ironSource Dashboard.
   4. Display Format: Interstitial (App Only)
      
3. Click ‘Save‘.

It is mandatory to create two separate placements for iOS and Android. We recommend creating one placement per ad location per application.

Step 4. Activate Meta Audience Network in Your ironSource Network Setup Module

There are 2 pieces of Data from the Meta Audience Network account which need to be inserted into your ironSource Network Setup Module in order for Meta Audience Network to work correctly in connection with ironSource:

Once you obtain this information, you must configure Meta Audience Network’s Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of Meta’s interstitial ad inventory and reporting data on ironSource’s Mediation platform.

1. App ID
   To retrieve your App ID, hover over My Apps in the upper-right corner and click on the specific app of which you want to see the App ID. This will take you to your Meta Audience Network Dashboard. Here you will see the specific App ID:
   
2. Placement ID
   To retrieve your Placement ID, click on ‘Audience Network’ in the left sidebar on your Meta Audience Network Dashboard.
   1. Check the box to accept the Terms of Service and click ‘Get Started‘.
      
   2. Scroll to the bottom of the page and create an Ad Placement.
      
   3. You will then see the below window open.
      Fill in the placement details:
      1. Name
      2. Steps to Trigger Ad (here you should fill in what steps an end user must take to see an ad)
      3. Select Interstitial as Display Format
      4. Ensure Status is Enabled.
      5. Click ‘Save‘.
   4. Scroll down to see your Placement ID at the bottom of the page.
      
3. App Token
   To retrieve your App Token, go to Tools & Support on the top menu.
   1. On the left sidebar, under Tools, click on ‘Access Token Tool‘.
      
   2. You will then be directed to the page with your App Token:
      

Configure Meta Audience Network’s Parameters into ironSource Account

• Once you have all these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.
  
• Select Meta from the list of Available Ad Networks and click on ‘Activate’.
  
  Note: Note: To run Interstitial Mediation with Meta, you must have an active Meta Audience Network Account. When you select Meta as a network, you will see the below pop-up. If you have an active Meta account, simply click activate and Save. If you do not have an active Meta account, you must register at Meta Audience Network and follow this documentation from Step 1.
  
• Select the app on which you’d like to run ironSource‘s Interstitial Mediation with Meta.
  
• Select Meta Audience Network from the Setup list of Ad Networks, click on the Define icon and insert the App ID, Placement ID and App Token in the relevant fields.
  
• Then set status to Active and click ‘Save’. You will then see Meta as Active for Interstitial Mediation on your Mediation Dashboard.
  
• New! Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 5. Add the Meta Audience Network Adapter to Your Build

Unity Plugin (Android Integration):

1. Download the Meta Unity Package:
   Import the SupersonicFacebookAdapter_[version].unitypackage to your Unity project. You can find the latest Meta Unity Package here.
2. Add the Meta files to your Unity project:
   1. To add the adapter, simply double click on the SupersonicFacebookAdapter_[version].unitypackage and add all files to your Unity project.
      
      Note: Note: If you are upgrading from a previous version, please remove Facebook.x.x.x.jar from Assets/Plugins/Android.
3. Update AndroidManifest.xml:
   Manifest permissions:
   

<uses-permission android:name="android.permission.INTERNET"/>

Manifest Activities:
Add the following activities inside the <application> tag on your manifestAdditions:

<activity android:name="com.facebook.ads.InterstitialAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize"/>

Unity Plugin (iOS Integration):

1. Download the Meta Unity Package:
   Import the SupersonicFacebookAdapter_[version].unitypackage to your Unity project. You can find the latest Facebook Unity Package here.
2. Add the Meta files to your Unity project:
   To add the adapter, simply double click on the SupersonicFacebookAdapter_[version].unitypackage and add all files to your Unity project.
   
   Note: Note: If you are upgrading from a previous version, please remove Facebook.x.x.x.framework from Assets/Plugins/iOS.
   Our Unity Plugin adds the necessary frameworks automatically to your Xcode project.

Done!
You are now all set to deliver Meta Audience Network Interstitial Ads through the ironSource Interstitial Mediation platform!