Google Ads のCAPI設定

← コンバージョンAPI設定にもどる

対応状況: 対応済み(クリックコンバージョンのアップロード)。広告クリックID(gclid / gbraid / wbraid)を持つCVを、Google 広告の「インポート(クリック)」コンバージョンへ送信します。

共通のアプリ側手順に加えて、Google固有で用意するものは次のとおりです。

用意するもの取得する場所使う場所
「インポート(クリック)」のコンバージョンアクション【媒体】Google 広告 管理画面
コンバージョンアクションのリソース名【媒体】(下記の調べ方参照)【アプリ】CVマッピングの「媒体側CV」

ヒント

認証は連携済みの Google 広告アカウントをそのまま使うため、追加のキー入力は不要です(対象の媒体フォルダに Google 広告アカウントが連携されている必要があります)。


手順A【媒体】コンバージョンアクションを作成する

  1. Google 広告の管理画面で 「目標」→「コンバージョン」→「概要」→「+ 新しいコンバージョン アクション」 を開きます。
  2. 「インポート」→「他のデータソースまたは CRM からのクリック」 を選んで作成します(タイプが「クリック」のインポートであることが重要です)。
  3. 作成したアクションが 「有効」 になっていることを確認します。

手順B【媒体】リソース名を確認する

アプリの「媒体側CV」には、コンバージョンアクションの リソース名 を登録します。形式は次のとおりです:

customers/<お客様ID(ハイフン無し)>/conversionActions/<コンバージョンアクションID>

コンバージョンアクションIDは、管理画面で対象アクションを開いたときの URL の ctId= の数字から確認できます。

手順C【アプリ】CVの対応付けを登録する

対象の媒体フォルダの 「コンバージョン設定(CAPI)」→「CV マッピング」 で入力します。

  1. アプリ内CV名: サイトのタグ(または LINE 連携)から送るCV名(例: Purchase)。
  2. 媒体側CV: 手順Bのリソース名(customers/…/conversionActions/…)。
  3. 「追加」を押して保存します。

照合と精度について

  • 照合には広告クリック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) である必要があります。テスト用トークンでは実データに書き込めません。