パラメータの受け渡しとポストバック
ソースは、プラットフォームと Qubix を双方向に接続します:
- リンクから Qubix へ — 訪問者が広告をクリックすると、Qubix はリンクから必要なパラメータ(広告識別子、ピクセルなど)を取り、その訪問に紐付けます。
- Qubix からプラットフォームへ — イベント(登録、入金)が発生すると、Qubix はプラットフォームにポストバックを送り、結果を知らせます。
両方向の設定はソースで行います — ソースの作成を参照してください。
広告リンク内のパラメータ
リンクからどの値を取るかは、ソースの パラメータ テーブルで設定します。各パラメータについて次を指定します:
- URLキー — どのキーで値がリンクに届くか;
- プレースホルダー — プラットフォームが値に置換するもの(独自のマクロまたは固定値)。
Facebook 広告のリンクの例:
https://your-domain/?pixel=123456789&ad_id={{ad.id}}
ここで {{ad.id}} は Facebook のマクロです: 広告を表示する際に、プラットフォーム自身が実際の識別子に置き換えます。あなたのソース用の出来合いのリンクは、ソースフォームの 広告用のURL例 ブロックで Qubix が組み立てます — コピーして、プラットフォーム上の広告の URL フィールドに貼り付けられます。
Ad ID パラメータは、クリックを広告に紐付け、広告別の統計を見るために必要です。これがなくてもソースは動作し続けますが、広告別の内訳は利用できません。
キャンペーンリンク側のパラメータについては — キャンペーンリンクとパラメータ。
S2S ポストバック: プラットフォームへの通知
ポストバック(server-to-server、S2S)は、イベントが発生したときに Qubix がプラットフォームに送るリクエストです。リクエストのテンプレートはソースの S2Sポストバック フィールドで設定します。テンプレートにはマクロを挿入します — 送信前に Qubix が実際の値に置換します:
| マクロ | 値 |
|---|---|
{external_id} | プラットフォーム側の訪問/リード識別子。 |
{status} | イベントのステータス(例: 登録、入金、却下)。 |
{revenue} | イベントの収益。 |
{payout} | イベントの報酬。 |
{currency} | 通貨。 |
{sub_id_N} | 追加のマーク(sub_id_1、sub_id_2 など)。 |
{tid} | トランザクション識別子。 |
ポストバックテンプレートの例:
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook: ポストバックの代わりに Conversions API
facebook テンプレートのソースでは、通常のポストバックは使われません。代わりに、Qubix はイベントを Facebook Conversions API に直接送ります。あなたが設定するのはイベントマッピングだけです: どの Qubix イベントがどの Facebook イベントに対応するか(例: 入金 → Purchase)。ピクセル識別子はクリックリンクから、アクセストークンはピクセルレジストリから取得されます。
詳しくは — Facebook Conversions API と ピクセル。