הגדרת Topics API

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

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

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

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

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

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

המלצות מרכזיות

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

שליטה ב-Topics API באמצעות דגלים של Chrome

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

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

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

שם הדגל ערך ברירת מחדל תיאור
BrowsingTopics פעיל אם Topics API מופעל.
PrivacySandboxAdsAPIsOverride פעיל הפעלת Google Ads API: דוחות שיוך (Attribution), 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. אתם יכולים לנסות את ההדגמות ולצפות בהדגמות של Topics, בשיתוף הפעולה עם הכלים ובסרטון ההדרכה של Topics.
    4. פיצול ההדגמות והרצתן מהאתר שלכם.
    5. כדי להבין טוב יותר את הפרטים, אפשר לקרוא את הסבר על ה-API.
  2. להבין את התפקיד של ה-API בתמיכה ברלוונטיות של מודעות בעתיד, כאשר קובצי cookie של צד שלישי לא יהיו זמינים לשיעור הולך וגדל של משתמשים.
  3. כדי לקבל התראות על שינויים בסטטוסים ב-API, כדאי להצטרף לרשימת התפוצה למפתחים ולהתעדכן בעדכונים האחרונים של Topics.
  4. להוסיף תוכן לשיחה בנושא בעיות ב-GitHub או שיחות W3C.
  5. אם נתקלתם במונחים לא מוכרים, כדאי לעיין במילון המונחים של ארגז החול לפרטיות.
  6. מידע נוסף על מושגים ב-Chrome, כמו דגלים של Chrome, זמין בסרטונים הקצרים ובמאמרים שזמינים בכתובת goo.gle/cc.

השלבים הבאים

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