Versionshinweise zur Privacy Sandbox für Android

Die Privacy Sandbox für Android bietet Entwicklervorschau- und Betaprogramme. Wir werden neue APIs und Funktionen in der Entwicklervorschau einzuführen und stabilisierten APIs für das Betaprogramm. Wir freuen uns über Feedback.

Wenn Sie die Privacy Sandbox für Android noch nicht kennen, beginnen Sie mit dem Programm Übersicht. Wenn Sie die Privacy Sandbox in Ihr Projekt einbinden möchten, Richte deine Entwicklungsumgebung ein und lade die Privacy Sandbox für Android herunter. auf Ihrem Testgerät oder Emulator.

Aktuelle Releases

Vorschau für Android VanillaIceCream

Protected Audience API

  • Die Möglichkeit, authentifizierte kontextbezogene Anzeigen an eine geschützte Auktion zu übergeben, wurde hinzugefügt. Dazu gehören auch Negativfilter für Apps, die bereits auf sowie das Frequency Capping für die Anzahl der Klicks, Impressionen, Aufrufe oder gewinnt. Die Implementierung unterscheidet sich von vorherigen Iterationen, da die Anzeigen müssen von der Anzeigentechnologie unterzeichnet werden. Weitere Informationen zur Implementierung finden Sie im Entwicklerleitfaden.
  • ContextualAds wurden in SignedContextualAds umbenannt und die zugehörigen Getter- und setter in AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Wenn eine nicht authentifizierte kontextbezogene App übergeben wurde, wird sie aus dem Auktion

Attribution Reporting API

Privacy Sandbox für Android – Betaupdate vom November 2023

Diese Betaversion der Privacy Sandbox für Android enthält Updates für die Privacy Sandbox APIs auf öffentlichen Android 14-Geräten Das SDK und die Geräte-Images sind mit dem SDK-Manager von Android Studio als Android API 34, Erweiterungsebene 10 und ähnelt in ihrer Funktion der Entwicklervorschau 9 mit einigen wichtigen Änderungen.

Protected Audience API

  • Anzeigentechnologie-Anbieter können jetzt die benutzerdefinierte Zielgruppendelegierung verwenden, um einer benutzerdefinierten Zielgruppe im Namen eines Käufers, der keine Gerätepräsenz hat.
  • Android unterstützt jetzt die Ausführung von Auktionen über Gebots- und Auktionsdienste.
  • Protected Audience-Auktionen unterstützen die CPC-Abrechnung.
  • In Protected Audience-Auktionen und ‐Berichten werden jetzt Header für Datenversionen unterstützt für vertrauenswürdige Bidding-Signale.
  • Protected Audience-Auktionen unterstützen das Filtern mit Frequency Capping für WIN-Ereignisse.
  • Unterstützung für Protected Audience Integration in die Attribution Reporting API

Attribution Reporting API

SDK-Laufzeit

  • Möglichkeit, andere SDKs innerhalb der SDK-Laufzeit zu laden, die vom SDK unterstützt werden Anwendungsfälle der Vermittlung

Frühere Versionen

Entwicklervorschau 10

Releasedatum: 19. Dezember 2023

Bekannte Einschränkungen

  • Es gibt ein Problem, das dazu führt, dass Google Play-Dienste in der Hintergrundinformationen zu erhalten, und die Nutzenden informieren: <ph type="x-smartling-placeholder">
      </ph>
    • Ein Neustart des Geräts kann dieses Problem beheben.
    • Falls beim Testen Probleme mit der Zeitüberschreitung bei asynchronen Aufrufen auftreten, Versuchen Sie, den folgenden ADB-Befehl hinzuzufügen, um den Grenzwert bis Timeout:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Nur physisches Gerät: Das Hinzufügen eines Google-Kontos wird nicht unterstützt. Folgen So bringen Sie das Gerät zum Startbildschirm: <ph type="x-smartling-placeholder">
      </ph>
    • Installieren Sie das Vorschaubild auf dem Smartphone.
    • Folgen Sie den Einrichtungsassistenten, ohne eine WLAN- oder mobile Datenverbindung herzustellen.
    • Stellen Sie auf dem Startbildschirm eine WLAN- oder mobile Datenverbindung her.
    • Starten Sie das Gerät neu.

Protected Audience API

  • Wir führen neue Funktionen ein: [Geschützte App-Signale][dp98], damit relevante App-Installationsanzeigen ausgeliefert werden können. Mit diesem DP stellen wir APIs für AdTechs: <ph type="x-smartling-placeholder">
      </ph>
    • Sie können Signale auswählen, indem Sie App-Ereignisse in einem geschützten Gerätespeicher speichern, werden zur Auslieferung relevanter App-Installationsanzeigen verwendet.
    • Geschützte Auktion für Gebots- und Auktionsdienste ausführen, die in vertrauenswürdige Ausführungsumgebungen, in denen sie auf ihre jeweiligen Signale zugreifen können zur Unterstützung bei der Anzeigenauswahl und bei der Gebotsabgabe.

Attribution Reporting API

  • Diese Version der Attribution Reporting API: <ph type="x-smartling-placeholder">
      </ph>
    • Fügt eine Protected Audience-Integration für eine benutzerdefinierte Zielgruppe hinzu Dimensionen in zusammengefassten Zusammenfassungsberichten.
    • Unterstützt Google Cloud Provider als TEE für den Aggregationsdienst.
    • Fügt das Feld „shared_debug_key“ hinzu, um das Debugging für netzwerkübergreifendes Arbeiten zu unterstützen ohne Weiterleitungen.
    • Fügt Versions-Header in ausführlichen Debugging-Berichtsanfragen hinzu.

On-Device-Personalisierung

  • Erste Version für Forscher und frühzeitige Entwicklung.
  • Die On-Device-Personalisierung bietet eine innovative Möglichkeit, Produkte anzupassen und Dienste bieten und gleichzeitig den Datenschutz für Endnutzer verbessern. Auf dem Gerät Personalisierung bietet eine Reihe von Diensten und Algorithmen als Bausteine dies zu erreichen, einschließlich, aber nicht beschränkt auf: <ph type="x-smartling-placeholder">
      </ph>
    • Föderiertes Computing (Federated Compute, FC), das Training, Auswertung und Personalisierung ermöglicht mithilfe von föderiertem Lernen modellieren. Verwendung von „Federated“ durch die On-Device-Personalisierung Die Berechnung basiert auf dem Modelltraining und (optional, bei Bedarf) Inferenz.
    • Kuckuck-Filter-basierte Zuordnung und Kreuzabgleich zwischen Daten, die sich nicht befinden.
    • Differential Privates (DP)-Training von dünnbesetzten Modellen unter Verwendung neuer Techniken wie z. B. DP Alternating Minimization (für das Training Daten) und die Modellpersonalisierung unter Billboard DP.

Entwicklervorschau 9

Freigabedatum: 15. August 2023

Bekannte Einschränkungen

  • Auktionsdaten, die durch den Aufruf der Bidding and Auktion API generiert wurden, werden nicht gelöscht automatisch in DP9.
  • getAdSelectionData und persistAdSelectionResult werden aufgerufen, wenn die Einwilligung erteilt wurde zum Absturz des Prozesses führt.
  • Die Negativfilterfunktion kann nicht mit getAdSelectionData verwendet werden und persistAdSelectionResult.

Protected Audience API

Attribution Reporting API

  • In dieser Version wurden die Fehlerbehebungsberichte für die Attribution Reporting API um folgende Verbesserungen verbessert: <ph type="x-smartling-placeholder">
      </ph>
    • Ausführliche Fehlerbehebungsberichte, die von im Web.
    • Debug-Berichte zur Web- und App-Attribution aktivieren (AdId erforderlich für beide Web- und App-Registrierung).
  • AdTech-Teams können Rauschparameter für verschiedene Berichtsszenarien konfigurieren.
  • In dieser Version wird die ursprungsbasierte Attribution eingeführt. Das bedeutet: <ph type="x-smartling-placeholder">
      </ph>
    • Der Ursprung wird für die Registrierung verwendet.
    • Für eine einzige Website werden mehrere Ursprünge akzeptiert.
    • Eine neue Ratenbegrenzung von einem Ursprung pro Quell-App oder -registrierung.
  • Anzeigentechnologie-Anbieter können jetzt die Anmeldung zum Testen der Verwendung von Attribution Reporting deaktivieren Fälle lokal zu verwalten.

SDK-Laufzeit

  • Das SDK kann nur eine Zulassungsliste mit Diensten starten oder eine Bindung an eine solche Liste vornehmen.
  • Das SDK kann nur auf einen Teil des Systems ContentProvider zugreifen (z. B. als com.android.providers.settings.SettingsProvider), wobei Daten keine Kennungen und kann nicht zur Erstellung eines Fingerabdrucks des Nutzers verwendet werden. Diese Überprüfungen gelten auch für den Zugriff auf ContentProvider mit ContentResolver.
  • Das SDK kann nur auf eine Untergruppe von Protected Broadcast Receivern zugreifen, z. B. als android.intent.action.AIRPLANE_MODE).
  • Das SDK kann eine Aktivität starten, die zu einer anderen App gehört, aber mit Einschränkungen was im Intent gesendet werden kann.

Privacy Sandbox für Android (Beta) vom März 2023

Die Betaversion der Privacy Sandbox für Android vom März 2023 enthält Updates Privacy Sandbox APIs auf öffentlichen Android 13-Geräten. Diese Version umfasst Ad Services Extensions 5 APIs und ähnelt in ihrer Funktion der Entwicklervorschau 6 mit einigen wichtigen Änderungen.

Bekannte Einschränkungen

  • Der Hintergrundabrufjob, der regelmäßig ausgeführt wird, um benutzerdefinierte FLEDGE-Anwendungen zu aktualisieren Zielgruppen den Vorgang zum Absturz bringen. Aus diesem Grund ist FLEDGE ist standardmäßig deaktiviert.

Allgemein

  • Ab dieser Version können Sie die Attribution Reporting API verwenden. Die API war zuvor deaktiviert. Wenn Sie die Attribution Reporting API in der vorherigen Version Betarelease: Lösche deine App- oder Gerätedaten, bevor du diesen Betarelease verwendest mit einem der folgenden Schritte: <ph type="x-smartling-placeholder">
      </ph>
    • Rufen Sie auf einem Gerät oder Emulator die Einstellungen auf und löschen Sie die App-spezifischen Speicher (nicht nur Cache) für alle zum Testen verwendeten Apps.
    • Setzen Sie Ihr physisches oder emuliertes Gerät auf die Werkseinstellungen zurück.
    • Führen Sie für ein emuliertes Gerät die Funktion Daten löschen aus.
  • Attribution Reporting unterstützt jetzt Schlüssel zur Fehlerbehebung, mit denen Entwickler erhalten Sie unveränderte Berichte und erweiterte Datenschutzberichte aus der Attribution der API erstellen. Debug-Schlüssel bieten eine Möglichkeit, einen besseren Überblick darüber zu erhalten, Berichte sind während der Umstellung auf die Privacy Sandbox strukturiert.
  • In Attribution Reporting ist vor Kurzem ein Fehler bei der Anzeige aufgetreten. Dienste, bei denen registerSource und registerTrigger fehlschlagen würden mit Ausnahmen. Wenn diese Probleme während der Entwicklung aufgetreten sind, wurde eine Lösung und diese Probleme sollten im Laufe der Zeit behoben sein.
  • Die Topics API-Vorschaufunktion ist jetzt gleichwertig mit der Privacy Sandbox auf Android-Entwicklervorschauen Ein Topics API-Aufrufer kann Themen in der Vorschau anzeigen, ohne den Topic Retrieval-Aufruf in die wöchentliche Epochenberechnung ein, sich auf die Liste der beobachteten Themen für den Aufrufer auswirken. Weitere Informationen finden Sie im shouldRecordObservation.

  • Wenn Sie Tests in FLEDGE unter Android aktivieren möchten, registrieren Sie sich für die Betaversion und melden Sie sich mit demselben Google-Konto in Ihrem Testgeräte. Andernfalls führen Versuche, APIs aufzurufen, IllegalStateException mit der Meldung „Der Dienst ist nicht verfügbar“ angezeigt. FLEDGE sollte mit der nächsten Betaversion reaktiviert werden.

    In der Zwischenzeit können Tests mit Entwicklervorschauen fortgesetzt werden. wird empfohlen und FLEDGE kann auf Geräten mit den folgenden Betriebssystemen manuell aktiviert werden: Warnungen:

    Sie können FLEDGE mit den folgenden ADB-Befehlen aktivieren. Dies führt jedoch dazu, Der Abruf im Hintergrund stürzt ab, was sich negativ auf den Systemzustand auswirkt. Messwerte. Dies ist keine dauerhafte Lösung, da diese Werte vom Plattform.

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

Frühere Versionen

Entwicklervorschau 8

Releasedatum: 23. Mai 2023

Bekannte Einschränkungen

  • Filter vom Typ „WIN“ für Frequency Capping können der geschützten Zielgruppe hinzugefügt werden Anzeigen verwenden, wird der Typ WIN noch nicht unterstützt und der Filtertyp ist ignoriert.
  • Um erfolgreiche Impressionen an erfolgreiche Käufer der Protected Audience API zu senden müssen Käufer bei der Privacy Sandbox registriert sein. Diese Anforderung kann nicht überschrieben werden.
  • Auf die Privacy Sandbox-Einstellungen auf einem Gerät mit der Privacy Sandbox zugreifen rufen Sie Einstellungen > Google > Anzeigen > Privacy Sandbox
  • Projekte mit Emulatoren können unter Android Studio Giraffe nicht bereitgestellt werden. Andere Versionen von Android Studio problemlos funktionieren. Eine Fehlerkorrektur wird in Android Studio eingeführt Giraffe am 26. Mai 2023.

Protected Audience API

Attribution Reporting API

  • OR-Triggerfilter wurden hinzugefügt. Das bedeutet, dass Filter jetzt aus einer Filtergruppe bestehen, eine Liste von Filterzuordnungen. Wenn keine der Filterzuordnungen in der Gruppe übereinstimmt die Filterdaten der Quelle enthält, wird das Objekt event_trigger_data ignoriert.
  • Ablauf von Impressionen und Berichtsfenster für Aggregation und Ereignisebene APIs wurden entkoppelt.
  • Unterstützung für Deduplizierungsschlüssel in aggregierten Berichten wurde hinzugefügt.
  • scheduled_report_time wurde den Ereignisberichten hinzugefügt, um es der Datenschutzrichtlinie zu entsprechen Sandbox for Web
  • Netzwerkübergreifende Attribution ohne Weiterleitungen

SDK-Laufzeit

Entwicklervorschau 7

Releasedatum: 26. Januar 2023

FLEDGE in der Android API

  • Der Parameter custom_audience_signals wurde wie folgt umbenannt JavaScript-Methoden: <ph type="x-smartling-placeholder">
      </ph>
    • generateBid() wurde in custom_audience_bidding_signals umbenannt.
    • scoreAd() wurde in custom_audience_scoring_signals umbenannt.
    • reportWin() wurde in custom_audience_reporting_signals umbenannt.
  • In diesem Release wird eine neue selectAds-Überschreibung hinzugefügt, AdSelectionFromOutcomeConfig zum Vergleich von selectAds-Ergebnissen. Dies ermöglicht AdTech SDKs, die diese API zur Ausführung der abfolgebasierten Vermittlung nutzen. Mehr Details finden Sie im Entwicklerleitfaden.
  • Die selectAds() API unterstützt jetzt Caching für Gebots- und Bewertungslogik JavaScript, das während der Anzeigenauswahl abgerufen wird.
    • Der Cache kann mit Cache-Control-Headern gesteuert werden, die vom Servers während des JavaScript-Abrufaufrufs an. no-cache oder no-store für Folgendes verwenden: verhindern, dass JavaScript-Antworten im Cache gespeichert werden, und "max-age", um die Cache-Dauer.
    • Der aktuelle Cache-Eintrag max-age ist standardmäßig auf zwei Tage festgelegt.

Attribution Reporting API für die Android API

  • In dieser Version werden Verkettungs-Weiterleitungen für registerSource() und registerTrigger() Der API-Nutzer kann nun eine HTTP-Weiterleitung als Serverantwort verwenden.

Erste Betaversion, Januar 2023

Releasedatum: 9. Januar 2023

Privacy Sandbox für Android Beta 1 ist die erste Verfügbarkeit von Privacy Sandbox Sandbox APIs auf öffentlichen Geräten und fügt Verbesserungen in den unten aufgeführten Bereichen hinzu.

Allgemein

  • Die Privacy Sandbox für Android Beta 1 entspricht funktional der Entwicklerversion Vorschau 5 mit einigen zusätzlichen Funktionen und Einschränkungen (siehe unten).
  • Entwickler müssen einen Registrierungsprozess durchlaufen, um anzeigenbezogene APIs (einschließlich Topics, FLEDGE und Attribution Reporting) Anmeldung Die Entwickleridentität wird überprüft und die erforderlichen entwicklerspezifischen Daten werden erfasst. durch die APIs.
  • Mit der Betaversion 1 der Privacy Sandbox für Android erhalten, wenn Sie angemeldet sind und Details auf die Zulassungsliste eingereicht haben. auf ihren eigenen physischen Geräten testen. Für die Entwicklung mit stabilen APIs in der veröffentlicht haben, laden Sie die neue SDK Ad Services Extensions 4 herunter.

Topics API

Attribution Reporting API

  • Attributionsberichte wurden deaktiviert und steht in diesem Veröffentlichung. Der Zugriff auf diese API sollte mit der nächsten Betaversion wieder aktiviert werden. Wir empfehlen dir, weiterhin mit Entwicklervorschauen zu testen.

SDK-Laufzeit

Die folgenden Einschränkungen werden voraussichtlich in der nächsten großen Android-Version Plattformrelease:

  • Das Anzeigen-Rendering in einer scrollbaren Ansicht wie RecyclerView nicht richtig funktioniert. Wenn die Größe des Elements angepasst wird, kann es zu Verzögerungen kommen. Nutzer Scroll-Ereignisse vom Typ „Touch“ werden nicht ordnungsgemäß an die Laufzeit übergeben.
  • Das Rendering von „WebView“ ist im SDK-Laufzeitprozess nicht verfügbar.
  • SDK-basierter Speicher ist nicht verfügbar.
  • Die Unterstützung für die APIs getAdId und getAppSetId ist noch nicht aktiviert.

Entwicklervorschau 6

Freigabedatum: 31. Oktober 2022

Privacy Sandbox in der Android-Entwicklervorschau 6 verbessert die folgenden Bereichen:

Allgemein

  • Zur Vorbereitung auf die Produktionseinführung wurde in der Entwicklervorschau 6 ein Flag , um den datenschutzfreundlichen API-Zugriff standardmäßig zu deaktivieren. Zu Testzwecken Aktivieren Sie den datenschutzfreundlichen API-Zugriff in der Entwicklervorschau, indem Sie den folgenden Befehl:

    adb shell device_config put adservices global_kill_switch false

  • Für die APIs AdIdManager und AppSetIdManager sind Google Play-Dienste erforderlich Version 22.36.16 oder höher.

    • Überprüfen Sie bei einem Android-Gerät, ob die richtige Version unter Einstellungen > Apps > Google Play-Dienste.
    • Wenn du die Google Play-Dienste auf die richtige Version aktualisieren musst, melde dich an auf deinem Android-Testgerät oder -Emulator mit einem Google-Konto. Gehen Sie dann Google Play Store > Profilsymbol > Einstellungen > Über. Klicken Sie im Bereich Play Store-Version auf Play Store aktualisieren.
    • Dieser Schritt gilt nur für die Entwicklung und das Testen. nach der Einführung der Privacy Sandbox für öffentliche Nutzer erforderlich.

Topics API

  • Eine Preview API wurde hinzugefügt, mit der Sie einstellen können, ob sich getTopics als als Beobachter.
  • Geringfügige Änderungen am Initialisierungscode für die Klasse GetTopicsRequest.
  • Integrationsleitfaden für Topics veröffentlicht.

FLEDGE in der Android API

  • Wenn Sie Tests mit echten Servern durchführen, wird die Aktivierung der API jetzt erzwungen. Folgen Sie dieser Anleitung, um Ihr Gerät zu konfigurieren. Diese Schritte sind nicht erforderlich, wenn Sie die Remote-Überschreibungen verwenden, die in der Beispiel-App.
  • Funktionsgefährdende Änderungen: <ph type="x-smartling-placeholder">
      </ph>
    • Url in Parametern durch Uri ersetzt Dies gilt für alle FLEDGE APIs und benutzerdefinierten JavaScript-Code für Gebots- und Bewertungslogik.
    • Das Feld „owner“ wurde aus den Eingaben der Custom Audience API entfernt.
  • Unvollständige benutzerdefinierte Zielgruppen kommen jetzt sofort für den Hintergrund infrage aktualisieren.
  • Das JavaScript-Speicherlimit wurde auf 10 MB festgelegt. Dies gilt für Bidding und Bewertungslogik.

Attribution Reporting API

  • AdTechs müssen sich registrieren, bevor sie Attribution Reporting verwenden können API in der Entwicklervorschau 6. Weitere Informationen finden Sie unter Registrieren Sie sich für ein Privacy Sandbox-Konto, um weitere Informationen zu erhalten.
  • In diesem Release werden Fehlerbehebungsschlüssel eingeführt, mit denen Entwickler unveränderte Berichte und die datenschutzoptimierten Berichte aus der Attribution Reporting API Mit Debug-Schlüsseln erhalten Sie einen besseren Einblick in wie Berichte bei der Umstellung mit der Privacy Sandbox strukturiert sind.

Entwicklervorschau 5

Allgemein

  • Bevor Sie in der Entwicklervorschau 5 auf die Privacy Sandbox APIs zugreifen können, müssen Sie müssen zuerst die APIs aktivieren und API-spezifische Berechtigungen konfigurieren.
    • Designs für die Privacy Sandbox für Android ermöglichen es Nutzern, datenschutzfreundliche APIs und die SDK Runtime sind auf ihrem Gerät aktiv. Diese Einstellungen sind in der Entwicklervorschau 5 standardmäßig deaktiviert. Ich kann den API-Zugriff mit einem ADB-Befehl aktivieren.
    • Die aufrufende App muss im Manifest API-spezifische Berechtigungen angeben und zugehörige AdServices-Konfigurationen, die den Zugriff auf eingebettete SDKs steuern.
  • Apps müssen die datenschutzfreundlichen APIs aufrufen, wenn sie im Vordergrund ausgeführt werden.
  • AdIdManager und AppSetIdManager sind derzeit nicht in Betrieb. Sie werden in einer späteren Version aktiviert werden.

SDK-Laufzeit

  • sendData() wird in einer zukünftigen Version verworfen.
  • loadSdk() gibt jetzt ein IBinder-Objekt zurück, um eine bidirektionale Kommunikation zu ermöglichen. zwischen dem laufzeitfähigen SDK und den in AIDL definierten Apps.
  • Apps haben Zugriff auf zusätzliche laufzeitfähige SDK-Lebenszyklusereignisse, z. B. wenn der SDK-Prozess beendet wird.

Attribution Reporting API

In dieser Version werden zusätzliche Funktionen der Attribution Reporting API eingeführt. einschließlich:

  • Unterstützung für verschlüsselte Aggregationsberichte
  • Unterstützung von App- und Web-Messungen
  • Konsolidierte Header in Quelle und Trigger-Registrierungsantworten: <ph type="x-smartling-placeholder">
      </ph>
    • Quelle: Attribution-Reporting-Register-Aggregatable-Source ist jetzt Teil der Community von Attribution-Reporting-Register-Source
    • Trigger: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data und Attribution-Reporting-Register-Aggregatable-Values wurden in einer Kopfzeile mit dem Namen Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects ist immer noch eine separate Kopfzeile

FLEDGE in der Android API

Diese Version enthält einige neue Funktionen und Verbesserungen sowie wichtige Änderungen:

  • Nicht abwärtskompatible Änderungen: <ph type="x-smartling-placeholder">
      </ph>
    • „runAdSelection()“ wurde in „selectAds()“ umbenannt.
    • Der Parameter von AdSelectionConfig.Builder.setAdSelectionSignals() mit AdSelectionSignals, die ein JSON-Objekt darstellt.
    • Die Verwendung von String für Käufer/Verkäufer von Anzeigentechnologien wurde durch Das AdTechIdentifier-Objekt.
    • TestCustomAudienceManager- und TestAdSelectionManager-Kurse hinzugefügt für Überschreiben des JavaScript-Remoteabrufs.
    • Der Inhaber einer benutzerdefinierten Zielgruppe muss der Paketname des Anruf-App.
  • FLEDGE APIs validieren jetzt die aufrufende App anhand einer Reihe von Einschränkungen und die im Entwicklerleitfaden beschrieben. Folgendes sind einige nennenswerte Beispiele.
    • Für selectAds und reportImpression gelten jetzt Zeitlimits für die Ausführung, nach dem und der Aufruf wird beendet.
    • selectAds und reportImpression haben jetzt ein Limit für den verbrauchten Arbeitsspeicher JavaScript ausgeführt werden. Die APIs geben einen Fehler aus, Verbrauch überschreitet die konfigurierten Limits.
    • selectAds und reportImpression validieren jetzt AdSelectionConfig -Objekt, um sicherzustellen, dass Felder syntaktisch gültig sind und die URLs unter der im Feld „seller“ verwendeten eTLD+1.
    • In AdServices werden benutzerdefinierte Zielgruppen jetzt beim Erstellen validiert. Einige von Bei dieser Validierung wird sichergestellt, dass die Ablaufzeit gültig ist und eine die Anzahl der benutzerdefinierten Zielgruppen, die eine App erstellen kann, und die Gesamtgröße Die im joinCustomAudience-Aufruf bereitgestellten Anzeigen Bei der Validierung dass die für die Signale und den Abruf der Gebotslogik bereitgestellten URIs erzwungen werden, und Hintergrundabrufe erfolgen unter der Domain des Käufers.
  • Die Metadaten für benutzerdefinierte Zielgruppen werden täglich durch einen Hintergrundabruf aktualisiert.
  • Benutzerdefinierte Zielgruppen werden entfernt, App deinstalliert ist.
  • Unterstützung zum Angeben von Trusted-Scoring-Signalen und Trusted Bidding-Daten wurde hinzugefügt während der Anzeigenauswahl. Das Antwortformat finden Sie im Codebeispiel.
  • Für FLEDGE für Android APIs ist WebView-Version 105.0.5195.58 oder höher erforderlich. Weitere Informationen finden Sie in den Einrichtungsinformationen im Entwicklerhandbuch.

  • Bekannte Probleme:

    • Wenn Sie einer benutzerdefinierten Zielgruppe beitreten, schneidet die Plattform derzeit nicht ab Hintergrund wird sofort aktualisiert, wenn Metadaten- oder AdData-Werte sind leer oder null. Die benutzerdefinierte Zielgruppe kommt für die Anzeige nicht infrage bis sie einen Tag später aktualisiert wird. Eine zukünftige Version Unvollständige benutzerdefinierte Zielgruppen sofort für den Hintergrundabruf verfügbar machen Aktualisierungen. Das aktuelle Standardarbeitsspeicherlimit für die JavaScript-Ausführung ist und kann bei normalen Arbeitslasten zum Absturz der JavaScriptEngine Geräte. Ihre JavaScript-Ausführung wird möglicherweise unerwartet mit dem Fehlermeldung "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Sie können dieses Problem manuell beheben, indem Sie den richtigen Arbeitsspeichergrenzwert konfigurieren mit dem folgenden Befehl:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Anzeigen für benutzerdefinierte Zielgruppen, die nicht der erforderlichen JSON-Struktur entsprechen, werden beim Hintergrundabruf aktualisiert.

Topics API

  • Die Taxonomie zur Klassifizierung von mobilen Apps wurde aktualisiert.
  • Aktualisierung des Designvorschlags und der Beispiel-Apps mit Die Benutzeroberfläche für Einstellungen wird gestartet, um zugewiesene Themen anzusehen.

Neuerungen bei Tools

Android Studio Canary unterstützt die Erstellung von SDK-APKs mit einem neuen Modultyp. Der Entwicklerleitfaden zu SDK Runtime wurde aktualisiert und die Privacy Sandbox wurde aktualisiert Beispielanwendungen auf GitHub spiegeln dieses Update wider.

Entwicklervorschau 4

Freigabedatum: 14. Juli 2022

Privacy Sandbox in der Android-Entwicklervorschau 4 verbessert die folgenden Bereichen:

SDK-Laufzeit

  • Apps können jetzt über die Hinzufügung von sendData().
  • Lokaler Speicher ist jetzt im SDK-Laufzeitprozess verfügbar.
  • Ein SDK kann auch eigenständige videobasierte Anzeigen oder Inhalte im SDK rendern Laufzeit:
  • Es wurden Klarstellungen zur Verwendung von Reflexionen hinzugefügt, um die Möglichkeit zu erwähnen, vorausgesetzt, der Inhalt ist nicht in einem anderen RE-SDK enthalten.

Attribution Reporting API

In dieser Version werden Änderungen eingeführt, die die Verwendung der Attribution verständlicher machen. Reporting API, z. B.:

  • Änderungen am Format von aggregierten Berichten zur Verbesserung der Lesbarkeit.
  • Die Headerfelder für die Funktionen „Conversion-Filterung“ und „Gebotsbarkeit“ wurden aktualisiert.
  • Wir haben in der WebApp API-Referenz Erläuterungen zur Erläuterung von Quelle und API hinzugefügt. die Registrierung sowie die Verfügbarkeit der Privacy and Consent API.

FLEDGE in der Android API

Diese Version enthält neue Funktionen, die Sie beim Testen und Debuggen unterstützen. als interne Verbesserungen:

  • Das Überschreiben von Remote-URLs zum Abrufen von JavaScript-Logik wird jetzt unterstützt während der Entwicklung.
  • Verbesserte Fehlerberichte bei der Anzeigenauswahl
  • Inaktive benutzerdefinierte Zielgruppen werden jetzt bei der Anzeigenauswahl herausgefiltert.

Topics API

Diese Version enthält mehrere wesentliche Änderungen an der Topics API. Die meisten und wichtig:

  • Der Rückgabetyp der getTopics() API wurde in den neuen Objekttyp Topic, der ganzzahlige IDs für folgende Elemente einschließt: Themen in der Taxonomie und Informationen zum Klassifikator und zur Taxonomie Versionen. Sie sollten alle vorhandenen Apps aktualisieren, die diese API verwenden.
  • Für die Topics API ist jetzt eine neue normale Berechtigung erforderlich.
  • Einführung des integrierten Klassifikators zum dynamischen Zuweisen von Die Themen basieren auf öffentlich verfügbaren App-Informationen.

Bekannte Probleme

  • Die erste Version dieser Geräte-Images (Version 6) lädt nicht auf Android Emulator Version 31.2.10. Aktualisierte Geräte-Images, die die wurden am 27. Juli 2022 zur Verfügung gestellt.

Entwicklervorschau 3

Releasedatum: 9. Juni 2022

Privacy Sandbox in der Android-Entwicklervorschau 3 bietet Funktionen für Attribution Reporting API und FLEDGE für Android

Attribution Reporting API

Die Attribution Reporting API verbessert den Datenschutz, indem die Abhängigkeit von und unterstützt wichtige Anwendungsfälle für Attribution und App-Conversion-Analyse.

Diese Version enthält Entwicklerressourcen, mit denen Sie Folgendes testen können: Funktionen der Attribution Reporting API:

  • Attributionsquelle registrieren und Ereignisse auslösen
  • Die Attribution nach der Quelle und nach der Installation anwenden
  • Ereignisberichte erhalten
  • Aggregierbare Berichte erhalten, die in diesem Release unverschlüsselt sind

Zur Unterstützung beim Testen werden eine Beispiel-App und ein Referenz-AdTech-Server zur Verfügung gestellt.

Bekannte Probleme:

FLEDGE unter Android

Neue Methode zum Einblenden von Anzeigen basierend auf benutzerdefinierten Zielgruppen mit FLEDGE für Android von App-Entwicklern und die Interaktionen innerhalb ihrer App definiert. Diese Lösung speichert Informationen und zugehörige Anzeigen lokal Workflows zur Anzeigenauswahl orchestrieren

Dieser Release enthält Entwicklerressourcen, mit denen Sie die folgenden FLEDGE testen können auf Android-Funktionen:

  • Einer benutzerdefinierten Zielgruppe beitreten oder sie verlassen und beobachten, wie sich Parameterwerte auswirken können Auktionsergebnisse
  • JavaScript-Auktionscode von Remote-Endpunkten abrufen
  • Anzeigenauktionen auf dem Gerät konfigurieren und initiieren
  • Impressionsberichte verarbeiten
  • Zur Unterstützung beim Testen werden eine Beispiel-App und eine simulierte Serverkonfiguration bereitgestellt.

Bekannte Probleme:

Entwicklervorschau 2

Freigabedatum: 17. Mai 2022

In der Entwicklervorschau 2 finden Sie MeasurementManager Attribution Reporting APIs

  • Sie können sich unter registerSource() und registerTrigger() registrieren. App-Anzeigenereignisse und Berichtsdaten auf Ereignisebene für App-zu-App-Anzeigen Namensnennung. Bei unserer aktuellen Implementierung wird das Attributionsmodell „Letzte Interaktion“ verwendet. Die Berichte werden gemäß den Definition in den Berichten Fenster. Weitere Informationen finden Sie in der MeasurementManager API. finden Sie weitere Informationen.

  • Der Bericht wird am Ende fester Zeitintervalle hochgeladen. und nicht zum genauen geplanten Zeitpunkt. Uploadintervall für Berichte beträgt standardmäßig 4 Stunden, kann aber mit dem folgenden ADB überschrieben werden. Befehl:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Eine Beispiel-App und ein Referenz-AdTech-Server zum Testen von APIs werden die in einer zukünftigen Version veröffentlicht werden.

  • Andere MeasurementManager Attribution Reporting API Funktionen wie aggregierte Berichte, Attribution nach der Installation und Weiterleitungen wird in einer späteren Version verfügbar sein.

Entwicklervorschau 1

Veröffentlichungsdatum: 28. April 2022

Die Entwicklervorschau 1 enthält eine Vorabversion der Topics API und SDK-Laufzeit: Funktionen für FLEDGE unter Android und Attribution Reporting APIs sind verfügbar in zukünftige Version.

  • Topics API <ph type="x-smartling-placeholder">
      </ph>
    • Die getTopics() API gibt derzeit Testwerte basierend auf Offline zurück Klassifizierung für eine begrenzte Anzahl von Apps. Klassifizierungen auf dem Gerät noch nicht implementiert.
    • Mit ADB-Befehlen können Sie Epochenintervalle überschreiben und einen Trigger erzwingen und Epochenberechnungen.
    • Weitere Informationen finden Sie im Topics-Entwicklerleitfaden.
  • SDK-Laufzeit <ph type="x-smartling-placeholder">
      </ph>
    • Sie können laufzeitfähige SDKs (RE SDKs) mit dem neuen SDK verpacken und erstellen. <sdk-library>-Element in der Manifestdatei deiner SDK-App. RE SDKs installieren auf einem unterstützten Testgerät oder Emulator, wie Sie es normalerweise mit einem in der Entwicklungsphase ist.
    • Sie können RE SDKs in eine App einbinden, in die SDK Runtime laden, und testen Sie die Auswirkungen des eingeschränkten Zugriffs auf den SDK-Code – Berechtigungen, und die App-zu-SDK-Kommunikation. Storage APIs für RE SDKs sind nicht implementiert und wird in einer zukünftigen Version verfügbar sein.
    • Ein SDK kann WebView-basierte Banneranzeigen oder Inhalte im SDK-Laufzeit.
    • Weitere Informationen finden Sie im Entwicklerleitfaden für die SDK Runtime.
  • Lint-Prüfungen unter Android <ph type="x-smartling-placeholder">
      </ph>
    • Android-Lint-Prüfungen zeigen in kompilierten Projekten fälschlicherweise Warnungen an mit dem API-Level TiramisuPrivacySandbox. Zum Beispiel sehen Sie möglicherweise die Warnmeldung: „Für den Anruf ist API-Level 33 erforderlich.“ Sie können vorübergehend können Sie dies mithilfe der Anmerkung @SuppressLint("NewApi") beheben.