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

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

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

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

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

Protected Audience API

  • היכולת להעביר מודעות מאומתות לפי הקשר למכרז מוגן נוסף. זה כולל גם סינון שלילי לאפליקציות שכבר מותקנות ב- במכשיר, וגם מכסת תדירות של קליקים, חשיפות, צפיות או מנצחת. היישום שונה מאיטרציות קודמות, בתור המודעות צריכות להיות חתומות על ידי טכנולוגיית הפרסום. איך ליישם את זה במדריך למפתחים.
  • השם של StructuredAds (מודעות לפי הקשר) השתנה ל-SignaturecontextAds יחד עם getter קשור ו- setter ב-AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • אם תועבר אפליקציה לפי הקשר לא מאומתת, היא תוסר מכרז

Attribution Reporting API

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

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

Protected Audience API

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

Attribution Reporting API

זמן ריצה ל-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 API שמאפשר לקהל בהתאמה אישית במאפיינים בדוחות סיכום מצטברים.
    • תמיכה ב-Google Cloud Provider כ-TEE של שירות הצבירה.
    • הוספת שדה shared_debug_key לתמיכה בניפוי באגים ברשתות שונות ללא הפניות לכתובות אחרות.
    • הוספת כותרות של גרסאות בבקשות לדוח ניפוי באגים מפורט.

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

  • גרסה ראשונית לחוקרים ולפיתוח מוקדם.
  • התאמה אישית במכשיר מציגה דרך חדשנית להתאמה אישית של מוצרים ושירותים שונים, תוך מתן הגנה משופרת על פרטיות משתמשי הקצה. במכשיר ההתאמה האישית מספקת קבוצת שירותים ואלגוריתמים כאבני בניין להשיג זאת, כולל, בין היתר:
    • מחשוב מאוחד (FC) שמאפשר אימון, הערכה והתאמה אישית מודלים של למידה משותפת. השימוש באיחוד האירופי לצורך התאמה אישית במכשיר המחשוב יתבסס על אימון המודל והֶקֵּשׁ (אופציונלי, אם צריך).
    • התאמה מבוססת-מסנן של קוקייה והתאמה בין נתונים ושנמצאות במיקומים שונים.
    • אימון דיפרנציאלי (DP) של מודלים מצומצםים באמצעות טכניקות חדשות כמו מינימליזציה חלופית של DP (לאימון נתונים מוצגים), והתאמה אישית של המודל בדף תיאור המוצר של לוח המודעות.

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

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

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

  • נתוני המכרזים שנוצרו על ידי קריאה ל-Bidding and 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

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

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

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

כללי

  • אפשר להשתמש ב-Attribution Reporting API החל מגרסה זו. ה-API היה הושבת בעבר. אם השתמשתם ב-Attribution Reporting API בגרסת בטא, צריך לנקות את נתוני האפליקציה או המכשיר לפני השימוש בגרסת הבטא הזו באמצעות אחד מהשלבים הבאים:
    • במכשיר או באמולטור, עוברים אל 'הגדרות' ומוחקים אפליקציות ספציפיות אחסון (לא רק המטמון) לכל אפליקציה שמשמשת לבדיקה.
    • מאפסים את המכשיר הפיזי או האמולציה להגדרות המקוריות.
    • במכשיר אמולציה, מפעילים את הפונקציה Wipe Data (איפוס הנתונים).
  • התכונה 'דוחות שיוך (Attribution)' תומכת עכשיו במפתחות ניפוי באגים, שמאפשרים למפתחים לקבל דוחות שלא בוצעו בהם שינויים ודוחות עם פרטיות מוגברת מהשיוך (Attribution) API. מפתחות לניפוי באגים מאפשרים לכם להבין טוב יותר את אופן הפעולה הדוחות יהיו מובנים במהלך המעבר לארגז החול לפרטיות.
  • לאחרונה התרחש ב-Attribution דוחות שיוך (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 API מודעות, סוג WIN עדיין אינו נתמך, ומסננים מהסוג הזה המערכת מתעלמת ממנו.
  • כדי לדווח על מספר החשיפות שזכו לקונים של Protected Audience API מכרזים, הקונים חייבים להיות רשומים לארגז החול לפרטיות. הדרישה הזו לא ניתן לשנות.
  • כדי לגשת להגדרות של ארגז החול לפרטיות במכשיר שיש בו ארגז חול לפרטיות זמינה, עבור אל הגדרות > Google > מודעות > ארגז החול לפרטיות.
  • אי אפשר לפרוס פרויקטים עם אמולטורים ב-Android Studio Giraffe. גרסאות אחרות של Android Studio אמור לפעול בצורה תקינה. התיקון יושק ב-Android Studio ג'ירפה ב-26 במאי 2023.

Protected Audience API

Attribution Reporting API

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

זמן ריצה ל-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 שמחייבת שינוי מברירת המחדל AdSelectionFromOutcomeConfig כדי להשוות בין selectAds תוצאות. הפעולה הזאת מאפשרת ערכות SDK של טכנולוגיות פרסום שמשתמשות ב-API הזה כדי להפעיל רשימת רשתות בתהליך בחירת רשת. פרטים נוספים ניתן למצוא פירוט במדריך למפתחים.
  • ב-API של selectAds() יש עכשיו תמיכה בשמירה במטמון ללוגיקת בידינג וציון JavaScript אוחזר בתהליך בחירת המודעה.
    • אפשר לשלוט במטמון באמצעות כותרות Cache-Control שהוחזרו על ידי במהלך קריאת האחזור של JavaScript. אפשר להשתמש ב-no-cache או ב-no-store כדי למנוע שמירה במטמון של תגובות JavaScript, וניצול מקסימלי של הגיל כדי לשלוט משך המטמון.
    • כברירת מחדל, הרשומה הנוכחית של המטמון max-age מוגדרת ליומיים.

דוחות שיוך (Attribution) ב-Android API

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

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

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

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

כללי

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

Topics API

Attribution Reporting API

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

זמן ריצה ל-SDK

ההגבלות הבאות צפויות שיתוקנו במכשירי Android העיקריים הבאים גרסת פלטפורמה:

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

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

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

ארגז החול לפרטיות ב-Android Developer Preview 6 מוסיף שיפורים התחומים הבאים:

כללי

  • כהכנה להשקה של סביבת הייצור, הוספנו תכונה חדשה ל-Developer Preview 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 Services
    • אם אתם צריכים לעדכן את Google Play Services לגרסה הנכונה, עליכם להיכנס לחשבון במכשיר בדיקה או באמולטור Android באמצעות חשבון Google. ואז עוברים אל חנות Google Play > סמל פרופיל > הגדרות > מידע כללי. מתחת כותרת גרסת חנות Play, מקישים על עדכון חנות Play.
    • השלב הזה רלוונטי רק לפיתוח ובדיקה, ולא נדרש אחרי ההשקה של ארגז החול לפרטיות למשתמשים הציבוריים.

Topics API

  • נוסף Preview API שמאפשר לקבוע אם getTopics יירשם בתור צופה מסוים.
  • שינויים קלים בקוד האתחול של המחלקה GetTopicsRequest.
  • פורסם מדריך השילוב של Topics.

FLEDGE ב-Android API

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

Attribution Reporting API

  • טכנולוגיות הפרסום צריכות להירשם כדי שניתן יהיה להשתמש בדוחות השיוך (Attribution) ממשק 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 יש עכשיו מגבלות זמן הפעלה, אחרי שהשיחה תסתיים.
    • עכשיו יש הגבלה על צריכת הזיכרון של selectAds ו-reportImpression במהלך הפעלת JavaScript. ממשקי ה-API יקפיצו שגיאה אם הזיכרון הצריכה חורגת מהמגבלות שהוגדרו.
    • selectAds ו-reportImpression מאמתים עכשיו את AdSelectionConfig כדי לוודא שהשדות תקפים מבחינה תחבירית ושכתובות ה-URL ב-eTLD+1 שבו נעשה שימוש בשדה המוכר.
    • עכשיו אפשר להשתמש בקהלים בהתאמה אישית ב-AdServices בזמן היצירה שלהם. חלק מ- האימות הזה כולל מוודאים שמועד התפוגה תקף ומחיל הגבלה למספר הקהלים בהתאמה אישית שהאפליקציה יכולה ליצור ולגודל הכולל של המודעות שסופקו בקריאה joinCustomAudience. האימות גם אוכפת שמזהי ה-URI שסופקו לאותות ולאחזור לוגיקה של בידינג, אחזור הנתונים ברקע מתבצע כולם תחת הדומיין של הקונה.
  • המטא-נתונים של קהלים בהתאמה אישית מתעדכנים מדי יום באמצעות אחזור ברקע התהליך.
  • המערכת מסירה קהלים בהתאמה אישית כאשר ה"בעלים" האפליקציה הוסרה.
  • נוספה תמיכה בציון אותות ציון מהימנים ונתוני בידינג מהימנים במהלך בחירת המודעות. ראו דוגמת קוד לפורמט התשובה.
  • FLEDGE לממשקי API של Android תלוי ב-WebView בגרסה 105.0.5195.58 ואילך. אפשר לקרוא פרטים נוספים במידע על ההגדרה במדריך למפתחים.

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

    • כשמצטרפים לקהל בהתאמה אישית, הפלטפורמה לא מניבה כרגע ביצועים הרקע מתעדכן באופן מיידי, אם אחד מהערכים של המטא-נתונים או AdData ריקים או null. לא ניתן יהיה להציג מודעות בקהל בהתאמה אישית עד שהפריטים יתעדכנו יום אחד לאחר מכן. גרסה עתידית ת הגדרת קהלים בהתאמה אישית שלא הושלמו כמתאימים לאחזור ברקע באופן מיידי מגבלת הזיכרון הנוכחית שמוגדרת כברירת מחדל לביצוע JavaScript היא נמוך מדי ועלול לגרום לעומסי עבודה רגילים לקרוס את JavaScript מכשירים. הפעלת 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 Preview 4 התחומים הבאים:

זמן ריצה ל-SDK

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

Attribution Reporting API

הגרסה הזו כוללת שינויים שנועדו להבהיר את השימוש בייחוס 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 Developer Preview 3 מוסיף פונקציונליות Attribution Reporting API ו-FLEDGE ב-Android.

Attribution Reporting API

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

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

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

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

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

FLEDGE ב-Android

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

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

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

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

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

תאריך ההפצה: 17 במאי 2022

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

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

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

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

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

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

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

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

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

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