瀏覽器 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 代表金鑰與網域相符。