Meta Audience Network Integration with Unity LevelPlay

https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network
Admin
This document provides instructions on how to integrate Meta Audience Network (formerly Facebook...
Tokens:2,137
Snippets:36
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Add Meta Audience Network Adapter and SDK via Gradle (Manual Download)

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

When manually downloading the adapter and SDK, add these specific versions to your app's build.gradle file. This example uses adapter version 4.3.50 and SDK version 6.20.0.

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:facebook-adapter:4.3.50'
    implementation 'com.facebook.android:audience-network-sdk:6.20.0'
}
```

--------------------------------

### Add Meta Audience Network Adapter and SDK via Gradle

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Include the Meta Audience Network adapter and its SDK as dependencies in your app's build.gradle file. This example uses adapter version 5.1.0 and SDK version 6.21.0.

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:facebook-adapter:5.1.0'
    implementation 'com.facebook.android:audience-network-sdk:6.21.0'
}
```

--------------------------------

### Configure Meta Mixed Audience Flag

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Set the Meta Mixed Audience flag to 'true' when targeting a mixed audience. This should be done before initializing LevelPlay Mediation, starting from Meta Adapter version 4.3.35+.

```java
LevelPlay.setMetaData("META_Mixed_Audience","true");
```

--------------------------------

### Configure Maven Repository for Meta Audience Network

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Ensure your app's build.gradle script includes the mavenCentral() repository to fetch dependencies.

```groovy
repositories {
    mavenCentral()
}
```

--------------------------------

### Add Manifest Permissions for Meta SDK

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Include these permissions in your AndroidManifest.xml to allow internet access and network state monitoring for the Meta SDK.

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

--------------------------------

### Proguard Configuration for Meta Audience Network

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

If you are using ProGuard, add these rules to your ProGuard file to prevent issues with the Meta Audience Network adapter.

```text
-dontwarn com.facebook.ads.internal.**
-keeppackagenames com.facebook.*
-keep public class com.facebook.ads.** {*;} 
-keep public class com.facebook.ads.**
{ public protected *; }
```

--------------------------------

### Configure Meta CacheFlag for Interstitial Ads

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Set the Meta CacheFlag for interstitial ads before initializing LevelPlay. Supported values include ICON, IMAGE, NONE, VIDEO, or ALL.

```java
LevelPlay.setMetaData("Meta_IS_CacheFlag","IMAGE");
```

--------------------------------

### Configure Network Security for Clear Text Traffic

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Define network security settings to permit clear text traffic to localhost, which is necessary for the Meta SDK on Android P and later. This configuration should be placed in a network_security_config.xml file.

```xml
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    ...
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
    ...
```

--------------------------------

### Apply Network Security Config in Manifest

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Reference the network security configuration file in your application's manifest by adding the android:networkSecurityConfig attribute to the <application> tag.

```xml
<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application android:networkSecurityConfig="@xml/network_security_config"
                    ... >
```

--------------------------------

### Add Audience Network Activity to Manifest

Source: https://docs.unity.com/en-us/grow/levelplay/sdk/android/networks/guides/meta-audience-network

Declare the AudienceNetworkActivity within the <application> tag of your AndroidManifest.xml. This activity is required for the Meta SDK to function correctly.

```xml
<activity
    android:name="com.facebook.ads.AudienceNetworkActivity"
    android:hardwareAccelerated="true"
    android:configChanges="keyboardHidden|orientation|screenSize" />
```
Tokens:
Raw