媒体ポストバック

リワードアプリやブースト系媒体のように独自のトラッキングシステムを使う媒体は、「コンバージョンが発生したら当社のアドレスに通知してほしい」と求めます。adstage はこの要望を リンク単位の設定 で処理します。媒体から受け取ったコールバック URL を登録しておくと、そのリンクから流入したユーザーがインストールや購入などのイベントを起こしたときに、adstage が媒体のアドレスを代わりに呼び出します。

媒体ごとの開発は必要ありません。仕様を受け取ってダッシュボードに入力すれば、すぐに連携できます。

1. どこで設定するか

ディープリンク > 作成 または既存リンクの詳細画面で、媒体ポストバック セクションをオンにします。設定は リンクごとに個別に 保存されるため、媒体ごとにリンクを分けて作成し、各リンクにその媒体のアドレスを入力します。

2. 設定項目

媒体から「クリック時に cb というパラメータで当社のクリック ID を渡します」と言われた場合は、クリック ID パラメータ名 に cb を入力します。

3. URL テンプレートとマクロ

媒体から受け取ったアドレスをそのまま貼り付け、値を入れるべき箇所にマクロを使います。

https://postback.network.com/install?cb={click_id}&adid={adid}

使用できるマクロは次のとおりです。

一覧にないマクロを求められた場合

媒体が {sub_id}、{pub_id} のように独自の値を求めてきた場合は、そのまま書けば大丈夫です。 一覧にないマクロは、クリック時にその名前で渡されたパラメータをそのまま返す（エコー） 方式で動作します。

つまり、媒体がクリック URL に ?sub_id=abc123 を付けて送ってきた場合、ポストバックの {sub_id} の箇所に abc123 が入ります。

ご注意ください

クリック時にそのパラメータが渡されなかった場合は、空の値で送信されます。媒体の仕様にあるパラメータが実際のクリック URL にも含まれているか確認してください。

4. 動作の仕組み

1. ユーザーが媒体の広告をタップし、adstage のトラッキングリンクから流入します。このとき、クリック ID と媒体のパラメータがあわせて記録されます。

2. そのユーザーがインストール、または設定したイベントを起こすと、adstage がアトリビューションによって媒体のクリックを特定します。

3. URL テンプレートのマクロを実際の値に置き換えて、媒体のアドレスを呼び出します。

重複防止

同じクリックに対して、同じイベントは 1 回だけ 送信されます。ユーザーがアプリを何度も開いたり、イベントが重複して収集されたりしても、媒体に 2 回送ることはありません。

install と first_open のように同じ意味で使われるイベント名は 1 つにまとめて処理されるため、両方が届いてもポストバックは 1 回だけ送信されます。

失敗時のリトライ

媒体のサーバーが一時的に応答しない場合でも、コンバージョンが気づかないうちに失われないよう、自動で再試行します。

5. 連携前に媒体へ確認すること

新しい媒体と連携するときは、次の 4 点を受け取るだけで済みます。

1. ポストバック URL — インストール用、そしてイベント用が別にあればそちらも
2. クリック ID パラメータ名 — クリック URL にどの名前で識別子を付けるか
3. 必要なマクロの一覧 — どの値を受け取りたいか
4. 対象イベント — インストールのみか、購入など他のイベントも必要か

6. 注意事項

• ポストバックの設定はリンク単位です。1 つの媒体に複数のリンクを渡す場合は、すべてのリンクに設定する必要があります。
• アトリビューションが成立して初めてポストバックが送信されます。媒体のリンクを経由していない流入は対象外です。
• URL に入る値は自動で URL エンコードされます。マクロの箇所に、あらかじめエンコードした値を入れないでください。
• 媒体によっては、レスポンス本文で成功／失敗を区別する場合があります。adstage は HTTP ステータスコードのみ で判定し、2xx と 3xx を成功とみなします。本文にエラーを含めて 200 で応答する媒体の場合は失敗を検知できないため、エラー時には 4xx・5xx を返すよう依頼してください。