Versionshinweise zur Privacy Sandbox für Android

Die Privacy Sandbox für Android bietet Vorschau- und Betaprogramme für Entwickler. Wir werden im Laufe der Zeit neue APIs und Funktionen in die Entwicklervorschau aufnehmen und stabilisierte APIs in das Betaprogramm aufnehmen. Wir freuen uns über Feedback.

Wenn Sie die Privacy Sandbox für Android noch nicht kennen, beginnen Sie mit der Programmübersicht. Wenn Sie die Privacy Sandbox in Ihr Projekt einbinden möchten, müssen Sie Ihre Entwicklungsumgebung einrichten und die Privacy Sandbox für Android auf Ihrem Testgerät oder Emulator herunterladen.

Aktuelle Releases

Android VanillaIceCream – Vorschau

Protected Audience API

  • Es wurde die Möglichkeit hinzugefügt, authentifizierte kontextbezogene Anzeigen an eine geschützte Auktion zu übergeben. Dazu gehören auch negative Filter für bereits auf dem Gerät installierte Apps sowie Frequency Capping für die Anzahl der Klicks, Impressionen, Aufrufe oder Erfolge. Die Implementierung unterscheidet sich von früheren Iterationen, da kontextbezogene Anzeigen von der Anzeigentechnologie signiert werden müssen. Informationen zur Implementierung finden Sie im Entwicklerleitfaden.
  • ContextualAds = SignedContextualAds und ein zugehöriger Getter und Setter in AdSelectionConfig; getPerBuyerSignedContextualAds und setPerBuyerSignedContextualAds
  • Wenn eine nicht authentifizierte kontextbezogene Anwendung übergeben wird, wird sie aus der Auktion entfernt.

Attribution Reporting API

Update der Privacy Sandbox für Android im 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 können über den SDK-Manager von Android Studio als Android API 34, Erweiterungsebene 10 heruntergeladen werden. Die Funktion ähnelt der [Entwicklervorschau 9][b25], hat aber einige wichtige Änderungen.

Protected Audience API

  • Anzeigentechnologie-Anbieter können jetzt die [Benutzerdefinierte Zielgruppendelegierung][b26] verwenden, um im Namen eines Käufers, der keine Präsenz auf dem Gerät hat, einer benutzerdefinierten Zielgruppe beizutreten.
  • Android unterstützt jetzt die Durchführung von Auktionen für Gebots- und Auktionsdienste.
  • Protected Audience-Auktionen unterstützen die CPC-Abrechnung.
  • Protected Audience-Auktionen und -Berichte unterstützen jetzt Datenversionsheader für vertrauenswürdige Gebotssignale.
  • Protected Audience-Auktionen unterstützen das Filtern von WIN-Ereignissen nach Frequency Capping.
  • Protected Audience unterstützt jetzt die [Integration in die Attribution Reporting API][b27].

Attribution Reporting API

  • Die Attribution Reporting API unterstützt jetzt [Integration in Protected Audience][b28]

SDK-Laufzeit

  • Möglichkeit des SDK, andere SDKs innerhalb der SDK-Laufzeit zu laden, um Anwendungsfälle für die Vermittlung zu unterstützen

Frühere Versionen

Entwicklervorschau 10

Veröffentlichungsdatum: 19. Dezember 2023

Bekannte Einschränkungen

  • Es gibt ein Problem, das die Google Play-Dienste im Hintergrund abstürzt und den Nutzer wiederholt darüber informiert:
    • Durch einen Neustart des Geräts lässt sich das Problem möglicherweise beheben.
    • Wenn beim Testen Probleme mit einer Zeitüberschreitung bei asynchronen Aufrufen auftreten, fügen Sie den folgenden ADB-Befehl hinzu, um den Schwellenwert bis zum Zeitlimit zu verlängern:
    • 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. So rufen Sie den Startbildschirm auf:
    • Installiere das Vorschaubild auf dem Smartphone.
    • Führe den Einrichtungsassistenten durch, ohne eine Verbindung zu einem WLAN oder mobilen Daten 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, [Protected App Signals][dp98], um die Auslieferung relevanter App-Installationsanzeigen zu unterstützen. Mit diesem DP veröffentlichen wir APIs, die es Anzeigentechnologien ermöglichen,
    • Sie können Signale auswählen, indem Sie App-Ereignisse im geschützten Speicher auf dem Gerät speichern. Diese Ereignisse werden zur Auslieferung relevanter App-Installationsanzeigen verwendet.
    • Sie führen eine geschützte Auktion für Gebots- und Auktionsdienste aus, die in vertrauenswürdigen Ausführungsumgebungen ausgeführt werden. Dort können die Nutzer auf ihre entsprechenden Signale zugreifen, um die Anzeigenauswahl und die Gebotseinstellung zu unterstützen.

Attribution Reporting API

  • Für diese Version der Attribution Reporting API gilt Folgendes:
    • Hierdurch wird die Protected Audience-Integration hinzugefügt, wodurch benutzerdefinierte Zielgruppendimensionen in zusammengefassten Zusammenfassungsberichten aktiviert werden.
    • Unterstützt Google Cloud-Anbieter als TEE für den Aggregationsdienst.
    • Das Feld „shared_debug_key“ wurde hinzugefügt, um das Debugging für netzwerkübergreifende Attribution ohne Weiterleitungen zu unterstützen.
    • In Anfragen für ausführliche Fehlerbehebungsberichte werden Versionsheader hinzugefügt.

Personalisierung auf dem Gerät

  • Erste Version für Forscher und frühe Entwicklungen.
  • Die On-Device-Personalisierung bietet eine innovative Möglichkeit, Produkte und Dienste anzupassen und gleichzeitig den Datenschutz für Endnutzer zu verbessern. Die On-Device-Personalisierung bietet eine Reihe von Diensten und Algorithmen als Bausteine, um dies zu erreichen. Dazu gehören unter anderem:
    • Federated Compute (FC), das das Trainieren, Bewerten und Personalisieren von Modellen mithilfe von föderiertem Lernen ermöglicht. Die Verwendung von föderiertem Computing bei der On-Device-Personalisierung basiert auf Modelltraining und (falls erforderlich) Inferenz.
    • Cuckoo Filter-basierter Abgleich und Cross-Match von Daten, die unterschiedlich angeordnet sind.
    • Differential Privates (DP)-Training von dünnbesetzten Modellen mit neuen Techniken wie DP Alternating Minimization (zum Trainieren von ungleich verteilten Daten) und Modellpersonalisierung unter Billboard-DP. ### Entwicklervorschau 9

Veröffentlichungsdatum: 15. August 2023

Bekannte Einschränkungen

  • Auktionsdaten, die durch Aufrufen der Bidding and Auktion API generiert werden, werden in DP9 nicht automatisch gelöscht.
  • Wenn getAdSelectionData und persistAdSelectionResult aufgerufen werden, wenn die Einwilligung widerrufen wird, stürzt der Prozess ab.
  • Das Feature für das negative Filtern funktioniert nicht mit getAdSelectionData und persistAdSelectionResult.

Protected Audience API

  • Anzeigentechnologie-Anbieter können jetzt die Delegierung für benutzerdefinierte Zielgruppen verwenden, um einem Aufruf auf dem Gerät einer benutzerdefinierten Zielgruppe beizutreten.
  • Android unterstützt jetzt die Durchführung von Auktionen für Gebots- und Auktionsdienste. 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 eine Auktion verloren gegangen ist, oder um Probleme in der JavaScript-Logik zu identifizieren.

Attribution Reporting API

  • In dieser Version werden Fehlerbehebungsberichte für die Attribution Reporting API durch folgende Verbesserungen verbessert:
    • Ausführliche Fehlerbehebungsberichte, die im Web unterstützt werden
    • Debugging-Berichte für die website- und appübergreifende Attribution aktivieren (AdId ist sowohl für die Web- als auch für die App-Registrierung erforderlich)
  • AdTech-Unternehmen können Rauschparameter für verschiedene Berichtsszenarien konfigurieren.
  • In diesem Release wird die ursprungsbasierte Attribution eingeführt. Das bedeutet:
    • Der Ursprung wird für die Registrierung verwendet.
    • Für eine Website werden mehrere Ursprünge akzeptiert.
    • Eine neue Ratenbegrenzung von einem Ursprung pro Quell-App oder Registrierung.
  • Anzeigentechnologie-Anbieter können jetzt die Registrierung für das lokale Testen von Attribution Reporting-Anwendungsfällen deaktivieren.

SDK-Laufzeit

  • Das SDK kann nur Dienste starten oder an eine Zulassungsliste von Diensten binden.
  • Das SDK kann nur auf einen Teil der System-ContentProvider (z. B. com.android.providers.settings.SettingsProvider) zugreifen, wenn die abgerufenen Daten keine Kennungen haben und nicht zum Erstellen eines Fingerabdrucks des Nutzers verwendet werden können. Diese Prüfungen gelten auch für den Zugriff auf ContentProvider mit ContentResolver.
  • Das SDK kann nur auf einen Teil der geschützten Übertragungsempfänger zugreifen (z. B. android.intent.action.AIRPLANE_MODE).
  • Das SDK kann eine Aktivität starten, die zu einer anderen App gehört, jedoch mit Einschränkungen dafür, was im Intent gesendet werden kann.

Privacy Sandbox für Android: Update vom März 2023

Die Betaversion der Privacy Sandbox für Android vom März 2023 enthält Updates für die Privacy Sandbox APIs auf öffentlichen Android 13-Geräten. Diese Version enthält 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 zum Aktualisieren von benutzerdefinierten FLEDGE-Zielgruppen ausgeführt wird, führt zum Absturz des Prozesses. Aus diesem Grund ist FLEDGE standardmäßig deaktiviert.

Allgemein

  • Ab dieser Version können Sie die Attribution Reporting API verwenden. Die API war zuvor deaktiviert. Wenn Sie im vorherigen Betarelease die Attribution Reporting API verwendet haben, löschen Sie Ihre App- oder Gerätedaten, bevor Sie diesen Betarelease verwenden. Gehen Sie dazu so vor:
    • Rufen Sie auf einem Gerät oder Emulator die Einstellungen auf und leeren Sie den appspezifischen Speicher (nicht nur den Cache) für alle Apps, die Sie zum Testen verwenden.
    • 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 Fehlerbehebungsschlüssel, mit denen Entwickler unveränderte und datenschutzkonforme Berichte über die Attribution API erhalten. Mit Schlüsseln zur Fehlerbehebung können Sie während der Umstellung auf die Privacy Sandbox einen besseren Einblick in die Struktur von Berichten erhalten.
  • In Attribution Reporting ist vor Kurzem ein Fehler mit Ad Services aufgetreten, bei dem registerSource und registerTrigger mit Ausnahmen fehlschlugen. Wenn diese Probleme während der Entwicklung aufgetreten sind, wurde eine Lösung bereitgestellt, die sich im Laufe der Zeit beheben sollte.
  • Die Vorschaufunktion der Topics API ist jetzt mit der Privacy Sandbox in den Android-Entwicklervorschauen identisch. Ein Topics API-Aufrufer kann Themen als Vorschau ansehen, ohne den Abruf von Themen bei der Berechnung der wöchentlichen Epochen einzubeziehen oder die Liste der für den Aufrufer beobachteten Themen zu beeinflussen. Weitere Informationen finden Sie im Feld shouldRecordObservation.

  • Wenn Sie Tests in FLEDGE für Android aktivieren möchten, registrieren Sie sich für das Betaprogramm und melden Sie sich mit demselben Google-Konto auf Ihren Testgeräten an. Andernfalls wird beim Aufruf von APIs ein IllegalStateException mit der Meldung „Dienst ist nicht verfügbar“ ausgelöst. FLEDGE sollte im nächsten Betarelease reaktiviert werden.

    In der Zwischenzeit können Tests in der Entwicklervorschau fortgesetzt werden und werden empfohlen. FLEDGE kann auf Geräten mit den folgenden Vorbehalten manuell aktiviert werden:

    Sie können FLEDGE mit den folgenden ADB-Befehlen aktivieren. Dies führt jedoch dazu, dass der Hintergrundabrufprozess abstürzt, was sich negativ auf die Systemzustandsmesswerte auswirkt. Dies ist keine dauerhafte Lösung, da diese Werte von der Plattform möglicherweise zurückgesetzt werden.

    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

Veröffentlichungsdatum: 23. Mai 2023

Bekannte Einschränkungen

  • Filter des Typs WIN können zwar Protected Audience-Anzeigen hinzugefügt werden, der Typ WIN wird jedoch noch nicht unterstützt. Filter dieses Typs werden ignoriert.
  • Damit Käufer gewonnene Impressionen an Protected Audience-Auktionen erfassen können, müssen sie bei der Privacy Sandbox registriert sein. Diese Anforderung kann nicht überschrieben werden.
  • Wenn Sie die Privacy Sandbox-Einstellungen auf einem Gerät mit verfügbarer Privacy Sandbox aufrufen möchten, rufen Sie Einstellungen > Google > Werbung > Privacy Sandbox auf.
  • Projekte mit Emulatoren können in Android Studio Giraffe nicht bereitgestellt werden. Andere Versionen von Android Studio sollten einwandfrei funktionieren. Für Android Studio Giraffe wird am 26. Mai 2023 eine Lösung eingeführt.

Protected Audience API

Attribution Reporting API

  • ODER-Trigger-Filter hinzugefügt. Filter bestehen nun aus einer Filtergruppe, d. h. einer Liste von Filterzuordnungen. Wenn keine der Filterzuordnungen im Satz mit den Filterdaten der Quelle übereinstimmen, wird das event_trigger_data-Objekt ignoriert.
  • Die Ablaufzeit von Impressionen und das Berichtszeitraum für Aggregations- und Ereignis-APIs wurden entkoppelt.
  • In aggregierten Berichten werden jetzt auch Deduplizierungsschlüssel unterstützt.
  • scheduled_report_time wurde den Ereignisberichten entsprechend der Privacy Sandbox für das Web hinzugefügt.
  • Netzwerkübergreifende Attribution ohne Weiterleitungen

SDK-Laufzeit

Entwicklervorschau 7

Veröffentlichungsdatum: 26. Januar 2023

FLEDGE in der Android API

  • Der Parameter custom_audience_signals wurde in den folgenden JavaScript-Methoden umbenannt:
    • generateBid() wurde in custom_audience_bidding_signals umbenannt.
    • scoreAd() wurde in custom_audience_scoring_signals umbenannt.
    • reportWin() wurde in custom_audience_reporting_signals umbenannt.
  • Dieser Release fügt eine neue selectAds-Überschreibung hinzu, die AdSelectionFromOutcomeConfig verwendet, um selectAds-Ergebnisse zu vergleichen. Dadurch können AdTech-SDKs diese API für die abfolgebasierte Vermittlung nutzen. Weitere Informationen finden Sie im Entwicklerleitfaden.
  • Die selectAds() API unterstützt jetzt Caching für Gebots- und Bewertungslogik, die während der Anzeigenauswahl abgerufen wird.
    • Der Cache kann mit Cache-Control-Headern gesteuert werden, die von den Servern während des JavaScript-Abrufaufrufs zurückgegeben werden. Verwende no-cache oder no-store, um zu verhindern, dass JavaScript-Antworten im Cache gespeichert werden, und „max-age“, um die Cache-Dauer zu steuern.
    • Der aktuelle Cache-Eintrag max-age ist standardmäßig auf zwei Tage festgelegt.

Attributionsberichte in der Android API

  • In diesem Release werden Daisy-Chain-Weiterleitungen für registerSource() und registerTrigger() unterstützt. Der API-Nutzer kann jetzt eine HTTP-Weiterleitung als Serverantwort verwenden.

Erste Betaversion, Januar 2023

Veröffentlichungsdatum: 9. Januar 2023

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

Allgemein

  • Die Privacy Sandbox für Android Beta 1 entspricht in ihrer Funktion der Entwicklervorschau 5. Es sind jedoch einige zusätzliche Funktionen und Einschränkungen unten aufgeführt.
  • Entwickler müssen einen Registrierungsprozess durchlaufen, um anzeigenbezogene APIs (einschließlich Topics, FLEDGE und Attribution Reporting) verwenden zu können. Bei der Registrierung wird die Identität des Entwicklers überprüft und die entwicklerspezifischen Daten erhoben, die von den APIs benötigt werden.
  • Mit der Privacy Sandbox für Android Beta 1 erhalten Entwickler, die sich registriert und Details auf die Zulassungsliste eingereicht haben, die Möglichkeit, Tests auf ihren eigenen physischen Geräten durchzuführen. Wenn Sie im Release für stabile APIs entwickeln möchten, laden Sie das neue SDK Ad Services Extensions 4 herunter.

Topics API

Attribution Reporting API

  • Attribution Reporting wurde deaktiviert und kann in dieser Version nicht verwendet werden. Der Zugriff auf diese API sollte im nächsten Betarelease wieder aktiviert werden. Wir empfehlen Ihnen, Tests mit Entwicklervorschauen fortzusetzen.

SDK-Laufzeit

Die folgenden Einschränkungen werden voraussichtlich in der nächsten größeren Android-Plattformversion behoben:

  • Das Anzeigen-Rendering in einer scrollbaren Ansicht wie RecyclerView funktioniert derzeit nicht richtig. Wenn die Größe des Elements angepasst wird, kann es zu einer Verzögerung kommen. Ereignisse beim Scrollen durch den Nutzer werden nicht korrekt an die Laufzeit übergeben.
  • WebView-Rendering ist im SDK-Laufzeitprozess nicht verfügbar.
  • Speicher pro SDK ist nicht verfügbar.
  • Die Unterstützung für die APIs getAdId und getAppSetId wurde noch nicht aktiviert.

Entwicklervorschau 6

Veröffentlichungsdatum: 31. Oktober 2022

Die Privacy Sandbox in der Android-Entwicklervorschau 6 bietet Verbesserungen in folgenden Bereichen:

Allgemein

  • In Vorbereitung auf die Produktionseinführung wurde in der Entwicklervorschau 6 ein Flag eingeführt, mit dem der Zugriff auf die datenschutzfreundliche API standardmäßig deaktiviert wird. Aktivieren Sie zu Testzwecken den Zugriff auf die datenschutzfreundliche API in der Entwicklervorschau. Führen Sie dazu den folgenden Befehl aus:

    adb shell device_config put adservices global_kill_switch false

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

    • Überprüfen Sie auf einem Android-Gerät, ob die richtige Version unter Einstellungen > Apps > Google Play-Dienste aufgeführt ist.
    • Wenn du die Google Play-Dienste auf die richtige Version aktualisieren musst, melde dich mit einem Google-Konto auf deinem Android-Testgerät oder Emulator an. Rufe dann Google Play Store > Profilsymbol > Einstellungen > Info auf. Tippen Sie unter der Überschrift Play Store-Version auf Play Store aktualisieren.
    • Dieser Schritt ist nur für Entwicklungs- und Testzwecke relevant und nach der Einführung der Privacy Sandbox für öffentliche Nutzer nicht mehr erforderlich.

Topics API

  • Es wurde eine Preview API hinzugefügt, mit der Sie festlegen können, ob sich getTopics als Beobachter registriert oder nicht.
  • Kleinere Änderungen am Initialisierungscode für die GetTopicsRequest-Klasse.
  • Integrationsanleitung für Topics veröffentlicht

FLEDGE in der Android API

  • Wenn Sie Tests mit echten Servern durchführen, wird das Aktivieren der API jetzt erzwungen. Folgen Sie dieser Anleitung, um Ihr Gerät zu konfigurieren. Diese Schritte sind nicht erforderlich, wenn Sie die Remote-Überschreibungen aus der Beispiel-App verwenden.
  • Wichtige Änderungen:
    • Url in Parametern durch Uri ersetzt. Dies gilt für alle FLEDGE APIs und für benutzerdefiniertes JavaScript für die Gebots- und Bewertungslogik.
    • Das Feld owner wurde aus den Eingaben für die Custom Audience API entfernt.
  • Unvollständige benutzerdefinierte Zielgruppen können jetzt sofort im Hintergrund aktualisiert werden.
  • Das JavaScript-Speicherlimit ist jetzt auf 10 MB festgelegt. Dies gilt für die Gebots- und Bewertungslogik.

Attribution Reporting API

  • Anzeigentechnologie-Anbieter müssen sich registrieren, bevor sie die Attribution Reporting API in der Entwicklervorschau 6 verwenden können. Weitere Informationen finden Sie unter Für Privacy Sandbox-Konto registrieren.
  • Mit diesem Release werden Debug-Schlüssel eingeführt, mit denen Entwickler neben den datenschutzkonformen Berichten auch unveränderte Berichte über die Attribution Reporting API erhalten. Mit Fehlerbehebungsschlüsseln können Sie sich einen besseren Überblick über die Struktur von Berichten während der Umstellung auf die Privacy Sandbox verschaffen.

Entwicklervorschau 5

Allgemein

  • Bevor du in der Entwicklervorschau 5 auf die Privacy Sandbox APIs zugreifen kannst, musst du zuerst die APIs aktivieren und API-spezifische Berechtigungen konfigurieren.
    • Designs für die Privacy Sandbox für Android ermöglichen es Nutzern zu steuern, ob datenschutzfreundliche APIs und die SDK-Laufzeit auf ihrem Gerät aktiv sind. Diese Einstellungen sind in der Entwicklervorschau 5 standardmäßig deaktiviert. Sie können den API-Zugriff mit dem Befehl „adb“ aktivieren.
    • Die Aufruf-App muss im Manifest und in den zugehörigen AdServices-Konfigurationen API-spezifische Berechtigungen angeben, 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 verfügbar. Sie werden in einem späteren Release aktiviert.

SDK-Laufzeit

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

Attribution Reporting API

Mit dieser Version werden zusätzliche Funktionen der Attribution Reporting API eingeführt, darunter:

  • Unterstützung für verschlüsselte Aggregationsberichte.
  • Unterstützung für app- und webübergreifende Messung:
  • Konsolidierte Header in Quell- und Trigger-Registrierungsantworten:
    • Quelle: Attribution-Reporting-Register-Aggregatable-Source ist jetzt Teil 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 einem einzigen Header mit dem Namen Attribution-Reporting-Register-Event-Trigger zusammengefasst.
    • Attribution-Reporting-Redirects ist immer noch ein separater Header

FLEDGE in der Android API

Diese Version enthält mehrere neue Funktionen und Verbesserungen sowie funktionsgefährdende Änderungen:

  • Wichtige Änderungen:
    • "runAdSelection()" wurde in "selectAds()" umbenannt.
    • Der Parameter von AdSelectionConfig.Builder.setAdSelectionSignals() wurde durch AdSelectionSignals ersetzt, das ein JSON-Objekt darstellt.
    • Die Verwendung von String zur Darstellung eines Käufers/Verkäufers von Anzeigentechnologie durch das Objekt AdTechIdentifier wurde ersetzt.
    • Die Klassen TestCustomAudienceManager und TestAdSelectionManager zum Überschreiben des Remote-JavaScript-Abrufs wurden hinzugefügt.
    • Der Inhaber einer benutzerdefinierten Zielgruppe muss der Paketname der aufrufenden App sein.
  • FLEDGE APIs prüfen jetzt die Aufrufer-App anhand einer Reihe von Einschränkungen und Einschränkungen, die im Entwicklerleitfaden beschrieben sind. Hier einige bemerkenswerte Beispiele.
    • Für selectAds und reportImpression gelten jetzt Zeitlimits für die Ausführung. Nach Ablauf dieser Zeit wird der Aufruf beendet.
    • selectAds und reportImpression haben jetzt ein Limit für den Arbeitsspeicher, der während der JavaScript-Ausführung belegt wird. Die APIs geben einen Fehler aus, wenn der Arbeitsspeicherverbrauch die konfigurierten Limits überschreitet.
    • selectAds und reportImpression validieren jetzt das AdSelectionConfig-Objekt, um sicherzustellen, dass die Felder syntaktisch gültig sind und die URLs der im Feld „seller“ verwendeten eTLD+1 entsprechen.
    • AdServices validiert benutzerdefinierte Zielgruppen jetzt zum Zeitpunkt der Erstellung. Dabei wird unter anderem geprüft, ob die Ablaufzeit gültig ist und wie viele benutzerdefinierte Zielgruppen eine App erstellen kann. Außerdem wird die Gesamtgröße der im joinCustomAudience-Aufruf bereitgestellten Anzeigen begrenzt. Außerdem wird durch die Validierung sichergestellt, dass sich alle URIs für das Abrufen von Signalen, die Gebotslogik und den Hintergrundabruf in der Domain des Käufers befinden.
  • Die Metadaten von benutzerdefinierten Zielgruppen werden täglich über einen Hintergrundabrufprozess aktualisiert.
  • Benutzerdefinierte Zielgruppen werden entfernt, wenn die Inhaber-App deinstalliert wird.
  • Unterstützung für die Angabe vertrauenswürdiger Bewertungssignale und vertrauenswürdiger Gebotsdaten bei der Anzeigenauswahl hinzugefügt. Im Codebeispiel finden Sie Informationen zum Antwortformat.
  • FLEDGE für Android APIs hängen von WebView-Version 105.0.5195.58 oder höher ab. Weitere Informationen finden Sie im Entwicklerleitfaden in den Informationen zur Einrichtung.

  • Bekannte Probleme:

    • Beim Beitreten zu einer benutzerdefinierten Zielgruppe führt die Plattform derzeit nicht sofort Hintergrundaktualisierungen durch, wenn einer der Metadaten oder AdData-Werte leer oder null ist. Die benutzerdefinierte Zielgruppe kommt erst für die Anzeigenauswahl infrage, wenn sie einen Tag später aktualisiert wird. In einem zukünftigen Release können unvollständige benutzerdefinierte Zielgruppen sofort aktualisiert werden. Das aktuelle Standard-Arbeitsspeicherlimit für die JavaScript-Ausführung ist zu niedrig und kann dazu führen, dass normale Arbeitslasten die JavaScriptEngine auf Geräten zum Absturz bringen. Ihre JavaScript-Ausführung wird möglicherweise unerwartet mit der Fehlermeldung "Fatal javascript OOM in CALL_AND_RETRY_LAST" beendet.

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

      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 während des Hintergrundabrufs aktualisiert.

Topics API

  • Die Taxonomie zur Klassifizierung von mobilen Apps wurde aktualisiert.
  • Wir haben den Designvorschlag und die Beispiel-Apps aktualisiert und die Benutzeroberfläche für Einstellungen eingeführt, um die zugewiesenen Themen anzusehen.

Änderungen bei Tools

Android Studio Canary unterstützt die Erstellung von SDK-APKs mit einem neuen Modultyp. Der Entwicklerleitfaden zur SDK Runtime wurde aktualisiert und die Privacy Sandbox-Beispiel-Apps auf GitHub beziehen sich auf diese Änderung.

Entwicklervorschau 4

Freigabedatum: 14. Juli 2022

Die Privacy Sandbox für die Android-Entwicklervorschau 4 enthält Verbesserungen in folgenden Bereichen:

SDK-Laufzeit

  • Apps können jetzt durch Hinzufügen von sendData() mit den laufzeitfähigen SDKs (RE-SDKs) kommunizieren.
  • Im SDK-Laufzeitprozess ist jetzt lokaler Speicher verfügbar.
  • Mit einem SDK können in der SDK-Laufzeit auch eigenständige videobasierte Anzeigen oder Inhalte gerendert werden.
  • Es wurden Erläuterungen zur Nutzung von Reflexionen hinzugefügt. Unter anderem ist jetzt auch die Möglichkeit zur Nutzung von Reflexion verfügbar, sofern der Inhalt nicht in einem anderen RE-SDK enthalten ist.

Attribution Reporting API

In dieser Version wurden Änderungen eingeführt, um die Verwendung der Attribution Reporting API verständlicher zu machen:

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

FLEDGE in der Android API

Diese Version enthält neue Funktionen, die beim Testen und Debuggen hilfreich sind, sowie eine interne Verbesserung:

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

Topics API

Diese Version enthält mehrere wichtige Änderungen an der Topics API:

  • Der Rückgabetyp der getTopics() API wurde in den neuen Objekttyp Topic geändert, der Ganzzahl-IDs, die Topics in der Taxonomie entsprechen, sowie Informationen zum Klassifikator und den Taxonomieversionen einschließt. Sie sollten alle vorhandenen Anwendungen aktualisieren, die diese API verwenden.
  • Für die Topics API ist jetzt eine neue normale Berechtigung erforderlich.
  • Einführung des Klassifizierungssystems auf dem Gerät, mit dem Themen basierend auf öffentlich verfügbaren App-Informationen dynamisch zugewiesen werden.

Bekannte Probleme

  • Die erste Version dieser Geräteabbildungen (Version 6) wird im Android-Emulator Version 31.2.10 nicht geladen. Aktualisierte Geräte-Images, die das Problem beheben, sind seit dem 27. Juli 2022 verfügbar.

Entwicklervorschau 3

Veröffentlichungsdatum: 9. Juni 2022

In der Privacy Sandbox für Android-Entwicklervorschau 3 werden Funktionen für die Attribution Reporting API und FLEDGE für Android hinzugefügt.

Attribution Reporting API

Die Attribution Reporting API verbessert den Datenschutz für Nutzer, da die Abhängigkeit von parteiübergreifenden Nutzerkennungen beseitigt wird. Sie unterstützt wichtige Anwendungsfälle für die App-Attributions- und Conversion-Analyse.

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

  • Attributionsquelle registrieren und Ereignisse auslösen
  • Priorisierte Trainingsquelle und Attribution nach der Installation
  • Ereignisberichte erhalten
  • Du erhältst zusammengefasste Berichte, die in diesem Release unverschlüsselt sind

Zur Unterstützung der Tests werden eine Beispiel-App und ein AdTech-Referenzserver bereitgestellt.

Bekannte Probleme:

FLEDGE auf Android

Mit FLEDGE für Android wird eine neue Möglichkeit eingeführt, Anzeigen basierend auf den von App-Entwicklern definierten benutzerdefinierten Zielgruppen und den Interaktionen mit der App auszuliefern. Mit dieser Lösung werden Informationen und zugehörige Anzeigen lokal gespeichert. Außerdem bietet sie ein Framework zum Orchestrieren der Workflows für die Anzeigenauswahl.

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

  • Benutzerdefinierte Zielgruppe beitreten oder verlassen und beobachten, wie sich Parameterwerte auf Auktionsergebnisse auswirken können
  • JavaScript-Auktionsdatencode von Remote-Endpunkten abrufen
  • Anzeigenauktionen auf dem Gerät konfigurieren und initiieren
  • Impressionsberichte verarbeiten
  • Eine Beispiel-App und eine Beispiel-Serverkonfiguration stehen zur Verfügung, um das Testen zu erleichtern.

Bekannte Probleme:

Entwicklervorschau 2

Veröffentlichungsdatum: 17. Mai 2022

Entwicklervorschau 2 enthält eine frühe Vorabversion der Attribution Reporting APIs für MeasurementManager.

  • Sie können registerSource() und registerTrigger() aufrufen, um App-Anzeigenereignisse zu registrieren und Berichtsdaten auf Ereignisebene für die App-zu-App-Attribution zu erhalten. In der aktuellen Implementierung wird das Attributionsmodell „Letzte Interaktion“ verwendet. Der Versand der Berichte wird in den Berichtszeiträumen festgelegt. Weitere Informationen finden Sie in der API-Referenz MeasurementManager.

  • Der Upload des Berichts erfolgt nach festen Intervallen und nicht zum exakt geplanten Zeitpunkt. Das Uploadintervall für Berichte beträgt standardmäßig 4 Stunden, kann aber mit dem folgenden ADB-Befehl überschrieben werden:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

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

  • Weitere Funktionen der MeasurementManager Attribution Reporting API wie zusammengefasste Berichte, die Attribution nach der Installation und Weiterleitungen sind in einer späteren Version verfügbar.

Entwicklervorschau 1

Veröffentlichungsdatum: 28. April 2022

Entwicklervorschau 1 enthält frühe Vorabversionen der Topics API und der SDK-Laufzeit. Die Funktionen für FLEDGE unter Android und die Attribution Reporting API werden in einer zukünftigen Version verfügbar sein.

  • Topics API
    • Die getTopics() API gibt derzeit für eine begrenzte Anzahl von Anwendungen Testwerte basierend auf der Offlineklassifizierung zurück. Klassifizierungen auf dem Gerät sind noch nicht implementiert.
    • Mit ADB-Befehlen können Sie Epochenintervalle überschreiben und Epochenberechnungen erzwingen.
    • Weitere Informationen finden Sie im Topics-Entwicklerleitfaden.
  • SDK-Laufzeit
    • Mit dem neuen <sdk-library>-Element in der Manifestdatei deiner SDK-App kannst du laufzeitfähige SDKs (RE SDKs) verpacken und erstellen. Installieren Sie RE SDKs auf einem unterstützten Testgerät oder Emulator, wie Sie es normalerweise bei der Entwicklung einer App tun würden.
    • Sie können RE SDKs in eine App einbinden, sie in die SDK-Laufzeit laden und die Auswirkungen des eingeschränkten Zugriffs auf den SDK-Code – Berechtigungen, Arbeitsspeicher und Kommunikation zwischen Apps und SDKs – testen. Speicher-APIs für RE SDKs sind noch nicht implementiert und werden in einer zukünftigen Version verfügbar sein.
    • Mit einem SDK können WebView-basierte Banneranzeigen oder Inhalte in der SDK-Laufzeit gerendert werden.
    • Weitere Informationen finden Sie im Entwicklerleitfaden zur SDK Runtime.
  • Android-Lint-Prüfungen
    • Bei Lint-Prüfungen von Android werden in Projekten, die mit dem API-Level TiramisuPrivacySandbox kompiliert wurden, fälschlicherweise Warnungen angezeigt. Möglicherweise wird die Warnmeldung angezeigt: „Für den Aufruf ist API-Level 33 erforderlich“. Sie können dieses Problem vorübergehend mit der Annotation @SuppressLint("NewApi") beheben.