משאבי תמיכה ל-Topics API באינטרנט

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

פתרון בעיות

אם אתם מבצעים קריאה ל-document.browsingTopics() או בקשה ל-fetch() עם הכותרת Sec-Browsing-Topics מוגדרת, אבל מקבלים מערך ריק בתגובה, יש כמה שלבים לניפוי באגים שאפשר לבצע כדי לזהות את שורש הבעיה, גם בסביבת הפיתוח המקומית וגם במערכת הפעילה.

ניפוי באגים באופן מקומי

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

  • כדי לעקוף את ההרשמה, מפעילים את הדגל chrome://flags/#privacy-sandbox-enrollment-overrides ומוסיפים את כתובת ה-URL של האתר שמפעיל את Topics.

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

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

  • לפני שמפעילים את Chrome עם דגלים, חשוב לוודא שסגרתם את כל המופעים והתהליכים האחרים של Chrome.

  • ודא ש:

    • אתם משתמשים ב-Chrome מגרסה 101 ואילך.
    • הסקריפט שלכם קרא ל-Topics API כדי לעקוב אחרי נושאים. במהלך הבדיקה, אתם יכולים לדמות התנהגות משתמשים על ידי ביקור באתרים שבהם התסריט מוטמע. דוגמה מעשית מופיעה בהדגמה.
    • אין לכם תוכנה לחסימת מודעות או אפליקציה או תוסף דומים שפועלים.
    • אתם לא במצב פרטי.
    • ב-chrome://settings/trackingProtection, האפשרות Block all third-party cookies מושבתת.

ניפוי באגים בהטמעה פעילה

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

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

משאבים