ポストバックトラッキングを利用すると、HilltopAdsからトラッキングシステムにイベント通知を直接送信できます。これにより、インプレッション、クリック、コンバージョンを自分の記録と照合し、設定に応じて報酬額も確認できます。
パブリッシャー向けポストバックとは？HilltopAdsでの利用方法
ポストバックとは、通知条件を満たすイベントが発生するたびに、HilltopAdsからトラッキング用エンドポイントに送信されるサーバー間リクエストです。
設定に応じて、次の情報を通知できます。
ポップアンダートラフィックで計測されたインプレッション、またはディスプレイ広告で計測されたクリック。
コンバージョン。
イベントに対応する報酬額。通知するには、報酬額のプレースホルダーを含める必要があります。
インプレッションまたはクリックのポストバックを受信した場合、そのイベントが計測されたことを意味します。報酬データには、CPMのインプレッションまたはCPAのコンバージョンから得られた収益が表示されます。
注意： ポストバックでは、計測されなかったインプレッションやフィルタリングされたインプレッションは通知されません。受信する通知は、選択したイベントと、アカウントマネージャーと設定した通知割合によって異なります。
ポストバックトラッキングの設定方法
連携の設定は、HilltopAdsのアカウントマネージャーが行います。設定を始める前に、ポストバック用エンドポイントを用意し、追跡するイベントを決めてください。
1. ポストバックURLをアカウントマネージャーに送る
トラッキングシステムでイベント通知を受信するエンドポイントを共有してください。例：
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidこの例では、各項目は次の意味を持ちます。
click_uuid：トラッキングシステムが識別子を受け取るために使用するパラメーターです。{{clickId}}：HilltopAdsの収益化リンクを通じて渡された一意の識別子に置き換えられます。{{payout}}：通知対象のイベントに対応する報酬額に置き換えられます。uid：パブリッシャーアカウントのIDです。ダッシュボードで確認できます。
エンドポイントによっては、異なるパラメーター名を使用する場合があります。パラメーターと値の対応関係を確認できるよう、トラッキングシステムで必要となる正確なURLをアカウントマネージャーに送ってください。
ユーザーIDなどの追加の値が必要な場合は、設定前にアカウントマネージャーとその対応関係を確認してください。
2. 通知を受け取るイベントを選ぶ
HilltopAdsでは、次の通知オプションを利用できます。
インプレッションまたはクリック
ポップアンダーのインプレッション、またはディスプレイ広告のクリックが計測されると、ポストバックが送信されます。
このポストバックは、そのイベントが計測されたことを確認するためのものです。
例：
https://website.com/postback?click_uuid={{clickId}}コンバージョンのみ
コンバージョンが発生すると、ポストバックが送信されます。ダイレクトリンクを利用するパブリッシャーに適したオプションです。
例：
https://website.com/postback?click_uuid={{clickId}}報酬が発生したすべてのイベント
報酬が発生したイベントに対してのみ、ポストバックが送信されます。
たとえば、CPAキャンペーンのインプレッションで報酬が発生しなかった場合、ポストバックは送信されません。その後、コンバージョンによって報酬が発生した場合は、そのイベントのポストバックを受信します。
例：
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}注意： {{payout}}プレースホルダーは、どの通知オプションでも使用できます。「報酬が発生したすべてのイベント」オプションでは、報酬が発生したイベントに対してのみ通知が送信されます。
すべてのイベント
計測されたインプレッションまたはクリックと、コンバージョンの両方についてポストバックが送信されます。
インプレッションまたはクリックが後にコンバージョンにつながった場合、同じclickIdを持つポストバックを2件受信します。1件はインプレッションまたはクリック、もう1件はコンバージョンに対応します。
例：
https://website.com/postback?click_uuid={{clickId}}同じ識別子に対する複数の通知を、トラッキングシステムで処理できることを確認してください。
3. 通知割合を決める
通知条件を満たすイベントの何％をエンドポイントに送信するか、アカウントマネージャーと確認してください。
通知割合は、10％や100％などに設定できます。システムの負荷を抑えるため、通常のデフォルト値は10％です。
イベントの選択と通知割合は、別々の設定です。「すべてのイベント」を選んでも、通知を100％受信するとは限りません。サンプリングが有効な場合、トラッキングシステムには合意した割合の通知のみが送信されます。
ポストバックの記録とHilltopAdsの統計を比較する際は、この割合を考慮してください。
4. 収益化リンクにトラッキングパラメーターを追加する
ポストバックの設定が完了すると、アカウントマネージャーからHilltopAdsの収益化リンクが提供され、使用するトラッキング値について説明があります。
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
トラッキングパラメーターには、次の項目があります。
clickId：インプレッションまたはクリックの一意のIDです。ポストバック通知とトラッキング記録を照合するために使用します。sId：広告ゾーンのIDです。
アカウントマネージャーの指示に従い、収益化リンク内のサンプル値やプレースホルダーを、正しい値またはシステムの動的マクロに置き換えてください。
収益化リンクとポストバックURLには、それぞれ異なる役割があります。
収益化リンクは、HilltopAdsにトラフィックを送信します。
ポストバックURLは、HilltopAdsからイベント通知を受信します。
必ずアカウントマネージャーから提供された収益化リンクを使用してください。ポストバック用エンドポイントをトラフィックの送信先として使用しないでください。
5. 連携を確認する
すべてのトラフィックに適用する前に、アカウントマネージャーと設定をテストしてください。次の点を確認します。
エンドポイントで、選択したイベントの通知を受信できること。
受信した識別子が、トラッキング記録と一致していること。
報酬額の通知を設定した場合、その金額を受信できること。
「すべてのイベント」を使用する場合、同じ
clickIdに対する複数の通知をトラッキングシステムで処理できること。通知割合が、合意した設定と一致していること。
パブリッシャー向けポストバックの設定やトラブルシューティングでサポートが必要な場合は、HilltopAdsのアカウントマネージャーにお問い合わせください。