トラッキングパラメータ
トラッキングパラメータは、広告クリックと成果を照合するために使用するパラメータです。
パラメータ 一覧
トラッキングパラメータの主な用途と仕様を説明します。
- タグ計測：任意のパラメータは成果地点タグ（CVページに設置するタグ）に追加して利用できます。
- システム連携：連携先から成果情報を受け取る際に、成果の照合に必要な値を受け取るために利用します。
| パラメータ | 種類 | 説明 |
|---|---|---|
| p | 広告登録時システムで生成されるID | 成果認証に必須 通知形式：半角英数字 出力文字数：12文字（固定） |
| cid | 広告クリック時にシステムで発行されたクリックID | 成果認証に必須 通知形式：半角英数字 出力文字数：27文字（固定） |
| plid | Google広告の並行トラッキング時のクリックID | Google広告の並行トラッキング時のクリックID 通知形式：生成されたセッションID 受け取り可能文字数：半角英数字で最大65,535文字 |
| args | 注文番号や申し込み番号などの成果識別ID | 付与推奨 通知形式：URLエンコードした文字列（半角英数字推奨） 受け取り可能文字数：最大255文字（エンコード後） |
| price | 成果発生時に取得した購入金額 | 定率案件の場合は必須 通知形式：半角数字 受け取り可能な数値：定率案件の場合は、0 ～ 2,147,483,647 （定率案件以外はマイナス値も可） ※数値に含まれるカンマ（,）は除去して処理します |
| pt | 報酬テーブルに設定したID | 通知形式：半角英数字および記号（-、_）（広告の報酬テーブル設定値） 設定可能文字数：最大30文字 |
| pg | 商品テーブルに設定したID | 通知形式：半角英数字および記号（-、_）（広告の商品テーブル設定値） 設定可能文字数：最大30文字 |
| did | 成果ステータス情報 （注文番号など成果ごとのユニークな値） | 成果ステータス連携時は必須 通知形式：半角英数字 受け取り可能文字数：最大255文字 |
| state | 成果の承認ステータス | 通知形式：半角英数字 受け取り可能文字数：最大30文字 ※デフォルトの値：未承認：0 承認：1 キャンセル：2 |
| tkp1 tkp2 tkp3 | 成果を識別する任意パラメータ | 通知形式：URLエンコードした文字列（半角英数字推奨） 受け取り可能文字数：半角英数字で最大65,535文字 |
| t | 広告に設定した成果認証パスワード | 通知形式：半角英数字 設定可能文字数：最大32文字 |
| mid | メディア登録時にシステムで生成されるID | 通知形式：半角英数字12文字（固定） |
| cap | cidとpを「_」で結合した特殊認証パラメータ | 通知形式：半角英数字、cid_p出力文字数：40文字（固定） ※連携先で付与できるパラメータ（受け取り・返却）が1つのみの場合に利用 |
パラメータ名を変更する場合
連携先の仕様に合わせてパラメータ名を変更する場合は、計測設定 | トラッキング設定 - トラッキングパラメータ変換 から設定します。
例：パラメータargsをaaaに変更する場合
パラメータ名を変換した場合の通知例
変換前：https://ACSドメイン/track.php?cid=[クリックID]&p=[広告ID]&args=[成果識別ID]
↓ ↓
変換後：https://ACSドメイン/track.php?cid=[クリックID]&p=[広告ID]&aaa=[成果識別ID]
システム連携：特定用途のパラメータ
参考：システム連携：仕入れ連携 - ポストバック受信URLを取得
成果ステータスの連携を行う場合
成果ステータスの連携には、did と state の両方が必要です。
did には成果を識別するためのユニークな値を指定します。
この値をキーとして、成果ステータスを紐付けます。state には、連携する成果ステータスを指定します。
did の値は、args と同じ値を使用することもできます。
成果ステータス連携時の通知例
https://ACSドメイン/track.php?cid=[クリックID]&p=[広告ID]&args=[成果識別ID]&did=[成果識別ID]&state=[成果ステータス値]
計測設定 | トラッキング設定 から、承認状態の値を変更することも可能です。
cidとpを結合して連携する場合
cap は、連携先システムで「受け取り・返却」パラメータを1つしか扱えない場合に使用します。
広告入稿時にクリックID（cid）と広告ID（p）を1つのパラメータ値に結合して連携先へ渡し、
ポストバック受信時に、cap の値から cid と p を分解して処理します。
連携先への広告入稿時
広告素材 | リンク設定 - システム経由 で、パラメータ付与形式を以下のように設定します。
- 手動記述（カスタムパラメータ＝[cid]）
- 手動記述（カスタムパラメータ＝[p]）
連携先への入稿からポストバック通知までの利用例
連携先の入稿URL
https://連携先システム発行の広告URL?abc=[cid]_[p]
※パラメータ名（abc）は連携先で受け取り可能な名前を指定します。
連携先からポストバック
https://ACSドメイン/track.php?cap=abc値
※abc値 には、広告クリック時に付与された [cid]_[p] の値が返却されます。