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

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

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

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

תוספי Android SDK

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

שנתחיל?

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

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

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

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

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