網頁版 Topics API 支援資源

查看網路上主題的偵錯、疑難排解和支援資源建議。

疑難排解

如果您使用 Sec-Browsing-Topics 標頭設定 document.browsingTopics() 呼叫或 fetch() 要求，但收到空陣列做為回應，您可以採取多個偵錯步驟，在本機開發環境和實際系統中找出問題的根本原因。

在本機偵錯

如果您在本機測試，請務必使用必要參數執行 Chrome。

  • 如要略過註冊程序，請啟用標記 chrome://flags/#privacy-sandbox-enrollment-overrides，並新增呼叫 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，則會傳回空白結果，因為應用程式可能尚未觀察到使用者的主題。您可以按照我們的建議對解決方案進行偵錯。

  • 確認您的網站已註冊 Privacy Sandbox。
  • 測試前端程式碼，確認 JavaScript 能正常運作。
  • 測試後端，確認能接收主題結果。
    • 請務必確認資料類型和後端 API 參數設定正確無誤。
    • 確認後端已設定為適當調整大小。
  • 根據我們的經驗，至少需要三週的時間，才能開始取得更多相關主題的結果。
  • 並非所有使用者都會啟用主題：
    • 使用者可以明確停用 Topics API。
    • 發布商的網頁可以控制權限政策，並選擇退出網站。
  • 在這個環境中新增指標和可觀察性：您需要這些指標和可觀察性來分析初步結果。指標示例包括：
    • 通話延遲時間。
    • 主題呼叫的 HTTP 錯誤。
  • 請盡量在前三週內，不要對導入方式進行任何變更。

資源