Banner Ads und Medium Rectangle Ads zu einer Unity App hinzufügen

Mit dem Audience Network kannst du deine Android- und iOS-Apps mit Facebook-Werbeanzeigen zu Geld machen. In diesem Leitfaden wird erklärt, wie du deiner App Werbebanner hinzufügst.

Schritte zum Hinzufügen von Werbebannern und Medium Rectangle Ads

Schritt 1: Ein Bannerobjekt erstellen

Schritt 2: Callback-Events hinzufügen

Schritt 3: Werbeanzeige laden

Schritt 4: Werbeanzeige präsentieren

Schritt 1: Ein Bannerobjekt erstellen

Zum Anzeigen eines Werbebanners musst du zunächst ein AdView-Objekt in einem C#-Skript erstellen, das an ein GameObject angehängt ist.

...
using AudienceNetwork;
...

public class AdViewTest : MonoBehaviour
{
    ...
    private AdView adView;
    ...

    public void LoadBanner()
    {
        if (this.adView) {
            this.adView.Dispose();
        }

        this.adView = new AdView("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);
        this.adView.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.adView.AdViewDidLoad = (delegate() {
            Debug.Log("Banner loaded.");
            this.adView.Show(100);
        });
        adView.AdViewDidFailWithError = (delegate(string error) {
            Debug.Log("Banner failed to load with error: " + error);
        });
        adView.AdViewWillLogImpression = (delegate() {
            Debug.Log("Banner logged impression.");
        });
        adView.AdViewDidClick = (delegate() {
            Debug.Log("Banner clicked.");
        });

        // Initiate a request to load an ad.
        adView.LoadAd();
    }
    ...
}

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

• placementId: Die Audience Network-Placement ID für diese Werbebanner-Einheit.
• size: Die Größe des Werbebanners, die von den AdSize-Enum-Werten festgelegt ist.

Schritt 2: Callback-Events hinzufügen

Als Nächstes kannst du einige Rückrufe implementieren, um die Lebenszyklus-Events der Banner Ad 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.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});
adView.AdViewDidFailWithError = (delegate(string error) {
    Debug.Log("Banner failed to load with error: " + error);
});
adView.AdViewWillLogImpression = (delegate() {
    Debug.Log("Banner logged impression.");
});
adView.AdViewDidClick = (delegate() {
    Debug.Log("Banner clicked.");
});
...

Schritt 3: Werbeanzeige laden

Nachdem die AdView instanziiert wurde, muss im nächsten Schritt eine Werbeanzeige geladen werden. Hierzu verwendest du die loadAd()-Methode in der AdView-Klasse.

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

...
adView.LoadAd();
...

Schritt 4: Werbeanzeige präsentieren

Nachdem das Werbebanner geladen wurde, kannst du schließlich die Show-Methode aufrufen, um das Werbebanner auf dem Bildschirm zu rendern. Du kannst zum Beispiel die Anzeige im AdViewDidLoad-Rückruf ansehen, wenn sie fertig geladen ist:

this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});

Es gibt drei verschiedene Arten der Show-Methode in der Klasse AdView, die du verwenden kannst, um die Werbebanner-Einheit zu rendern:

• public bool Show(AdPosition position): Rendern der Werbebanner-Einheit an vordefinierten Positionen, verfügbare Optionen sind: AdPosition.TOP zum Rendern am oberen Bildschirmrand, AdPosition.BOTTOM zum Rendern am unteren Bildschirmrand.
• public bool Show(double y): Rendert die Werbebanner-Einheit an den Bildschirmkoordinaten (0, y).
• public bool Show(double x, double y): Rendert die Werbebanner-Einheit an den Bildschirmkoordinaten (x, y).

Banner Ad-Größen

Im Audience Network werden drei Werbeanzeigengrößen für AdView unterstützt. Die Breite der Bannereinheit ist flexibel, muss aber mindestens 320 Pixel betragen. Lediglich die Höhe ist festgelegt.