privacysandbox ads

  
הספרייה הזו מאפשרת שילוב עם ממשקי API לשמירה על הפרטיות, שהם חלק מארגז החול לפרטיות ב-Android.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
12 במרץ 2025 - - 1.1.0-beta12 -

הצהרת יחסי תלות

כדי להוסיף תלות ב-privacysandbox-ads, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

מגניבKotlin
dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}
 
dependencies {

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

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

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.1

גרסה 1.1.0-beta12

12 במרץ 2025

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 משוחררים. גרסת 1.1.0-beta12 מכילה את ההוספות האלה.

תכונות חדשות

  • עדיפות של קהל מותאם אישית: הוספנו שדה עדיפות בקהל המותאם אישית. כך הקונים יכולים לציין ערך עדיפות ב-CustomAudience. המערכת תשתמש בערך הזה כדי לזהות קהלים מותאמים אישית שצריך לכלול במכרז, אם קבוצת הקהלים המותאמים אישית של הקונה חורגת מהמגבלות הגודל לכל קונה
  • הגדרות המוכר: התכונה הזו מאפשרת למוכרים להגדיר פרמטרים של מכרזים כדי לשלוט בגודל של עומס העבודה ובמשתתפים במכרז. הגדרת המכרז של המוכר תאפשר למוכרים לציין:
    • רשימת קונים מורשים
    • במכרזים שהמוכר התחיל, רק הקונים ברשימת ההיתרים יוכלו להוסיף CustomAudiences למכרז
    • מגבלת גודל לקונה
    • המוכרים יכולים לציין מגבלה לכל קונה כדי לקבוע את גודל הנתונים שיועלו על ידי כל קונה למטען הייעודי שנשלח אל SellerFrontendService. אם הקונה חורג מהמגבלה על הגודל לכל קונה, המערכת תשתמש בעדיפות CustomAudience שהוגדרה בהגדרות של המטען הייעודי לקונה כדי לקבל את הנתונים במסגרת המגבלות הצפויות.
    • מגבלת הגודל המקסימלית של המטען הייעודי
    • למוכרים שונים יכולה להיות הקצאה שונה של משאבים, ויכול להיות שהם ירצו להגדיר מגבלה על הגודל המקסימלי של עומס העבודה (payload) בכל מכרז. מגבלת הגודל המקסימלי תהיה בהתאם לקטגוריות הגודל הקבועות שהוגדרו על ידי ה-API של ProtectedAudience.
  • עדכונים מושהים של קהלים בהתאמה אישית: התכונה הזו מאפשרת לקונים לתזמן עדכונים מושהים של קהלים בהתאמה אישית. כל בקשת עדכון מאפשרת למבצע הקריאה להגדיר עדכון מתוזמן באמצעות ה-API החדש של scheduleCustomAudienceUpdate(). בכל עדכון, המשתמש יכול לציין קבוצות של קהלים מותאמים אישית להצטרפות או ליציאה.

שינויים ב-API

  • הוספת הגדרות מוכר ב-GetAdSelectionRequest API (Ibb5c7)
  • השקת ממשק ה-API של ScheduleCustomAudienceUpdate כניסיוני (I6b905)

גרסה 1.1.0-beta11

30 באוקטובר 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 משוחררים. גרסת 1.1.0-beta11 כוללת את ההוספות האלה.

תכונות חדשות

  • העדכון הזה מסיר את התמיכה במדידת ביצועים בארגז החול לפרטיות ובממשקי ה-API של adid ב-Android R, שהוצאו משימוש. קריאות לקבלת כיתות הניהול ב-Android R יחזירו עכשיו null.

גרסה 1.1.0-beta10

21 באוגוסט 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 משוחררים. גרסת 1.1.0-beta10 כוללת את ההוספות האלה.

שינויים ב-API

  • הוספת עומסי יתר חסרים של קונסטרוקטור Java לממשקי ה-API הניסיוניים GetAdSelectionDataOutcome,‏ PersistAdSelectionResultRequest,‏ ReportEventRequest ו-FetchAndJoinCustomAudienceRequest. (I19e7f)

גרסה 1.1.0-beta09

10 ביולי 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 משוחררים. גרסת 1.1.0-beta09 מכילה את ההוספות האלה.

שינויים ב-API

  • הוספת עומסי יתר חסרים של קונסטרוקטור Java ל-GetAdSelectionDataRequest Experimental API. (Ifbf88).

גרסה 1.1.0-beta08

26 ביוני 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 משוחררים. גרסת 1.1.0-beta08 כוללת את ההוספות האלה.

תכונות חדשות

  • הוספנו תמיכה באותות מוגנים של אפליקציות.
  • תמיכה במספר ספקי ענן במכרזים של שרתים ל-B&A.

שינויים ב-API

  • ממשק ה-API הניסיוני GetAdSelectionDataRequest::seller לא מאפשר ערך null. (I68044)
  • מוסיפים את GetAdSelectionDataRequest::coordinatorOriginUri Experimental API. (I18c0b)
  • הוספת ה-API של updateSignals. (Ia8512)

גרסה 1.1.0-beta07

14 במאי 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 משוחררים. גרסת 1.1.0-beta07 מכילה את ההוספות האלה.

תכונות חדשות

  • GetTopics תומך עכשיו בתשובות מוצפנות כחלק מ-GetTopicsResponse.

שינויים ב-API

  • הוספת EncryptedTopic לכיתה GetTopicResponse. (Iab362)

גרסה 1.1.0-beta06

17 באפריל 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 משוחררים. גרסת 1.1.0-beta06 מכילה את ההוספות האלה.

הערה

  • החל מהגרסה 1.1.0-beta06 של privacysandbox-ads jetpack, כל המכשירים עם Android R שפועלים בהם הדגלים יוכלו לגשת ל-PPAPI. בכל תרחיש לדוגמה שלא צריך לתמוך ב-Android R, יידרשו אמצעי הגנה נוספים בקוד באמצעות קוד jetpack של privacysandbox-ads.

תכונות חדשות

  • תמיכה בתאימות לאחור ל-Android R.

גרסה 1.1.0-beta05

3 באפריל 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 משוחררים. גרסת 1.1.0-beta05 כוללת את ההוספות האלה.

תיקוני באגים

  • נוספה תפיסת שגיאות כשהגדרת הכיתה לא נמצאת במכשירי Android S בגלל שהתג uses-library חסר במניפסט.

גרסה 1.1.0-beta04

24 בינואר 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 משוחררים. גרסה 1.1.0-beta04 כוללת את ההצהרות האלה.

תכונות חדשות

  • ממשק API חדש שתומך בדיווח על אירועי משתמשים לאחר המכרז
  • נוספה תמיכה בסינון לפי מכסת תדירות במודעות רימרקטינג
  • תמיכה בהענקת גישה ל'הצטרפות לקהל מותאם אישית'
  • תמיכה בקיצוץ של רשתות בתהליך בחירת הרשת (Mediation) ב-Waterfall
  • תמיכה במכרזים מוגנים בשרתים של בידינג ומכרזים

שינויים ב-API

  • הצגת ממשק ה-API הניסיוני AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2)
  • הצגת ממשק ה-API הניסיוני ReportEventRequest::inputEvent (Ib94f3)
  • הופכים את השדה ReportImpressionRequest::adSelectionConfig לאפשרות אופציונלית (Ief280)
  • הצגת ממשקי ה-API הניסיוניים AdSelectionManager::getAdSelectionData ו-AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • הצגת CustomAudienceManager::fetchAndJoinCustomAudience API ניסיוני (I09152)
  • הצגת ממשק ה-API הניסיוני AdSelectionManager::reportEvent (I0d7dc)
  • הוספנו את ה-API הניסיוני AdSelectionManager::updateAdCounterHistogram ושינינו את AdData כדי לציין סדרה של AdFilters (I87b83)

תיקוני באגים

  • עכשיו מתבצעת התאמה של URIs של קלט באתר/במקור משותף, במקום דרישה להתאמה מדויקת של שם המארח.
  • תיקון הבדיקה שנכשלה בגלל סכמת HTTPS חסרה (d573058)
  • תיקון סכמת HTTPS חסרה מכתובות URL באינטרנט (cecdcb8)
  • הוספת הערה על זריקות לממשקי ה-API למדידת ביצועים (2dba359)

גרסה 1.1.0-beta03

15 בנובמבר 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 משוחררים. גרסה 1.1.0-beta03 כוללת את ההצהרות האלה.

תכונות חדשות

  • תמיכה בתאימות לאחור ל-Android S.

גרסה 1.1.0-beta02

4 באוקטובר 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 משוחררים. גרסה 1.1.0-beta02 כוללת את ההתחייבויות האלה.

שינויים ב-API

  • הסרת בדיקת הגרסה T+ ממערכי הבקשות למדידות. לקוחות לא צריכים לבצע בדיקה של גרסת הפלטפורמה של T+ בצד שלהם כדי לגשת לכיתות הבקשות MeasurementManager של sandbox הפרטיות. MeasurementManager יהיה null בהתנהגות החדשה. (Ieb105)

גרסה 1.1.0-beta01

23 באוגוסט 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 פורסמים ללא שינויים. גרסה 1.1.0-beta01 כוללת את השמירות האלה.

גרסה 1.1.0-alpha01

9 באוגוסט 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 ו-androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 משוחררים. גרסה 1.1.0-alpha01 כוללת את ההוספות האלה.

שינויים ב-API

  • הצגת רשימת registerSource (Iae92f)
  • הוסרו שימושים ב-API הניסיוני isAtLeastU() (Ie9117, ‏ b/289269026)

תיקוני באגים

  • מיזוג של קובצי API ניסיוניים וציבוריים (I15da3, ‏ b/278769092)

גירסה 1.0

גרסה 1.0.0-beta05

7 ביוני 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 משוחררים. גרסה 1.0.0-beta05 כוללת את ההצהרות האלה.

תיקוני באגים

  • הוספת בדיקה של תוסף SDK 5 אל TopicsManager
  • שינוי התלות של פונקציות הקורוטיינטים ב-Kotlin ל-1.7.1 כדי למנוע שגיאות כפולות ב-build של הכיתות ב-Gradle

גרסה 1.0.0-beta04

10 במאי 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 משוחררים. גרסה 1.0.0-beta04 כוללת את ההצהרות האלה.

תיקוני באגים

  • פתרון בעיית נעילה גורפת כשמבצע הקריאה מפעיל ממשקי API למדידת מודעות בשרשור הראשי. (I65361)

גרסה 1.0.0-beta03

19 באפריל 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 משוחררים. גרסה 1.0.0-beta03 מכילה את ההצהרות האלה.

תכונות חדשות

  • הפעלת Preview API ל-Topics.

גרסה 1.0.0-beta02

22 במרץ 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 משוחררים. גרסה 1.0.0-beta02 מכילה את ההצהרות האלה.

תיקוני באגים

  • הפעלת ממשקי ה-API של MeasurementManager עבור תוסף SDK מגרסה 5 ואילך.
  • השבתנו את ממשקי ה-API של MeasurementManager עבור תוסף ה-SDK בגרסה 4 ואילך.

גרסה 1.0.0-beta01

22 בפברואר 2023

הגרסאות androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 פורסמו ללא שינויים משמעותיים. גרסה 1.0.0-beta01 שוחררה מענף פנימי.

שינויים בהתנהגות

  • דוחות השיוך (Attribution) הושבתו ולא זמינים לשימוש בגרסה הזו.

גרסה 1.0.0-alpha01

11 בינואר 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 ו-androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 משוחררים. גרסה 1.0.0-alpha01 שוחררה מענף פנימי.

  • זוהי ספרייה חדשה של Jetpack שמאפשרת שילוב עם ממשקי ה-API לשמירה על הפרטיות של ארגז החול לפרטיות (Topics, ‏ FLEDGE ו-Attribution Reporting).
  • אפשר להשתמש בממשקי ה-API של ארגז החול לפרטיות ב-Jetpack כתחליף לממשקי ה-API של ארגז החול לפרטיות שכלולים ב-Extension SDK 4.