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

Der Grund für die Installation neuer Apps sind meist App-Installationsanzeigen. Wenn Sie den ROI Ihrer Werbeausgaben maximieren möchten, sollten Sie zur Installation einer App keine Anzeigen mehr auf Geräten schalten, auf denen die App bereits installiert ist. In diesem Vorschlag wird diese Vorgehensweise als "Filtern von App-Installationsanzeigen" bezeichnet.

In diesem Vorschlag wird erläutert, wie Protected Audience unter Android die kontextbezogene Anzeigenfilterung, insbesondere die Filterung von App-Installationsanzeigen, auf datenschutzfreundliche Weise unterstützt. Um teilnehmen zu können, muss in der App auf dem Gerät ausdrücklich die Filterung von App-Installationsanzeigen aktiviert werden. Bei der Anzeigenauswahl werden mögliche Anzeigen basierend auf der Liste der Apps herausgefiltert, die auf dem Gerät installiert sind und dem Anzeigentechnologie-Mitarbeiter bekannt sind.

Die Liste der installierten Apps ist nur während des Anzeigenauswahlvorgangs sichtbar und stützt sich auf die Buy-Side-Plattform, um zu signalisieren, dass eine bestimmte Anzeige gefiltert werden soll, wenn 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 von App-Installationsanzeigen zu aktivieren, ruft der App-Entwickler die registerForAdFiltering App Registration API aus seiner App oder ein AdTech SDK mit einer Liste der eTLD+1s von Käufern von Anzeigentechnologien auf. So können nur die Käufer auf der Liste und nur diese Käufer Anzeigen nach Installationsstatus der App filtern – entweder direkt oder über das SDK ihrer Anzeigentechnologie. Durch die Registrierung hat der App-Entwickler die vollständige Kontrolle darüber, ob seine App zur Filterung von App-Installationsanzeigen verwendet werden soll oder nicht. 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 kennzeichnen, die aufgrund des Installationsstatus der App herausgefiltert werden soll. Dazu wird der Paketname der App in die Metadaten der Anzeige aufgenommen. Die Anfrage zum Filtern von App-Installationsanzeigen ist Teil der Anzeigendaten, die in den Protected Audience-Auktionsprozess eingespeist werden. Die Erstellung der Anzeigendaten hängt davon ab, ob es sich um eine kontextbezogene Anzeige oder eine Remarketing-Anzeige handelt.

  • Beim Anwendungsfall „Kontextbezogene Anzeigen“ – dem Hauptanwendungsfall für das Filtern von App-Installationsanzeigen – sind Filterinformationen Teil der Anzeigendaten, die Käufer an Verkäufer weitergeben können, wenn sie auf ein kontextbezogenes Gebot außerhalb der Protected Audience antworten. Protected Audience erwartet, dass Filterinformationen im Rahmen der kontextbezogenen Antwort zurückgegeben werden, genau wie alle anderen anzeigenspezifischen Metadaten.
  • Beim Remarketing-Anwendungsfall erwartet Protected Audience, dass Filterinformationen in der benutzerdefinierten Zielgruppe enthalten sind. Es gibt zwei Möglichkeiten, diese einzubeziehen: beim Hinzufügen der Zielgruppe und beim Abrufen neuer Zielgruppendaten im Rahmen der Aktualisierung der Zielgruppe. 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: App-Installationsanzeigen während der Anzeigenauswahl herausfiltern

Während einer Anzeigenanfrage kann der Käufer mehrere Anzeigen mit Filterinformationen an den Verkäufer zurücksenden, damit Anzeigen für installierte Apps herausgefiltert werden. Der Verkäufer muss die Filterinformationen als Teil der Funktionskonfiguration selectAds im Feld adData übergeben. 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);

Das Filtern wird in der selectAds API verarbeitet. Die Protected Audience API filtert die Anzeige heraus, wenn die in der Mitteilung angegebene App mit der App in der App-Installationsliste von Anzeigentechnologie-Käufern übereinstimmt. Zwei Ergebnisse sind möglich:

  • Die App wurde in dieser Liste nicht gefunden. Das bedeutet, dass sie nicht installiert oder geöffnet wurde.
  • Die App befindet sich in dieser Liste, das heißt, sie ist installiert und geöffnet. Wenn Protected Audience feststellt, dass eine App bereits vorhanden ist, wird die Anzeige aus der Liste der Anzeigen ausgeschlossen, die in der Auktion zur Auslieferung von scoreAds verwendet werden.

Überlegungen beim Einsatz von kontextbezogenen Anzeigen

Durch das Filtern von App-Installationsanzeigen unterstützen die Protected Audience APIs nun die Filterung von kontextbezogenen Anzeigen. In Situationen, in denen die Auktion eine Mischung aus kontextbezogenen und Remarketing-Anzeigen oder ausschließlich kontextbezogene Anzeigen umfasst, sind einige Dinge wichtig.

  • Bei einer selectAd-Auktion hat der Käufer die Möglichkeit, eine Liste mit ContextualAd-Objekten zu übergeben. Diese Objekte enthalten die eTLD+1 des Käufers, das Gebot für die Anzeige, eine URL, die auf die Berichtslogik für die Anzeige verweist, die AdData mit der eigentlichen URL des Anzeigeninhalts sowie eine Bestätigungssignatur des Käufers. Weitere Informationen finden Sie unter Signieren von kontextbezogenen Anzeigen. Das Format AdData wird sowohl für Kontext- als auch für Remarketing-Anzeigen verwendet.
  • Zu Beginn des Auktionsprozesses werden kontextbezogene Anzeigen und Remarketing-Anzeigen anhand der Paketnamen gefiltert, die in der AdData.adFilters.appInstallFilters.packageNames enthalten sind. Anschließend werden die Gebotswerte für alle Remarketing-Anzeigen bestimmt und sowohl die Remarketing- als auch die kontextbezogene Anzeige wird mithilfe der bereitgestellten scoreAds-Funktion bewertet. Die Anzeige mit der höchsten Punktzahl gewinnt. Dieser Vorgang funktioniert auch dann, wenn keine Remarketing-Anzeigen vorhanden sind.

  • Wenn eine kontextbezogene Anzeige die Auktion gewinnt und durch die App Impressionsberichte ausgelöst werden, lädt Protected Audience eine JS-Funktion namens reportWin() aus der Berichts-URL in den kontextbezogenen Anzeigendaten herunter und führt sie aus. Dies ähnelt der Berichterstellung für eine Remarketing-Anzeige, die 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 Anzeigensignierung

  • Kontextbezogene Anzeigen, die nach App-Installationen gefiltert werden, müssen vom Käufer signiert sein. Die Plattform verwendet diese Signatur, um das AdTech-Unternehmen zu überprüfen, das die Anzeigen bereitgestellt hat, und um zu prüfen, welche AdTech-App-Installationsfilter auf die Anzeigen angewendet werden sollen. Damit soll verhindert werden, dass böswillige Anzeigentechnologien die Identität eines anderen Anzeigentechnologie-Anbieters nutzen, um von der Registrierung des App-Installationsfilters der anderen Anzeigentechnologie zu profitieren.

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

  • Bei der Privacy Sandbox werden Anzeigentechnologie-Anbieter während der Registrierung aufgefordert, die Verfügbarkeit des bereitgestellten Endpunkts zu bestätigen. Weitere Informationen zu den Maßnahmen, die für aktuelle und neu registrierte Anzeigentechnologien erforderlich sind, finden Sie in der Registrierungsanleitung.

  • Ein Entwicklerleitfaden mit einer ausführlichen Anleitung zur Implementierung wird demnächst veröffentlicht.