JS トラッキング導入仕様書
概要
このトラッキング方式は、Javascript タグを用いた通知方式です。
設定
- 成果として設定したいコンバージョンページへ弊社指定 CV タグを設置頂きます。
- クリック識別子(ICLink パラメータ)を Cookie へ保存する為の設定をご対応頂きます。
CV タグ
コンバージョンページへの設置タグ
<span id="iclinksales"></span>
<script src="//static.iclink.site/iclink.js"></script>
<script>
reportToIcLink({
orderId: "御社側での注文情報を識別するID",
customerId: "御社側での顧客ID",
items: [
{
code: "商品を識別するコード",
price: 商品単価,
quantity: 個数,
},
],
totalPrice: 注文合計金額,
});
</script>
note
タグはコンバージョンページの <body> 内にご設置下さい。
「"items":[]」オブジェクト内は複数要素の指定が可能です。 ※オブジェクト内に「,,...」で要素毎に連結の上、ご設定下さい。
複数要素設定例:
items: [
{
"code": "商品を識別するコードA",
"price": 商品単価A,
"quantity": 個数A
},
{
"code": "商品を識別するコードA",
"price": 商品単価B,
"quantity": 個数B
},
],
各パラメータについて
| パラメータ名 | サブパラメータ名 | 型 | 必須 | 上限値 | 説明 |
|---|---|---|---|---|---|
| orderId | string | 必須 | 50 文字以内 | 御社側での注文情報を識別する ID。また、50 文字を超える場合は、50 文字以降が切り捨てられ計上される。 | |
| customerId | string | 50 文字以内 | 御社側での顧客を識別する ID。また、50 文字を超える場合は、50 文字以降が切り捨てられ計上される。 | ||
| items | code | string | 必須 | 50 文字以内 | 商品を識別するコード。また 50 文字を超える場合は、50 文字目以降が切り捨てられ成果として計上される。 |
| price | Number | 必須 | 99999999.99 | 商品単価。 | |
| quantity | Number | 必須 | 9999 | 商品個数。 | |
| totalPrice | Number | 9999999999 | 注文合計金額。省略時は[price] [quantity]から自動的に計算される。 |
設置例
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="Description" content="ご注文ありがとうございました" />
<meta name="Keywords" content="ICLink" />
<title>完了ページ設定デモ</title>
</head>
<body>
<p>ご購入頂きまして、まことにありがとうございました</p>
<span id="iclinksales"></span>
<script src="//static.iclink.site/iclink.js"></script>
<script>
reportToIcLink({
orderId: "order001234",
customerId: "customer002234",
items: [
{
code: "item1",
price: 200,
quantity: 2,
},
{
code: "item2",
price: 300,
quantity: 1,
},
],
total_price: 700,
});
</script>
</body>
</html>
クリック識別子の Cookie 保存
設置 JS タグ
<script src="//static.iclink.site/iclink.js"></script>
設置個所について
クリック識別子(ICLink パラメータ)を Cookie として保存する全ページの<head>内へご設置下さい。
info
広告主様ランディングページへの設置必須となります。
サイトの申込導線上にクロスドメインがある場合
広告主様ランディングページとコンバージョンページのドメインが異なる場合は、 Cookie の仕様上、保存時のドメイン以外での参照が行えません。
caution
クロスドメインに未対応のため、該当する場合は ICLink 運営側にご連絡ください
実行結果
JS タグ実行時のコンソールログへの出力内容です。
| 出力ログ | 内容 |
|---|---|
| [INFO] reportToIcLink finished. url: {出力タグ} | JS タグの出力に成功した際に出力されます。 |
| [ERROR] span タグが存在しません。処理を終了します。 | <span id="iclinksales"></span> の存在が確認出来ない場合にログ出力されます。 |
| [ERROR] price = {反映値}; 半角数字で入力してください。 | 「"price":」の箇所の反映値が Number 型ではない場合にログ出力されます。 |
| [ERROR] quantity = {反映値}; 半角数字で入力してください。 | 「"quantity":」の箇所の反映値が Number 型ではない場合にログ出力されます。 |
| [ERROR] total_price = {反映値}; 半角数字で入力してください。 | 「"total_price":」の箇所の反映値が Number 型ではない場合にログ出力されます。 |
出力ログの停止
ログの出力の停止をご希望の際は、こちらの機能をご利用下さい。
スクリプトタグに data-iclinkdisablelog="1" の属性を追加下さい。
<script src="//static.iclink.site/iclink.js"></script>
<script src="//static.iclink.site/iclink.js" data-iclinkdisablelog="1"></script>