ブラウザSDKリファレンス
このスクリプトの機能は、意図的に小さくしています。タグ1つ、要素1種類、関数1つです。
スクリプトタグ
| 属性 | 意味 |
|---|---|
| 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?)信頼できる動作
- タグが何度含まれていても、ページごとに1回だけ実行されます。
- クライアントサイドのナビゲーションで後から追加された広告枠を検出します。
- 各ユニットをclosed shadow root内に描画します。お客様のCSSはユニットに影響せず、ユニットもページに影響しません。
- ページに例外を投げることはありません。失敗した場合は、広告枠が空のまま折りたたまれて終了します。
- レポートはsendBeaconとtext/plainの本文で送信されるため、プリフライトリクエストは発生しません。
デバッグ
広告枠にdata-loop-debugを追加すると、開発者ツールで検査できるよう、そのshadow rootが開きます。ネットワークタブの最初のリクエストは /v1/config です。200が返れば、キーとドメインが一致しています。