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

Neue App-Installationen werden in der Regel durch App-Installationsanzeigen erzielt. Um den ROI Ihrer Werbeausgaben zu maximieren, sollten Sie keine Anzeige für die Installation einer App auf Geräten schalten, auf denen diese App bereits installiert ist. In diesem Vorschlag bezeichnen wir diese Vorgehensweise als „Filtern von App-Installationsanzeigen“.

In diesem Vorschlag wird beschrieben, wie Protected Audience unter Android das Filtern kontextbezogener Anzeigen, insbesondere das Filtern von App-Installationsanzeigen, auf datenschutzfreundliche Weise unterstützt. Damit die App auf dem Gerät teilnehmen kann, muss sie die Filterung von Anzeigen für App-Installationen explizit aktivieren. Bei der Anzeigenauswahl werden Anzeigenkandidaten anhand der Liste der auf dem Gerät installierten Apps herausgefiltert, die der Ad-Tech-Anbieter kennt.

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

So richten Sie das Filtern von Anzeigen für App-Installationen ein:

Schritt 1: App für das Filtern von App-Installationsanzeigen registrieren

Um die Filterung von App-Installationsanzeigen zu aktivieren, ruft der App-Entwickler die registerForAdFiltering-App-Registrierungs-API über seine App oder ein Ad-Tech-SDK mit einer Liste von eTLD+1s des Ad-Tech-Käufers auf. So können die Käufer auf der Liste und nur diese Käufer Anzeigen direkt oder über das SDK ihrer Ad-Tech-Lösung nach dem Installationsstatus der App filtern. Durch die Registrierung hat der App-Entwickler die volle Kontrolle darüber, ob seine App am Filtern von App-Installationsanzeigen 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 sie so kennzeichnen, dass sie basierend auf dem Installationsstatus einer App herausgefiltert wird. Dazu muss der Paketname der App in den Metadaten der Anzeige enthalten sein. Die Filteranfrage für Anzeigen zur App-Installation ist Teil der Anzeigeninformationen, die in den Protected Audience-Auktionsprozess einfließen. 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 App-Install-Anzeigen, sind Filterinformationen Teil der Anzeigendaten, die Käufer Verkäufern zur Verfügung stellen können, wenn sie außerhalb von Protected Audience auf ein kontextbezogenes Gebot reagieren. Protected Audience erwartet, dass Filterinformationen als Teil der kontextbezogenen Antwort zurückgegeben werden, genau wie alle anderen anzeigenspezifischen Metadaten.
  • Für den Remarketing-Anwendungsfall werden bei Protected Audience Filterinformationen in der benutzerdefinierten Zielgruppe erwartet. Es gibt zwei Möglichkeiten, wie das passieren kann: beim Beitreten der Zielgruppe und beim Abrufen neuer Zielgruppendaten im Rahmen der Aktualisierung der Zielgruppe. Die Anfrage zum Herausfiltern von App-Installationsanzeigen sollte im AdData-JSON-Objekt 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

Während 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 Verkäuferseite muss die Filterinformationen als Teil der selectAds-Funktionskonfiguration im Feld adData übergeben. Android erwartet ein Nachrichtenformat, das dem folgenden ähnelt.

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. Bei Protected Audience-Filtern wird die Anzeige herausgefiltert, wenn die in der Nachricht angegebene App mit der App in der Liste der App-Installationen des Ad-Tech-Käufers übereinstimmt. Es gibt zwei mögliche Ergebnisse:

  • Die App wird in dieser Liste nicht gefunden. Das bedeutet, dass sie nicht installiert und geöffnet wurde.
  • Die App wird in dieser Liste angezeigt. Das bedeutet, dass sie installiert und geöffnet wurde. Wenn Protected Audience erkennt, dass eine App bereits vorhanden ist, wird die Anzeige aus der Liste der Anzeigen ausgeschlossen, die für die Auktion verwendet werden, um scoreAds auszuführen.

Wichtige Aspekte bei kontextbezogenen Anzeigen

Durch das Filtern von App-Installationsanzeigen wird die Unterstützung von kontextbezogenem Filtern von Anzeigen in den Protected Audience APIs eingeführt. In Situationen, in denen die Auktion eine Mischung aus kontextbezogenen Anzeigen und Remarketing-Anzeigen ist oder nur aus kontextbezogenen Anzeigen besteht, sind einige Angaben wichtig.

  • Wenn eine selectAd-Auktion ausgeführt wird, hat der Käufer die Möglichkeit, eine Liste von ContextualAd-Objekten zu ü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 das AdData mit der tatsächlichen URL für den Anzeigeninhalt sowie eine Verifikationssignatur des Käufers (weitere Informationen finden Sie unter Signieren kontextbezogener Anzeigen). Das AdData-Format wird sowohl in kontextbezogenen Anzeigen als auch in Remarketing-Anzeigen verwendet.
  • Zu Beginn des Auktionsprozesses werden kontextbezogene Anzeigen und Remarketing-Anzeigen anhand der Gruppe von Paketnamen gefiltert, die in der AdData.adFilters.appInstallFilters.packageNames angegeben sind. Anschließend werden Gebotswerte für alle Remarketing-Anzeigen festgelegt und sowohl die Remarketing- als auch die kontextbezogenen Anzeigen werden mit der bereitgestellten scoreAds-Funktion bewertet. Die Anzeige mit der höchsten Punktzahl gewinnt. Dieser Prozess funktioniert auch, wenn keine Remarketing-Anzeigen vorhanden sind.

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

    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 Anzeigen

  • Kontextbezogene Anzeigen, die eine Filterung für App-Installationen enthalten, müssen vom Käufer signiert werden. Die Plattform verwendet diese Signatur, um die Ad-Tech-Lösung zu überprüfen, die die Anzeigen bereitgestellt hat, und um festzustellen, welche Ad-Tech-App-Installationsfilter auf die Anzeigen angewendet werden sollen. So soll verhindert werden, dass eine schädliche Ad-Tech-Lösung die Identität einer anderen Ad-Tech-Lösung verwendet, um von der Registrierung der App-Installationsfilter der anderen Ad-Tech-Lösung zu profitieren.

  • Im Rahmen der Privacy Sandbox werden diese Schlüssel vom Anzeigentechnologie-Endpunkt abgerufen, der bei der Registrierung angegeben wurde. Als Best Practice empfehlen wir, 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 der Registrierung die Verfügbarkeit des von ihnen bereitgestellten Endpunkts bestätigen. Weitere Informationen zu den erforderlichen Maßnahmen für aktuelle und neu registrierte Ad-Tech-Unternehmen finden Sie in der Registrierungsanleitung.

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