できること
KARTE Signalsでは、Google広告に対して、オンラインでは発生しないコンバージョン（例：商談・契約）を、広告クリックに紐づけてオフラインコンバージョンとして送信できます。
本ドキュメントでは、以下のようなケースに対応した設定方法を説明します。
通常のクリックコンバージョンとして送信したい場合は、こちらのドキュメントをご参照ください。
事前設定
下記の事前準備を完了していることをご確認ください。
1. KARTE計測タグの設置
2. Google広告と連携するための事前準備
3. 連携するオフラインコンバージョンデータを準備する
注意事項
送信期限： オフラインコンバージョンデータは、広告クリック（接触）が発生してから90日以内に送信する必要があります。
タイムゾーン： データの発生日時（コンバージョン時間）は、Google広告のアカウントで設定されているタイムゾーンと一致している必要があります。
Google広告の管理画面にて、顧客データに関するポリシーを確認し、利用規約に同意している必要があります。
広告APIの設定
必要な権限 作業するGoogleアカウントは、「Google広告の標準権限以上」と「KARTE SignalsのAPI編集権限」の両方を持っている必要があります。
メニューから その他の機能 > 広告API > 追加 を開き、Google Data Manager API Event を選択します。
名前・説明を入力します。（任意）
以下の送信先情報を入力します。
カスタマーID / 広告主ID: 実際にコンバージョンを記録するGoogle広告のカスタマーIDを入力します（ハイフンなし10桁）。
コンバージョンアクションID: Google広告側で作成した「コンバージョンアクションID」を入力します。
認証用MCCアカウントID（任意）: MCCアカウント等の権限を使用してデータを送信する場合、その管理用アカウントIDを入力します。
リンク済みアカウントID（任意）: データパートナー権限を利用して別アカウントを経由する場合のみ入力します。通常は空欄のままで問題ありません。
「取得」ボタンをクリックし、Googleの認証画面で連携を承認します。
「認証済み」という表示を確認し、「保存」を押します。
コネクタの設定
1.テンプレートの選択
コネクタ > 作成 > テンプレートを選択 から、Google Data Manager API でオフラインコンバージョンを連携する（VBB用）(v1)を選択し、決定ボタンを押してください。
2.送信先の広告API
広告APIは、「広告APIの設定」で作成したものを選択します。
独自にデータをハッシュ対応済み
KARTEに既にハッシュ化された個人情報データを連携している場合に利用します。
ハッシュ化のルールが媒体側の規定に沿っているか確認してください。
3.配信パラメータ
下記を参考に、配信パラメータを設定してください。
| パラメーター名 | 説明 |
|---|---|
| イベントソース | コンバージョンが発生したオフラインのデータ元や接点（例：CRM、店舗POS、コールセンターなど）を指定します。媒体側での分析や学習データの分類に利用されます。 |
| ◯時間前までのデータを利用する | 媒体に送信するデータを遡って抽出する期間です。基盤となるオフラインデータ（CRM等）の更新頻度に合わせて設定してください。 |
| 広告接触から対象イベントまでの日数 | アトリビューションウィンドウです。広告をクリック等してから何日以内のオフラインCVを有効とするかを指定します。（最大90日前まで指定可能） |
4.利用するデータ
Googleに送信するデータの種類ごとに、どのデータを使うかを指定します。
設定後、必ず「保存」ボタンを押し、プレビューに意図通りのデータが表示されるか確認してください。
マッチングのための必須条件 Google側でオフラインコンバージョンを正しくユーザーと紐づけるために、【広告クリックデータ（GCLID）】または【個人情報データ（メールアドレス等）】のどちらか一方が必ず連携されている必要があります。
オフラインコンバージョンデータ
Googleに送信するコンバージョン発生時の情報を指定します。
利用するデータ
事前設定で接続したオフラインデータを選択してください。
カラムマッピング
保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| user_id | ○ | ユーザーID KARTEのuser_idを選択してください。 | |
| transaction_id | ○ | イベントの重複除外用ID オンラインイベントとの結合に利用します。 | |
| sync_date | ○ | イベントの発生日時 コンバージョンが発生した日時情報が入っている項目を指定してください。 | |
| item_quantity | 購入した商品の数量 数量情報がある場合は選択してください。 | ||
| item_price | イベントの値 イベントごとに異なる値を設定する場合は設定不要です。 | ||
| currency | イベントの値の通貨コード イベントごとに異なる値を設定する場合は設定不要です。 |
※その他項目は、Google広告への連携には使用しないため、設定不要です。
コンバージョンデータ（中間イベント）
例：資料請求など、広告クリック後に初めて発生したオンラインイベント
このデータを使って、**「資料請求より前に記録されたgclidのみ」**を使用するよう、処理内でフィルタリングされます。
この中間イベントの取得がない場合、**実際の資料請求より後に発生した広告クリックが誤って紐づけられる、可能性があり、**誤った広告にアトリビューションされるリスクがあります。
利用するデータ
事前準備で用意したCRMデータを選択してください
KARTEイベント
利用するKARTEイベントを選択してください。
※相対日時で指定する、データ利用日数は変更しないでください。
保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| user_id | ○ | ユーザーID KARTEのuser_idを選択してください。 | |
| transaction_id | ○ | イベントの重複除外用ID オフラインイベントとの結合に利用します。 | |
| sync_date | ○ | イベントの発生日時 コンバージョンが発生した日時情報が入っている項目を指定してください。 | |
| revenue | コンバージョン値 値を送りたい場合に、選択してください。 | ||
| currency | イベントの値の通貨コード イベントごとに異なる値を設定する場合は設定不要です。 |
※その他項目は、Google広告への連携には使用しないため、設定不要です。
広告クリックデータ
Google広告に送信するGCLID（クリックID）のデータを抽出します。
作成ボタンを押したのち、何も変更せずに保存ボタンを押してください。
コンバージョン値
Google広告に送信するオフラインイベントの値データを抽出します。
オフラインイベントと別でコンバージョン値を管理している場合に利用します。
※同じテーブルで管理されている場合はお手数ですが、オフラインコンバージョンデータと同じデータが抽出されるようにご設定ください。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| transaction_id | ○ | イベントの重複除外用ID 重複除外設定で送信した項目を選択してください。 | |
| conversion_value | イベントの値 | ||
| conversion_currency | イベントの値の通貨コード 未指定の場合はJPYで送信されます。 |
個人情報データ
Googleに送信する個人情報データを抽出します。
利用するデータ
identifyイベントで個人情報データを取得している場合は、KARTEデータ/ユーザーマスタを選択してください。
外部から連携している場合は、外部データから該当のデータを選択してください。
必要に応じて、カラムマッピング、データを絞り込みを実施してください。
保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
※個人情報は、メールアドレス、電話番号、氏名と住所のセットの中から1つ以上を含める必要があります。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| user_id | ○ | ユーザーID KARTEのuser_idを選択してください | |
| ※ | ○ | メールアドレス | |
| phone | ※ | ○ | 電話番号 |
| first_name | ※ | 名 | |
| last_name | ※ | 姓 | |
| zip_code | ※ | 郵便番号 | |
| country | ※ | 国コード 指定がない場合は「JP」が固定で連携されます |
※その他項目は、Google広告への連携には使用しないため、設定不要です。
5.送信スケジュール
定期的に連携する場合は、繰り返し実行の有効にするにチェックを入れて、実行間隔を設定してください。
元となるオフラインデータ（CRM、POS、Salesforce等）がKARTE（Datahub）にインポートされる頻度・時間帯に合わせて設定してください。
ユーザーマスタを利用する場合は、送信スケジュールを「50分」に指定してください。
6.送信
「下書き保存」をクリック後、「データを取得」ボタンを押して、プレビューでデータの中身と件数にエラーがないか最終確認します。
問題なければ「送信」ボタンを押して連携を開始します。
連携後の効果確認
オフラインデータが正しく送られ、Googleユーザーとマッチングできているかは、Google広告の管理画面で確認できます。
確認手順： Google広告のトップ ＞ 目標 ＞ コンバージョン（概要） ＞ 該当のアクションを選択 ＞ 診断タブ
※カバレッジやマッチ率は、データが十分に蓄積されてから表示されます（送信から最大24時間程度で更新）。
見方のポイント
アップロードのステータス: 正常に受信されている場合「成功」または「問題なし」と表示されます。エラーが出ている場合は、コンバージョン時間（タイムゾーン）やGCLID/個人情報のハッシュ化形式に問題がないか確認してください。
マッチ率: 送信したオフラインデータのうち、Googleのログインユーザー、または広告クリックとどれくらい一致（マッチ）したかを表します。
スマート自動入札への活用: 連携されたオフラインコンバージョン数が安定（目安として直近30日で30件以上）してくると、そのオフラインCV（例：店舗購入や大口成約）を目標とした自動入札の精度が大幅に向上します。