Benutzerdefinierten Korrelator mit dem Mobile Ads SDK verwenden

Bei einigen Apps müssen zwei Anzeigenanfragen miteinander korreliert werden.

Das Google Mobile Ads SDK lässt keine Korrelation von zwei Anfragen zu. Daher ist es schwierig zu verhindern, dass dasselbe Creative für zwei ähnliche Anzeigenanfragen ausgeliefert wird. Korrelierte Anzeigenanfragen sind auch für Roadblocks und Competitive Exclusions in Ad Manager erforderlich.

Ein Korrelatorwert ist eine zufällige vorzeichenlose Ganzzahl mit 16 Zeichen, die als String dargestellt wird. Standardmäßig generiert das GMA SDK mit jeder Anzeigenanfragen einen neuen Korrelator . Das bedeutet, dass keine zwei Anfragen korreliert werden.

Wenn Sie zwei Anfragen korrelieren möchten, können Sie den von the GMA SDK generierten Korrelator manuell überschreiben und denselben Korrelator auf mehrere Anzeigenanfragen anwenden. Dazu müssen Sie diese Funktion verwenden, müssen Sie Ihren eigenen zufälligen Korrelator generieren. Hier sind Beispiele dafür, wie Sie Ihren eigenen Korrelator übergeben können:

Java

Bundle extras = new Bundle();
String correlator = "2510196024846425"; // make randomly - should be 16 digits.
extras.putString("correlator", correlator);
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle()
val correlator = "2510196024846425" // make randomly - should be 16 digits.
extras.putString("correlator", correlator)
val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

Die Lebensdauer des Korrelators beträgt 30 Sekunden. Anfragen, die in einem Abstand von mehr als 30 Sekunden gestellt werden, werden vom Server nicht als korreliert betrachtet.

Best Practices

Wenn Sie den benutzerdefinierten Korrelator verwenden, erhält Ad Manager den Kontext, der erforderlich ist, um zu verhindern, dass dasselbe Creative ausgewählt wird. Die Anzeigenanfragen müssen jedoch sequenziell gestellt werden: Stellen Sie eine Anzeigenanfrage, erhalten Sie die Antwort und stellen Sie dann die nächste Anfrage.

Sie können dies mehrmals tun, aber je mehr Aufrufe Sie tätigen, desto mehr Ressourcen werden verbraucht. Beschränken Sie sich am besten auf 3 bis 5 sequenzielle Anfragen. Sie können zusätzliche Aufrufe tätigen, wenn der Nutzer auf der Seite nach unten scrollt.

Da der Korrelator nach 30 Sekunden abläuft, müssen Sie für denselben langen Seitenaufruf keinen neuen Wert generieren. Generieren Sie zu Beginn jedes neuen langen Seitenaufrufs einen neuen Korrelator. Wenn Sie dieses Verhalten nicht mehr benötigen, übergeben Sie keinen eigenen Korrelator mehr.

Damit die zurückgegebenen Anzeigen nach Ablauf des Korrelators nicht in nachfolgenden Aufrufen ausgeliefert werden, sollten Sie ein Frequency Capping von einer Anzeige alle 5 bis 10 Minuten hinzufügen. Die ausgewählte Zeit sollte mit der typischen Nutzung Ihrer App übereinstimmen. Frequency Cappings können gelöscht werden, wenn Sie die Anzeigen nicht rendern. Wenn Sie also eine Anzeigenanfrage stellen, die Anzeige aber nicht rendern und zusätzliche Aufrufe tätigen, erhalten Sie möglicherweise dieselbe Anzeige.