תחילת העבודה עם ארגז החול לפרטיות ב-Android

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

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

כדי להשתמש בגרסת הבטא, המפתחים צריכים להדר את הפתרונות שלהם באמצעות עדכון של תוסף SDK ברמת ה-API 33.

תוספי Android SDK

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

תחילת העבודה

כדי להתחיל, צריך לבצע את השלבים הבאים:

שלב 1: הרשמה לתוכנית הבטא והרשמה אליה

  • הרשמה: משלימים את תהליך ההרשמה כדי להשתמש בממשקי ה-API שקשורים למודעות.
  • הרשמה: כדי להשתתף בתוכנית הבטא, חובה register. ההרשמה מאפשרת לכם:
    • הפעלת המכשירים שלך למטרות בדיקה פנימית.
    • צריך לציין מספר מוגבל של אפליקציות שפורסמו בחנות Google Play שיכולות לשלב בצורה ישירה ממשקי API לשמירה על פרטיות או לשלב פתרונות SDK שמשתמשים בממשקי ה-API.
    • בדיקה של הפצת ערכות SDK תואמות זמן ריצה באמצעות חנות Google Play. השלב הזה לא נדרש אם צריך רק לבדוק את זמן הריצה של ה-SDK במכשיר.

שלב 2: הגדרת סביבת הפיתוח

איך מגדירים את ארגז החול לפרטיות ב-Android SDK ב-Android Studio.

שלב 3: הגדרת הרשאות ב-AdServices

להצהיר על הרשאות ספציפיות ל-API ולהגדיר גישה ל-SDK למשאבים שמנוהלים על ידי ה-API המטורגט.

שלב 4: הגדרת תמונה של מכשיר או אמולטור

כדי לבצע בדיקות מקצה לקצה צריך להשתמש במכשיר Android 13 נתמך או להשתמש בתמונת אמולטור בתוסף ה-SDK המתאים.

שלב 5: מגדירים מכשירים לשימוש בארגז החול לפרטיות ב-Android

קביעת הגדרות כדי להפעיל (או להשבית) את ארגז החול לפרטיות ב-Android כך שיפעל במכשירים.

פתרון בעיות ידועות

כדי למנוע בעיות ידועות בשילוב של PP API במכשירי Android מגרסה 12 ומטה, מפתחים שמשלבים ממשקי API של שירותי פרסום במכשירי Android מגרסה 12 ומטה צריכים לבצע את הפעולות הבאות:

  1. צריך לוודא שקובץ המניפסט של אפליקציית הלקוח מכיל את תג extservices מסוג <uses-library>. הנה התג הרלוונטי:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. אם אתם משתמשים בספריית jetpack androidx.privacysandbox.ads, עליכם לוודא שאתם משתמשים בגרסה 1.1.0-בטא05 ואילך.

אילו משאבים זמינים למפתחים?

תוכנית הבטא של ארגז החול לפרטיות ב-Android כוללת את הכלים והמשאבים הבאים.

תמונות מערכת של SDK ואמולטור

ב-Android Studio אפשר להוריד את תמונות המערכת העדכניות ביותר של התוספים ושל האמולטורים דרך מנהל ה-SDK. איך להגדיר את סביבת הפיתוח ולהגדיר גישה ל-API

הפניית API

ההפניות המלאות של ה-API זמינות.

תמיכה ומשוב

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

מקפידים לעדכן את סביבת הפיתוח

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