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

Integrating Facebook Audience Network (FAN) Native Ads into your Android application requires a slightly different approach compared to banner or interstitial ads. Native ads are designed to match the look and feel of your app, offering a more cohesive experience to users.

Here's how you can implement FAN Native Ads in your Android app:

1. Setup on Facebook:

As with other FAN ad types, you should have registered your app with the Facebook Developers portal and added the "Audience Network" to your app.

2. Integrate Facebook SDK:

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

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

Then sync your project with the Gradle files.

3. Design Your Native Ad Layout:

Create an XML layout for your native ad that can blend with your app��s UI. For example, native_ad_layout.xml:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <com.facebook.ads.MediaView
        android:id="@+id/native_ad_media"
        android:layout_width="match_parent"
        android:layout_height="200dp" />

    <TextView
        android:id="@+id/native_ad_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <!-- Add more views for other ad elements like description, icon, etc. -->

    <com.facebook.ads.AdChoicesView
        android:id="@+id/ad_choices_container"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</RelativeLayout>

4. Load and Display the Native Ad:

In your activity or fragment:

import com.facebook.ads.*;

public class YourActivity extends AppCompatActivity {

    private NativeAd nativeAd;

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

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

        nativeAd = new NativeAd(this, "YOUR_PLACEMENT_ID");
        nativeAd.loadAd(nativeAd.buildLoadAdConfig().withAdListener(new NativeAdListener() {
            @Override
            public void onMediaDownloaded(Ad ad) {
                // Native ad finished downloading all assets
            }

            @Override
            public void onError(Ad ad, AdError adError) {
                // Native ad failed to load
            }

            @Override
            public void onAdLoaded(Ad ad) {
                // Native ad is loaded and ready to be displayed
                inflateAd(nativeAd);
            }

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

            @Override
            public void onLoggingImpression(Ad ad) {
                // Native ad impression
            }
        }).build());
    }

    private void inflateAd(NativeAd nativeAd) {
        nativeAd.unregisterView();

        // Add the Ad view into your layout
        LinearLayout adContainer = findViewById(R.id.native_ad_container);
        LayoutInflater inflater = LayoutInflater.from(YourActivity.this);
        View adView = inflater.inflate(R.layout.native_ad_layout, adContainer, false);
        adContainer.addView(adView);

        // Fill the native ad views with data
        TextView nativeAdTitle = adView.findViewById(R.id.native_ad_title);
        nativeAdTitle.setText(nativeAd.getAdvertiserName());

        // Bind a listener to the native ad view
        List<View> clickableViews = new ArrayList<>();
        clickableViews.add(adView);
        nativeAd.registerViewForInteraction(adView, clickableViews);
    }

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

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

5. Testing:

Before going live, always test the integration:

Go 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, allowing you to test the native ad placement without affecting live users.

After testing, set your app to live in the Facebook Developers portal, and you can start showing real native ads. Monitor performance and adjust your placements and design as needed for an optimal user experience and revenue.

Adding Facebook Audience Network native ads to Android Studio project:
- Add FAN native 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 or fragment code to include the FAN native ad.

Displaying Facebook Audience Network natives in Android app:

Display FAN native ads in your Android app by integrating the native ad and rendering it within your app's content. 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.AdListener;
import com.facebook.ads.AdOptionsView;
import com.facebook.ads.MediaView;
import com.facebook.ads.NativeAd;
import com.facebook.ads.NativeAdLayout;

public class MainActivity extends AppCompatActivity {

    private NativeAd nativeAd;
    private NativeAdLayout nativeAdLayout;

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

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

        // Load the native ad
        nativeAd = new NativeAd(this, getString(R.string.facebook_native_ad_unit_id));
        nativeAd.setAdListener(new AdListener() {
            @Override
            public void onError(Ad ad, AdError adError) {
                // Handle error
            }

            @Override
            public void onAdLoaded(Ad ad) {
                // Native ad loaded
                inflateNativeAd(nativeAd);
            }

            // Implement other AdListener methods as needed
        });

        // Load ad
        nativeAd.loadAd();
    }

    private void inflateNativeAd(NativeAd nativeAd) {
        // Inflate native ad view
        nativeAdLayout = findViewById(R.id.native_ad_layout);
        nativeAdLayout.addView(NativeAdLayout.inflateWith(nativeAd)
                .setAdListener(nativeAdListener)
                .setExpandable(AdOptionsView.Orientation.HORIZONTAL)
                .build());

        // Register the native ad for impressions and clicks
        nativeAd.registerViewForInteraction(nativeAdLayout, mediaView);
    }

    private AdListener nativeAdListener = new AdListener() {
        @Override
        public void onError(Ad ad, AdError adError) {
            // Handle native ad error
        }

        @Override
        public void onAdLoaded(Ad ad) {
            // Native ad loaded, perform necessary UI updates
        }
    };

    // Other activity lifecycle methods...

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

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