瀏覽器 SDK 參考

這個腳本刻意保持極小的介面:一個標籤、一種元素、一個函式。

腳本標籤

屬性意義
src顯示在您「整合」頁面上的腳本位址。
data-loop您的公開金鑰。公開;僅在您已驗證的網域上有效。
async必要。腳本不得阻擋您的頁面。

版位元素

屬性意義
data-loop-slot位置的名稱,最多 64 個字元。它會出現在您的版位報表中。
data-loop-size選填。可為 300x250、320x50、320x100、728x90、970x250、160x600 之一。使版位成為橫幅。
data-loop-type選填。recommendation(未指定尺寸時的預設值)、feed 或 banner。

追蹤轉換

name 是最多 40 個字元的字串。props 是選填的扁平物件,內容為字串、數字與布林值。除非目前這次頁面載入是經由版位抵達的,否則該呼叫會被忽略。

loop('track', name, props?)

您可以信賴的行為

  • 無論標籤被引入幾次,每個頁面只執行一次。
  • 會找到由用戶端導覽之後才加入的版位。
  • 每個版位都在封閉的 shadow root 中渲染:您的 CSS 無法影響它,它也無法影響您的頁面。
  • 絕不會拋出錯誤到您的頁面。任何失敗都會讓版位保持空白並收合。
  • 以 sendBeacon 搭配 text/plain 內容回報,因此不會發出 preflight 請求。

除錯

在版位上加入 data-loop-debug,即可開啟其 shadow root,以便在開發者工具中檢查。在網路分頁中,第一個請求是對 /v1/config;回應 200 代表金鑰與網域相符。

下一步疑難排解 →