Filter für App-Installationsanzeigen für Protected Audience

App-Installationsanzeigen sind eine gängige Methode, um die Anzahl der Installationen Ihrer App zu steigern. Um den ROAS Ihrer Werbeausgaben zu maximieren, sollten Sie keine Anzeigen zur Installation einer App auf Geräten schalten, auf denen diese App bereits installiert ist. In diesem Vorschlag bezeichnen wir diese Praxis als „App-Installationsanzeigen-Filter“.

In diesem Vorschlag wird erläutert, wie Protected Audience auf Android-Geräten den datenschutzfreundlichen Filtern von kontextbezogenen Anzeigen, insbesondere von Anzeigen für App-Installationen, dient. Damit die Funktion genutzt werden kann, muss die App auf dem Gerät das Filtern von Anzeigen für App-Installationen ausdrücklich aktivieren. Bei der Anzeigenauswahl werden Anzeigenkandidaten anhand der Liste der auf dem Gerät installierten Apps gefiltert, die der Anzeigentechnologie bekannt sind.

Die Liste der installierten Apps ist nur während der Anzeigenauswahl sichtbar. Die Buy-Side-Plattform muss signalisieren, dass eine bestimmte Anzeige basierend auf der Existenz einer App auf dem Gerät gefiltert werden soll.

So richten Sie die Filterung von Anzeigen für App-Installationen ein:

Schritt 1: App für die Filterung von App-Installationsanzeigen registrieren

Wenn der App-Entwickler die Filterung von Anzeigen für App-Installationen aktivieren möchte, ruft er die registerForAdFiltering App Registration API über seine App oder ein SDK für Anzeigentechnologien mit einer Liste der eTLD+1s von Anzeigentechnologienkäufern auf. So können die Käufer auf der Liste und nur diese Anzeigen basierend auf dem Installationsstatus der App filtern, entweder direkt oder über das SDK ihrer Anzeigentechnologie. Durch die Registrierung hat der App-Entwickler die volle Kontrolle darüber, ob seine App an der Filterung von Anzeigen für App-Installationen teilnehmen soll oder nicht. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

Schritt 2: App-Installationsanzeigen herausfiltern lassen

Wenn eine Anzeige für Gebote infrage kommt, können Käufer festlegen, dass sie basierend auf dem Installationsstatus einer App herausgefiltert werden soll. Dazu geben Sie den Paketnamen der App in den Metadaten der Anzeige an. Die Anfrage zum Filtern von Anzeigen für App-Installationen ist Teil der Anzeigendaten, die in den Auktionsprozess für Protected Audience einfließen. Diese Anzeigendaten werden unterschiedlich erstellt, je nachdem, ob es sich um eine kontextbezogene oder eine Remarketing-Anzeige handelt.

  • Beim Anwendungsfall für kontextbezogene Anzeigen, dem Hauptanwendungsfall für das Filtern von Anzeigen für App-Installationen, sind Filterinformationen Teil der Anzeigendaten, die Käufer an Verkäufer weitergeben können, wenn sie auf ein kontextbezogenes Gebot außerhalb von Protected Audience reagieren. Bei Protected Audience werden Filterinformationen wie alle anderen anzeigespezifischen Metadaten als Teil der kontextbezogenen Antwort zurückgegeben.
  • Für den Anwendungsfall „Remarketing“ müssen bei Protected Audience Filterinformationen in der benutzerdefinierten Zielgruppe enthalten sein. Es gibt zwei Möglichkeiten, wie das geschehen kann: beim Zusammenführen der Zielgruppe und beim Abrufen neuer Zielgruppendaten im Rahmen des Aktualisierungsprozesses. Die Anfrage zum Ausfiltern von Anzeigen für App-Installationen sollte im JSON-Objekt AdData so aussehen: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Schritt 3: Anzeigen für App-Installationen bei der Anzeigenauswahl herausfiltern

Bei einer Anzeigenanfrage kann der Käufer mehrere Anzeigen mit Filterinformationen an den Verkäufer zurückgeben, damit Anzeigen für installierte Apps herausgefiltert werden können. Die Sell-Side-Seite muss die Filterinformationen im Feld adData als Teil der selectAds-Funktionskonfiguration übergeben. Android erwartet ein ähnliches Nachrichtenformat.

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 defined earlier
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Die Filterung erfolgt in der selectAds API. Protected Audience filtert die Anzeige heraus, wenn die in der Meldung angegebene App mit der App in der Liste der App-Installationen der Ad Tech-Käufer übereinstimmt. Es gibt zwei mögliche Ergebnisse:

  • Die App wird in dieser Liste nicht angezeigt. Sie ist also nicht installiert und wird nicht geöffnet.
  • Die App befindet sich in dieser Liste, d. h., sie ist installiert und geöffnet. Wenn Protected Audience erkennt, dass eine App bereits vorhanden ist, wird die Anzeige aus der Liste der Anzeigen ausgeschlossen, die in der Auktion für die Auslieferung von scoreAds verwendet werden.

Wichtige Aspekte bei kontextbezogenen Anzeigen

Mit dem Filtern von Anzeigen für App-Installationen unterstützen die Protected Audience APIs jetzt auch den Filtern von kontextbezogenen Anzeigen. In Fällen, in denen die Auktion eine Mischung aus kontextbezogenen und Remarketing-Anzeigen oder nur kontextbezogene Anzeigen enthält, sind einige Dinge zu beachten.

  • Wenn eine selectAd-Auktion durchgeführt wird, kann der Käufer eine Liste von ContextualAd-Objekten übergeben. Diese Objekte enthalten die eTLD+1 des Anzeigenkäufers, das Gebot für die Anzeige, eine URL, die auf die Berichtslogik für die Anzeige verweist, und die AdData mit der URL der tatsächlichen Anzeigeninhalte sowie eine Bestätigungssignatur des Käufers. Weitere Informationen finden Sie unter Signatur für kontextbezogene Anzeigen. Das AdData-Format wird sowohl für kontextbezogene als auch für Remarketing-Anzeigen verwendet.
  • Zu Beginn des Auktionsprozesses werden kontextbezogene und Remarketing-Anzeigen anhand der Paketnamen gefiltert, die in der AdData.adFilters.appInstallFilters.packageNames angegeben sind. Anschließend werden Gebotswerte für alle Remarketing-Anzeigen festgelegt. Sowohl Remarketing- als auch kontextbezogene Anzeigen werden mithilfe der bereitgestellten scoreAds-Funktion bewertet. Die Anzeige mit der höchsten Punktzahl gewinnt. Hinweis: Dieser Vorgang funktioniert auch dann, wenn keine Remarketing-Anzeigen vorhanden sind.

  • Wenn eine kontextbezogene Anzeige die Auktion gewinnt und die Berichterstellung zu Impressionen von der App ausgelöst wird, lädt Protected Audience eine JS-Funktion namens reportWin() von der Berichts-URL herunter, die in den Daten der kontextbezogenen Anzeige enthalten ist, und führt sie aus. Das ist vergleichbar mit Berichten für Remarketing-Anzeigen, die die Auktion gewinnen.

    Beispiel für eine JavaScript-Funktion für Berichte:

    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} };
}

Kontextbezogene Anzeigensignatur

  • Kontextbezogene Anzeigen, die die Filterung nach App-Installationen umfassen, müssen vom Käufer unterzeichnet werden. Anhand dieser Signatur wird auf der Plattform überprüft, welche Anzeigentechnologie die Anzeigen bereitgestellt hat und welche App-Installationsfilter auf die Anzeigen angewendet werden sollen. So soll verhindert werden, dass böswillige Anzeigentechnologien die Identität einer anderen Anzeigentechnologie verwenden, um von der Registrierung der App-Installationsfilterung der anderen Anzeigentechnologie zu profitieren.

  • Die Privacy Sandbox ruft diese Schlüssel vom Anzeigentechnologie-Endpunkt ab, der bei der Registrierung angegeben wurde. Wir empfehlen als Best Practice, die Schlüssel häufig, aber spätestens alle sechs Monate zu aktualisieren.

  • Anbieter von Anzeigentechnologien müssen während der Registrierung in der Privacy Sandbox die Verfügbarkeit des von ihnen bereitgestellten Endpunkts bestätigen. Weitere Informationen zu den erforderlichen Maßnahmen für bereits registrierte und neu registrierte Anbieter von Anzeigentechnologien finden Sie in der Anleitung zur Registrierung.

  • Ein Entwicklerhandbuch mit einer detaillierten Anleitung zur Implementierung wird demnächst veröffentlicht.