Hinzufügen von Interstitial Ads zu einer Unity-App

Mit dem Audience Network kannst du deine Android- und iOS-Apps mit Facebook-Werbeanzeigen zu Geld machen. Interstitial Ads sind eine Vollbild-Anzeigenerfahrung und können an Übergangspunkten im Fluss einer App verwendet werden, z. B. zwischen Aktivitäten oder während der Pause zwischen Levels in einem Spiel. Der Inhalt der Werbeanzeige kann aus Bildern, Videos oder Carousels bestehen. In diesem Leitfaden wird erklärt, wie du deiner App Interstitial Ads hinzufügst.

Schritte zur Erstellung von Interstitial Ads

Schritt 1: Interstitial Ad-Objekt erstellen

Schritt 2: Callback-Events hinzufügen

Schritt 3: Werbeanzeige laden

Schritt 4: Werbeanzeige präsentieren

Schritt 1: Interstitial Ad-Objekt erstellen

Zum Anzeigen einer Interstitial Ad musst du zunächst ein InterstitialAd-Objekt in einem C#-Skript erstellen, das an ein GameObject angehängt ist.

...
using AudienceNetwork;
...

public class InterstitialAdTest : MonoBehaviour
{
    ...
    private InterstitialAd interstitialAd;
    private bool isLoaded;
    ...

    public void LoadInterstitial()
    {
        this.interstitialAd = new InterstitialAd("YOUR_PLACEMENT_ID");
        this.interstitialAd.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.interstitialAd.InterstitialAdDidLoad = (delegate() {
            Debug.Log("Interstitial ad loaded.");
            this.isLoaded = true;
        });
        interstitialAd.InterstitialAdDidFailWithError = (delegate(string error) {
            Debug.Log("Interstitial ad failed to load with error: " + error);
        });
        interstitialAd.InterstitialAdWillLogImpression = (delegate() {
            Debug.Log("Interstitial ad logged impression.");
        });
        interstitialAd.InterstitialAdDidClick = (delegate() {
            Debug.Log("Interstitial ad clicked.");
        });

        this.interstitialAd.interstitialAdDidClose = (delegate() {
            Debug.Log("Interstitial ad did close.");
            if (this.interstitialAd != null) {
                this.interstitialAd.Dispose();
            }
        });

        // Initiate the request to load the ad.
        this.interstitialAd.LoadAd();
    }
    ...
}

Der Konstruktor für eine InterstitialAd weist die folgenden Parameter auf:

• placementId: Die Audience Network-Placement ID für diese Interstitial Ad-Einheit.

Schritt 2: Callback-Events hinzufügen

Als Nächstes kannst du einige Rückrufe implementieren, um die Lebenszyklus-Events der Werbeanzeige zu abonnieren. Überwache diese Events, indem du einen Delegate für das Event registrierst, wie im folgenden Beispiel gezeigt:

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.interstitialAd.InterstitialAdDidLoad = (delegate() {
    Debug.Log("Interstitial ad loaded.");
    this.isLoaded = true;
});
interstitialAd.InterstitialAdDidFailWithError = (delegate(string error) {
    Debug.Log("Interstitial ad failed to load with error: " + error);
});
interstitialAd.InterstitialAdWillLogImpression = (delegate() {
    Debug.Log("Interstitial ad logged impression.");
});
interstitialAd.InterstitialAdDidClick = (delegate() {
    Debug.Log("Interstitial ad clicked.");
});

this.interstitialAd.interstitialAdDidClose = (delegate() {
    Debug.Log("Interstitial ad did close.");
    if (this.interstitialAd != null) {
        this.interstitialAd.Dispose();
    }
});
...

Schritt 3: Werbeanzeige laden

Nachdem die InterstitialAd instanziiert wurde, musst du im nächsten Schritt eine Werbeanzeige laden. Dazu verwendest du die loadAd()-Methode in der InterstitialAd-Klasse.

Hier siehst du, wie im obigen Beispiel eine Werbeanzeige geladen wird:

...
this.interstitialAd.LoadAd();
...

Schritt 4: Werbeanzeige präsentieren

Nachdem die Interstitial Ad geladen wurde, kannst du schließlich die Show-Methode aufrufen, um die Interstitial Ad auf dem Bildschirm zu rendern. Du kannst beispielsweise eine Funktion für ShowInterstitial aufrufen, wenn die Interstitial Ad gezeigt werden soll:

// Show button
public void ShowInterstitial()
{
    if (this.isLoaded) {
        this.interstitialAd.Show();
        this.isLoaded = false;

    } else {
        Debug.Log("Interstitial Ad not loaded!");
    }
}