Ad Manager-Publisher können eigene native Anzeigenformate erstellen, indem sie benutzerdefinierte Listen von Assets definieren. Diese werden als benutzerdefinierte native Anzeigenformate bezeichnet und können mit Reservierungsanzeigen verwendet werden. Mit benutzerdefinierten nativen Anzeigen können Publisher beliebige Bild- und Stringdaten an ihre Apps übergeben. Diese Daten werden durch ein CustomNativeAd-Objekt dargestellt.
Benutzerdefinierte native Anzeige laden
Benutzerdefinierte native Anzeigen werden mithilfe von AdLoader-Objekten geladen. Mit der Methode ForCustomNativeAd() wird AdLoader für die Verarbeitung benutzerdefinierter nativer Anzeigen konfiguriert. Diese Methode hat zwei Parameter:
- Die
formatIdder benutzerdefinierten Anzeige, die dieAdLoaderanfordern soll. Jedem benutzerdefinierten nativen Anzeigenformat ist ein Format-ID-Wert zugeordnet. Dieser Parameter gibt an, welches Format Ihre App für dieAdLoaderanfordern soll. - Ein optionaler
Action<CustomNativeAd, string>, der aufgerufen wird, wenn der Nutzer auf die Anzeige klickt.
Benutzerdefinierte native Anzeigen werden über die Klasse AdLoader geladen, die eine eigene Klasse AdLoader.Builder hat, um sie bei der Erstellung anzupassen. Mit der Methode ForCustomNativeAd() wird der AdLoader für die Verarbeitung nativer Anzeigen konfiguriert.
void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.ForCustomNativeAd("10063170")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
Da ein einzelner Anzeigenblock so eingerichtet werden kann, dass mehrere benutzerdefinierte native Anzeigenformate ausgeliefert werden, kann ForCustomNativeAd() mehrmals mit unterschiedlichen Format-IDs aufgerufen werden, um den Anzeigen-Loader für mehrere mögliche benutzerdefinierte native Anzeigenformate vorzubereiten.
Benutzerdefinierte native Anzeigenereignisse
Die Klasse AdLoader stellt Anzeigenereignisse vom Typ EventHandler bereit, um Sie über den Lebenszyklus einer benutzerdefinierten nativen Anzeige zu informieren. Im folgenden Beispiel wird gezeigt, wie Sie sich für benutzerdefinierte Ereignisse nativer Anzeigen in einem Anzeigen-Loader registrieren:
private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
Die Methode HandleCustomNativeAdLoaded() enthält einen Parameter CustomNativeAdEventArgs. Über diesen Ereignisparameter kann auf die geladene benutzerdefinierte native Anzeige zugegriffen werden, wie unten gezeigt:
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
this.customNativeAd = args.nativeAd;
}
Die Methode HandleCustomNativeAdFailedToLoad() enthält einen Parameter AdFailedToLoadEventArgs. Sie können auf die Fehlermeldung zugreifen, indem Sie die Methode GetMessage für das Feld LoadAdError aufrufen, wie unten gezeigt:
void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
string message = args.LoadAdError.GetMessage();
Debug.Log("Ad Loader fail event received with message: " + message);
}
Benutzerdefinierte native Anzeigenformate für das Displaynetzwerk
Benutzerdefinierte native Anzeigen unterstützen eine beliebige Anzahl von benutzerdefinierten Bild- und Text-Assets. Der Zugriff auf diese Assets erfolgt über die Klasse CustomNativeAd, die die Methoden GetTexture2D() und GetText() bereitstellt, die die Variablen-ID eines Formatfelds als Parameter verwenden.
Hier ein Implementierungsbeispiel für den Zugriff auf Assets aus einer benutzerdefinierten nativen Anzeige:
private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...
void Update()
{
if(adLoaded)
{
mainImageTexture = customNativeAd.GetTexture2D("MainImage");
headline = customNativeAd.GetText("Headline");
adLoaded = false;
}
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
customNativeAd = args.nativeAd;
adLoaded = true;
...
}
Impressionen und Klicks für benutzerdefinierte native Anzeigen verarbeiten
Bei benutzerdefinierten nativen Anzeigen ist Ihre App für die Erfassung von Impressionen und die Meldung von Click-Events an das SDK verantwortlich.
Impressionen aufzeichnen
Wenn Sie eine Impression für eine benutzerdefinierte Anzeige erfassen möchten, rufen Sie die Methode RecordImpression() für die entsprechende CustomNativeAd auf:
customNativeAd.RecordImpression();
Klicks melden
Wenn Sie dem SDK melden möchten, dass ein Klick auf ein Asset erfolgt ist, rufen Sie die Methode PerformClick() für das entsprechende CustomNativeAd auf und übergeben Sie den Namen des Assets, auf das geklickt wurde. Wenn Sie beispielsweise ein Asset in Ihrem benutzerdefinierten Format mit dem Namen „MainImage“ haben und einen Klick auf die Textur erfassen möchten, die diesem Asset entspricht, sieht Ihr Code so aus:
customNativeAd.PerformClick("MainImage");
Auf benutzerdefinierte Klickaktionen reagieren
Wenn ein Klick auf eine benutzerdefinierte Anzeige gemeldet wird, werden die möglichen Antworten des SDK in dieser Reihenfolge versucht:
Suchen Sie einen Content-Resolver für die Deeplink-URL der Anzeige und starten Sie den ersten, der die URL auflöst.
Öffnen Sie einen Browser und rufen Sie die herkömmliche Ziel-URL der Anzeige auf.
Wenn Sie die Klickaktion für Ihre benutzerdefinierten nativen Anzeigenformate selbst verarbeiten möchten, anstatt den Nutzer zu einem Deeplink oder Webbrowser weiterzuleiten, geben Sie in der Methode AdLoader.Builder.ForCustomNativeAd() einen optionalen Action<CustomNativeAd, string> an. Wenn Sie diese benutzerdefinierte Klickaktion festlegen, überschreiben Sie das Klickverhalten des SDK. Hier ein Beispiel, in dem eine benutzerdefinierte Klickaktion verwendet wird, um einen Klick für ein bestimmtes Asset zu protokollieren:
private void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
.Build();
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.LoadAd(createAdRequest());
}
private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}