セッショントラッキング導入仕様書#

概要#

このトラッキング方式は、HTTPリクエストを用いた通知方式です。

【①】 メディアサイトに掲載されているA8.netの広告素材がクリックされた際に、A8.net広告配信サーバーへリダイレクトされます。

【②】 広告主様ランディングページへリダイレクト時にクリック識別子(A8パラメータ)を付与しますので、広告主様にてクリック識別子(A8パラメータ)を保持頂きます。

【③】 サンクスページまでクリック識別子(A8パラメータ)を消失しないよう引継いで頂きます。

【④】 「HTTPリクエスト」でA8.netのシステムに成果データとして通知頂きます。

エンドポイント#

https://px.a8.net/a8fly/earnings

パラメータ#

パラメータ名		概要	上限値	備考
a8		詳細については「クリック識別子(A8パラメータ)について」をご確認下さい。	上限無
pid		A8.net発行のプログラムID (PGID)。	15byte固定	別途、A8.net サポートよりお知らせします。
so		御社側での注文情報を識別するID。 A8.netでは「注文番号」としてレポートされます。	50byte以内	半角英数字および -（ハイフン）, _（アンダースコア）が利用できます。それ以外の文字を利用する場合にはURLエンコードしてください。
SI	商品単価	商品単価	99999999.99	半角数字・最大15桁（整数部：8桁、小数部：6桁、小数点：1桁）。小数点は利用できます。カンマは入れないでください。
	商品個数	商品個数	9999	半角数字・最大4桁。小数点は利用できます。カンマは入れないでください。
	総額	注文合計金額	99999999.99	半角数字・最大15桁（整数部：8桁、小数部：6桁、小数点：1桁）。小数点は利用できます。カンマは入れないでください。
	商品コード	商品を識別するコード	50byte以内	半角英数字および .（ドット）, _（アンダースコア）が利用できます。それ以外の文字を利用する場合にはURLエンコードしてください。
currency		通貨コード	3byte固定	半角英字・固定3桁。利用できる通貨コードは、「JPY/AUD/CHF/CNY/EUR/GBP/HKD/KRW/NZD/SGD/TWD/USD」。空欄/未設定/対応外通貨コードの場合は[JPY]が適用されます。

Note

パラメータは全て必須となります。

成果通知フォーマット#

https://px.a8.net/a8fly/earnings?a8={識別パラメータ}&pid={s0000000****0**}&so={注文番号}&si={商品単価}-{商品個数}-{総額}-{商品コード}&currency={通貨コード}

クリック識別子(A8パラメータ)について#

概要

広告主様ランディングページへリダイレクト時に付与致しますクリック識別子(A8パラメータ)は、
エンドユーザを識別する為のパラメータとなります。

仕様

付与情報

エンドユーザを識別する為のパラメータとなります。

[パラメータ形式]

プログラムURL?(引数名)=(クリック識別子(A8パラメータ))
※パラメータは送客(広告素材クリック)される毎にユニーク値で付与致します。

引数名

a8 で付与されます。

Info

引数名は変更可能となっておりますので、変更をご希望の際は弊社担当までご連絡下さい。

クリック識別子(A8パラメータ)

約92byteの可変長文字列となります。
ただし、メディアの掲載内容によって、パラメータ長は変動致します。(約92byte～500byte)

Info

使用文字：半角英数字記号3種類『 - 』ハイフン『 _ 』アンダースコア『 . 』ドットとなります。

設定#

A8への成果通知処理の設定(HTTPリクエスト)
クリック識別子(A8パラメータ)の引継ぎ処理

成果通知処理#

HTTPリクエスト#

HTTPリクエスト(サーバー間通信)で成果データを通知する方式です。

コンバージョンページからのアクションでA8.netまで指定フォーマットで成果データを返します。

通信方式

HTTPリクエスト

Info

SSL通信推奨

通信フォーマット

上記、「エンドポイント」「パラメータ」「成果通知フォーマット」をご確認下さい。

メソッド

GET

sample

curl での実装例

curl https://px.a8.net/a8fly/earnings?a8=cETptEiKDY6gaZC8p.yFABCYRE.M_y0YaBw2AGS2_LI2_cyETp-&pid=s00000000062001&so=order-flyEc001&si=500.2-1-500.2-a001&si=200.4-2-400.8-a002

成果送信のレスポンスについて#

成果データが送信され、通信が行われるとtext/plain形式で常に「0」が返されます。

クリック識別子(A8パラメータ)の引継ぎ処理#

広告クリック時にA8.netより付与しますクリック識別子(A8パラメータ)を
サンクスページまで消失しないよう引継ぎ処理をご対応下さい。

Example

(参考)クリック識別子(A8パラメータ)を引継ぐ方法は以下のような方法があります。

DB 上または Cookie に保存する。※推奨
form の hidden フィールドに埋め込む。
(例) <input type="hidden" name="a8" value="(経由 AS 情報)">
リンクタグの URL に付加する。 (例) <a href="next.cgi?a8=(経由 AS 情報)">次</a>

備考

DBに保存頂く際は、256byte 以上にて保証頂けますようお願い致します。
パラメータの保存期間は90日以上にてご設定ください。