Google Ads のCAPI設定
対応状況: 対応済み(クリックコンバージョンのアップロード)。広告クリックID(gclid / gbraid / wbraid)を持つCVを、Google 広告の「インポート(クリック)」コンバージョンへ送信します。
共通のアプリ側手順に加えて、Google固有で用意するものは次のとおりです。
| 用意するもの | 取得する場所 | 使う場所 |
|---|---|---|
| 「インポート(クリック)」のコンバージョンアクション | 【媒体】Google 広告 管理画面 | — |
| コンバージョンアクションのリソース名 | 【媒体】(下記の調べ方参照) | 【アプリ】CVマッピングの「媒体側CV」 |
ヒント
認証は連携済みの Google 広告アカウントをそのまま使うため、追加のキー入力は不要です(対象の媒体フォルダに Google 広告アカウントが連携されている必要があります)。
手順A【媒体】コンバージョンアクションを作成する
- Google 広告の管理画面で 「目標」→「コンバージョン」→「概要」→「+ 新しいコンバージョン アクション」 を開きます。
- 「インポート」→「他のデータソースまたは CRM からのクリック」 を選んで作成します(タイプが「クリック」のインポートであることが重要です)。
- 作成したアクションが 「有効」 になっていることを確認します。
手順B【媒体】リソース名を確認する
アプリの「媒体側CV」には、コンバージョンアクションの リソース名 を登録します。形式は次のとおりです:
customers/<お客様ID(ハイフン無し)>/conversionActions/<コンバージョンアクションID>
コンバージョンアクションIDは、管理画面で対象アクションを開いたときの URL の ctId= の数字から確認できます。
手順C【アプリ】CVの対応付けを登録する
対象の媒体フォルダの 「コンバージョン設定(CAPI)」→「CV マッピング」 で入力します。
- アプリ内CV名: サイトのタグ(または LINE 連携)から送るCV名(例:
Purchase)。 - 媒体側CV: 手順Bのリソース名(
customers/…/conversionActions/…)。 - 「追加」を押して保存します。
照合と精度について
- 照合には広告クリックID(gclid / gbraid / wbraid)を使います。LPに配布タグを設置していれば自動で捕捉されます。
- メールアドレス・電話番号を送っている場合は、Google の拡張コンバージョン形式(ハッシュ化)で自動的に同梱され、照合の補助に使われます。
- クリックIDが無いCVは Google へは送信されません(転送結果は「対象外(no_match_key)」になります)。
確認のしかた
設定後にテストのCVを発生させ、Google 広告の対象コンバージョンアクションに計上されるか確認します(反映まで数時間かかることがあります)。アプリの転送結果ログも参照してください。
| 転送結果のエラーコード | 意味 |
|---|---|
EXPIRED_CLICK | クリックがコンバージョンの計測期間(既定30日)を超過。再送されません |
CLICK_NOT_FOUND | クリックIDが見つからない(テスト用の偽IDなど)。再送されません |
DUPLICATE_ORDER_ID | 同じ注文番号で計上済み(重複排除が効いた正常な状態) |
TOO_RECENT_CONVERSION_ACTION | アクション作成直後。時間をおいて自動で再送されます |
注意
Google Ads API の developer token が本番アクセス(standard access) である必要があります。テスト用トークンでは実データに書き込めません。