הדגמות ושיתופי פעולה עם מומחים יעזרו לכם להבין את ממשקי ה-API של ארגז החול לפרטיות.
יש כמה הדגמות של ממשקי ה-API של ארגז החול לפרטיות. ברוב הדמואים תצטרכו להכיר את ממשקי ה-API, לכן אם עדיין לא קראתם את המסמכים, כדאי לעיין בקישורים שצירפנו לצד הדמואים.
הדגמות ושיתופי פעולה
Protected Audience API
ההדגמה משתמשת ב-Protected Audience API כדי להצטרף לקבוצות של תחומי עניין של מפרסמים בשני אתרים של מפרסמים, ואז מפעילה מכרז במכשיר כדי לבחור מודעה להצגה באתר של בעל תוכן דיגיטלי.
Topics API
With the Topics API, a user's device observes and records topics that appear to be of interest to the user based on their activity. The API then allows callers (such as ad tech platforms) to access these topics without revealing other information about the user's activity. The following resources provide examples of the API in action.
Resources for Topics on the Web
- Headers demo: This is a recommended, more performant approach.
- JavaScript demo: Use JavaScript Topics methods if you can't modify headers.
- Topics API colab: Experiment with the TensorFlow Lite model used by Chrome to infer topics from hostnames.
- Topics documentation for the Web: Learn more about how Topics work and how to implement it.
Resources for Topics on Android
- Sample apps: Refer to Kotlin sample app or Java sample app to guide your integration.
- Topics API colab: Test different combinations of app info against the topics classifier model.
- Topics documentation for Android: Learn how Topics works on Android.
דוחות שיוך (Attribution)
Attribution Reporting API מאפשר למפרסמים ולספקי טכנולוגיות פרסום למדוד המרות שנובעות מקליקים על מודעות ומצפיות במודעות, מודעות ב-iframe של צד שלישי ומודעות בהקשר של צד ראשון. בהדגמה הזו, מפרסם משתמש בספק טכנולוגיית פרסום כדי להציג את המודעות שלו באתר של בעל תוכן דיגיטלי.
הדגמה
Noise Lab
כשכלי איסוף נתונים יוצר חבילות של דוחות עם נתונים נצברים ושירות הצבירה מעבד אותם, נתונים אקראיים מתווספים לדוחות הסיכום שמתקבלים כדי להגן על פרטיות המשתמשים. כדאי להשתמש ב-Noise Lab כדי להתנסות בערכים שונים ולראות את ההשפעה של הרעש.
Aggregation Service
The Aggregation Service is responsible for decrypting and combining collected data from aggregatable reports, adds noise, and returns a final summary report. This is all accomplished within a trusted execution environment (TEE).
Colabs
Shared Storage
Shared Storage API מספקת אחסון שאפשר להשתמש בו באתרים שונים. כלומר, אפשר לאחסן ערך בדומיין אחד, ואז לקרוא את הערך מדומיין אחר. אתם יכולים להגדיר נתונים באופן חופשי, אבל יש הגבלות על האופן שבו אתם מוציאים נתונים מהאחסון. ההדגמה הזו ממחישה איך זה עובד.
CHIPS
התכונה Cookies Having Independent Partitioned State (קובצי Cookie עם חלוקה עצמאית למחיצות, CHIPS) מאפשרת למפתחים להוסיף קובץ Cookie לאחסון עם חלוקה למחיצות, עם צנצנות נפרדות של קובצי Cookie לכל אתר ברמה העליונה, וכך לשפר את הפרטיות והאבטחה של המשתמשים. ההדגמה הזו ממחישה איך זה עובד.
קבוצות של אתרים קשורים
קבוצות של אתרים קשורים מאפשרות לחברה להצהיר על קשרים בין אתרים, כדי שהדפדפנים יאפשרו גישה מוגבלת לקובצי Cookie של צד שלישי למטרות ספציפיות. Chrome ישתמש בהצהרות האלה לגבי הקשרים כדי להחליט מתי לאפשר או לדחות גישה של אתר לקובצי ה-Cookie שלו בהקשר של צד שלישי.
- הדגמה
- כלי ליצירת קובץ JSON לשליחה: הכלי הזה יוצר את משאבי ה-JSON שנדרשים לשליחת קבוצות של אתרים קשורים (RWS).
- Docs
מדיניות ההרשאות
מדיניות ההרשאות מאפשרת למפתחים לשלוט בתכונות הדפדפן שזמינות לדף, ל-iframe ולמשאבי המשנה שלו, על ידי הצהרה על קבוצת מדיניות שהדפדפן צריך לאכוף. ההדגמה הזו מאפשרת לכם לנסות את המדיניות הזמינה.
הפחתת מידע בסוכן משתמש
הפחתת סוכן המשתמש מצמצמת את המידע המזהה שמשותף במחרוזת סוכן המשתמש, שיכול לשמש לזיהוי פסיבי של טביעת אצבע. לבקשות למשאבים יש עכשיו כותרת User-Agent מצומצמת, והערכים המוחזרים מממשקי Navigator מסוימים מצומצמים. הדמו הזה מאפשר לכם להתנסות בערכים החדשים של מחרוזת UA.
Private State Token API
באמצעות Private State Token API, אתר יכול להנפיק אסימונים קריפטוגרפיים למשתמש שהוא סומך עליו, ואפשר להשתמש באסימונים האלה בהמשך במקומות אחרים. הטוקנים מאוחסנים בצורה מאובטחת בדפדפן של המשתמש, ואפשר להשתמש בהם בהקשרים אחרים כדי לאשר את האותנטיות של המשתמש. כדאי לעיין ב-API בהדגמה הזו.
מסגרת הדגמות בארגז החול לפרטיות
מסגרת ההדגמות של ארגז החול לפרטיות מציעה מתכונים, דוגמאות קוד ואפליקציות הדגמה שמבוססות על ממשקי Privacy Sandbox API. ההנחיות האלה נועדו לעזור לעסקים ולמפתחים להתאים את האפליקציות שלהם ואת העסקים שהם תומכים בהם לסביבה עסקית באינטרנט ללא קובצי Cookie של צד שלישי.
| תרחיש לדוגמה | תיאור | APIs |
|---|---|---|
| טירגוט מחדש / רימרקטינג | איך להציג מודעות רלוונטיות למשתמש שערך מחקר על מותג או מוצר באינטרנט. | Protected Audience API Fenced Frame |
| שיוך המרות למגע יחיד | איך מודדים המרה אחרי צפייה במודעות באתר חדשות וקניית מוצר באתר קניות אונליין. | Attribution Reporting API |
| מודעת וידאו VAST In-stream במכרז של מוכר יחיד ב-Protected Audience | מספק פרטים על פתרון זמני שמאפשר לנגני וידאו מוטמעים ברמה העליונה לגשת לכתובת ה-URL של VAST XML. | Protected Audience API |
| מודעת וידאו In-stream בפורמט VAST בהגדרה של מכרז רציף ב-Protected Audience | דוגמה לאחת מהדרכים לטפל בקובצי VAST XML בהגדרת מכרז רציף של Protected Audience, כשהמודעה מוצגת ב-iframe. | Protected Audience API |