# Click-to-WhatsApp 広告の属性計測
Meta (Facebook/Instagram) の「WhatsApp にクリック」広告を運用している場合、Your AI Connector を使用すると、各 WhatsApp リードがどの広告から来たのかを特定できます。また、Meta に実際のコンバージョンを報告するために必要な Meta クリック識別子を取得することも可能です。これにより、広告キャンペーンを「チャットを開始した人」だけでなく、実際の売上や予約に向けて最適化できるようになります。
---
## 取得される情報
ユーザーが「WhatsApp にクリック」広告をタップしてビジネスにメッセージを送信すると、Meta はその最初のメッセージに非表示の参照情報を付加します。Your AI Connector はこれを自動的に読み取り、連絡先情報として保存します。設定や構成は不要で、自動的に実行されます。
取得された情報は、連絡先に `ad_referral` として保存され、以下が含まれます。
| フィールド | 内容 |
|---|---|
| `ctwa_clid` | Metaクリック識別子。これは、下流のコンバージョンを正確な広告クリックに紐付けるためにMetaのコンバージョンAPIへ送信する値です。オーガニック投稿からの参照の場合は空になります（下記参照）。 |
| `source_id` | ユーザーがクリックした広告（または投稿）のID。 |
| `source_type` | `ad`（有料のClick-to-WhatsApp広告）または `post`（オーガニックのFacebook/Instagram投稿）のいずれか。 |
| `source_url` | 広告コンテンツに関連付けられたリンク。 |
| `headline` | 広告の見出しテキスト。 |
| `body` | 広告の本文テキスト。 |
| `channel` | 参照元となったチャネル（現在は常に `whatsapp`）。 |
| `captured_at` | 連絡先に参照情報が最初に記録された日時。 |
カスタムフィールドを設定している場合は、連絡先の[クイックビューパネル](../get-started/creating-contacts.md)でこれを確認できます。また、WebhookやAPI（下記参照）を通じて直接読み取ることも可能です。連絡先テーブルの個別のラベル付きフィールドとしては表示されません。
> **ペイロードから読み取れない情報が1つあります：** どの電話番号宛てに会話が届いたかという情報です。これにはページIDやWhatsApp BusinessアカウントIDが含まれていません。番号が1つだけであれば問題ありませんが、複数のFacebookページで複数の番号を運用している場合は、自社側でマッピングを行う必要があります。
---
## 対応している接続
> これは**公式WhatsApp API接続でのみ**機能します。Metaは、公式WhatsApp Business APIを通じてのみ、構造化された参照情報（`ctwa_clid`を含む）を提供します。**非公式のWhatsApp（Web）接続ではこの情報を受信できません。** その仕組み上、非公式接続では広告クリックデータを利用できないようになっています。
したがって、クローズドループの広告属性計測が重要な場合は、公式WhatsApp API経由で接続された番号を使用してClick-to-WhatsAppキャンペーンを実行してください。
---
## ファーストタッチの動作
参照情報は、連絡先が広告から送信する**最初**のメッセージで取得されます。同じ連絡先が後で別の広告をクリックし、その新しいクリックにクリック識別子が含まれている場合、保存されている `ad_referral` は更新され、レポート用に最新のクリックIDが保持されます。オーガニック投稿からの参照（`ctwa_clid`を持たないもの）は、以前に取得された有料広告のクリックIDを上書きすることはありません。
---
## Meta広告やGoogle広告へのデータ連携
Your AI Connector はアトリビューションデータを取得して公開しますが、現時点では Meta や Google にコンバージョンをネイティブに送信する機能は**ありません**。データは Webhook と自動化ツールを使用して転送する必要があります。
`ad_referral`オブジェクトは、送信される[Webhook](webhooks.md)イベントの`contact`セクションに含まれています（例：新規メッセージ、連絡先の再開、連絡先タグの更新、および予約完了などの分析イベント）。
一般的なクローズドループ設定の例：
1. リードが「WhatsApp にクリック」広告をクリックしてメッセージを送信します。Your AI Connector は連絡先に `ad_referral`（`ctwa_clid` を含む）を記録します。
2. リードの状況が進展した（通話を予約した、顧客になった、失注したなど）場合、その結果をマークします（以下の「ファネルステージの引き継ぎ」を参照）。
3. Webhook が自動化ツール（Zapier、Make、または Pabbly）に送信され、結果と連絡先の `ctwa_clid` が渡されます。
4. 自動化ツールが Meta のコンバージョン API（`action_source = business_messaging` と `ctwa_clid` を使用）または Google 広告（オフラインコンバージョンインポート / リード向け拡張コンバージョン）を呼び出し、コンバージョンを報告します。
これにより、MetaとGoogleはどの広告が実際の成果を生み出したかを学習し、それに向けて最適化を行います。
---
## ファネルステージの引き継ぎ
コンバージョンを報告するには、通常、クリックID（自動的に取得されます）と成果（ユーザーが設定します）の2つが必要です。成果を紐付ける最も確実な方法は**タグ**を使用することです。タグを適用すると `contact_tags_updated` Webhook が実行され、そのペイロードに連絡先の `ad_referral` が含まれるためです。（タグを削除してもWebhookは実行されません。詳細は [連絡先タグの更新](webhooks.md#contact-tags-updated-webhook) を参照してください。）
タグは自動的に適用できます：
- 会話中にAIエージェントに連絡先をタグ付けさせます。エージェントの設定で自動タグ付けルールを作成してください。これが「広告ごとに1つのランディングページ → 1つのエントリーメッセージ → 1つのタグ」というパターンで、ソースを自分でラベル付けする方法です。
- または、チャットや連絡先ページから手動でタグ付けすることも可能です。
関連するタグが変更されるたびに、クリックIDが添付されたウェブフックが起動し、コンバージョンとして転送できるようになります。
Webhook URLは、設定（Settings）ではなく、連絡先が属するエージェント（またはキャンペーン）の**タグ（Tags）**タブで、タグごとに設定されます。各タグに独自のURLが割り当てられますが、すべてを1か所で受信したい場合は、同じエンドポイントを指定することも可能です。
### 見逃したクリックIDを読み取る
`ad_referral`は、`GET /v1/contacts/{id}`（`adReferral`として）および連絡先リストエンドポイント（`ad_referral`として）の両方でAPIから返されます。そのため、受信側がダウンしていた場合や、事後に照合を行う場合は、次のWebhookを待たずにクリックIDを読み取ることができます。クリックIDが記録される前に到着した連絡先には`null`が入ります。この値は受信したメッセージ自体からしか取得できないため、遡って埋めることはできません。
---
## 制限事項
- 公式WhatsApp API接続のみ（非公式のWeb接続は不可）。
- ネイティブなワンクリックのMeta CAPIやGoogle広告連携はまだありません。データはZapier/Make/Pabbly経由で転送してください。ネイティブ連携をご希望の場合は、hi@youraiconnector.comまでサポートにお知らせください。
- アトリビューションは、この機能が有効になった時点から記録されます。それ以前に行われた会話に遡って適用することはできません。
---
## 次のステップ
- [Webhooks](webhooks.md) — 完全なペイロードと、どのイベントに `ad_referral` が含まれるかを確認します。
- [タグを使用して連絡先にラベルを付ける](../get-started/creating-tags.md) — ファネルステージを示すタグを設定します。