הגדרת Topics API

הכנת הסביבה לשימוש ב-Topics API, לבדיקה ולפיתוח של אפליקציות אינטרנט.

.

פיתוח ובדיקה באופן מקומי

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

הפעלת Topics בדפדפן

כדי להפעיל את Topics API במופע Chrome שלכם לצורך בדיקה מקומית, יש לכם שתי אפשרויות:

  1. מפעילים את כל ממשקי ה-API לשמירה על פרטיות בפרסום בקטע chrome://settings/adPrivacy.
  2. (מומלץ) מריצים את Chrome משורת הפקודה עם דגלים של Chromium באמצעות פרמטרים ספציפיים של Topics API כדי להגדיר לפי הצורך. אתם יכולים לשלוט באופן מדויק יותר בתכונות של 'נושאים' על ידי הפעלת Chrome משורת הפקודה. לדוגמה, אפשר להגדיר את תקופות ה-Topics (מסגרת הזמן שבה ה-API משתמש כדי לחשב את תחומי העניין של המשתמש) ולהגדיר את אופן הפעולה של ה-API בהתאם לצרכים שלכם.

המלצות עיקריות

  1. חשוב לסגור ולהפסיק את כל התהליכים של Chrome לפני שמתחילים תהליך חדש באמצעות הדגלים.
  2. מוודאים שכל ממשקי ה-API בנושא פרטיות בפרסום מופעלים בקטע chrome://settings/adPrivacy.
  3. אם ה-API לא פועל כמצופה, אפשר לנסות את הטיפים שלנו לפתרון בעיות.
  4. אם יש לכם שאלות, תוכלו לעיין בבעיות ב-GitHub שקשורות להסבר.

שליטה ב-Topics API באמצעות תכונות ניסיוניות של Chrome

אפשר לשנות את ההתנהגות של Topics API באמצעות דגלים ב-Chrome. מריצים את Chrome משורת הפקודה עם הפרמטרים שצוינו כדי להקל על הבדיקה. לדוגמה, בהדגמה של כותרות מומלץ להשתמש בדגלים הבאים:

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

בטבלה הבאה מוסבר כל פרמטר, ערך ברירת המחדל שלו והמטרה שלו.

שם הדגל ערך ברירת המחדל תיאור
BrowsingTopics פעיל האם Topics API מופעל.
PrivacySandboxAdsAPIsOverride פעיל הפעלת ממשקי API של מודעות: Attribution Reporting, ‏ Protected Audience, ‏ Topics, ‏ Fenced Frames.
PrivacySandboxSettings4 הושבת ההגדרה הזו מפעילה את הגרסה הרביעית של הגדרות ממשק המשתמש של ארגז החול לפרטיות.
OverridePrivacySandboxSettingsLocalTesting פעיל אם ההגדרה הזו מופעלת, הדפדפן לא דורש יותר שההגדרות הבסיסיות יופעלו כדי להפעיל את התכונות של ארגז החול לפרטיות.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck הושבת אם האפשרות הזו מופעלת, המערכת לא תבדוק אם אפשר לנתב את כתובת ה-IP באופן ציבורי כשהיא קובעת אם דף מסוים עומד בדרישות להיכלל בחישוב של נושאים.
BrowsingTopics:number_of_epochs_to_expose 3 מספר התקופות של זמן המערכת שממנו יחושבו הנושאים שיוצגו בהקשר של הבקשה. בדפדפן יישמרו באופן פנימי עד N+1 תקופות.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s משך כל תקופה. לצורך ניפוי באגים, כדאי להגדיר את הערך הזה ל-15 שניות (למשל), במקום ל-7 ימים שמוגדר כברירת מחדל.
BrowsingTopics:number_of_top_topics_per_epoch 5 מספר הנושאים שמחושב בכל תקופה.
BrowsingTopics:use_random_topic_probability_percent 5 ההסתברות שנושא ספציפי בתקופה מסוימת הוא אחד מהנושאים שמוחזרים באופן אקראי מכל הטקסונומיה של הנושאים. האקראיות נשמרת לתקופה מסוימת ולכל אתר.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 כמה תקופות של נתוני שימוש ב-API (כלומר, תצפיות על נושאים) ישמשו לסינון הנושאים בהקשר של קריאה.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 המספר המקסימלי של דומיינים בהקשר של צפייה שיישארו לכל נושא מוביל. המטרה היא להגביל את הזיכרון שבשימוש.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 המספר המקסימלי של רשומות שאפשר לאחזר ממסד הנתונים לכל שאילתה בהקשרים של שימוש ב-API. השאילתה תתבצע פעם אחת בכל תקופה בזמן חישוב הנושאים. המטרה היא להגביל את השימוש המקסימלי בזיכרון.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 המספר המקסימלי של דומיינים של הקשר לשימוש ב-API שמותר לאחסן לכל טעינת דף.
BrowsingTopics:config_version 1 מקודד את פרמטרי ההגדרה של Topics API. כל מספר גרסה צריך להיות ממופה רק לקבוצת הגדרות אחת. בדרך כלל אפשר לעדכן את פרמטרי ההגדרה בלי לעדכן את config_version בבדיקות מקומיות, אבל במצבים מסוימים זה עלול להשאיר את הדפדפן במצב לא עקבי ולגרום לקריסת הדפדפן. לדוגמה, אם מעדכנים את number_of_top_topics_per_epoch.
BrowsingTopics:taxonomy_version 1 גרסת הטקסונומיה שבה נעשה שימוש ב-API.

לפני שמתחילים בהטמעה

לפני שמתחילים בהטמעה, מומלץ לעיין במשאבים הבאים כדי להכיר את Topics API.

  1. עיון במסמכי התיעוד למפתחים:
    1. להבין את המטרה של Topics API ואת התפקיד שלו בפרסום מבוסס-עניין
    2. איך התכונה 'נושאים' פועלת באינטרנט.
    3. מומלץ לנסות את ההדגמות ולצפות בהדגמות של נושאים, ב-Colab ובכלים בסרטון ההדרכה.
    4. אפשר ליצור עותק של ההדגמות ולהריץ אותן מהאתר שלכם.
    5. כדי להבין את הפרטים, אפשר לקרוא את ההסבר על ה-API.
  2. הבנת התפקיד של ה-API בתמיכה ברלוונטיות של מודעות בעתיד, שבו קובצי Cookie של צד שלישי לא יהיו זמינים עבור חלק הולך וגדל מהמשתמשים.
  3. כדי לקבל הודעות על שינויים בסטטוס של ה-API, הצטרפו לרשימת התפוצה למפתחים והמתינו לעדכונים האחרונים בנושא Topics.
  4. אתם יכולים להצטרף לשיחה בבעיות ב-GitHub או בשיחות W3C.
  5. אם נתקלתם במונחים לא מוכרים, תוכלו לעיין במילון המונחים של ארגז החול לפרטיות.
  6. מידע נוסף על מושגים ב-Chrome, כמו תכונות ניסיוניות של Chrome, זמין בסרטונים ובמאמרים הקצרים בכתובת goo.gle/cc.

השלבים הבאים

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