How to Integrate Facebook Audience Network (FAN) Interstitial Ads in Android?

Facebook Audience Network (FAN) Interstitial ads are full-screen ads that cover the interface of an app. To integrate these ads into your Android app, follow the steps below:

1. Setup on Facebook:

Make sure you've registered your app with the Facebook Developers portal and added "Audience Network" to your app, as described in the previous answer for banner ads.

2. Integrate Facebook SDK:

In your build.gradle (app module), ensure you've added:

implementation 'com.facebook.android:facebook-android-sdk:latest_version'
implementation 'com.facebook.android:audience-network-sdk:latest_version'

Sync your project with the Gradle files.

3. Load the Interstitial Ad:

In your activity or fragment, initialize the SDK and then load the interstitial ad:

import com.facebook.ads.*;

public class YourActivity extends AppCompatActivity {

    private InterstitialAd interstitialAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.your_layout);

        // Initialize the Audience Network SDK
        AudienceNetworkAds.initialize(this);

        interstitialAd = new InterstitialAd(this, "YOUR_PLACEMENT_ID");
        interstitialAd.loadAd();

        interstitialAd.setAdListener(new InterstitialAdListener() {
            @Override
            public void onInterstitialDisplayed(Ad ad) {
                // Interstitial ad displayed callback
            }

            @Override
            public void onInterstitialDismissed(Ad ad) {
                // Interstitial dismissed callback
            }

            @Override
            public void onError(Ad ad, AdError adError) {
                // Ad error callback
            }

            @Override
            public void onAdLoaded(Ad ad) {
                // Interstitial ad is loaded and ready to be displayed
                // Show the ad
                interstitialAd.show();
            }

            @Override
            public void onAdClicked(Ad ad) {
                // Ad clicked callback
            }

            @Override
            public void onLoggingImpression(Ad ad) {
                // Ad impression logged callback
            }
        });
    }

    @Override
    protected void onDestroy() {
        if (interstitialAd != null) {
            interstitialAd.destroy();
        }
        super.onDestroy();
    }
}

Replace YOUR_PLACEMENT_ID with your actual placement ID from the Facebook Developers portal.

4. Permissions:

Ensure your AndroidManifest.xml has:

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

5. Testing:

Always test the interstitial ad integration before going live:

Navigate to the Monetization Manager.
Click on "Integration" > "Test Devices" in the sidebar.
Add your device using its Ad ID.

Your device will now receive test ads from the Facebook Audience Network, so you can validate the ad placement without interfering with your app's live users.

After testing, set your app to live in the Facebook Developers portal and start showing real interstitial ads. Always ensure that you're displaying interstitial ads at appropriate times to not disrupt the user experience. Remember to monitor ad performance and adjust your placements and strategy as needed.

Adding Facebook Audience Network interstitial ads to Android Studio project:
- Add FAN interstitial ads to your Android Studio project by following these steps:
  - Open your build.gradle file and add the FAN SDK dependency.
```
implementation 'com.facebook.android:audience-network-sdk:6.0.0'
```
  - Sync your project to fetch the new dependency.
  - Update your activity code to include the FAN interstitial ad.

Displaying Facebook Audience Network interstitials in Android app:

Display FAN interstitials in your Android app by integrating the interstitial ad and showing it at appropriate points. Here's a simplified example:

// MainActivity.java
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import com.facebook.ads.Ad;
import com.facebook.ads.AdError;
import com.facebook.ads.InterstitialAd;
import com.facebook.ads.InterstitialAdListener;

public class MainActivity extends AppCompatActivity {

    private InterstitialAd interstitialAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Initialize the Audience Network SDK
        AdSettings.initialize(getApplicationContext());

        // Load the interstitial ad
        interstitialAd = new InterstitialAd(this, getString(R.string.facebook_interstitial_ad_unit_id));
        interstitialAd.setAdListener(new InterstitialAdListener() {
            @Override
            public void onInterstitialDisplayed(Ad ad) {
                // Interstitial ad shown
            }

            @Override
            public void onInterstitialDismissed(Ad ad) {
                // Interstitial ad dismissed
            }

            @Override
            public void onError(Ad ad, AdError adError) {
                // Handle error
            }

            @Override
            public void onAdLoaded(Ad ad) {
                // Interstitial ad loaded
                if (interstitialAd.isAdLoaded()) {
                    interstitialAd.show();
                }
            }

            @Override
            public void onAdClicked(Ad ad) {
                // User clicked on the interstitial ad
            }

            @Override
            public void onLoggingImpression(Ad ad) {
                // Ad impression logged
            }
        });

        // Load ad
        interstitialAd.loadAd();
    }

    // Other activity lifecycle methods...

    @Override
    protected void onDestroy() {
        if (interstitialAd != null) {
            interstitialAd.destroy();
        }
        super.onDestroy();
    }
}

Make sure to replace "@string/facebook_interstitial_ad_unit_id" with your actual FAN interstitial ad unit ID.