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 den datenschutzfreundlichen Filter von kontextbezogenen Anzeigen, insbesondere von Anzeigen für App-Installationen, unterstützt. 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 die Anzeigenkandidaten anhand der Liste der Apps herausgefiltert, die auf dem der Anzeigentechnologie bekannten Gerät installiert sind.

Die Liste der installierten Apps ist nur während der Anzeigenauswahl sichtbar. Die Plattform auf der Käuferseite signalisiert, dass eine bestimmte Anzeige basierend auf dem Vorhandensein 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

Um die Filterung von App-Installationsanzeigen zu aktivieren, ruft der App-Entwickler die registerForAdFiltering-API zur App-Registrierung über seine App oder ein Anzeigentechnologie-SDK mit einer Liste der eTLD+1-Werte für Anzeigentechnologie-Käufer 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 App-Installationsanzeigen ist Teil der Anzeigendaten, die in den Protected Audience-Auktionsprozess eingespeist werden. Diese Anzeigendaten werden unterschiedlich erstellt, je nachdem, ob es sich um eine kontextbezogene Anzeige 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. Protected Audience erwartet, dass Filterinformationen im Rahmen der Kontextantwort zurückgegeben werden, wie alle anderen anzeigenspezifischen Metadaten.
  • Beim Remarketing-Anwendungsfall erwartet Protected Audience, dass Filterinformationen in der benutzerdefinierten Zielgruppe enthalten sind. 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 Herausfiltern von App-Installationsanzeigen 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. Auf der Verkäuferseite müssen die Filterinformationen im Rahmen der Konfiguration der Funktion selectAds im Feld adData übergeben werden. Android erwartet ein 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);

Die Filterung erfolgt in der selectAds API. Protected Audience filtert die Anzeige heraus, wenn die in der Nachricht angegebene App mit der App in der App-Installationsliste des Käufers von Anzeigentechnologie ü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 ist in dieser Liste zu finden, 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.

Überlegungen im Zusammenhang mit 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 aus kontextbezogenen Anzeigen besteht, sind einige Dinge wichtig.

  • 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, die AdData mit der tatsächlichen URL des Anzeigeninhalts und eine Bestätigungssignatur des Käufers. Weitere Informationen finden Sie unter Signatur von kontextbezogenen 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 bei der Auktion erfolgreich ist und von der App ausgelöste Impressionsberichte ausgelöst werden, lädt Protected Audience eine JS-Funktion namens reportWin() aus der Berichts-URL herunter, die in den kontextbezogenen Anzeigendaten enthalten ist, und führt sie aus. Das entspricht der Berichterstellung für eine Remarketing-Anzeige, die die Auktion gewonnen hat.

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

Kontextbezogene Anzeigensignatur

  • Kontextbezogene Anzeigen mit Filterung für App-Installationen müssen vom Käufer signiert werden. Die Plattform verwendet diese Signatur, um die Anzeigentechnologie zu überprüfen, von der die Anzeigen bereitgestellt wurden, und um zu prüfen, welche Filter für App-Installationen 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.

  • Im Rahmen der Privacy Sandbox müssen Anbieter von Anzeigentechnologien während des Registrierungsprozesses 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.

  • In naher Zukunft wird ein Entwicklerleitfaden mit ausführlicheren Anleitungen zur Implementierung veröffentlicht.