תוכנית הבטא של ארגז החול לפרטיות ב-Android מספקת ממשקי API יציבים. תוכלו להשתמש במהדורות הבטא של התוכנית כדי ליצור ולבדוק פתרונות לבדיקות מוגבלות בסביבת הייצור במכשירים ניידים עם Android מגרסה 13 ואילך לכל ממשקי ה-API, ובמכשירים עם Android מגרסה 12 ואילך ל-Attribution Reporting API (ARA). נתחיל לתמוך באחוז קטן של מכשירים ונגדיל את המספר הזה עם הזמן. כדי להשתתף, ארגונים יכולים לבקש גישה למספר מוגבל של מכשירים, וגם לרשום אפליקציות שמשתמשות בממשקי ה-API של ארגז החול לפרטיות.
במסגרת זמן הריצה ל-SDK, אנחנו מציעים גרסת בטא סגורה שבה מפתחים יוכלו לבדוק הפצת SDK שתואמת לזמן ריצה לאפליקציות נבחרות.
כדי להשתמש במהדורת הבטא, המפתחים צריכים לקמפל את הפתרונות שלהם עם עדכון של תוסף SDK ברמת API 33.
תוספים ל-Android SDK
ממשקי API יציבים במהדורות בטא מוצגים באמצעות שיטת הפצה חדשה של תוספים ל-Android SDK. שיטת ההשקה הזו מאפשרת להשיק תכונות יציבות של Android בין גרסאות ראשיות. יש לו מנגנון חדש למתן גרסאות שמאפשר להשתמש בממשקי API חדשים באפליקציות בכמה רמות API באמצעות עדכוני מערכת של Google Play. התוסף של SDK של ארגז החול לפרטיות ב-Android נקרא Ad Services Extensions. מידע נוסף על תוספים ל-Android SDK
שנתחיל?
כדי להתחיל להשתמש בארגז החול לפרטיות ב-Android, מבצעים את השלבים הבאים:
שלב 1: הרשמה לתוכנית הבטא
- רישום: כדי להשתמש בממשקי ה-API שקשורים למודעות, צריך להשלים את תהליך ההרשמה.
- רישום: עליכם להירשם כדי להשתתף בתוכנית הבטא.
הרישום מאפשר לכם:
- הפעלת מכשירים משלכם למטרות בדיקה פנימית.
- אפשר לציין מספר מוגבל של אפליקציות שפורסמו בחנות Google Play, שיכולות לשלב ישירות ממשקי API לשמירה על פרטיות או לשלב פתרונות SDK שמשתמשים בממשקי ה-API.
- בדיקת הפצת SDK מופעלת בסביבת זמן ריצה באמצעות חנות Google Play. אם אתם צריכים לבדוק רק את SDK Runtime במכשיר, השלב הזה לא נדרש.
שלב 2: הגדרת סביבת הפיתוח
מגדירים את ארגז החול לפרטיות ב-Android SDK ב-Android Studio.
שלב 3: הגדרת ההרשאות ב-AdServices
להצהיר על הרשאות ספציפיות ל-API ולהגדיר את הגישה של ה-SDK למשאבים שמנוהלים על ידי ה-API המטורגט.
שלב 4: מגדירים תמונה של מכשיר או אמולטור
כדי לבצע בדיקה מקצה לקצה, צריך לבצע אינטראקציה עם מכשיר Android 13 נתמך או להשתמש בקובץ אימג' של אמולטור עבור תוסף ה-SDK המתאים.
שלב 5: הגדרת מכשירים לשימוש בארגז החול לפרטיות ב-Android
מגדירים את ההגדרות כדי להפעיל (או להשבית) את ארגז החול לפרטיות ב-Android במכשירים.
פתרון בעיות מוכרות
כדי להימנע מבעיות ידועות בשילוב עם PP API במכשירים עם Android מגרסה 12 ומטה, מפתחים שמשלבים עם ממשקי API של שירותי מודעות במכשירים האלה צריכים לבצע את הפעולות הבאות:
- מוודאים שקובץ המניפסט של אפליקציית הלקוח מכיל את התג extservices
<uses-library>. התג הרלוונטי הוא:
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- אם אתם משתמשים בספריית jetpack של
androidx.privacysandbox.ads, חשוב לוודא שאתם משתמשים בגרסה 1.1.0-beta05 ואילך.
אילו משאבים למפתחים זמינים?
תוכנית הבטא של ארגז החול לפרטיות ב-Android כוללת את הכלים והמשאבים הבאים.
קובצי אימג' של מערכת SDK ושל אמולטור
באמצעות Android Studio, אפשר להוריד את התמונות העדכניות ביותר של מערכת האמולטור והתוסף של Ad Services דרך SDK Manager. מידע נוסף על הגדרת סביבת הפיתוח ועל הגדרת גישה ל-API
הפניית API
הפניית ה-API המלאה זמינה.
תמיכה ומשוב
כשאתם בודקים ומפתחים באמצעות ארגז החול לפרטיות ב-Android, כדאי לעיין בהערות למהדורה ולהשתמש בכלי למעקב אחר בעיות כדי לדווח על בעיות ולתת משוב.
עדכון סביבת הפיתוח
מומלץ מאוד לעדכן את סביבת הפיתוח לגרסה האחרונה. כך אפשר לוודא שיש לכם את התכונות ותיקוני האבטחה העדכניים ביותר, ושהסביבה שלכם תואמת לגרסאות האחרונות של יחסי התלות. כדי לקבל התראות על גרסאות חדשות, תוכלו להירשם לעדכונים באימייל.