privacysandbox ads

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von privacysandbox-ads hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
 
}

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
   
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.1

Version 1.1.0-beta12

12. März 2025

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 werden freigegeben. Version 1.1.0-beta12 enthält diese Commits.

Neue Funktionen

• Priorität der benutzerdefinierten Zielgruppe: Wir haben der benutzerdefinierten Zielgruppe ein Prioritätsfeld hinzugefügt. So können Käufer einen Prioritätswert in einer CustomAudience angeben. Mit diesem Wert werden benutzerdefinierte Zielgruppen identifiziert, die in einer Auktion berücksichtigt werden sollen, wenn die Anzahl der benutzerdefinierten Zielgruppen des Käufers die Größenbeschränkungen pro Käufer überschreitet.
• Verkäuferkonfiguration: Mit dieser Funktion können Verkäufer Auktionsparameter definieren, um die Nutzlastgröße und die Auktionsteilnehmer zu steuern. In der Auktionskonfiguration für Verkäufer können Verkäufer Folgendes angeben:
  • Liste der zulässigen Käufer
  • Bei Auktionen, die von diesem Verkäufer initiiert werden, können nur die Käufer auf der Zulassungsliste CustomAudiences für die Auktion beitragen.
  • Maximale Anzahl pro Käufer
  • Verkäufer können ein Limit pro Käufer festlegen, um die Datenmenge zu regulieren, die von jedem Käufer in die an SellerFrontendService gesendete Nutzlast hochgeladen wird. Wenn der Käufer die Größe pro Käufer überschreitet, wird die in der Käufernutzlastkonfiguration festgelegte CustomAudience-Priorität verwendet, um die Daten innerhalb der erwarteten Limits zu halten.
  • Maximale Größe der Nutzlast
  • Unterschiedliche Verkäufer können unterschiedliche Ressourcenzuweisungen haben und möchten möglicherweise ein maximales Limit für die Auktionsnutzlast pro Anfrage festlegen. Die maximale Größe berücksichtigt die Buckets mit fester Größe, die von der ProtectedAudience API festgelegt wurden.
• Verzögerte Aktualisierungen benutzerdefinierter Zielgruppen: Mit dieser Funktion können Käufer verzögerte Aktualisierungen für benutzerdefinierte Zielgruppen planen. Mit jeder Aktualisierungsanfrage kann der Aufrufer mithilfe der neuen scheduleCustomAudienceUpdate() API eine verzögerte Aktualisierung planen. Bei jeder Aktualisierung kann der Nutzer Gruppen von benutzerdefinierten Zielgruppen angeben, die hinzugefügt oder entfernt werden sollen.

API-Änderungen

• Verkäuferkonfiguration in der GetAdSelectionRequest API hinzufügen (Ibb5c7)
• Einführung der ScheduleCustomAudienceUpdate API als experimentell (I6b905)

Version 1.1.0-beta11

30. Oktober 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 werden freigegeben. Version 1.1.0-beta11 enthält diese Commits.

Neue Funktionen

• Durch dieses Update wird die Unterstützung für die Privacy Sandbox-Mess- und adid-APIs auf Android R aufgehoben, die eingestellt wurde. Aufrufe zum Abrufen der Managerklassen unter Android R geben jetzt „null“ zurück.

Version 1.1.0-beta10

21. August 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 werden freigegeben. Version 1.1.0-beta10 enthält diese Commits.

API-Änderungen

• Fehlende Java-Konstruktorüberladungen für die experimentellen APIs GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest und FetchAndJoinCustomAudienceRequest hinzufügen (I19e7f)

Version 1.1.0-beta09

10. Juli 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 werden freigegeben. Version 1.1.0-beta09 enthält diese Commits.

API-Änderungen

• Fehlende Java-Konstruktorüberladungen für die experimentelle GetAdSelectionDataRequest API hinzufügen (Ifbf88).

Version 1.1.0-beta08

26. Juni 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 werden freigegeben. Version 1.1.0-beta08 enthält diese Commits.

Neue Funktionen

• Unterstützung für Signale geschützter Apps hinzugefügt.
• Unterstützung mehrerer Cloud-Anbieter für B&A-Serverauktionen.

API-Änderungen

• Der Wert für die experimentelle API GetAdSelectionDataRequest::seller darf nicht null sein. (I68044)
• Fügen Sie die experimentelle GetAdSelectionDataRequest::coordinatorOriginUri API hinzu. (I18c0b)
• updateSignals API hinzugefügt. (Ia8512)

Version 1.1.0-beta07

14. Mai 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 werden freigegeben. Version 1.1.0-beta07 enthält diese Commits.

Neue Funktionen

• GetTopics unterstützt jetzt verschlüsselte Antworten als Teil von GetTopicsResponse.

API-Änderungen

• EncryptedTopic wurde der Klasse GetTopicResponse hinzugefügt. (Iab362)

Version 1.1.0-beta06

17. April 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 werden freigegeben. Version 1.1.0-beta06 enthält diese Commits.

Note

• Ab der Privacy Sandbox-Anzeigen-Jetpack-Version 1.1.0-beta06 können alle Android R-Geräte mit aktivierten Flags auf die PPAPIs zugreifen. Für Anwendungsfälle, die Android R nicht unterstützen sollten, sind im Code zusätzliche Guard-Objekte mit dem Privacy Sandbox-Ads-Jetpack-Code erforderlich.

Neue Funktionen

• Unterstützung der Abwärtskompatibilität mit Android R

Version 1.1.0-beta05

3. April 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 werden freigegeben. Version 1.1.0-beta05 enthält diese Commits.

Fehlerkorrekturen

• Es wurde eine Fehlerbehandlung hinzugefügt, wenn auf Android S-Geräten aufgrund eines fehlenden „uses-library“-Tags im Manifest keine Klassendefinition gefunden wird.

Version 1.1.0-beta04

24. Januar 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 werden freigegeben. Version 1.1.0-beta04 enthält diese Commits.

Neue Funktionen

• Neue API zur Unterstützung von Berichten zu Nutzerereignissen nach der Auktion
• Unterstützung für die Filterung nach Frequency Capping für Remarketing-Anzeigen hinzugefügt
• Unterstützung der Delegierung von „Zielgruppe mit benutzerdefinierten Zielgruppen verknüpfen“
• Unterstützung für die Kürzung der Vermittlungsabfolge
• Unterstützung für geschützte Auktionen auf Gebots- und Auktionsservern

API-Änderungen

• Einführung der experimentellen AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) API (I86cd2)
• Einführung der experimentellen ReportEventRequest::inputEvent API (Ib94f3)
• ReportImpressionRequest::adSelectionConfig als optional kennzeichnen (Ief280)
• Einführung der experimentellen APIs AdSelectionManager::getAdSelectionData und AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
• Einführung der experimentellen CustomAudienceManager::fetchAndJoinCustomAudience API (I09152)
• Einführung der experimentellen AdSelectionManager::reportEvent API (I0d7dc)
• Einführung der experimentellen AdSelectionManager::updateAdCounterHistogram API und Änderung von AdData, um eine Reihe von AdFilters anzugeben (I87b83)

Fehlerkorrekturen

• Eingabe-URIs werden jetzt anhand einer freigegebenen Website/eines freigegebenen Ursprungs abgeglichen, anstatt dass eine genaue Übereinstimmung des Hostnamens erforderlich ist.
• Fehler beim Testen aufgrund fehlenden HTTPS-Schemas beheben (d573058)
• Fehlendes HTTPS-Schema in Web-URLs korrigieren (cecdcb8)
• Den Mess-APIs die Anmerkung „throws“ hinzufügen (2dba359)

Version 1.1.0-beta03

15. November 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 werden freigegeben. Version 1.1.0-beta03 enthält diese Commits.

Neue Funktionen

• Abwärtskompatibilität mit Android S

Version 1.1.0-beta02

4. Oktober 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 werden freigegeben. Version 1.1.0-beta02 enthält diese Commits.

API-Änderungen

• Die T+-Versionsprüfung wurde aus den Klassen für Messanfragen entfernt. Clients müssen für den Zugriff auf die Anfrageklassen MeasurementManager der Privacy Sandbox keine T+-Plattformversionsprüfung durchführen. MeasurementManager ist dann null. (Ieb105)

Version 1.1.0-beta01

23. August 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 werden ohne Änderungen veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Version 1.1.0-alpha01

9. August 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 und androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 werden freigegeben. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

• Einführung der registerSource-Liste (Iae92f)
• Verwendungen der experimentellen isAtLeastU() API entfernt (Ie9117, b/289269026)

Fehlerkorrekturen

• Zusammenführen von experimentellen und öffentlichen API-Dateien (I15da3, b/278769092)

Version 1.0

Version 1.0.0-beta05

7. Juni 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 werden freigegeben. Version 1.0.0-beta05 enthält diese Commits.

Fehlerkorrekturen

• TopicsManager wird eine Prüfung für SDK-Erweiterung 5 hinzugefügt
• Die Abhängigkeit von Kotlin-Coroutinen wurde auf 1.7.1 erhöht, um doppelte Buildfehler von Klassen in Gradle zu vermeiden

Version 1.0.0-beta04

10. Mai 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 werden freigegeben. Version 1.0.0-beta04 enthält diese Commits.

Fehlerkorrekturen

• Behebung des Deadlock-Problems, wenn APIs zur Analyse von Anzeigendiensten vom Aufrufer im Hauptthread aufgerufen werden. (I65361)

Version 1.0.0-beta03

19. April 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 werden freigegeben. Version 1.0.0-beta03 enthält diese Commits.

Neue Funktionen

• Die Preview API für Topics wurde aktiviert.

Version 1.0.0-beta02

22. März 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 werden freigegeben. Version 1.0.0-beta02 enthält diese Commits.

Fehlerkorrekturen

• Die MeasurementManager APIs wurden für die SDK-Erweiterung Version 5 und höher aktiviert.
• Die MeasurementManager APIs wurden für die SDK-Erweiterungsversion 4 und niedriger deaktiviert.

Version 1.0.0-beta01

22. Februar 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 werden ohne nennenswerte Änderungen veröffentlicht. Version 1.0.0-beta01 wurde aus einem internen Branch veröffentlicht.

Verhaltensänderungen

• Attributionsberichte wurden deaktiviert und sind in dieser Version nicht verfügbar.

Version 1.0.0-alpha01

11. Januar 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 und androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 werden freigegeben. Version 1.0.0-alpha01 wurde aus einem internen Branch veröffentlicht.

• Dies ist eine neue Jetpack-Bibliothek, die die Einbindung in die datenschutzfreundlichen APIs der Privacy Sandbox (Topics API, FLEDGE API und Attribution Reporting API) ermöglicht.
• Die Privacy Sandbox-APIs von Jetpack können als Drop-in-Ersatz für die Privacy Sandbox-APIs verwendet werden, die im Extension SDK 4 bereitgestellt werden.