נתוני הגרסה של 'ארגז החול לפרטיות ב-Android'

ארגז החול לפרטיות ב-Android מאפשר גישה לתצוגה מקדימה למפתחים ולתוכניות בטא. במשך הזמן נציג ממשקי API ותכונות חדשים בתצוגה המקדימה למפתחים, ונקדם ממשקי API מיוצבים לתוכנית הבטא. נשמח לקבל משוב.

אם לא השתמשתם בארגז החול לפרטיות ב-Android, התחילו במאמר סקירה כללית של התוכנית. כדי להתחיל ליצור את ארגז החול לפרטיות בפרויקט, צריך להגדיר את סביבת הפיתוח ולהוריד את ארגז החול לפרטיות ב-Android במכשיר הבדיקה או באמולטור.

הגרסאות הנוכחיות

תצוגה מקדימה של VanillaIceCream ל-Android

Protected Audience API

  • נוספה האפשרות להעביר מודעות מאומתות לפי הקשר למכירה פומבית מוגנת. זה כולל גם סינון שלילי לאפליקציות שכבר מותקנות במכשיר, כמו גם מכסת תדירות של מספר קליקים, חשיפות, צפיות וזכיות. ההטמעה שונה מהגרסאות הקודמות, מאחר שהמודעות לפי הקשר נדרשות לחתום על ידי טכנולוגיות המודעות. אפשר לקרוא איך לבצע את ההטמעה הזו במדריך למפתחים.
  • השם של contextAds שונה ל-SignedcontextAds יחד עם getter ו-setter קשורים ב-AdSelectionConfig; getPerBuyerSignatureAds, setPerBuyerSignedcontextAds
  • אם מועברת אפליקציה לפי הקשר לא מאומתת, היא תוסר מהמכרז

Attribution Reporting API

עדכון לגרסת הבטא של ארגז החול לפרטיות ב-Android מנובמבר 2023

הגרסה הזו של גרסת הבטא של ארגז החול לפרטיות ב-Android כוללת עדכונים בממשקי ה-API של ארגז החול לפרטיות במכשירי Android 14 ציבוריים. ניתן להוריד את ה-SDK ואת התמונות של המכשיר באמצעות מנהל ה-SDK של Android Studio כ-Android API 34, רמת תוסף 10, והפונקציונליות שלו דומה לזו של [תצוגה מקדימה למפתחים 9][b25], עם כמה שינויים חשובים.

Protected Audience API

  • טכנולוגיות פרסום יכולות עכשיו להשתמש ב[הענקת גישה לקהלים בהתאמה אישית][b26] כדי להצטרף לקהל בהתאמה אישית מטעם קונה שאין לו נוכחות במכשיר.
  • עכשיו יש ב-Android תמיכה בניהול מכרזים על שירותים של בידינג ומכרזים.
  • מכרזים של 'קהלים מוגנים' תומכים בחיוב לפי עלות לקליק.
  • מעכשיו, הדוחות והמכרזים של Protected Audience API תומכים בכותרות של גרסאות נתונים עבור אותות מהימנים של בידינג.
  • מכרזים של 'קהלים מוגנים' תומכים בסינון של מכסת תדירות באירועי WIN.
  • Protected Audience API תומך עכשיו ב[שילוב עם Attribution Reporting API][b27].

Attribution Reporting API

  • Attribution Reporting API תומך עכשיו ב[שילוב עם Protected Audience][b28]

זמן ריצה ל-SDK

  • יכולת מ-SDK לטעון ערכות SDK אחרות בתוך זמן הריצה של ה-SDK כדי לתמוך בתרחישים לדוגמה של תהליך בחירת הרשת (Mediation)

גרסאות קודמות

תצוגה מקדימה 10 למפתחים

תאריך ההשקה: 19 בדצמבר 2023

מגבלות ידועות

  • יש בעיה שגורמת ל-Google Play Services לקרוס ברקע ומודיעה למשתמש שוב ושוב:
    • הפעלה מחדש של המכשיר עשויה לפתור את הבעיה.
    • במהלך הבדיקה, אם נתקלתם בבעיות בתזמון של הקריאות האסינכרוניות, נסו להוסיף את פקודת ה-adb הבאה כדי להאריך את הסף עד שהזמן הקצוב לתפוגה יעבור:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • במכשיר פיזי בלבד: אין תמיכה בהוספת חשבון Google. כדי להעביר את המכשיר למסך הבית, פועלים לפי השלבים הבאים:
    • מתקינים את התמונה של התצוגה המקדימה בטלפון.
    • מבצעים את שלבי אשף ההגדרה גם אם לא מחוברים ל-Wi-Fi או לחבילת גלישה.
    • במסך הבית, מתחברים לרשת Wi-Fi או לחבילת גלישה.
    • יש להפעיל מחדש את המכשיר.

Protected Audience API

  • אנחנו מוסיפים יכולות חדשות, [Protected App Signals][dp98], כדי לתמוך בהצגת מודעות רלוונטיות להתקנת אפליקציות. במסגרת הפיתוח הזה, אנחנו משיקים ממשקי API שמאפשרים טכנולוגיות פרסום כדי:
    • איסוף אותות על ידי אחסון אירועים באפליקציה באחסון מוגן במכשיר, שמשמשים להצגת מודעות רלוונטיות להתקנת אפליקציות.
    • מפעילים מכרז מוגן על שירותי בידינג ושירותי מכרזים בסביבות ביצוע מהימנות, כדי לקבל גישה לאותות הרלוונטיים כדי לעזור בבחירת המודעות ובבידינג.

Attribution Reporting API

  • בגרסה הזו של Attribution Reporting API:
    • מוסיף שילוב Protected Audience, שמאפשר מאפייני קהל מותאמים אישית בדוחות סיכום מצטברים.
    • תמיכה בספק Google Cloud כסביבת TEE עבור שירות הצבירה.
    • הוספת השדה shared_debug_key לתמיכה בניפוי באגים לצורך שיוך חוצה-פלטפורמות בלי הפניות אוטומטיות.
    • מוסיף כותרות גרסה בבקשות מפורטות של דוחות ניפוי באגים.

התאמה אישית במכשיר

  • גרסה ראשונית לחוקרים ופיתוח מוקדם.
  • התאמה אישית במכשיר מציגה דרך חדשנית להתאמה אישית של מוצרים ושירותים, תוך הגנה משופרת על הפרטיות של משתמשי הקצה. ההתאמה האישית במכשיר מספקת קבוצה של שירותים ואלגוריתמים כאבני בניין כדי להשיג את המטרה הזו, כולל, בין היתר:
    • Federated Compute (FC) שמאפשר אימון, הערכה והתאמה אישית של מודלים באמצעות Federated Learning. השימוש של ההתאמה האישית במכשיר ב-Federated Compute יתבסס על אימון מודלים ועל ההסקה (אופציונלית, אם יש צורך).
    • התאמות שמבוססות על מסנן קוקיו והתאמתו בין נתונים שנמצאים בנפרד.
    • אימון פרטי דיפרנציאלי (DP) של מודלים דלילים באמצעות שיטות חדשות כמו מזעור מתחלף של DP (לאימון על נתונים שנמצאים במיקום שונה) והתאמה אישית של מודלים באמצעות לוח DP. ### תצוגה מקדימה למפתחים 9

תאריך הפרסום: 15 באוגוסט 2023

מגבלות ידועות

  • נתוני מכרזים שנוצרו על ידי קריאה ל-Open Bidding ול-Auction API לא נמחקים באופן אוטומטי ב-DP9.
  • הפעלה של getAdSelectionData ו-persistAdSelectionResult כשמבטלים את ההסכמה תגרום לקריסה של התהליך.
  • תכונת הסינון השלילי לא פועלת עם getAdSelectionData ועם persistAdSelectionResult.

Protected Audience API

Attribution Reporting API

  • הגרסה הזו משפרת את דוחות ניפוי הבאגים של Attribution Reporting API על ידי:
    • תמיכה בדוחות מפורטים של ניפוי באגים נתמכים באינטרנט.
    • הפעלת דוחות של ניפוי באגים לפי שיוך באתרים ובאפליקציות (נדרש מזהה פרסום גם ברישום של אתרים וגם באפליקציות).
  • טכנולוגיות הפרסום יכולות להגדיר פרמטרים של "רעש" לתרחישי דיווח שונים.
  • הגרסה הזו עוברת לשיוך מבוסס-מקור, כלומר:
    • המקור משמש לרישום.
    • המערכת מקבלת כמה מקורות המשויכים לאתר אחד.
    • מגבלת קצב חדשה של יצירת בקשות ממקור אחד לכל אפליקציית מקור או הרשמה.
  • טכנולוגיות הפרסום יכולות עכשיו להשבית את ההרשמה לבדיקה מקומית של מקרי שימוש בדוחות שיוך (Attribution).

זמן ריצה ל-SDK

  • ניתן להפעיל את ה-SDK רק ברשימת היתרים של שירותים או לקשר אליה.
  • ל-SDK יש גישה רק לקבוצת משנה של המערכת ContentProvider (כמו com.android.providers.settings.SettingsProvider), שבה הנתונים שהושגו חסרים מזהים ולא ניתן להשתמש בהם כדי ליצור טביעת אצבע של המשתמש. הבדיקות האלה חלות גם על גישה אל ContentProvider באמצעות ContentResolver.
  • ל-SDK יש גישה רק לקבוצת משנה של מקלטי שידור מוגנים (למשל android.intent.action.AIRPLANE_MODE).
  • ה-SDK יכול להפעיל פעילות ששייכת לאפליקציה אחרת, אבל עם מגבלות על מה שאפשר לשלוח ב-Intent.

עדכון לגרסת הבטא של ארגז החול לפרטיות ב-Android ממרץ 2023

גרסת הבטא של ארגז החול לפרטיות ב-Android במרץ 2023 כוללת עדכונים בממשקי ה-API של ארגז החול לפרטיות במכשירי Android 13 ציבוריים. הגרסה הזו כוללת ממשקי API 5 של תוספים של שירותי מודעות, והפונקציונליות שלה דומה לתצוגה מקדימה למפתחים 6, עם כמה שינויים עיקריים.

מגבלות ידועות

  • משימת אחזור הרקע שרצה מדי פעם כדי לעדכן קהלים בהתאמה אישית של FLEDGE גורמת לתהליך לקריסה. בגלל הבעיה הזו, FLEDGE מושבת כברירת מחדל.

כללי

  • אפשר להשתמש ב-Attribution Reporting API החל מגרסה זו. ה-API הושבת בעבר. אם השתמשתם ב-Attribution Reporting API בגרסת הבטא הקודמת, עליכם לנקות את נתוני האפליקציה או המכשיר לפני השימוש בגרסת הבטא הזו באחת מהדרכים הבאות:
    • במכשיר או באמולטור, נכנסים להגדרות ומנקים אחסון ספציפי לאפליקציה (ולא רק את המטמון) של האפליקציות שמשמשות לבדיקה.
    • איפוס להגדרות המקוריות במכשיר הפיזי או המדמה.
    • במכשיר אמולציה, מבצעים את הפונקציה מחיקת נתונים.
  • דוחות השיוך (Attribution) תומכים עכשיו במפתחות של ניפוי באגים, שמאפשרים למפתחים לקבל מ-Attribution API דוחות ללא שינויים ודוחות עם שיפור פרטיות. מפתחות של ניפוי באגים מספקים הזדמנות לקבל תמונה ברורה יותר לגבי המבנה של הדוחות במהלך המעבר לארגז החול לפרטיות.
  • בדוחות השיוך (Attribution) התרחש לאחרונה באג בשירותי המודעות, שבהם registerSource ו-registerTrigger נכשלו ללא יוצא מן הכלל. אם נתקלתם בבעיות האלה במהלך הפיתוח, כבר השקנו תיקון והבעיה אמורה להיפתר עם הזמן.
  • פונקציונליות התצוגה המקדימה של Topics API זהה עכשיו לארגז החול לפרטיות בתצוגות המקדימות למפתחי Android. קורא של Topics API יכול להציג תצוגה מקדימה של נושאים בלי לכלול את הקריאה לאחזור הנושאים בחישוב של התקופה השבועית, או להשפיע על רשימת הנושאים המתועדים עבור מבצע הקריאה החוזרת. בשדה shouldRecordObservation יש פרטים נוספים.

  • כדי להפעיל בדיקה ב-FLEDGE ב-Android, צריך להירשם לתוכנית הבטא ולהשתמש באותו חשבון Google כדי להיכנס למכשירי הבדיקה. אחרת, ניסיונות להפעיל ממשקי API יגרמו ל-IllegalStateException עם ההודעה "השירות לא זמין". אמורים להחזיר את FLEDGE בגרסת הבטא הבאה.

    בינתיים, מומלץ להמשיך לבדוק באמצעות תצוגות מקדימות למפתחים, ואפשר להפעיל את FLEDGE באופן ידני במכשירים עם האזהרות הבאות:

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

    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

גרסאות קודמות

תצוגה מקדימה למפתחים 8

תאריך ההשקה: 23 במאי 2023

מגבלות ידועות

  • אפשר להוסיף למודעות מכסת תדירות מסוג WIN למודעות Protected Audience, אבל הסוג WIN עדיין לא נתמך והמערכת מתעלמת ממסננים מהסוג הזה.
  • כדי לדווח על חשיפות זכו בקונים שזכו במכרזים של Protected Audience, הקונים צריכים להיות רשומים לארגז החול לפרטיות. אי אפשר לבטל את הדרישה הזו.
  • כדי לגשת להגדרות של ארגז החול לפרטיות במכשיר שבו ארגז החול לפרטיות זמין, עוברים להגדרות > Google > מודעות > ארגז החול לפרטיות.
  • לא ניתן לפרוס פרויקטים עם אמולטורים ב-Android Studio Giraffe. גרסאות אחרות של Android Studio אמורות לפעול כראוי. פתרון הבעיה יושק ב-Android Studio Giraffe ב-26 במאי 2023.

Protected Audience API

Attribution Reporting API

  • נוספו מסנני טריגר מסוג OR. כלומר, המסננים כוללים עכשיו קבוצת מסננים, שהיא רשימה של מפות סינון. אם אף אחד מהמסננים לא ממופים בקבוצה תואם לנתוני הסינון של המקור, המערכת מתעלמת מהאובייקט event_trigger_data.
  • בוצע פיצול של חלון התפוגה של החשיפות וחלון הדיווח לממשקי API של צבירה ושל אירוע ברמת האירוע.
  • נוספה תמיכה במפתחות לביטול כפילויות בדוחות נצברים.
  • הוספנו את scheduled_report_time לדוחות האירועים כדי להתאים לארגז החול לפרטיות באינטרנט.
  • הטמעת שיוך חוצה-פלטפורמות ללא הפניות לכתובת אחרת.

זמן ריצה ל-SDK

תצוגה מקדימה למפתחים 7

תאריך ההשקה: 26 בינואר 2023

FLEDGE ב-Android API

  • השם של הפרמטר custom_audience_signals השתנה בשיטות ה-JavaScript הבאות:
    • השם של generateBid() השתנה ל-custom_audience_bidding_signals.
    • השם של scoreAd() השתנה ל-custom_audience_scoring_signals.
    • השם של reportWin() השתנה ל-custom_audience_reporting_signals.
  • בגרסה הזו נוסף שינוי חדש של selectAds להשוואת תוצאות של selectAds באמצעות AdSelectionFromOutcomeConfig. כך מתאפשרת ערכות SDK של טכנולוגיות פרסום שמתבססות על ה-API הזה כדי להפעיל את תהליך בחירת הרשת (Mediation) ב-Waterfall. פרטים נוספים מופיעים במדריך למפתחים.
  • ה-API של selectAds() תומך עכשיו בשמירה במטמון לצורך בידינג ולוגיקת חישוב שאוחזרה במהלך בחירת המודעות.
    • אפשר לשלוט במטמון באמצעות כותרות Cache-Control שהוחזרו על ידי השרתים במהלך קריאה לאחזור JavaScript. כדאי להשתמש ב-no-cache או ב-no-store כדי למנוע שמירה במטמון של תגובות של JavaScript, וכדי להגדיר את משך הזמן של המטמון כדי לקבוע את משך הזמן המקסימלי.
    • כברירת מחדל, הערך הנוכחי של המטמון max-age מוגדר ליומיים.

Attribution Reporting ב-Android API

  • בגרסה הזו נוספה תמיכה בהפניות אוטומטיות בשרשרת עבור registerSource() ו-registerTrigger(). צרכן ה-API יכול עכשיו להשתמש בהפניה אוטומטית מסוג HTTP כתגובת השרת.

גרסת בטא ראשונית, ינואר 2023

תאריך ההשקה: 9 בינואר 2023

'ארגז החול לפרטיות' ב-Android בטא 1 מייצג את הזמינות הראשונה של ממשקי ה-API של ארגז החול לפרטיות במכשירים ציבוריים, ומוסיף שיפורים לאזורים שמפורטים בהמשך.

כללי

  • הפונקציונליות של ארגז החול לפרטיות ב-Android Beta 1 זהה מבחינה פונקציונליות לתצוגה מקדימה 5 למפתחים, עם כמה תכונות והגבלות נוספות שמפורטות בהמשך.
  • המפתחים צריכים להשלים תהליך הרשמה כדי להשתמש בממשקי API שקשורים למודעות (כולל Topics, FLEDGE ו-Attribution Reporting). בתהליך הרישום מאמתים את זהות המפתח ואוספים נתונים ספציפיים למפתח שנדרשים לממשקי ה-API.
  • בגרסת הבטא של ארגז החול לפרטיות ב-Android, מפתחים שנרשמו לרשימת ההיתרים וששלחו אותה עשויים לקבל הזדמנות לבצע בדיקה במכשירים פיזיים שלהם. כדי לפתח בגרסה מול ממשקי API יציבים, הורידו את תוספים חדשים ל-SDK של מודעות שירותים 4.

Topics API

Attribution Reporting API

  • Attribution Reporting הושבת ואינו זמין לשימוש בגרסה הזו. הגישה ל-API הזה תופעל מחדש בגרסת הבטא הבאה. מומלץ להמשיך לבדוק באמצעות תצוגות מקדימות למפתחים.

זמן ריצה ל-SDK

המגבלות הבאות צפויות להיפתר בגרסה הגדולה הבאה של הפלטפורמה ל-Android:

  • עיבוד מודעות בתצוגה הניתנת לגלילה כמו RecyclerView לא פועל כרגע באופן תקין. אם גודל הרכיב ישתנה, ייתכן שתיתקל ב-jank. אירועי גלילה במגע המשתמש לא מועברים לסביבת זמן הריצה כמו שצריך.
  • העיבוד של WebView לא זמין בתהליך זמן הריצה של ה-SDK.
  • אחסון לפי SDK אינו זמין.
  • התמיכה בממשקי ה-API של getAdId ו-getAppSetId עדיין לא הופעלה.

תצוגה מקדימה למפתחים 6

תאריך ההשקה: 31 באוקטובר 2022

בגרסה 6 של 'ארגז החול לפרטיות' בתצוגה מקדימה למפתחי Android, הוספנו שיפורים בתחומים הבאים:

כללי

  • כהכנה להשקה של גרסת הייצור, הוספנו לאפליקציה 'תצוגה מקדימה למפתחים 6' סימון שמאפשר להשבית את הגישה ל-API לשמירה על הפרטיות כברירת מחדל. למטרות בדיקה, מפעילים את הגישה ל-API לשמירה על הפרטיות בתצוגה המקדימה למפתחים על ידי הרצת הפקודה הבאה:

    adb shell device_config put adservices global_kill_switch false

  • ממשקי ה-API של AdIdManager ו-AppSetIdManager מחייבים את Google Play Services בגרסה 22.36.16 ואילך.

    • במכשיר Android, מוודאים שהגרסה הנכונה רשומה בקטע הגדרות > אפליקציות > שירותי Google Play.
    • אם צריך לעדכן את Google Play Services לגרסה המתאימה, נכנסים לחשבון Google במכשיר הבדיקה או באמולטור של Android. לאחר מכן עוברים אל חנות Google Play > סמל הפרופיל > הגדרות > מידע כללי. מתחת לכותרת גרסת חנות Play, מקישים על עדכון חנות Play.
    • השלב הזה רלוונטי רק לפיתוח ולבדיקות, ולא יהיה צורך בו אחרי ההשקה של ארגז החול לפרטיות למשתמשים הציבוריים.

Topics API

FLEDGE ב-Android API

  • אם מבצעים בדיקה מול שרתים אמיתיים, כעת נאכפת הפעלת ה-API. יש לפעול לפי השלבים האלה כדי להגדיר את המכשיר. לא צריך לבצע את השלבים האלה אם משתמשים בשינוי מברירת המחדל מרחוק שנמצא באפליקציה לדוגמה.
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • הפרמטר Url בפרמטרים הוחלף ב-Uri. המדיניות הזו חלה על כל ממשקי ה-API של FLEDGE ו-JavaScript בהתאמה אישית ללוגיקת הבידינג והציון.
    • הוסר השדה owner מרשומות ה-API של קהלים בהתאמה אישית.
  • קהלים בהתאמה אישית חלקיים כשירים עכשיו באופן מיידי לרענון רקע.
  • מגבלת הזיכרון של JavaScript מוגדרת עכשיו ל-10MB. הדבר נכון גם לגבי לוגיקת הבידינג והציון.

Attribution Reporting API

  • טכנולוגיות הפרסום צריכות להירשם כדי שיוכלו להשתמש ב-Attribution Reporting API בתצוגה המקדימה 6 למפתחים. מידע נוסף זמין במאמר הרשמה לחשבון ארגז חול לפרטיות.
  • בגרסה הזו נוספו מפתחות לניפוי באגים, שמאפשרים למפתחים לקבל דוחות ללא שינויים יחד עם דוחות עם פרטיות משופרת מ-Attribution Reporting API. מפתחות ניפוי הבאגים מאפשרים לכם להבין טוב יותר את המבנה של הדוחות במהלך המעבר עם ארגז החול לפרטיות.

תצוגה מקדימה למפתחים 5

כללי

  • לפני שתוכלו לגשת לממשקי ה-API של ארגז החול לפרטיות בתצוגה המקדימה של מפתח 5, עליכם להפעיל את ממשקי ה-API ולהגדיר הרשאות ספציפיות ל-API.
    • עיצובים לארגז החול לפרטיות ב-Android מאפשרים למשתמשים לקבוע אם ממשקי API לשמירה על הפרטיות וזמן הריצה של ה-SDK יהיו פעילים במכשיר שלהם. ההגדרות האלה מוגדרות כמושבתות כברירת מחדל בתצוגה המקדימה למפתחים 5. אפשר להפעיל גישה ל-API באמצעות פקודת adb.
    • אפליקציית הקריאה צריכה לציין הרשאות ספציפיות ל-API במניפסט והגדרות קשורות ל-AdServices ששולטות בגישה לערכות SDK מוטמעות.
  • האפליקציות צריכות להפעיל את ממשקי ה-API לשמירה על הפרטיות כשהן פועלות בחזית.
  • AdIdManager ו-AppSetIdManager לא פעילים כרגע. הם יופעלו בגרסה מאוחרת יותר.

זמן ריצה ל-SDK

  • הגרסה sendData() תוצא משימוש בגרסה עתידית.
  • loadSdk() מחזיר עכשיו אובייקט IBinder כדי לאפשר תקשורת דו-כיוונית בין ה-SDK שמופעל בזמן הריצה לבין האפליקציות שמוגדרות ב-AIDL.
  • לאפליקציות יש גישה לאירועים נוספים במחזור החיים של SDK שמותאמים לזמן ריצה, למשל בסיום תהליך ה-SDK.

Attribution Reporting API

בגרסה הזו נוספו תכונות נוספות ב-Attribution Reporting API, כולל:

  • תמיכה בדוח צבירה מוצפן.
  • תמיכה במדידה באפליקציות ובאתרים שונים.
  • כותרות מאוחדות במקור ומפעילות תגובות רישום:
    • מקור: Attribution-Reporting-Register-Aggregatable-Source הוא עכשיו חלק מ-Attribution-Reporting-Register-Source
    • טריגר: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data ו-Attribution-Reporting-Register-Aggregatable-Values אוחדו לכותרת אחת בשם Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects היא עדיין כותרת נפרדת

FLEDGE ב-Android API

הגרסה הזו כוללת כמה תכונות חדשות ושיפורים, וכן שינויי תוכנה שעלולים לגרום לכשלים:

  • שינויי תוכנה שעלולים לגרום לכשלים:
    • השם של runAdSelection() השתנה ל-selectAds().
    • החלפנו את הפרמטר של AdSelectionConfig.Builder.setAdSelectionSignals() בערך AdSelectionSignals, שמייצג אובייקט JSON.
    • החליף את השימוש ב-String כדי לייצג קונה/מוכר של פרסום דיגיטלי באובייקט AdTechIdentifier.
    • נוספו מחלקות TestCustomAudienceManager ו-TestAdSelectionManager לשינוי שליפה מרחוק של JavaScript.
    • הבעלים של קהל בהתאמה אישית צריך להיות שם החבילה של האפליקציה שמתקשרת.
  • ממשקי ה-API של FLEDGE מאמתים עכשיו את אפליקציית הקריאה בהתאם למספר הגבלות ומגבלות שמפורטות במדריך למפתחים. הנה כמה דוגמאות בולטות.
    • מעכשיו יש מגבלות זמן להפעלה של selectAds ושל reportImpression, ולאחר מכן השיחה תסתיים.
    • עכשיו יש מגבלה על השימוש בזיכרון במהלך הרצת JavaScript ל-selectAds ול-reportImpression. אם צריכת הזיכרון תחרוג מהמגבלות שהוגדרו, בממשק ה-API תופיע הודעת שגיאה.
    • selectAds ו-reportImpression מאמתים עכשיו את האובייקט AdSelectionConfig כדי לוודא שהשדות חוקיים מבחינה תחבירית ושכתובות ה-URL נמצאות מתחת ל-eTLD+1 המשמש בשדה בית העסק.
    • מערכת AdServices מאמתת עכשיו קהלים בהתאמה אישית בזמן היצירה שלהם. חלק מהאימותים האלה כוללים הקפדה על תוקף של זמן תפוגה והגבלה על מספר הקהלים בהתאמה אישית שאפליקציה יכולה ליצור ועל הגודל הכולל של המודעות שסופקו בקריאה ל-joinCustomAudience. האימות גם אוכף שמזהי ה-URI שסופקו לאותות ולאחזור לוגיקת בידינג ולאחזור רקע נמצאים כולם בדומיין של הקונה.
  • המטא-נתונים של קהלים בהתאמה אישית מתעדכנים מדי יום על ידי תהליך אחזור ברקע.
  • קהלים בהתאמה אישית מוסרים כשמסירים את האפליקציה 'בעלים'.
  • נוספה תמיכה לציון אותות של ציון מהימנות ונתוני בידינג מהימנים במהלך בחירת המודעות. אפשר לראות את דוגמת הקוד כדי לראות את פורמט התשובה.
  • רכיבי ה-FLEDGE לממשקי API ל-Android תלויים ב-WebView גרסה 105.0.5195.58 ואילך. אפשר לקרוא פרטים נוספים במידע על ההגדרה במדריך למפתחים.

  • בעיות ידועות:

    • בשלב הזה, הפלטפורמה לא מבצעת עדכוני רקע באופן מיידי כשמצטרפים לקהל בהתאמה אישית, אם אחד מהערכים או המטא-נתונים או הערכים של השדה AdData ריקים או null. לא ניתן יהיה לבחור מודעות בקהל בהתאמה אישית עד שהוא יעודכן יום אחד לאחר מכן. בגרסה עתידית, קהלים בהתאמה אישית שאינם מלאים יהיו כשירים באופן מיידי לעדכון אחזור נתונים ברקע. מגבלת ברירת המחדל הנוכחית בזיכרון היא נמוכה מדי, ועלולה לגרום לעומסי עבודה רגילים לקרוס את JavaScriptEngine במכשירים. הפעלת ה-JavaScript עשויה להסתיים באופן בלתי צפוי עם הודעת השגיאה "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      אפשר לפתור את הבעיה באופן ידני על ידי הגדרה של סף הזיכרון המתאים באמצעות הפקודה הבאה:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • מודעות של קהלים בהתאמה אישית שלא תואמות למבנה ה-JSON הנדרש מתעדכנות במהלך אחזור הרקע.

Topics API

עדכוני כלים

ב-Android Studio Canary יש תמיכה בבניית חבילות APK של SDK עם סוג מודול חדש. המדריך למפתחים בנושא זמן ריצה ל-SDK עודכן, והאפליקציות לדוגמה של ארגז החול לפרטיות ב-GitHub משקפות את העדכון הזה.

תצוגה מקדימה למפתחים 4

תאריך ההשקה: 14 ביולי 2022

הכלי ארגז חול לפרטיות בתצוגה מקדימה למפתחי Android 4 מוסיף שיפורים בתחומים הבאים:

זמן ריצה ל-SDK

  • עכשיו אפליקציות יכולות לתקשר עם ערכות SDK תואמות זמן ריצה (RE-SDK) באמצעות התוספת sendData().
  • האחסון המקומי זמין עכשיו בתהליך זמן הריצה של ה-SDK.
  • באמצעות ה-SDK אפשר גם לעבד מודעות וידאו או תוכן בנפרד שמבוססות על וידאו בזמן הריצה של ה-SDK.
  • הוספנו הבהרות לגבי השימוש ברפליקציה, כדי לכלול את האפשרות להשתמש בהשתקפות בתנאי שהתוכן לא נמצא ב-RE-SDK אחר.

Attribution Reporting API

בגרסה הזו בוצעו שינויים שנועדו לשפר את הבהירות לגבי השימוש ב-Attribution Reporting API, למשל:

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

FLEDGE ב-Android API

הגרסה הזו כוללת תכונות חדשות שיעזרו בבדיקה ובניפוי באגים, וגם שיפורים פנימיים:

  • נוספה תמיכה בביטול כתובות URL מרוחקות לאחזור לוגיקת JavaScript במהלך הפיתוח.
  • דיווח משופר על שגיאות במהלך בחירת מודעות.
  • המערכת תסנן עכשיו קהלים בהתאמה אישית שאינם פעילים במהלך בחירת המודעות.

Topics API

הגרסה הזו כוללת כמה שינויים משמעותיים ב-Topics API, והכי חשוב:

  • סוג ההחזרה ב-API getTopics() השתנה לאובייקט Topic החדש, שכולל מזהים של מספרים שלמים שתואמים לנושאים בטקסונומיה, ומידע על גרסאות המסווג וטקסונומיה. יש לעדכן את כל האפליקציות הקיימות באמצעות ממשק API זה.
  • ל-Topics API נדרשת עכשיו הרשאה רגילה חדשה.
  • מבוא למערכת "מסווג במכשיר" כדי להקצות נושאים באופן דינמי על סמך פרטי האפליקציה הזמינים לציבור.

בעיות ידועות

  • לא ניתן לטעון את הגרסה הראשונית של התמונות במכשיר (גרסה 6) באמולטור Android בגרסה 31.2.10. ב-27 ביולי 2022 הוצגו תמונות עדכניות של מכשירים שמתייחסות לבעיה.

תצוגה מקדימה למפתחים 3

תאריך הפצה: 9 ביוני 2022

ארגז חול לפרטיות בתצוגה מקדימה למפתחים של Android 3 מוסיף פונקציונליות ל-Attribution Reporting API ול-FLEDGE ב-Android.

Attribution Reporting API

Attribution Reporting API מבטל את ההסתמכות על מזהי משתמשים של צדדים שונים במטרה לשפר את פרטיות המשתמשים, ותומך בתרחישים חשובים של שימוש בשיוך ובמדידה של המרות באפליקציות שונות.

הגרסה הזו כוללת מקורות מידע למפתחים שיעזרו לכם לבדוק את התכונות הבאות של Attribution Reporting API:

  • רישום מקור השיוך והפעלת אירועים
  • שיוך (Attribution) עם תעדוף לפי מקור ושיוך לאחר ההתקנה
  • קבלת דוחות אירועים
  • קבלת דוחות מצטברים, שאינם מוצפנים בגרסה הזו

ניתן להשתמש באפליקציה לדוגמה ושרת טכנולוגיות של מודעות עזר כדי לסייע בבדיקה

בעיות מוכרות:

FLEDGE ב-Android

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

הגרסה הזו כוללת מקורות מידע למפתחים שיעזרו לכם לבדוק את FLEDGE הבאים בתכונות של Android:

  • מצטרפים לקהל מותאם אישית או עוזבים קהל מותאם אישית, ובודקים איך ערכי הפרמטרים עשויים להשפיע על תוצאות המכרז
  • אחזור קוד מכרז של JavaScript מנקודות קצה מרוחקות
  • הגדרה והתחלת מכרזים של מודעות במכשיר
  • טיפול בדיווח על חשיפות
  • אפליקציה לדוגמה ותצורה של שרת מדומים מסופקות כדי לסייע בבדיקה

בעיות מוכרות:

תצוגה מקדימה למפתחים 2

תאריך הפרסום: 17 במאי 2022

תצוגה מקדימה 2 למפתחים כוללת תצוגות מקדימות מוקדמות של ממשקי ה-API לדיווח על שיוך (Attribution) של MeasurementManager.

  • ניתן להתקשר אל registerSource() ואל registerTrigger() כדי לרשום אירועי מודעות באפליקציה ולקבל נתוני דיווח ברמת האירוע לצורך שיוך מאפליקציה לאפליקציה. בהטמעה הנוכחית שלנו נעשה שימוש בשיוך (Attribution) לנקודת המגע האחרונה. תזמון השליחה של הדוחות מתבצע בהתאם להגדרה שמופיעה בחלונות הדיווח. מידע נוסף זמין במאמר ה-API של MeasurementManager.

  • העלאת הדוח בפועל מתבצעת בסוף מרווחי הזמן הקבועים, ולא במועד המדויק שנקבע. כברירת מחדל, פרק הזמן להעלאת דוחות הוא 4 שעות, אבל אפשר לבטל אותו באמצעות פקודת ה-adb הבאה:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • באחת מהגרסאות הבאות יפורסמו אפליקציות לדוגמה ושרת טכנולוגיות של מודעות עזר לצורך בדיקות של ממשקי API.

  • תכונות אחרות של MeasurementManager Attribution Reporting API, כמו דוחות מצטבר, שיוך אחרי ההתקנה והפניות אוטומטיות, יהיו זמינות בגרסה מאוחרת יותר.

תצוגה מקדימה למפתחים 1

תאריך הפצה: 28 באפריל 2022

תצוגה מקדימה 1 למפתחים כוללת תצוגות מקדימות מוקדמות של Topics API ו-SDK זמן ריצה. הפונקציונליות של FLEDGE ב-Android ושל Attribution Reporting API תהיה זמינה במהדורה עתידית.

  • Topics API
    • כרגע, ה-API getTopics() מחזיר ערכי בדיקה על סמך סיווג אופליין לקבוצת אפליקציות מוגבלת. עדיין לא הטמעת סיווגים במכשיר.
    • ניתן לך להשתמש בפקודות adb כדי לשנות מרווחים של epoch וחישוב epoch של epoch.
    • פרטים נוספים זמינים במדריך למפתחים של Topics.
  • זמן ריצה ל-SDK
    • אתם יכולים לארוז ולבנות ערכות SDK תואמות זמן ריצה (RE SDK) באמצעות האלמנט <sdk-library> החדש בקובץ המניפסט של אפליקציית ה-SDK. תוכלו להתקין ערכות SDK של RE במכשיר בדיקה או באמולטור נתמכים, כמו שבדרך כלל מתקינים אפליקציה במהלך הפיתוח.
    • תוכלו לשלב אפליקציה עם ערכות SDK של RE, לטעון אותן בזמן הריצה של ה-SDK ולבדוק את ההשפעה של הגישה המוגבלת על קוד ה-SDK – הרשאות, זיכרון ותקשורת בין האפליקציה ל-SDK. ממשקי Storage API עבור ערכות SDK של RE עדיין לא מוטמעים, והם יהיו זמינים בגרסאות עתידיות.
    • ה-SDK יכול לעבד מודעות באנר או תוכן על סמך WebView בזמן הריצה ל-SDK.
    • לקבלת מידע נוסף, אפשר לקרוא את המדריך למפתחים בנושא זמן ריצה ל-SDK.
  • בדיקות איתור שגיאות בקוד של Android
    • יכול להיות שבבדיקות של אימות שגיאות בקוד של Android יוצגו אזהרות באופן שגוי בפרויקטים שהורכבו באמצעות רמת ה-API TiramisuPrivacySandbox. לדוגמה, ייתכן שתוצג לכם הודעת האזהרה: "השיחה דורשת רמת API 33". אפשר לטפל בבעיה באופן זמני באמצעות ההערה @SuppressLint("NewApi").