Keitaro統合ガイド

Keitaroを使用してBlockchain-Adsネットワークのサーバー間(S2S)コンバージョントラッキングを設定するには、Blockchain-Adsを設定してポストバックURLを生成し(Keitaroがコンバージョンデータを送信する場所)、それをKeitaroのカスタムトラフィックソースとして統合します。これにより、Keitaroが入ってくるトラフィックから{clickid}をキャプチャし、一致するクリックID、収益、その他の詳細を含むポストバックをBlockchain-Adsに送り返します。

ステップ 1：Blockchain-AdsでS2Sコンバージョンイベントを作成する

1. Blockchain-Ads HUBダッシュボードにログインしてください。
2. Advertising > Tracking > Create Conversion > Server to Serverに移動してください。
3. 画面の指示に従ってイベントを設定してください：
   
   • コンバージョンイベントに名前を付けます（例：「Lead」または「Sale」）。
   • イベントタイプ（例：lead、purchase）と、該当する場合は収益フィールドを指定します。
   • これにより、イベントの一意のトラッカーIDと、次の形式のポストバックURLが生成されます：

• {clickid}：一意のクリックIDのプレースホルダー（Blockchain-Adsがこれを元のクリックと照合します）。
• trackerid：固定のイベントID（変更しないでください）。
• {transaction_value}：収益/支払額のオプションのプレースホルダー（収益を追跡しない場合は省略）。

この完全なポストバックURLをコピーしてください—Keitaroで必要になります。

4. イベントを保存します。注意：Blockchain-Adsでキャンペーンを作成する際は、宛先URLをKeitaroキャンペーンURLに設定してください（例：https://your-keitaro-domain.com/campaign123?clickid={clickid}）。Blockchain-Adsは実際のクリックID値を自動的に追加します。

ステップ 2：KeitaroでBlockchain-Adsをカスタムトラフィックソースとして追加する

1. Keitaroダッシュボードにログインしてください。
2. Traffic Sources > Createに移動してください。
3. 「From template」フィールドで「Blockchain-Ads」を検索してください—テンプレートが存在しない場合は、Customを選択するか、空白のままにして手動で作成してください。
4. 基本詳細を入力してください：
   
   • 名前：「Blockchain-Ads」。
   • Click IDパラメータ：clickidに設定してください（これにより、KeitaroはBlockchain-Adsトラフィックからの入力?clickid=xxx値をキャプチャし、ポストバックの外部IDとして内部に保存します）。
5. パラメータテンプレートセクション（プロンプトが表示された場合）：
   
   • クリックIDの行を追加してください：
     
     • 列 1 (Alias)：空白のままにするか、レポート用に「External ID」に設定してください。
     • 列 2 (Parameter name)：clickid。
     • 列 3 (Macro)：空白のままにしてください（Blockchain-Adsが実際の値を直接追加するため）。
   • 必要に応じて他のパラメータを追加してください（例：Blockchain-AdsマクロからのキャンペーンIDまたはsubID用）。
6. S2S Postbackフィールド：
   
   • ステップ 1のポストバックURLを貼り付けてください。
   • Blockchain-AdsのプレースホルダーをKeitaroの同等物に置き換えてください：
     
     • {clickid} → {external_id}（キャプチャしたクリックIDを渡します）。
   • 変換後のURLの例：

特定のコンバージョンステータスのみを送信したい場合（例：承認されたリード）、「Send only statuses」ドロップダウンメニューを使用して選択してください（例：「Lead」、「Sale」）。

7. Createをクリックしてトラフィックソースを保存してください。
8. （オプション）複数のキャンペーンがある場合は、Update in campaignsをチェックして既存のキャンペーンに適用してください。

ステップ 3：Keitaroでキャンペーンを設定してテストする

1. Campaigns > Createに移動してください（または既存のものを編集します）。
2. Traffic SourceとしてBlockchain-Adsを選択してください。
3. フローを構築してください：ストリーム、ランディングページ、オファーを追加します。コンバージョンの場合：
   
   • アフィリエイトオファーを使用する場合は、アフィリエイトネットワークからKeitaroへのポストバックを設定してください（Affiliate Networksの下）。
   • コンバージョンルールを定義してください（例：オファーからのS2Sポストバック、ピクセル発火、またはカスタムイベント）。
4. KeitaroキャンペーンURLを生成してコピーしてください（https://your-domain.com/abc?clickid={external_id}のように表示されます—これをBlockchain-Adsキャンペーンの宛先として貼り付けてください）。
5. テスト：
   
   • Keitaro URLを指すBlockchain-Adsでテストキャンペーンを開始してください。
   • クリックとコンバージョンをシミュレートしてください（例：テストオファー経由）。
   • キャプチャされたクリック/コンバージョンにKeitaroレポート (Reports > Conversions) を確認してください。
   • Blockchain-Adsトラッキングでポストバックが到着することを確認してください（一致するクリックIDと収益）。
   • 必要に応じて、Postmanなどのツールを使用して手動でテストポストバックを発火してください。

ヒントとトラブルシューティング

• Keitaroのプレースホルダー：clickidには{external_id}、金額には{revenue}、イベントタイプには{status}を使用してください（例：「lead」をステータスにマッピング）。エンコードされていない値の場合は、接頭辞_を使用してください（例：{_external_id}）。
• 収益/通貨：コンバージョンの通貨が異なる場合は、{revenue:USD}を使用して変換してください。
• エラー：ポストバックにはHTTPSを使用していることを確認してください。データが流れない場合は、URLエンコーディング、ファイアウォールブロック、または一致しないトラッカーIDを確認してください。KeitaroはLogs > Postbacksでポストバック試行を記録します。
• 高度：複数のイベントの場合、Blockchain-Adsで個別のコンバージョンイベントを作成し、Keitaroに複数のポストバックURLを追加してください（ステータスごとに1つ）。

この設定により、Cookieを使用せずに正確なアトリビューションが可能になります。Keitaroの詳細については、docs.keitaro.ioのドキュメントを参照してください。