בדיקת ממשקי ה-API למדידה ולרלוונטיות של מודעות בארגז החול לפרטיות

ארגז החול לפרטיות כולל מבחר הצעות להפעלת תרחישים לדוגמה של פרסום, ללא צורך במעקב בין אתרים. גרסאות מקור לניסיון מספקות למפתחים הזדמנות להעריך את טכנולוגיות האינטרנט החדשות ולספק משוב עליהן באמצעות בדיקות בעולם האמיתי. בתקופות ניסיון קודמות, אתרים יכלו לבדוק מול ממשקי API נפרדים. עבור ממשקי ה-API של Topics, FLEDGE ו-Attribution Reporting אנחנו מספקים גרסת מקור אחת לניסיון, שמאפשרת לאתרים להריץ ניסויים מאוחדים בכל ממשקי ה-API, וליצור גרסה ראשונית של מחזור החיים של המודעות מקצה לקצה. ממשקי ה-API זמינים לבדיקה ב-Chrome 101, בגרסת הבטא ואילך. בגרסת הבטא של Chrome 101 יש גם עדכונים לאמצעי הבקרה של המשתמשים, ככל שאנחנו ממשיכים לערוך שינויים באפשרויות התצורה.

כמפתחים, תוכלו להירשם לתקופת ניסיון עם מקור יחיד כדי לבדוק את ה-APIs של Topics, FLEDGE ו-Attribution Reporting. במדריך הזה תלמדו את שלבי ההגדרה של ממשקי ה-API, הסבר איך לאמת את ההגדרות ומפורטים משאבים נוספים לבדיקה מול ממשקי ה-API.

מה כלול בגרסת המקור לניסיון?

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

  • נושאים לצורך צפייה בנושאים של דפדפן וגישה אליהם דרך document.browsingTopics().
  • FLEDGE כדי לנהל קבוצות של תחומי עניין בדפדפן, יחד עם בידינג ובחירת מודעות על סמך הקבוצות האלה ואותות אחרים.
  • Fenced Frame לצורך רינדור כתובת ה-URL האטומה של הזוכה במכרז של המודעות ב-FLEDGE.
  • Attribution Reporting כדי למדוד את הביצועים במהלך מחזור החיים של המודעה ולדווח עליהם.
    • כחלק מ-Attribution Reporting, צריך לעבד ולקבץ את הדוחות הנצברים באמצעות שירות צבירה כדי להפיק דוחות סיכום. בקרוב נפרסם כלים ומדריכים נוספים לבדיקות מקומיות ולגרסאות מקור לניסיון.
    • אם השתתפתם בגרסאות ניסיון קודמות של המקור לדיווח על Attribution, חשוב לזכור שתצטרכו לבצע עדכונים במקביל לשינויים האחרונים ב-API. פרטים נוספים זמינים במדריך להעברת נתונים.

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

איך מפתחים נרשמים לגרסת המקור לניסיון?

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

  • <meta> בקטע <head> של הדף ברמה העליונה: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • כותרת ה-HTTP בתגובה ברמה העליונה של הדף: Origin-Trial: TOKEN_GOES_HERE

חלק מהפונקציונליות שזמינה בגרסת המקור לניסיון מיועדת לשימוש בהקשרים שבין כמה אתרים, למשל כשאתם מספקים שירות כצד שלישי באתר ברמה העליונה. אם אתם צריכים להפעיל את גרסת המקור לניסיון עבור הקשרים הנוספים האלו, הקפידו לבחור באפשרות של 'התאמה של צד שלישי'. כדי להפעיל את גרסת המקור לניסיון מ-JavaScript של צד שלישי, צריך להוסיף את התג <meta> אל הדף שברמה העליונה (כלומר, הדף של הצד הראשון, לא התוכן שלכם) מהסקריפט. לדוגמה:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

אפשר לקרוא מידע נוסף במדריך לתחילת העבודה עם גרסאות המקור לניסיון של Chrome.

איך מפתחים בודקים באופן מקומי?

במסמכי התיעוד למפתחים בנושא Topics, FLEDGE ו-Attribution Reporting תוכלו למצוא הנחיות ספציפיות לגבי בדיקה של מפתחים מקומיים לכל API. ממשקי ה-API לא פועלים כברירת מחדל וצריך להפעיל אותם באמצעות דגלים לצורך בדיקה.

כדי להפעיל ממשקי API לבדיקה, צריך:

  • משתמשים ב-Chrome 101 בטא ומעלה.
    • כדי להשתמש ב-FLEDGE נדרש Chrome במחשב.
    • ממשקי API לא זמינים בגרסאות iOS של Chrome.
  • מפעילים את ממשקי ה-API באמצעות הדגל chrome://flags/#privacy-sandbox-ads-apis.
    • הדגל הזה מאלץ את ההפעלה של ממשקי ה-API לבדיקה קלה יותר, אם אתם רוצים לשכפל משתמש בעל גרסת ניסיון מקור שעומד בדרישות, וההגדרות הנוספות שלו עדיין יכולות להשבית את ממשקי ה-API, עליך להפעיל את Chrome באמצעות הדגלים של ה-CLI: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs.
    • יכול להיות שבממשקי API מסוימים יהיו יותר סימונים נוספים להגדרה פרטנית יותר, תוכלו למצוא פרטים במדריכים הספציפיים.
    • סימונים נוספים עלולים להתנגש בדגל הזה, לכן כדאי להגדיר את הדגל היחיד הזה אם תיתקלו בבעיות.
  • מפעילים את גרסאות הניסיון של ארגז החול לפרטיות בהגדרות Chrome: הגדרות > אבטחה ופרטיות > ארגז החול לפרטיות. אפשר לגשת אליו גם בכתובת chrome://settings/adPrivacy.
  • הפעלת קובצי cookie של צד שלישי בהגדרות Chrome: הגדרות > אבטחה ופרטיות. מגדירים את קובצי Cookie ונתונים אחרים מאתרים לאפשרות "התרת כל קובצי ה-cookie" או "חסימת קובצי cookie של צד שלישי במצב פרטי". אפשר לגשת לתכונה הזו גם בכתובת chrome://settings/cookies.
  • להיות בסשן גלישה רגיל. אין להשתמש במצב פרטי.

איך מפתחים בודקים אם גרסת המקור לניסיון מוגדרת כראוי?

במאמר פתרון בעיות בגרסאות המקור לניסיון של Chrome מופיעה רשימת משימות מפורטת לאימות ההגדרה של גרסת המקור לניסיון.

כלי הפיתוח שמציגים את הסטטוס של גרסת המקור לניסיון בקטע &#39;אפליקציות&#39;

הסטטוס של גרסת המקור לניסיון מוצג בכרטיסייה 'אפליקציות' בקטע 'מסגרות' בכלי הפיתוח.

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

אילו משתמשים זכאים לגרסת המקור לניסיון?

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

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

כדי שמשתמש יהיה כשיר, עליו:

  • משתמשים ב-Chrome 101 בטא ומעלה.
    • כדי להשתמש ב-FLEDGE נדרש Chrome במחשב.
    • אין גרסאות מקור לניסיון זמינות בגרסאות iOS של Chrome.
  • הגלישה במהלך תקופת הניסיון של המקור הפעיל.
  • להפעיל את גרסאות הניסיון של ארגז החול לפרטיות דרך 'הגדרות' > 'אבטחה ופרטיות' > 'ארגז החול לפרטיות'. אפשר לגשת אליהן גם דרך chrome://settings/adPrivacy.
  • הפעלתם קובצי cookie של צד שלישי דרך 'הגדרות' > 'אבטחה ופרטיות' > 'קובצי cookie ונתונים נוספים מאתרים' בהגדרה 'לאפשר את כל קובצי ה-cookie' או 'חסימת קובצי cookie של צד שלישי במצב פרטי', שאפשר לגשת אליהם גם דרך chrome://settings/cookies.
  • בסשן גלישה רגיל ולא במצב פרטי.
  • להיות בקבוצת הניסוי הפעילה ב-Chrome.

איך מפתחים צריכים לזהות תמיכה ב-API?

כמו בכל תכונה של פלטפורמת אינטרנט, יש לזהות תמיכה בתכונה לפני השימוש בה.

נושאים

מחפשים את הפונקציה browsingTopics() ב-document ואת מדיניות ההרשאות](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeature) עבור "browsing-topics".

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

אם תרצו להצטרף לקבוצת תחומי עניין של מודעות, חפשו את הפונקציה joinAdInterestGroup ב-navigator ואת מדיניות ההרשאות של "join-ad-interest-group".

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

כדי להפעיל מכרז, צריך לבדוק את הפונקציה runAdAuction ב-navigator ואת מדיניות ההרשאות של "run-ad-auction".

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

דוחות ייחוס (Attribution)

מחפשים את האובייקט attributionReporting ב-window ואת מדיניות ההרשאות עבור 'דיווח על שיוך (Attribution)'.

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

איפה מפתחים יכולים לתת משוב ולקבל תמיכה?

בדף הסקירה הכללית של המשוב מפורטים המסלולים השונים לשליחת משוב על ההיבטים השונים של ארגז החול לפרטיות. יש קטעים ספציפיים עבור Topics, FLEDGE ו-Attribution Reporting שמספקים את הקישורים הנפרדים לכל API.

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