JSトラッキング導入仕様書#
概要#
このトラッキング方式は、Javascriptタグを用いた通知方式です。
【①】メディアサイトに掲載されているA8.netの広告素材がクリックされた際に、
A8.net広告配信サーバーへリダイレクトされます。
【②-1】 Cookie方式の場合:
広告主様サイトのランディングページへのリダイレクト時にクリック識別子(A8パラメータ)を付与します。
ランディングページ遷移後、付与したクリック識別子(A8パラメータ)をランディングページドメインでCookieに保存致します。
【②-2】DNS方式の場合:
広告主様のコンバージョンページへクリック識別子(A8パラメータ)を付与します。
また、付与したクリック識別子(A8パラメータ)をコンバージョンページドメインでCookieに保存致します。
その後、広告主様ランディングページへリダイレクトします。
【③】Cookieに保存したクリック識別子(A8パラメータ)と同ページに設定頂いたタグの情報をA8へ成果通知致します。
設定#
- 成果として設定したいコンバージョンページへ弊社指定CVタグを設置頂きます。
- クリック識別子(A8パラメータ)をCookieへ保存する為の設定をご対応頂きます。
CVタグ#
コンバージョンページへの設置タグ#
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
|
Note
タグはコンバージョンページの<body>
内にご設置下さい。
「"items":[]」
オブジェクト内は複数要素の指定が可能です。
※オブジェクト内に「{},{},...」
で要素毎に連結の上、ご設定下さい。
Attention
コメントアウトの部分は必須ではありませんが、
サイトリニューアルやシステム移管等の際に、誤ってタグが削除されてしまうと、
トラッキング漏れが発生する可能性があります。
成果集計漏れ等がないよう管理をお願い致します。
複数要素設定例:
1 2 3 4 5 6 7 8 9 10 11 12 |
|
各パラメータについて#
パラメータ名 | 型 | 必須 | 上限値 | 説明 | |
---|---|---|---|---|---|
pid | string | 必須 | 15byte固定 | A8.net発行のプログラムID (PGID) | |
order_number | string | 50byte以内 | 御社側での注文情報を識別するID。A8.netでは「注文番号」としてレポートされます。 省略時には[null-タイムスタンプ-乱数]という文字列を自動生成する。また、50byteを超える場合は、50byte以降が切り捨てられ計上される。 |
||
currency | string | 3byte固定 | 通貨コード。「JPY/AUD/CHF/CNY/EUR/GBP/HKD/KRW/NZD/SGD/TWD/USD」 が利用可能。 空欄/未設定/対応外通貨コードの場合は[JPY] | ||
items | code | string | 50byte以内 | 商品を識別するコード。省略時は[a8]となる。また50byteを超える場合は、50byte目以降が切り捨てられ成果として計上される。 | |
price | Number | 必須 | 99999999.99 | 商品単価。小数点以下第二位まで受け入れる。(レポート上は[currency]の設定値に基づいて[JPY]へ計算されたあと、小数点以下を切り落とされる) | |
quantity | Number | 必須 | 9999 | 商品個数。フォーマットエラー時は[1]となる。 | |
total_price | Number | 9999999999 | 注文合計金額。省略時は[price] [quantity] [currency] から[JPY]で自動的に計算される。 | ||
repeat | string | 拡張機能「リピート制御」を使用する際のパラメータ。 | |||
amount_priority | string | 拡張機能「注文単位での割引対応」を使用する際のパラメータ。 | |||
coupon | string | 拡張機能「クーポンコードトラッキング」を使用する際のパラメータ。 |
設置例#
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
|
クリック識別子のCookie保存#
クリック識別子(A8パラメータ)をCookieへ保存する方法は2種類御座います。
DNS方式#
広告主様のコンバージョンページのドメインのサブドメインをご発行頂き、弊社指定のCNAMEを設定頂きます。
エンドユーザーがメディアサイトに掲載されている広告リンクをクリックした際に、A8.netのサーバーより
直接広告主様のコンバージョンページへクリック識別子(A8パラメータ)を付与致します。
設定
サブドメインの発行
御社のコンバージョンページのドメインのサブドメイン
を発行下さい。
CNAMEの割り当て
発行頂いたサブドメインに以下、CNAME
を割り当てて下さい。
trck.a8.net.
Note
cname
の設定方法はDNSサーバー管理会社によって異なります為、各社の案内をご参照下さい。
Example
所持するドメインが yoursite.net
CVページのドメインが cv.yoursite.net
新たに発行するドメインが a8clk.cv.yoursite.net
設定例:a8clk.cv CNAME trck.a8.net.
※TTL設定は、任意の間隔にてご設定可能です
※設定の反映まで48時間程度掛かる事がございます。
その他、設定可能な例
- other.cv.yoursite.net (サブドメイン)
- a8.yoursite.net (並列の階層での設定)
- clk.yoursite.net (並列の階層での設定)
設定不可な例
- track.a8.cv.yoursite.net (2階層以上離れている)
- a8.click.yoursite.net (サブドメインが異なる)
trck.a8.net が行う挙動について
- 御社ドメイン名で、cookie を発行致します "a8{広告ID}={クリックID};"という書式となります
- 指定のLPへのリダイレクトを実施致します(商品リンク対応の場合には任意のページ)
ヘルスチェック
- CNAME設定後、サブドメインをブラウザ等でアクセス頂き a8dns is works と表示されれば設定は成功となります。
Cookie方式#
広告主様のLPページに弊社指定タグを設定頂きます。
エンドユーザーがメディアサイトに掲載されている広告リンクをクリックした際に、
A8.netのサーバーよりクリック識別子(A8パラメータ)を広告主様LPページへ付与致します。
LPページで弊社指定タグがCookieとして保存致します。
設置JSタグ
1 2 3 4 5 6 |
|
設置個所について
- クリック識別子(A8パラメータ)をCookieとして保存する全ページの
<head>
内へご設置下さい。
Note
広告主様ランディングページへの設置必須となります。
その他、商品リンク機能をご利用の場合はサイト内の全ページの<head>
内へ指定タグのご設置を推奨致します。
サイトの申込導線上にクロスドメインがある場合
広告主様ランディングページとコンバージョンページのドメインが異なる場合は、 Cookieの仕様上、保存時のドメイン以外での参照が行えません。
この為、クロスドメインの際に、遷移後のドメインに対して、クリック識別子(A8パラメータ)をCookieとして再度保存する必要が御座います。
この場合、追加で以下のタグを設置下さい。
設置JSタグ
- ドメインが切り替わる前のページに以下タグをご設定下さい。
1 2 3 4 5 6 7 |
|
- ドメインが切り替わった後のページに以下タグをご設定下さい。
1 2 3 4 5 6 |
|
設定例:
申込導線
広告 → LP(ドメインA)→ 購入申込ページ(ドメインB)→ 成果発生ページ(ドメインB)
LP(ドメインA)へ設置するタグ
1 2 3 4 5 6 7 |
|
購入申込ページ(ドメインB)へ設置するタグ
1 2 3 4 5 6 |
|
付与Cookieについて#
クリック識別子(A8パラメータ)を保持する付与Cookieは以下となります。
Name | _a8_{A8.net発行のプログラムID (PGID)} |
---|---|
Value | クリック識別子(A8パラメータ) |
Domain | クリック識別子(A8パラメータ)付与ページのルートドメイン |
Path | / |
expire | 3653日 |
出力ログについて#
JSタグ実行時のコンソールログへの出力内容です。
出力ログ | 内容 |
---|---|
[INFO] a8sales() is SUCCESS. URL= {出力タグ} | JSタグの出力に成功した際に出力されます。 |
[ERROR] spanタグが存在しません。処理を終了します。 | 「<span id="a8sales"></span>」の存在が確認出来ない場合にログ出力されます。 |
[ERROR] {反映値}: pidが文字列ではありません。 | 「"pid":」の箇所の反映値がString型ではない場合にログ出力されます。 |
[ERROR] {反映値}: pidの桁数が異なります。 | 「"pid":」の箇所の反映値が弊社指定の桁数ではない場合にログ出力されます。 |
[ERROR] price = {反映値}: 商品単価の入力値が異なります。半角数字で入力してください。 | 「"price":」の箇所の反映値がNumber型ではない場合にログ出力されます。 |
[ERROR] quantity = {反映値}: 商品個数の入力値が異なります。半角数字で入力してください。 | 「"quantity":」の箇所の反映値がNumber型ではない場合にログ出力されます。 |
拡張機能#
リピート制御#
概要
こちらの機能は、成果のリピート制御機能となります。
Note
■ 主な使用ケース
サンクスページ内で、複数成果地点毎のタグを発火させ成果計上を行いたい。
(ex. 予約商品と通常商品を同時購入した場合、広告主様の管理上、注文番号を分けており、それぞれ注文番号毎にタグを出力したい)
申し込み導線上で、複数の成果地点を成果対象としたい。
(ex.1クリック内で「問い合わせフォーム」での申し込み後、「契約申込フォーム」の申し込みも成果対象とする場合)
ページリロード等による同注文番号の成果発生を制御したい。
設定
コンバージョンページに設定頂いているタグに "repeat": true,
のパラメータを追加下さい。
設定例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
|
Note
この機能が有効となるのは異なる注文番号の場合となります。
同ページ内に同じ注文番号のタグが複数回表示された場合は、無効となります。
repeat": true
の後に,
が御座いませんと動作しない場合が御座いますので、タグの上部になるべくご設定頂くことを推奨致します。
注文単位での割引対応#
概要
こちらの機能は、注文単位での割引対応となります。
コンバージョンタグよりA8.netへ成果通知を行う際に、
広告主様に設定頂くコンバージョンタグの「items」
内の「price × quantitiy」
より
算出した値が成果対象となる注文金額となります。
Example
例:"price":1000, "quantitiy":2 の場合
1000×2 = 2000 が成果対象となる注文金額となる
この為、ユーザーが「会員ポイント」や「クーポン」の使用で商品金額に対して割引を行った場合、
コンバージョンタグに反映頂く price
の値を割引後の金額にご修正頂く必要が御座いました。
しかし、広告主様のシステム仕様によっては、直接 price
の修正が難しい場合があり、
この場合、成果計上後、手動で金額修正にてご対応頂いておりました。
この機能は、total_price
に割引後の注文合計金額の反映が可能な場合、
この total_price
の値を元に price
の金額を修正する機能となります。
設定
コンバージョンページに設定頂いているタグに "amount_priority" : "total_price",
のパラメータを追加下さい。
設定例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
|
データの反映例
注文内容
商品A:300円 数量:2個
商品B:200円 数量:1個
合計:800円 ポイント: -100pt 注文合計金額:700円
A8CVタグ
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
|
上記の場合、通常 300 × 2 + 200 × 1 = 800
の金額に対して、成果報酬額が計算されますが、
"amount_priority" : "total_price",
をタグ内に追加頂くと price
の値が修正され、
注文合計金額が 700円(300×2 + 200×1)
に対して成果報酬額が計算されます。
Note
total_price
に割引後の注文合計金額が反映されている事が必須条件となります。
"amount_priority" : "total_price"
の後に 「,」
が御座いませんと動作しない場合が御座いますので、
タグの上部になるべくご設定頂くことを推奨致します。
出力ログの停止#
概要
1 2 3 4 5 6 7 |
|
上記2本のタグは、実行結果をコンソールにログ出力します。
ログの出力の停止をご希望の際は、こちらの機能をご利用下さい。
設定
各スクリプトタグに「data-a8stoplog="1"」
の属性を追加下さい。
設定例
1 2 3 |
|
1 2 3 |
|
クーポンコードトラッキング#
エンドユーザーが物品購入(申込み)時に利用したクーポンコード情報を用いて、
集客元メディアを特定し効果計測を行う仕組みです。
通常のアフィリエイトトラッキングと異なり、クリックやCookieの付与などが不要な為、
Webサイト以外のSNS/紙/音声媒体など、多岐に渡る媒体への掲載が可能です。
活用方法については、色々な可能性を持っておりますので新しい販路開拓の一助になるかと思います。
「こんな媒体への掲載はどうですか?」というご相談もお待ちしております。
導入の流れ
Note
1.利用するクーポンの発行
2.発行済みクーポン情報の登録
3.利用されたクーポン情報を送信するシステム設定
4.成果計上テストの実施
5.実際のメディアとクーポンを紐付け
1. 利用するクーポンの発行
配布予定のクーポン条件などを事前に準備し、
各ご利用会社様の注文システムなどで利用できる状態のクーポンコードの発行をお願い致します。
配布予定メディア1つに対して、最低1つのクーポンコードが必要となる為、
発行数については事前に担当営業とご確認ください。
また、通常配布用以外に A8.net での成果テストのために
A8.netテスト用のクーポンコード をご用意頂くと成果計上時のご案内がスムーズに行えます。
Tip
クーポンの利用条件としては、以下項目などを分かりやすくしておくと、
掲載者とのやり取りがスムーズになります。
・利用可能期間:(開始-終了予定日)
・最低金額:(税抜き 1,000円以上)
・対象商品の限定有無:(商品Aのみ)
・利用ユーザーの限定有無:(新規登録者限定)
・同一ユーザーの再利用の可否:(NG)
・利用上限の有無:(1,000人に達した時点で終了)
・クーポンコードの大文字小文字区別の有無:(無し)
・クーポンコードの併用:(NG)
Tip
「0(ゼロ)とO(オー)」「I(アイ)とl(エル)」など、近い文字を同時に使うことを極力避けると、
掲載間違いなどを防ぐことが出来ます。
2. 発行済みクーポン情報の登録
(1)で発行したクーポンコードを A8.net に登録します。
Note
現状はA8.netにて登録作業を代行しておりますので、
以下データを担当営業までご送付下さい。
※設定画面は近日提供予定となります。
登録時に必要な項目
クーポンコード | 管理用クーポンコード※ | 開始日時 | 終了日時 | プログラムID | 利用特典コメント |
---|---|---|---|---|---|
SAMPLE123 | 000001234 | 2021/1/10 8:04 | 2021/12/3 14:14 | s00000000062001 | 注文金額から100円OFF |
SAMPLE124 | 000001235 | 2021/1/10 8:04 | 2021/12/3 14:14 | s00000000062001 | ItemA 1,000円OFF |
SAMPLE125 | 000001236 | 2021/1/10 8:04 | 2021/12/3 14:14 | s00000000062001 | ItemA 1,000円OFF |
SAMPLE126 | 000001237 | 2021/1/10 8:04 | 2021/12/3 14:14 | s00000000062001 | ItemBのサンプルプレゼント |
※管理用クーポンコード:弊社へ送信するクーポンの情報が利用システム内部の値となり、
利用されるクーポンコードと異なる場合に設定(通常はクーポンコードのみで問題ありません)
3. 利用されたクーポン情報を送信するシステム設定
注文(申込み)完了時などの成果を計測したい地点に到達した際に、
利用されたクーポンコード情報を A8.net に送信する設定を行います。
javascriptタグを設置
/ サーバー間通信にて直接送信
の2パターンから、
お客様の環境に合致する送信方法をご選択下さい。
javascriptタグを完了ページへ設置する場合
コンバージョンページへの設置タグに coupon
パラメータを追加する事で
クーポンコードトラッキングが利用出来る様になります。
パラメータ名 | 型 | 必須 | 上限値 | 説明 |
---|---|---|---|---|
coupon | string | 50byte以内 | 利用されたクーポンコードの値 |
以下の書式に合わせて、完了ページに出力される様に設定をお願い致します。
設定書式:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
|
※クーポンコードが利用されない場合は空の値とすることで通常計測との併用可能
設定例:値の定義を切り出して行う例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
|
サーバー間通信で送信を行う場合
リクエスト先の情報等をお渡しいたしますので、担当営業までご相談下さい。
システム設定上の注意:既に通常のアフィリエイト広告を設定し稼働しているケース
既存のトラッキング設定に影響が出る可能性がございますので、クーポンコードの導入テスト時には、
テスト用のPGID(s00000000062001)を用いて既存タグが表示されるページに追加する形で設定を行って下さい。
併用して設置する場合の設置例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
|
4. 成果計上テストの実施
クーポンの登録・利用されたクーポン情報の送信設定が完了後、
成果計上テストのご案内を致しますので、担当営業宛にご連絡下さい。
指定のテスト規定(名前・メアド・決済方法・実施時間ほか)がある場合には、合わせてご連絡下さい。
※テストは クーポンコード利用時 / 非利用時 の双方のケースにて実施致します。
Attention
テストPGを利用して計上テストが正常に完了した場合、並行して設置しているテスト用のタグの削除と、既存のタグの切替えが必要となります。
この場合は、念の為既存タグへの影響を考慮し再度テストを実施する場合がございます。
5. メディアと配布クーポンを紐付け
利用準備は完了している状態です。
最後に掲載先メディアとご登録済みクーポンコードの紐付け*を行い、
クーポンコードを掲載先メディアに対して提供する事で実際の利用開始となります。
Note
現在はA8.netにて代行して対応しております。
設定画面については近日提供予定となります。
Tip
メディアの特徴と内容にあったコードを提供する事で、よりユーザーの利用を促進する事ができます。
配布先との調整中にご検討下さい。
例: A8.net というメディアには "A8JUNE500" など