Benutzerdefinierten Korrelator mit dem Google Mobile Ads SDK verwenden

Bei einigen Apps müssen zwei Anzeigenanfragen miteinander in Beziehung gesetzt werden.

Mit dem Google Mobile Ads SDK können Sie zwei Anfragen nicht in Beziehung setzen. 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 Anzeigenanfrage einen neuen Korrelator. Das bedeutet, dass keine zwei Anfragen korreliert werden.

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

Swift

var correlator = "2510196024846425" // make randomly - should be 16 digits.
let request = AdManagerRequest()
let extras = Extras()
extras.additionalParameters = ["correlator": correlator];
request.register(extras)

Objective-C

NSString *correlator = @"2510196024846425" // make randomly - should be 16 digits.
DRPRequest *request = [[GAMRequest alloc] init];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{ @"correlator": correlator};
[request registerExtras:extras];

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

Mit dem benutzerdefinierten Korrelator erhält Ad Manager den Kontext, der erforderlich ist, um zu verhindern, dass dasselbe Creative ausgewählt wird. Die Anzeigenanfragen müssen jedoch sequenziell erfolgen: Senden Sie eine Anzeigenanfrage, rufen Sie die Antwort ab und senden Sie dann die nächste Anfrage.

Sie können dies mehrmals tun, aber je mehr Aufrufe Sie ausführen, desto mehr Ressourcen werden verbraucht. Es empfiehlt sich, die Anzahl der aufeinanderfolgenden Anfragen auf 3 bis 5 zu beschränken. Sie können zusätzliche Aufrufe ausführen, wenn der Nutzer auf der Seite nach unten scrollt.

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

Damit die zurückgegebenen Anzeigen nicht in nachfolgenden Aufrufen nach Ablauf des Korrelators ausgeliefert werden, sollten Sie ein Frequency Capping von einer Anzeige alle 5 bis 10 Minuten hinzufügen. Der ausgewählte Zeitraum sollte mit der typischen Nutzung Ihrer App übereinstimmen. Frequency Capping-Werte 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 ausführen, erhalten Sie möglicherweise dieselbe Anzeige.