できること

KARTE Signalsでは、コンバージョンのインポート機能を使用してYahoo!検索広告のコンバージョン補完を実施することができます。ここではその連携方法について説明します。

※Datahub ジョブフローを使って連携する場合は、こちらのドキュメントをご確認ください。

事前準備

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

広告APIの設定

その他の機能 > 広告API > 追加から、Yahoo! Search Ads Conversion APIを選択します。
名前、説明は、適宜修正してください。
事前準備で用意したアカウントIDとベースアカウントID（MCCアカウントID）を入力し、保存ボタンを押してください。

コネクタの設定

1.テンプレートの選択

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

2.送信先の広告API

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

3.配信パラメータ

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

パラメーター名	説明
Yahoo!のイベント名	媒体管理画面のツールからコンバージョン計測内でインポート先のコンバージョン名を指定してください。
◯時間前までのデータを利用する	媒体に送信するデータを作成するための期間を抽出します。現在から[入力された時間]前までの期間が抽出されます。24時間以内に送信することを推奨します。
広告接触から対象イベントまでの日数	アトリビューションウィンドウです。広告接触から[入力された日数]以内であれば対象イベントを送信します。

4.利用するデータ

コンバージョンデータ

Yahoo!に送信するコンバージョンデータを抽出します。
利用するデータ
- KARTEデータ/イベントデータを選択してください。
KARTEイベント
- コンバージョン補完に利用するKARTEイベントを選択してください。
  ※相対日時で指定する、データ利用日数は変更しないでください。
必要に応じて、カラムマッピング、データを絞り込みを実施してください。
保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。

フィールド名	必須	説明
user_id	○	ユーザーID KARTEのuser_idを選択してください
transaction_id		Yahoo!への連携には使用しないため、設定不要です
sync_date	○	※自動で取得されるため、変更不要です。
revenue	○	コンバージョン値値を送りたい場合に、選択してください。
items		Yahoo!への連携には使用しないため、設定不要です
session_id	○	※自動で取得されるため、変更不要です。
pv_id	○	※自動で取得されるため、変更不要です。

クリックID（yclid）

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

5.送信スケジュール

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

6.送信

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

送信確認

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

データの確認

ツール>コンバージョン測定にてコンバージョン毎に比較します。
「表示項目」を編集し、【コンバージョン数（全て）】を選択し、表示されるようにします。
Yahoo!コンバージョンタグとsignalsから送信したCVでそれぞれ【コンバージョン数】と【コンバージョン数（全て）】を比較し、差分を確認します。差分の数値を補完されたコンバージョンとして計測します。

null

Yahoo!検索広告のコンバージョンを補完する