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

<ph type="x-smartling-placeholder">

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. von ContextualAd 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 die AdData 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 Format AdData 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 Funktion scoreAds 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.