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