/web_ads ページの「CAPI設定」タブの操作方法を説明します。フォーム経由のコンバージョン (CV) をサーバー側から広告媒体に直接送る「コンバージョン API (CAPI)」の設定を行うページです。
1. CAPI とは
iOS の ITP（Intelligent Tracking Prevention）や Cookie 規制によって、ブラウザのピクセルタグだけでは広告 CV を取りこぼすケースが増えています。
CAPI は grip 側のサーバーから直接、広告媒体のサーバーに CV を送信する 仕組みで、ピクセル計測の取りこぼしを補完して広告の実績計測精度を上げます。
送信先
- Meta Ads（Facebook / Instagram 広告）— Conversions API
- Google Ads — オフライン コンバージョン アップロード
- LINEヤフー広告 — オフライン コンバージョン
2. 設定の前提
CAPI 設定を行う前に、各広告媒体の OAuth 連携が完了している必要 があります。
OAuth 連携は「/setting/integrations」（設定 > 広告連携）で行います。未連携の媒体は、CAPI 設定タブ内に黄色い警告が出て、各設定ページへのリンクボタンが表示されます。
3. ページの開き方
- 左メニューから「WEB予算・広告管理」を開く
- 上部のタブで「CAPI設定」をクリックする
4. 媒体別の設定項目
CAPI は媒体ごとに 1 つずつカードが並びます。共通する入力項目は次の通りです。
| 項目 | 必須 | 入力内容 |
|---|---|---|
| 有効化チェック | ○ | この媒体に CAPI を送るかどうか |
| Pixel ID / Conversion Action / Conversion Tracker | 有効時 ○ | 媒体側で作成した CV 計測 ID をプルダウンから選択 |
| 既定イベント名 | × | 送信時に使うイベント名。デフォルトは Lead。高度設定 |
| テスト イベント コード | ×（Meta のみ） | Meta Events Manager の「テスト」タブで確認するためのコード |
5. 媒体別の取得方法
Meta コンバージョン API
- Meta 広告マネージャー > Events Manager を開く
- 設定するピクセル（または Conversion API）を選ぶ
- その ID を、CAPI 設定の Pixel プルダウンから選択
Meta 用の「テスト イベント コード」を入れておくと、保存後の「テスト送信」ボタンで Events Manager のテスト タブに反映されるため、配信前に動作確認できます。
Google Ads コンバージョン アップロード
- Google Ads 管理画面 > ツール > インポート > その他データソース を開く
- CAPI で送信するコンバージョン アクションを確認する（「CAPIオススメ」マークが付いているもの推奨）
- 該当アクションを、CAPI 設定の Conversion Action プルダウンから選択
重要: Google 側で「自動タグ設定」が ON になっている必要があります。OFF の場合、gclid が付与されず全件取りこぼします。プルダウン下にも警告が出ます。
LINEヤフー広告 オフライン コンバージョン
- Yahoo! 広告 / LINE 広告の管理画面で、オフライン用の Conversion Tracker を作成する
- ★印（= CAPI 推奨）が付いた Tracker を、CAPI 設定の Conversion Tracker プルダウンから選択
6. 保存と送信タイミング
- カード下の「保存」ボタンで即時保存されます
- 保存以降に grip 上のフォームから入った CV は、grip サーバーが受信したタイミング（バッチ処理）で該当媒体へ自動送信されます
- 1 媒体ずつ別々に保存できるので、Meta だけ先に有効化、Google は後日、といった運用が可能です
7. テスト送信
有効化したカード下に「✈ テスト送信」ボタンが表示されます。クリックすると次が走ります。
| 媒体 | テスト送信の動作 |
|---|---|
| Meta | テスト イベント コードを設定していれば、Events Manager の「テスト」タブに反映 |
validate_only=true で送信形式の検証のみ実施。実際の CV としてはアップロードしない | |
| LINEヤフー | 同上の検証のみ |
カード下に「最終テスト日時 / 結果（成功 / 失敗 / スキップ）」が残ります。失敗の場合はトーストでエラー内容が出ます。
8. エラー表示と対処
| 表示 | 意味 | 対処 |
|---|---|---|
| Meta広告連携が必要 | OAuth 未連携 | 「Meta広告連携へ」ボタンから連携 |
| Google広告連携が必要 | OAuth 未連携 | 「Google広告連携へ」ボタンから連携 |
| LINEヤフー広告連携が必要 | OAuth 未連携 | 「LINEヤフー広告連携へ」ボタンから連携 |
| OAuth トークン更新失敗 | リフレッシュ トークンが期限切れ等 | 該当媒体の連携を一度解除して再連携 |
| Yahoo!広告アカウント未選択 | MCC 配下で広告アカウントを選んでいない | 連携設定でアカウントを選択 |
| Pixel / Conversion が出てこない | 媒体側で未作成 | 媒体管理画面で作成してからリロード |
9. プライバシーポリシー追記のお願い
CAPI では、フォームに入った氏名・メール・電話を SHA-256 でハッシュ化したうえで 広告媒体側に送信します。これは「第三者提供」に該当するため、プライバシーポリシーへの明記が法令上必要です。
CAPI 設定タブ内に「プライバシーポリシー追記を推奨」セクションがあり、雛形文章が用意されています。ワンクリックでコピーできるので、自社のプライバシーポリシーに転記してください。
10. 権限・利用範囲
- 表示・編集は全ログイン ユーザーで可能（ページ自体は権限フィルタなし）
- サイト未選択時はページがロックされます
- 各媒体は OAuth 連携が完了している必要があります（未連携時は警告のみ）
11. トラブルシューティング
| 症状 | 確認ポイント |
|---|---|
| テスト送信で「成功」なのに Meta に反映されない | テスト イベント コード設定漏れの可能性。Events Manager の「概要」ではなく「テスト」タブを確認 |
| Google で「自動タグ設定が OFF」警告 | Google Ads 管理画面で自動タグ設定を ON にする（必須） |
| LINEヤフーのプルダウンが空 | 管理画面で Conversion Tracker を作成し、しばらく経ってから再読み込み |
| 保存ボタンが押せない | OAuth 未連携。先に連携を完了させる |
