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

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

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

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

תוספי Android SDK

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

שנתחיל?

כדי להתחיל, מבצעים את הפעולות הבאות:

שלב 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

קביעת הגדרות להפעלה (או השבתה) של פרטיות Sandbox ב-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-beta05 ואילך.

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

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

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

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

הפניית API

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

תמיכה ומשוב

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

עדכון סביבת הפיתוח

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