הדגמות ושיתופי פעולה עם מפתחים יעזרו לכם להבין את ממשקי ה-API של ארגז החול לפרטיות.
יש כמה הדגמות של ממשקי ה-API של ארגז החול לפרטיות. ברוב הדוגמאות תצטרכו להכיר את ממשקי ה-API, לכן אם עדיין לא קראתם את המסמכים, כדאי לעיין בקישורים שצירפנו לצד הדוגמאות.
הדגמות ושיתופי פעולה
Protected Audience API
ההדגמה משתמשת ב-Protected Audience API כדי לאחד קבוצות של תחומי עניין של מודעות בשני אתרים של מפרסמים, ואז עורכת מכרז במכשיר כדי לבחור מודעה להצגה באתר של בעל תוכן דיגיטלי.
Topics API
בעזרת Topics API, המכשיר של המשתמש משגיח ומתעדות נושאים שנראים כנושאי עניין למשתמש על סמך הפעילות שלו. לאחר מכן, ה-API מאפשר למבצע הקריאה החוזרת (כמו פלטפורמות של טכנולוגיית פרסום) לגשת לנושאים האלה בלי לחשוף מידע נוסף על הפעילות של המשתמש. המשאבים הבאים מספקים דוגמאות ל-API בפעולה.
משאבים לנושאים באינטרנט
- הדגמה של כותרות: זוהי גישה מומלצת עם ביצועים טובים יותר.
- דוגמה ל-JavaScript: אם אין לכם אפשרות לשנות את הכותרות, השתמשו בשיטות של Topics ב-JavaScript.
- Topics API colab: אפשר להתנסות במודל TensorFlow Lite שמשמש את Chrome כדי להסיק נושאים משמות מארח.
- מסמכי העזרה של Topics לאינטרנט: מידע נוסף על אופן הפעולה של Topics ועל האופן שבו מטמיעים אותו.
משאבים ל-Topics ב-Android
- אפליקציות לדוגמה: אפשר להיעזר באפליקציה לדוגמה ב-Kotlin או באפליקציה לדוגמה ב-Java כדי להבין איך לשלב את המודעות.
- Topics API colab: בדיקת שילובים שונים של פרטי האפליקציה במודל הסיווג של הנושאים.
- מסמכי תיעוד של Topics ל-Android: מידע על אופן הפעולה של Topics ב-Android.
דוחות ייחוס (Attribution)
Attribution Reporting API מאפשר למפרסמים ולספקי טכנולוגיות פרסום למדוד המרות לגבי קליקים על מודעות וצפיות במודעות, מודעות ב-iframe של צד שלישי ומודעות בהקשר של אינטראקציה ישירה (First-Party). בהדגמה הזו, מפרסם משתמש בספק טכנולוגיית פרסום כדי להציג את המודעות שלו באתר של בעל תוכן דיגיטלי.
הדגמה
מעבדת רעש
כאשר דוחות נצברים מקובצים על ידי אוסף ומעובדים על ידי שירות הצבירה, נתונים אקראיים נוספים לדוחות הסיכום שהתקבלו כדי להגן על פרטיות המשתמשים. אפשר להשתמש ב-Noise Lab כדי להתנסות בערכים שונים ולראות מהי ההשפעה של רעש.
Aggregation Service
שירות הצבירה אחראי על הפענוח והשילוב של הנתונים שנאספו מדוחות נצברים, מוסיפים רעש ומחזירים דוח סיכום סופי. כל זה מתבצע בסביבת הפעלה מהימנה (TEE).
Colabs
נפח אחסון משותף
ממשק ה-API של אחסון משותף מספק נפח אחסון שאפשר להשתמש בו בכל האתרים. כלומר, אפשר לאחסן ערך בדומיין אחד, ואז לקרוא את הערך מדומיין אחר. אתם יכולים להגדיר נתונים בחופשיות, אבל קיימת הגבלה על האופן שבו אתם מוציאים נתונים מנפח האחסון. בהדגמה הזו אפשר לראות איך זה עובד.
צ'יפים
קובצי cookie עם מצב נפרד של חלוקה למחיצות (CHIPS) מאפשרים למפתחים לצרף קובץ cookie לאחסון מחולק למחיצות (Partitions), עם מאגרי קובצי cookie נפרדים לכל אתר ברמה העליונה, שמשפרים את הפרטיות והאבטחה של המשתמשים. בהדגמה הזו אפשר לראות איך זה עובד.
קבוצות של אתרים קשורים
התכונה 'קבוצות של אתרים קשורים' מאפשרת לחברה להצהיר על קשרים בין אתרים, כדי שדפדפנים יאפשרו גישה מוגבלת לקובצי cookie של צד שלישי למטרות ספציפיות. מערכת Chrome תשתמש בקשרים המוצהרים האלה כדי להחליט מתי לאשר או לדחות את הגישה של אתר לקובצי ה-cookie שלו בהקשר של צד שלישי.
- הדגמה
- מחולל JSON לשליחה. הכלי הזה יוצר את משאבי ה-JSON שדרושים לצורך שליחה של קבוצות אתרים קשורים (RWS).
- Docs
מדיניות ההרשאות
מדיניות ההרשאות מאפשרת למפתח לשלוט בתכונות הדפדפן הזמינות לדף, למסגרות ה-iframe ולמשאבי המשנה שלו, באמצעות הצהרה על קבוצת כללי מדיניות שהדפדפן צריך לאכוף. בהדגמה הזו אפשר לנסות את כללי המדיניות הזמינים.
הפחתת מידע בסוכן משתמש
הפחתת המידע בסוכן המשתמש מפחיתה את הפרטים המזהים שמשותפים במחרוזת ה-User-Agent, ויכולה לשמש ליצירה פסיבית של טביעת אצבע דיגיטלית. עכשיו הכותרת של סוכן המשתמש קטנה יותר בבקשות משאבים וערכי ההחזרה מממשקים מסוימים של Navigator צומצמו. בהדגמה הזו אפשר להתנסות בערכי המחרוזת החדשים של UA.
ממשק API של אסימון מצב פרטי
באמצעות Private State Token API, אתר יכול להנפיק אסימונים קריפטוגרפיים למשתמש שהוא בוטח בו, וניתן להשתמש בהם מאוחר יותר במקומות אחרים. האסימונים מאוחסנים באופן מאובטח על ידי הדפדפן של המשתמש, וניתן לממש אותם בהקשרים אחרים כדי לאשר את מהימנות המשתמש. בהדגמה הזו אפשר לראות את ה-API.
מסגרת של הדגמות בארגז החול לפרטיות
מסגרת ההדגמות של ארגז החול לפרטיות מציעה מתכונים בספרי בישול, קוד לדוגמה ואפליקציות להדגמה, על סמך ממשקי ה-API של ארגז החול לפרטיות. הם נועדו לעזור לעסקים ולמפתחים להתאים את האפליקציות שלהם ואת העסקים שהם תומכים לסביבה עסקית באינטרנט, בלי קובצי cookie של צד שלישי.
| תרחיש לדוגמה | תיאור | ממשקי API |
|---|---|---|
| טירגוט מחדש / רימרקטינג | איך להציג מודעות רלוונטיות למשתמש שחקר מותג או מוצר באינטרנט. | Protected Audience API Fenced Frame |
| שיוך (Attribution) המרות בנקודת מגע אחת | איך מודדים המרה אחרי צפייה במודעות באתר חדשות וקניית מוצר באתר קניות אונליין. | Attribution Reporting API |
| מודעת וידאו In-stream מסוג VAST במכרז עם אתר מכירה יחיד ב-Protected Audience API | הצגת פרטים על פתרון זמני שמאפשר לנגני וידאו מוטמעים ברמה העליונה לגשת לכתובת URL מסוג VAST XML. | Protected Audience API |
| מודעת וידאו In-stream מסוג VAST בהגדרה של מכרז רציף של Protected Audience | מוצגת אחת הדרכים שבהן ניתן לטפל בקובצי XML מסוג VAST בהגדרת מכרז רציף של Protected Audience כשהמודעה מעובדת ב-iframe. | Protected Audience API |