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
- Möglichkeit zum Löschen einer Quelle, wenn die App bereits auf dem Gerät installiert ist
- Updates von der flexiblen Lite-Ereignisberichterstellung zur vollständigen flexiblen Ereignisberichterstellung
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
- Unterstützung der Attribution Reporting API Einbindung in Protected Audience
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
undpersistAdSelectionResult
werden aufgerufen, wenn die Einwilligung erteilt wurde zum Absturz des Prozesses führt.- Die Negativfilterfunktion kann nicht mit
getAdSelectionData
verwendet werden undpersistAdSelectionResult
.
Protected Audience API
- Anzeigentechnologie-Anbieter können jetzt die benutzerdefinierte Zielgruppendelegierung verwenden, um einer benutzerdefinierten an einen On-Device-Anrufer.
- Android unterstützt jetzt die Durchführung von Auktionen über Gebote und Auktionen Dienste – Protected Audience-Auktionen unterstützen die CPC-Abrechnung.
- Die Report Interactions API heißt jetzt
reportEvent
. - Die Methode für das Frequency Capping und die Zählertypen wurden umbenannt.
- In Berichten zur Fehlerbehebung erfahren Sie, warum ein oder zur Ermittlung von Problemen in der JavaScript-Logik.
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. alscom.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 aufContentProvider
mitContentResolver
. - 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
undregisterTrigger
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 TypWIN
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
- FLEDGE wurde in Protected Audience API umbenannt.
- Protected Audience wurde in der Betaversion von März 2023 standardmäßig deaktiviert. Das Problem wurde behoben und Protected Audience ist jetzt nur eine begrenzte Anzahl an Nutzern.
- Die folgenden neuen Funktionen wurden hinzugefügt:
<ph type="x-smartling-placeholder">
- </ph>
- Frequency Capping: Definition
- Interaktionsberichte
- Kontextbezogene Anzeigen in eine Auktion einbeziehen
- Auszuschließende Anzeigenfilterung für App-Installationen
- Vordefinierte URIs ist eine Bibliothek vordefinierter Logik zur Verwendung im durch AdTechs anstelle von JavaScript-Code,
- Versionsverwaltung für JavaScript-Funktionen für Gebote und Bewertungen
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
- Implementierung der SDK-zu-SDK-Kommunikation für den App-Prozess und das SDK Laufzeitprozess.
- Individuelle Unterstützung von SDK-Aktivitäten
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 incustom_audience_bidding_signals
umbenannt.scoreAd()
wurde incustom_audience_scoring_signals
umbenannt.reportWin()
wurde incustom_audience_reporting_signals
umbenannt.
- In diesem Release wird eine neue
selectAds
-Überschreibung hinzugefügt,AdSelectionFromOutcomeConfig
zum Vergleich vonselectAds
-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
oderno-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.
- Der Cache kann mit
Attribution Reporting API für die Android API
- In dieser Version werden Verkettungs-Weiterleitungen für
registerSource()
undregisterTrigger()
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
- Mit dem Android Topics Classifier Colab können Entwickler wie das Klassifikatormodell funktioniert.
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
undgetAppSetId
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
undAppSetIdManager
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 durchUri
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
undAppSetIdManager
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 vonAttribution-Reporting-Register-Source
- Trigger:
Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data
undAttribution-Reporting-Register-Aggregatable-Values
wurden in einer Kopfzeile mit dem NamenAttribution-Reporting-Register-Event-Trigger
Attribution-Reporting-Redirects
ist immer noch eine separate Kopfzeile
- Quelle:
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()
mitAdSelectionSignals
, die ein JSON-Objekt darstellt. - Die Verwendung von
String
für Käufer/Verkäufer von Anzeigentechnologien wurde durch DasAdTechIdentifier
-Objekt. TestCustomAudienceManager
- undTestAdSelectionManager
-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
undreportImpression
gelten jetzt Zeitlimits für die Ausführung, nach dem und der Aufruf wird beendet. selectAds
undreportImpression
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
undreportImpression
validieren jetztAdSelectionConfig
-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 imjoinCustomAudience
-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.
- Für
- 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 odernull
. 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 ObjekttypTopic
, 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:
- Die Attribution Reporting API verschlüsselt zusammengefasste Berichte noch nicht gemäß des Designvorschlags. Zu Testzwecken werden Berichtsnutzlasten Klartext, bis die Verschlüsselung implementiert ist.
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:
- Eine benutzerdefinierte Zielgruppe kann an der Anzeigenauswahl beteiligt werden, noch bevor sie „Aktivierungszeit“.
Entwicklervorschau 2
Freigabedatum: 17. Mai 2022
In der Entwicklervorschau 2 finden Sie
MeasurementManager
Attribution Reporting APIs
- Sie können sich unter
registerSource()
undregisterTrigger()
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 derMeasurementManager
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.
- Die
- 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.
- Sie können laufzeitfähige SDKs (RE SDKs) mit dem neuen SDK verpacken und erstellen.
- 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.
- Android-Lint-Prüfungen zeigen in kompilierten Projekten fälschlicherweise Warnungen an
mit dem API-Level