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 |
連絡先に参照情報が最初に記録された日時。 |
カスタムフィールドを設定している場合は、連絡先のクイックビューパネルでこれを確認できます。また、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イベントの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）ではなく、連絡先が属するエージェント（またはキャンペーン）の**タグ（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 — 完全なペイロードと、どのイベントに
ad_referralが含まれるかを確認します。 - タグを使用して連絡先にラベルを付ける — ファネルステージを示すタグを設定します。