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

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

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

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

תוספים ל-Android SDK

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

שנתחיל?

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

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

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

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

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

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

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

באמצעות Android Studio, אפשר להוריד את התמונות העדכניות ביותר של מערכת האמולטור והתוסף של Ad Services דרך SDK Manager. מידע נוסף על הגדרת סביבת הפיתוח ועל הגדרת גישה ל-API

הפניית API

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

תמיכה ומשוב

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

שומרים על סביבת הפיתוח מעודכנת

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