Bereitstellen von benutzerrelevanten Anzeigen mit der Anzeigenauswahl-API

Die Anzeigenauswahl-API stellt benutzerrelevante Anzeigen auf Ihrer Website bereit, ohne Cookies von Drittanbietern zu verwenden.

Ausführlicher Inhalt:

• Einführung
• Nachweisregistrierung und Alpharegistrierung
  • Wann und wo ist die Vorschau verfügbar?
  • Flags für Tests
  • Registrierungs- und Nachweisanforderungen und -prozess
  • JSON-Beispieldatei
    • Wichtige Felder und Werte
• Bereitstellen der Ad Selection-API-Dienste
  • Images für die Bereitstellung von Diensten
  • Dienstleistungen für Verkäufer
  • Dienstleistungen für Käufer
  • Benutzerdefinierte Funktionen
    • Benutzerdefinierte Funktionen für Verkäufer
    • Benutzerdefinierte Funktionen für Käufer
  • Bereitstellungshandbuch
• Verwenden der Anzeigenauswahl-API auf Ihrer Website
• Bereitstellen von Feedback zur Ursprungstestphase
• Nutzungsbedingungen
• Nachtrag zum Datenschutz
• Siehe auch

Einführung

Die Anzeigenauswahl-API stellt benutzerrelevante Anzeigen auf Ihrer Website bereit, ohne Cookies von Drittanbietern zu verwenden.

Die Anzeigenauswahl-API kann verwendet werden von:

• Verkäufer , die eine angebotsseitige Plattform (Supply-Side Platform, SSP) ausführen, die die API verwenden können, um ihren Herausgebern qualitativ hochwertigere Anzeigen bereitzustellen.

• Käufer , die eine nachfrageseitige Plattform (Demand-Side Platform, DSP) betreiben, die die API verwenden können, um die Effektivität von Werbekampagnen zu verbessern.

Um mit der Verwendung der Anzeigenauswahl-API zu beginnen und den End-to-End-Flow zu testen, registrieren Sie sich für die eingeschränkte Vorschau der Anzeigenauswahl-API.

Als Verkäufer, der eine angebotsseitige Plattform betreibt, oder ein Käufer, der eine nachfrageseitige Plattform betreibt, verwenden Sie diesen Leitfaden für:

• Stellen Sie benutzerrelevante Anzeigen mit der eingeschränkten Vorschau der Ad Selection-API bereit, indem Sie sich für die Ursprungstestversion registrieren.
• Schließen Sie den API-Nachweis ab, indem Sie ihre JSON-Datei für Nachweise veröffentlichen.
• Richten Sie eine Evaluierungsumgebung mit einem unterstützten Cloudanbieter ein.
• Sehen Sie sich die Dokumentation zur Anzeigenauswahl-API an.
• Bereiten Sie Ihre User-Defined Functions (UDFs) vor.
• Stellen Sie Ihre Dienste in Azure bereit.
• Testen Sie die Anzeigenauswahl-API auf Ihrer Website.

Siehe auch:

• Übersicht über die Anzeigenauswahl im privacy-preserving-ads Repository.

Nachweisregistrierung und Alpharegistrierung

Wann und wo ist die Vorschau verfügbar?

Microsoft Edge-Versionen ab 130.0.2808.0 unterstützen die Anzeigenauswahl-API in einer eingeschränkten Vorschauversion für Entwickler außerhalb des Europäischen Wirtschaftsraums (EWR) und des Vereinigten Königreichs (UK).

Flags für Tests

Um die Features der Ad Selection-API-Plattform auf Ihrem Entwicklercomputer zu ändern, verwenden Sie die Testflags der Ad Selection-API unter edge://flags#edge-ad-selection-api:

Das Api-Flag "Anzeigenauswahl" aktiviert die Anzeigenauswahl-API und die zugehörigen Features, z. B.:

• Zuordnungsberichte.
• Eingezäunte Rahmen.
• Freigegebener Speicher.
• Private Aggregation.

Registrierungs- und Nachweisanforderungen und -prozess

Entwickler, die an Alphatests interessiert sind, können an der Ursprungstestversion für die Anzeigenauswahl-API teilnehmen. Diese Ursprungstestversion ermöglicht end-to-End-Tests von Ad Selection-API-Features, die sowohl die API-Nutzung als auch die Bereitstellung sicherer Containerimages abdecken.

Füllen Sie für jede Domäne der obersten Ebene, die Sie mit der Anzeigenauswahl-API verwenden möchten, das Registrierungsformular für die Ursprungstestregistrierung für diese Domäne aus, und senden Sie dann das Formular.

So registrieren Sie sich für die Ad Selection-API-Ursprungstest für eine Domäne:

1. Führen Sie zunächst die Schritte unter Testen experimenteller APIs und Features mithilfe von Ursprungstests aus.

2. Erstellen Sie dann eine Datei mit dem Namen ad-selection-attestations.json, und hosten Sie die Datei in der Domäne der /.well-known/ obersten Ebene im Verzeichnis. Zum Beispiel:

   https://contoso.example/.well-known/ad-selection-attestations.json

   Die ad-selection-attestations.json Datei muss innerhalb von 30 Tagen nach Erhalt des OT-Tokens veröffentlicht werden. Das Hosten dieser JSON-Datei ist erforderlich, um den Nachweis abzuschließen und Ihrem Code den Zugriff auf die Anzeigenauswahl-API zu ermöglichen, um die Anzeigenauswahl-API mit unterstützten Microsoft Edge-Clients zu testen.

JSON-Beispieldatei

Die JSON-Datei des Nachweises muss den Namen haben ad-selection-attestations.jsonund den folgenden Standards entsprechen. Es folgt ein Beispiel für eine ad-selection-attestations.json Datei:

{
    "ad_selection_api_attestations": [
        {
            "attestation_parser_version": "2",
            "attestation_version": "2",
            "privacy_policy": [
                "https://contoso.example/privacy/"
            ],
            "ownership_token": "<Your Unique Token Here>",
            "enrollment_site": "https://contoso.example/",
            "platform_attestations": [
                {
                    "platform": "edge",
                    "attestations": {
                        "ad_selection_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "attribution_reporting_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "shared_storage_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        },
                        "private_aggregation_api": {
                            "ServiceNotUsedForIdentifyingUserAcrossSites": true/false
                        }
                    }
                },
                {
                    "platform": "android",
                    "attestations": {}
                }
            ]
        }
    ]
}

Wichtige Felder und Werte

• Die ad-selection-attestations.json Datei muss das Ursprungstesttoken enthalten, das für diese Domäne der obersten Ebene generiert und an Sie gesendet wurde. "ownership_token": ist das Ursprungstesttoken, das beim Registrieren dieser Domäne für die Testversion des Ad Selection-API-Ursprungs generiert wurde.

• "platform_attestations": Im Abschnitt "platform": muss oder "android"sein"edge".

• Die Datei muss eine Liste von APIs (Features, die der Ad Services-API zugeordnet sind) enthalten. "platform_attestations": Im Abschnitt sind die folgenden gültigen Elemente von"attestations"::

  • "ad_selection_api": – Die Haupt-API für private Auktionslogik.
  • "attribution_reporting_api": – Zuordnungsberichte.
  • "shared_storage_api": – Freigegebener Speicher.
  • "private_aggregation_api": – Private Aggregation.
  • Voraussetzungen:
    • Jeder "..._api": Eintrag muss ein einzelnes Feld ( "ServiceNotUsedForIdentifyingUserAcrossSites":) mit einem - oder false -trueWert aufweisen. true bedeutet, dass dieser Dienst nicht für die standortübergreifende Identifizierung des Benutzers verwendet wird. false bedeutet, dass dieser Dienst verwendet wird, um den Benutzer websiteübergreifend zu identifizieren.

Bereitstellen der Ad Selection-API-Dienste

Die Ad Selection-API verwendet eine vertrauenswürdige Ausführungsumgebung (Trusted Execution Environment, TEE), um ein Maß an Sicherheit für Datenintegrität, Datengeheimnis und Codeintegrität bereitzustellen. Siehe Confidential Computing: Hardware-Based Vertrauenswürdige Ausführung für Anwendungen und Daten. Dienste, die von der Anzeigenauswahl-API bereitgestellt werden, müssen in einer TEE ausgeführt werden, um die von diesen Diensten verwendeten Daten zu schützen.

Ad Selection Services, die in einer TEE ausgeführt werden, sollten auf einer Cloudplattform bereitgestellt werden, die die erforderlichen Sicherheitsfeatures unterstützt. Zunächst können Dienste in Azure mithilfe vertraulicher ACI-Container bereitgestellt werden. Weitere Informationen finden Sie unter Vertrauliche Container auf Azure Container Instances.

Die Anzeigenauswahl-API bietet verschiedene Dienste, die von Verkäufern oder Käufern bereitgestellt werden müssen.

Images für die Bereitstellung von Diensten

Fügen Sie Ihre User-Defined Functions (UDFs) innerhalb der bereitgestellten Images von Diensten hinzu. Die User-Defined Functions kann benutzerdefinierte Geschäftslogik ausführen. Die User-Defined Functions werden in privaten Containern innerhalb der bereitgestellten Dienste ausgeführt.

Jedes Image definiert einen Dienst. Einige Bilder enthalten keine UDFs und bestehen vollständig aus vordefiniertem Code. Einige Bilder enthalten UDFs als Funktionen mit einem leeren Text oder Startercode, die die relevanten User-Defined Functions für diesen Dienst sind. Füllen Sie die Textkörper der User-Defined Functions in diesen Bildern mit Ihrem eigenen benutzerdefinierten Code aus.

Microsoft stellt für jeden Dienst ein Image bereit, das auf einem Cloudanbieter bereitgestellt werden kann. Dies sind die öffentlichen Images, die für die Bereitstellung verwendet werden müssen. Nur offizielle Bilder von Microsoft können private Auktionen durchführen.

Images für die Bereitstellung:

• Verkäufer
  • Front-End-Dienst für Den Verkäufer für die Anzeigenauswahl
  • Anzeigenauswahl-Auktionsdienst
• Käufer
  • Ad Selection Buyer Front-End-Service
  • Anzeigenauswahl-Gebotsdienst
  • Anzeigenauswahl K-Anonymitätsdienst
• Verkäufer und Käufer
  • Schlüsselwertdienst für die Anzeigenauswahl

Dienstleistungen für Verkäufer

Dienstleistungen für Käufer

Benutzerdefinierte Funktionen

Verkäufer und Käufer müssen ihren eigenen benutzerdefinierten Code als User-Defined Functions (UDFs) bereitstellen, die in privaten Containern innerhalb der bereitgestellten Dienste ausgeführt werden. Diese User-Defined Functions können benutzerdefinierte Geschäftslogik ausführen.

Jeder Käufer oder Verkäufer kann mehrere Instanzen eines bestimmten Diensts bereitstellen, z. B.:

• SellerFrontEnd und Auction.
• BuyerFrontend, Gebot und K-Anonymität.

Einige dieser Dienste verwenden eine Eingabe, bei der es sich um ein JavaScript-Worklet handelt, das User-Defined Functions definiert.

User-Defined-Funktionen für Verkäufer

User-Defined-Funktionen für Käufer

Bereitstellungshandbuch

So stellen Sie den Ad Selection-API-Dienst in Azure bereit:

1. Erstellen Sie ein Azure-Konto, und erstellen Sie ein Abonnement bei Microsoft Azure.

2. Wählen Sie die Option Vertrauliche ACO-Container aus .

3. Wechseln Sie in einem neuen Fenster oder einer neuen Registerkarte zu Terraform-Bereitstellungsskripts , laden Sie die Terraform-Bereitstellungsskripts herunter, und zeigen Sie die Bereitstellungsdokumentation an. Hinweis: Stellen Sie sicher, dass der Hash des heruntergeladenen Images mit dem Hash im heruntergeladenen Skript übereinstimmt.

4. Die Terraform-Skripts enthalten bereits Links zu öffentlichen Images, die von Microsoft bereitgestellt werden. Wählen Sie die erforderlichen Dienste aus, und stellen Sie sie bereit, indem Sie die Schritte im enthaltenen readme.mdausführen.

   1. Legen Sie bestimmte Flags für Ihre Umgebung fest, einschließlich der Speicherorte von Auktionsarbeitslets.

   2. Konfigurieren Sie alle Voraussetzungen, und bereiten Sie alle Tools für die Bereitstellung vor.

   3. Erstellen Sie Azure Ressourcen, und führen Sie das Terraform-Skript aus, das die Bereitstellung abgeschlossen hat.

5. Entwickeln Sie Worklets einschließlich user-defined-function (UDF), und starten Sie Ad Selection API-Dienste.

Verwenden der Anzeigenauswahl-API auf Ihrer Website

Um mit der Verwendung der Anzeigenauswahl-API zu beginnen, müssen Verkäufer und Käufer den JavaScript-Code ihrer Websites ändern, der ausgeführt wird, wenn der Browser Microsoft Edge ist.

• Verkäufer: Um private Auktionen durchzuführen, Interessengruppen abzurufen und Berichte zu erstellen, aktualisieren Sie Ihren Code auf den Websites der Herausgeber.

• Käufer: Um Interessengruppen zu erstellen und im Browser zu speichern, aktualisieren Sie den Code auf den Websites Ihrer Werbepartner. Sie können den Delegierungsmechanismus verwenden, um die Erstellung von Interessensgruppen in Domänen von Drittanbietern einzuschränken und zuzulassen.

Weitere Informationen zu den verfügbaren API-Methoden und zum Anzeigen von Beispielcode finden Sie unter Details zur Anzeigenauswahl-API.

Bereitstellen von Feedback zur Ursprungstestphase

Um Feedback zur Testversion der Ad Selection-API zu geben, erstellen Sie ein neues Issue im WICG/privacy-preserving-ads-GitHub-Repository:

• Um vorhandene Probleme anzuzeigen, wechseln Sie zur Registerkarte Probleme des WICG/privacy-preserving-ads-Repositorys.

• Um ein neues Issue zu übermitteln, wechseln Sie zum Formular für das neue Problem.

Nutzungsbedingungen

Weitere Informationen finden Sie unter Nutzungsbedingungen für die Anzeigenauswahl-API.

Nachtrag zum Datenschutz

Informationen zur Ad Selection-API finden Sie unter Datenschutz-Nachtrag.

Siehe auch

Ursprungstests:

• Registrierung der Ad Selection-API-Ursprungstestversion in Microsoft Edge
• Testen experimenteller APIs und Features mithilfe von Ursprungsversuchen

Entwurfs- und technische Dokumente:

• Übersicht über die Anzeigenauswahl
• Api-Vorschlag für die Anzeigenauswahl
• Details zur Anzeigenauswahl-API

Images für die Bereitstellung:

• Verkäufer
  • Front-End-Dienst für Den Verkäufer für die Anzeigenauswahl
  • Anzeigenauswahl-Auktionsdienst
• Käufer
  • Ad Selection Buyer Front-End-Service
  • Anzeigenauswahl-Gebotsdienst
  • Anzeigenauswahl K-Anonymitätsdienst
• Verkäufer und Käufer
  • Schlüsselwertdienst für die Anzeigenauswahl

Bereitstellungsskripts:

• Terraform-Bereitstellungsskripts

Vertrauenswürdige Ausführungsumgebung (Trusted Execution Environment, TEE):

• Confidential Computing: Hardware-Based vertrauenswürdige Ausführung für Anwendungen und Daten

Azure:

• Microsoft Azure
• Vertrauliche Container auf Azure Container Instances