Die Zahl der Neuinstallationen von mobilen Apps ist in der Regel auf App-Installationsanzeigen zurückzuführen. Zum Maximieren sollten Sie keine Anzeige für die Installation einer App Geräte, auf denen die gleiche App bereits installiert ist. In diesem Vorschlag beziehen wir uns auf als „Filtern von App-Installationsanzeigen“.
In diesem Vorschlag wird erläutert, wie Protected Audience für Android kontextabhängige die Anzeigenfilterung, insbesondere das Filtern von App-Installationsanzeigen, Damit du teilnehmen kannst, muss die App auf dem Gerät explizit der App zustimmen Anzeigenfilterung installieren. Bei der Anzeigenauswahl werden Anzeigenkandidaten aufgrund der in der Liste der auf dem der Anzeigentechnologie installierten Apps.
Die Liste der installierte Apps sind nur während der Anzeigenauswahl sichtbar auf der Buy-Side-Plattform an, um zu signalisieren, dass eine bestimmte Anzeige anhand der ob eine App auf dem Gerät vorhanden ist.
So richten Sie den Filter für App-Installationsanzeigen ein:
Schritt 1: App für die Filterung von App-Installationsanzeigen registrieren
Um die Filterung für App-Installationsanzeigen zu aktivieren, ruft der App-Entwickler die Methode
über die App Registration API von registerForAdFiltering
oder über ein SDK für Anzeigentechnologien
mit einer Liste der eTLD+1-Käufer von Anzeigentechnologie. So können die Käufer auf der Liste
nur diese Käufer auswählen, um Anzeigen anhand des Installationsstatus der App zu filtern,
direkt oder über das SDK der Anzeigentechnologie. Durch die Registrierung haben Sie die volle Kontrolle über
App-Entwickler, ob ihre App App-Installations-Anzeigen enthalten soll oder nicht
Filterung.
java
void registerForAdFiltering(List<AdTechIdentifier> buyers);
Schritt 2: Anfrage zum Herausfiltern von App-Installationsanzeigen
Wenn eine Anzeige für Gebote in Betracht gezogen wird, können Käufer die Anzeige werden aufgrund des Installationsstatus einer App herausgefiltert. Dies geschieht durch Einbeziehung des Paketname der App in den Metadaten der Anzeige. Filteranfrage für App-Installationsanzeigen ist Teil der Anzeigendaten, die in den Auktionsprozess von Protected Audience eingespeist werden. Dieses Anzeigendaten werden unterschiedlich erstellt, je nachdem, ob es sich um kontext- Remarketing-Anzeige.
- Für kontextbezogene Anzeigen – der Hauptanwendungsfall für die App-Installation Anzeigenfilterung, Filterinformationen sind Teil der Anzeigendaten die Käufer Verkäufern geben können, wenn sie auf ein kontextbezogenes Gebot außerhalb von der Protected Audience API. Protected Audience geht davon aus, als Teil der kontextbezogenen Antwort zurückgegeben, wie jede andere anzeigenspezifischen Metadaten.
- Beim Remarketing-Anwendungsfall erwartet Protected Audience Filter.
die in die benutzerdefinierte Zielgruppe aufgenommen werden sollen. Es gibt zwei Möglichkeiten
damit dies geschieht: beim Beitritt und beim
neue Zielgruppendaten im Rahmen des
Zielgruppen-Update-Prozesses.
Die Anfrage zum Herausfiltern von App-Installationsanzeigen sollte in etwa so aussehen:
das JSON-Objekt
AdData
:json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
Schritt 3: App-Installationsanzeigen bei der Anzeigenauswahl herausfiltern
Während einer Anzeigenanfrage kann der Käufer mehrere Anzeigen mit
Filtern von Informationen, damit Anzeigen für installierte Apps herausgefiltert werden können. Die
ist erforderlich, um die Filterinformationen als Teil des
Funktionskonfiguration für selectAds
im Feld adData
. Android erwartet eine
Nachrichtenformat ähnlich dem folgenden.
AdData myAdData = new AdData.Builder()
.setRenderUri(Uri.parse("https://.."))
.setMetadata("{...}")
.setFilters(new AdFilters.Builder()
.setAppInstalledFilter(new AppInstalledFilter.Builder()
.setPackageNames(ImmutableList.of("app1.package", "app2.package"))
.build())
.build())
.build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
.setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
.setDecisionLogicUri(Uri.parse("https://..."))
...
.setContextualAds(ImmutableList.of(new ContextualAd.Builder()
.setBuyer(AdTechIdentifier.fromString("example.com"))
.setReportingUri("https://example.com/reporting")
.setBid(20)
// myAdData could be taken from the JSON above
.setAd(myAdData)
.build()))
.build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);
Das Filtern wird in der selectAds
API verarbeitet. Protected Audience-Filter
Wenn die in der Mitteilung angegebene App mit der App in der Anzeigentechnologie übereinstimmt
der Käufer Liste mit bestimmten App-Installationen. Es sind zwei Ergebnisse möglich:
- Die App ist in dieser Liste nicht enthalten, sie ist also nicht installiert und nicht geöffnet.
- Die App ist in dieser Liste aufgeführt, d. h., sie ist installiert und geöffnet.
Wenn Protected Audience erkennt, dass eine App bereits vorhanden ist, wird die Anzeige
von der Liste der Anzeigen ausgeschlossen werden, die im Rahmen der Auktion für
scoreAds
verwendet werden.
Überlegungen im Zusammenhang mit kontextbezogenen Anzeigen
Durch die Filterung von App-Installationsanzeigen werden die Protected Audience APIs zum Filtern von kontextbezogenen Anzeigen. In der Spalte Situationen, in denen eine Auktion eine Mischung aus Kontext- und Remarketing-Anzeigen ist oder ausschließlich aus kontextbezogenen Anzeigen besteht.
- Bei einer
selectAd
-Auktion hat der Käufer die Möglichkeit, die Übergabe in einer Liste durchzuführen. vonContextualAd
Objekten. Diese Objekte enthalten die eTLD+1 des Anzeigenkäufers, das Gebot für die Anzeige, eine URL, die auf die Reporting-Logik für die Anzeige verweist, und dieAdData
mit der tatsächlichen URL des Anzeigeninhalts und eine Bestätigung Signatur des Käufers (weitere Informationen unter Signatur von kontextbezogenen Anzeigen) Details. Beachten Sie, dass das FormatAdData
sowohl im Kontext- als auch Remarketing-Anzeigen. - Zu Beginn des Auktionsprozesses werden Kontext- und Remarketing-Anzeigen
gefiltert nach den Paketnamen, die in den
AdData.adFilters.appInstallFilters.packageNames
Dann werden die Gebotswerte Remarketing-Anzeigen ausgewählt und sowohl das Remarketing als auch kontextbezogene Anzeigen werden mithilfe der angegebenen FunktionscoreAds
bewertet. Die Anzeige mit der höchsten Punktzahl gewinnt. Dieser Vorgang funktioniert auch, wenn Remarketing-Anzeigen vorhanden sind. Wenn eine kontextbezogene Anzeige die Auktion gewinnt, wird der Impressionsbericht App herunterladen, lädt Protected Audience eine JS-Funktion namens
reportWin()
aus der Berichts-URL, die in den kontextbezogenen Anzeigendaten enthalten ist. Dies ist vergleichbar mit der Berichterstellung für eine Remarketing-Anzeige, die Auktion.Beispiel für eine JavaScript-Berichtsfunktion:
function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals) { let reporting_address = 'https://reporting.example.com'; return {'status': 0, 'results': {'reporting_uri': reporting_address + '?some_signal=' + per_buyer_signals.some_signal} }; }
Kontextabhängige Anzeigensignatur
Kontextbezogene Anzeigen mit Filterung nach App-Installationen müssen vom Käufer. Die Plattform verwendet diese Signatur, um die bereitgestellte Anzeigentechnologie zu verifizieren. welche Anzeigentechnologie-App-Installationsfilter auf die Anzeigen angewendet werden sollen. Dies ist um zu verhindern, dass böswillige Anzeigentechnologie die Identität eines anderen Anbieters für weil andere Anzeigentechnologie-Anbieter von der Registrierung für die Filterung von App-Installationen profitieren.
Die Privacy Sandbox ruft diese Schlüssel vom angegebenen Anzeigentechnologie-Endpunkt ab während der Registrierung. Als Best Practice empfehlen wir, dass die Schlüssel werden häufig, jedoch spätestens alle sechs Monate aktualisiert.
Die Privacy Sandbox fordert Anzeigentechnologie-Experten dazu auf, die Verfügbarkeit der Anzeige zu bestätigen technisch bereitgestellten Endpunkt. Weitere Informationen zu Maßnahmen, die für aktuelle und neu registrierte Anzeigentechnologie-Anbieter erforderlich sind, finden Sie in den Anleitung für die Registrierung
In unserem Entwicklerhandbuch finden Sie die in naher Zukunft veröffentlicht werden.
Persönliche Empfehlungen
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Entwicklerleitfaden für die Protected Audience API auf Android-Geräten
- Versionshinweise
- Targeting auf benutzerdefinierte Zielgruppen mit der Protected Audience API unterstützen