できること

KARTE Signalsでは、Yahoo!検索広告に対し、オンラインで発生しないコンバージョン（例：商談・契約）を、広告クリックに紐づけてオフラインコンバージョンとして送信できます。

本ドキュメントでは、以下のような中間イベント（例：資料請求）を含むケースに対応した設定方法を説明します。
null

通常のオフラインコンバージョンとして送信したい場合は、こちらのドキュメントをご参照ください。

事前準備

下記の事前準備を完了していることをご確認ください

  1. KARTE計測タグの設置
  2. Yahoo!検索広告側でのコンバージョン測定設定
  3. Yahoo!検索広告アカウントID確認
  4. Signalsで利用する外部データの取り込み方法

広告APIの設定

補足

広告API接続には、Yahoo!広告アカウントに対して「登録更新権限以上」のステータスが必要です。

  • その他の機能 > 広告API > 追加 から、Yahoo! Search Ads Conversion APIを選択します。
  • 名前、説明は、適宜修正してください。
  • 事前準備で用意したアカウントIDを入力し、取得するボタンを押してください。
  • 画面が遷移したら、「承認」を押して、接続を完了させてください。

コネクタの設定

1.テンプレートの選択

  • コネクタ > 作成 > テンプレートを選択 から、Yahoo!検索広告オフラインコンバージョンAPIでコンバージョン補完をする（VBB用）(v1)を選択し、決定ボタンを押してください。

2.送信先の広告API

  • 広告APIは、「広告APIの設定」で作成したものを選択します。
  • アップロードタイプを設定します。コンバージョンをインポートする作業は新規作成を設定してください。インポートしたデータを調整、削除したい場合は調整/削除を設定してください。
  • アップロードファイル名を入力します。Yahoo!検索広告のコンバージョン測定画面のインポート先に表示されるファイル名を入力します。入力された名称は下記イメージのように一覧から確認が可能です。
    null

3.配信パラメータ

下記を参考に、配信パラメータを設定してください。

パラメーター名 説明
Yahoo!のイベント名 媒体管理画面のツールからコンバージョン計測内でインポート先のコンバージョン名を指定してください。
◯時間前までのデータを利用する 現在からさかのぼって、媒体に送信するデータを抽出する期間です。
広告接触から対象イベントまでの日数 アトリビューションの対象となる広告クリックとコンバージョンイベントの間の日数を指定します。

4.利用するデータ

オフラインコンバージョンデータ

Yahoo!広告に送信するオフラインイベントデータを抽出します。

フィールド名 必須 推奨 説明
user_id ○ ユーザーID
KARTEのuser_idを選択してください。
transaction_id ○ イベントの重複除外用ID
オンラインイベントとの結合に利用します。
sync_date ○ イベントの発生日時
自動で取得されるため、変更不要です。
item_price イベントの値
イベントごとに異なる値を設定する場合は設定不要です。
currency イベントの値の通貨コード
イベントごとに異なる値を設定する場合は設定不要です。

※その他項目は、Yahoo!広告への連携には使用しないため、設定不要です。

コンバージョンデータ（中間イベント）

例：資料請求など、広告クリック後に初めて発生したオンラインイベント
このデータを使って、「資料請求より前に記録されたyclidのみ」を使用するよう、処理内でフィルタリングされます。
この中間イベントが取得できていない場合、実際の資料請求より後に発生した広告クリックが誤って紐づけられ、誤った広告にアトリビューションされるリスクがあります。

  • 利用するデータ
    • KARTEデータ/イベントデータを選択してください。
  • カラムマッピング
  • 保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
フィールド名 必須 推奨 説明
user_id ○ ユーザーID
KARTEのuser_idを選択してください。
transaction_id ○ イベントの重複除外用ID
オフラインイベントとの結合に利用します。
sync_date ○ イベントの発生日時
自動で取得されるため、変更不要です。

※その他項目は、Yahoo!広告への連携には使用しないため、設定不要です。

クリックID（yclid）

  • Yahoo!広告に送信するyclid（クリックID）のデータを抽出します。
  • 他項目はそのまま、変更せず保存ボタンを押してください。

コンバージョン値データ

  • Yahoo!広告に送信するオフラインイベントの値データを抽出します。
  • オフラインイベントと別でコンバージョン値を管理している場合に利用します。
    ※同じテーブルで管理されている場合はお手数ですが、オフラインコンバージョンデータと同じデータが抽出されるようにご設定ください。
フィールド名 必須 推奨 説明
transaction_id ○ イベントの重複除外用ID
オフラインイベントとの結合に利用します。
conversion_value ○ イベントの値
conversion_currency イベントの値の通貨コード
未指定の場合はJPYで送信されます。

5.送信スケジュール

  • 定期的に連携する場合は、繰り返し実行の「有効にする」にチェックを入れて、実行間隔を設定してください。
  • 利用するデータで外部データを利用している場合は、その連携頻度/連携時間に合わせてスケジューリングしてください。

6.送信

  • 「下書き保存」ボタンをクリックした後、「データを取得」ボタンを押すと、実際に連携される件数とデータが確認できます。
  • 確認して問題なければ、「送信」ボタンを押してください。

送信確認

  • Yahoo!広告の管理画面のメニュー>ツール>コンバージョン測定>インポートを開きます。まずは、ファイル名を確認し、KARTE Signalsから送られた送信されたデータが反映されていることを確認してください。
  • 取り込まれたデータを確認するには、全件ファイルをダウンロードをしてください。ステータスが終了(エラー)になっている場合、エラーファイルをダウンロードして理由を確認してください。
  • ステータスが終了になっていれば、連携完了です。null