Gán thuộc tính cho quảng cáo Click-to-WhatsApp #

Nếu bạn chạy quảng cáo “Click to WhatsApp” trên Meta (Facebook/Instagram), Your AI Connector có thể cho bạn biết mỗi khách hàng tiềm năng từ WhatsApp đến từ quảng cáo nào — và cung cấp cho bạn mã định danh nhấp chuột của Meta mà bạn cần để báo cáo chuyển đổi thực tế lại cho Meta. Điều này cho phép các chiến dịch quảng cáo của bạn tối ưu hóa cho doanh số và lượt đặt chỗ thực tế, thay vì chỉ tối ưu hóa cho “những người bắt đầu cuộc trò chuyện.”

Bạn đang chạy quảng cáo dẫn đến một trang trên trang web của riêng mình có nút WhatsApp? Xem Gán thuộc tính nhấp chuột quảng cáo cho WhatsApp.

Những thông tin được ghi lại #

Khi ai đó nhấn vào quảng cáo Click-to-WhatsApp và nhắn tin cho doanh nghiệp của bạn, Meta sẽ đính kèm thông tin giới thiệu ẩn vào tin nhắn đầu tiên đó. Your AI Connector sẽ tự động đọc thông tin này và lưu trữ trên thông tin liên hệ. Không cần thiết lập, không cần cấu hình — mọi thứ diễn ra tự động.

Thông tin được ghi lại sẽ lưu trên thông tin liên hệ dưới dạng ad_referral và bao gồm:

Bạn có thể thấy thông tin này mà không cần thiết lập gì cả: trang của liên hệ hiển thị nhãn Đến từ quảng cáo bên dưới tên của họ (di chuột qua để xem chi tiết quảng cáo), bảng liên hệ bên cạnh cuộc trò chuyện cũng hiển thị thông tin này, và Hoạt động của liên hệ bắt đầu bằng lượt nhấn vào quảng cáo. Bạn cũng có thể đọc thông tin này thông qua webhook và API (xem bên dưới). Đây không phải là một cột trong bảng Liên hệ.

Một điều mà payload không cho bạn biết: cuộc hội thoại đó được gửi đến số nào của bạn. Không có id trang hoặc id Tài khoản WhatsApp Business trong đó. Với một số điện thoại duy nhất thì điều đó không quan trọng; nếu bạn chạy nhiều số trên các Trang Facebook khác nhau, bạn sẽ cần phải ánh xạ điều đó ở phía mình.

Các khách hàng tiềm năng không có số điện thoại #

Một số người nhắn tin cho bạn từ quảng cáo đã ẩn số điện thoại của họ trên WhatsApp. Trong trường hợp đó, Meta sẽ cung cấp một id riêng tư cho người đó thay vì số điện thoại, và liên hệ sẽ được tạo với trường số điện thoại trống. Điều này là bình thường. Các phản hồi, câu trả lời từ AI và tin nhắn theo dõi tự động vẫn gửi được đến người đó vì Your AI Connector liên hệ với họ thông qua id đó.

Hãy để trống trường số điện thoại trên các liên hệ như vậy. Đừng nhập số điện thoại doanh nghiệp của chính bạn vào đó: tin nhắn không thể được gửi từ một số đến chính nó, vì vậy tin nhắn theo dõi tự động tiếp theo sẽ thất bại và liên hệ đó sẽ bị tạm dừng. Your AI Connector hiện từ chối lưu một trong các số điện thoại đã kết nối của bạn làm số điện thoại của liên hệ. Nếu sau này người đó chia sẻ số điện thoại của họ hoặc nhắn tin lại cho bạn khi số điện thoại đã hiển thị, trường này sẽ được tự động điền vào.

Kết nối nào hỗ trợ tính năng này #

Tính năng này chỉ hoạt động trên kết nối WhatsApp API chính thức. Meta chỉ cung cấp thông tin giới thiệu có cấu trúc (bao gồm ctwa_clid) thông qua WhatsApp Business API chính thức. Kết nối WhatsApp (web) không chính thức sẽ không nhận được thông tin này — theo thiết kế, không có dữ liệu nhấp chuột quảng cáo nào khả dụng trên kết nối đó.

Vì vậy, nếu việc gán thuộc tính quảng cáo khép kín (closed-loop) quan trọng với bạn, hãy chạy các chiến dịch Click-to-WhatsApp thông qua số điện thoại được kết nối bằng WhatsApp API chính thức.

Quảng cáo Click-to-Instagram và Click-to-Messenger #

Các quảng cáo mở tin nhắn trực tiếp (DM) trên Instagram hoặc cuộc trò chuyện trên Messenger được ghi nhận theo cùng một cách, trên Trang Facebook và tài khoản Instagram mà bạn đã kết nối với thẻ Instagram & Messenger. Khi ai đó bắt đầu cuộc trò chuyện từ một trong những quảng cáo đó, liên hệ sẽ nhận được một ad_referral với channel được đặt thành instagram hoặc messenger, source_type được đặt thành ad và source_id được đặt thành ID quảng cáo. Điều đó cung cấp cho bạn thông tin về quảng cáo đằng sau mỗi liên hệ, để bạn có thể tính toán chi phí trên mỗi lượt đặt chỗ cho từng quảng cáo.

Một vài điểm khác biệt so với WhatsApp:

• Không có ctwa_clid; trường đó trống. Meta chỉ cấp mã định danh nhấp chuột đó cho WhatsApp.
• headline là tiêu đề của quảng cáo khi Meta gửi nó, và source_url là liên kết hình ảnh hoặc video của quảng cáo nếu có. body thì trống.
• Nếu liên hệ ban đầu đến từ một quảng cáo và sau đó bắt đầu trò chuyện từ một quảng cáo khác, ad_referral sẽ hiển thị quảng cáo mới hơn.
• Các liên hệ từ quảng cáo Messenger sẽ mang thông tin quảng cáo kể từ ngày 14 tháng 10 năm 2026 trở đi. Những liên hệ đến từ quảng cáo Messenger trước ngày đó sẽ không có ad_referral, vì chi tiết quảng cáo không được ghi lại vào thời điểm đó và không thể điền bổ sung sau này.
• Các cuộc trò chuyện Messenger bắt đầu bằng việc nhấn vào nút Bắt đầu (Get Started) của Trang sẽ không được ghi lại. Hãy xóa nút Bắt đầu khỏi Trang của bạn (trong Meta Business Suite, cài đặt Hộp thư) để mọi người bắt đầu cuộc trò chuyện bằng cách nhập tin nhắn, khi đó quảng cáo sẽ được ghi lại trong tin nhắn đầu tiên của họ.

Hành vi tương tác đầu tiên (First-Touch) #

Lượt giới thiệu được ghi lại trong tin nhắn đầu tiên mà một liên hệ gửi từ quảng cáo. Nếu cùng liên hệ đó sau này nhấp vào một quảng cáo khác và lượt nhấp mới hơn đó mang theo mã định danh nhấp chuột, thì ad_referral đã lưu trữ sẽ được làm mới để mã nhấp chuột luôn cập nhật cho mục đích báo cáo. Các lượt giới thiệu từ bài đăng tự nhiên (không có ctwa_clid) sẽ không bao giờ ghi đè lên mã nhấp chuột quảng cáo trả phí đã được ghi lại trước đó.

Đưa dữ liệu vào Meta hoặc Google Ads #

Your AI Connector thu thập dữ liệu thuộc tính và hiển thị dữ liệu đó. Đối với các quảng cáo gửi người dùng đến trang web của riêng bạn trước, Your AI Connector có thể gửi kết quả cho Meta thay bạn khi một thẻ được áp dụng: xem Gửi kết quả cho Meta. Đối với quảng cáo Click-to-WhatsApp, bạn chuyển tiếp dữ liệu bằng webhook cùng với một công cụ tự động hóa.

Đối tượng ad_referral được bao gồm trong phần contact của các sự kiện webhook gửi đi (ví dụ: Tin nhắn mới, Liên hệ đã tiếp tục, Thẻ liên hệ đã cập nhật và các sự kiện phân tích như Đã đặt lịch hẹn).

Một thiết lập khép kín điển hình:

1. Khách hàng tiềm năng nhấp vào quảng cáo Click-to-WhatsApp của bạn và nhắn tin cho bạn. Your AI Connector ghi lại ad_referral (bao gồm cả ctwa_clid) trên thông tin liên hệ.
2. Khi khách hàng tiềm năng tiến triển — đã đặt lịch gọi, trở thành khách hàng, hoặc bị mất — bạn đánh dấu kết quả đó (xem phần “Chuyển tiếp giai đoạn phễu” bên dưới).
3. Một webhook sẽ kích hoạt đến công cụ tự động hóa của bạn (Zapier, Make hoặc Pabbly) mang theo cả kết quả và ctwa_clid của khách hàng.
4. Công cụ tự động hóa của bạn sẽ gọi API Chuyển đổi của Meta (sử dụng action_source = business_messaging và ctwa_clid) hoặc Google Ads (Nhập chuyển đổi ngoại tuyến / Chuyển đổi nâng cao cho khách hàng tiềm năng) để báo cáo chuyển đổi.

Bằng cách này, Meta và Google sẽ biết được quảng cáo nào mang lại kết quả thực tế và tối ưu hóa dựa trên đó.

Chuyển tiếp giai đoạn phễu #

Để báo cáo một chuyển đổi, bạn thường cần hai thứ: id nhấp chuột (được ghi lại tự động) và kết quả (do bạn thiết lập). Cách đáng tin cậy nhất để đính kèm kết quả là sử dụng thẻ, vì việc áp dụng một thẻ sẽ kích hoạt webhook contact_tags_updated — và payload đó bao gồm ad_referral của liên hệ. (Việc xóa thẻ sẽ không kích hoạt webhook này; xem Cập nhật Thẻ Liên hệ.)

Bạn có thể áp dụng thẻ tự động:

• Hãy để AI Agent gắn thẻ liên hệ trong cuộc trò chuyện — thiết lập các quy tắc tự động gắn thẻ trong cấu hình của agent. Đây là cách mô hình “một trang đích cho mỗi quảng cáo → một tin nhắn đầu vào → một thẻ” hoạt động nếu bạn muốn tự gắn nhãn nguồn.
• Hoặc gắn thẻ thủ công từ mục Trò chuyện hoặc trang Danh bạ.

Bất cứ khi nào một thẻ liên quan thay đổi, webhook sẽ kích hoạt kèm theo id nhấp chuột, sẵn sàng để chuyển tiếp dưới dạng chuyển đổi.

URL webhook được thiết lập trên chính thẻ đó, trong tab Tags của trình chỉnh sửa tác nhân AI mà liên hệ được gán vào, chứ không phải trong phần Cài đặt (Settings). Mỗi thẻ có một URL riêng và tất cả chúng đều có thể trỏ đến cùng một điểm cuối nếu bạn muốn có một nơi duy nhất để nhận mọi thứ.

Đọc id nhấp chuột mà bạn đã bỏ lỡ #

ad_referral cũng được API trả về trên cả GET /v1/contacts/{id} (dưới dạng adReferral) và điểm cuối danh sách liên hệ (dưới dạng ad_referral), vì vậy nếu trình nhận của bạn bị lỗi hoặc bạn đang đối soát sau đó, bạn có thể đọc lại id nhấp chuột thay vì đợi webhook tiếp theo. Các liên hệ đến trước khi id nhấp chuột được ghi lại trên họ sẽ có null ở đây — giá trị này chỉ có thể được ghi lại từ chính tin nhắn đến, vì vậy không có gì để điền vào một cách hồi tố.

Hạn chế #

• Chỉ kết nối API WhatsApp chính thức (không phải kết nối web không chính thức).
• Tính năng Gửi kết quả cho Meta tích hợp sẵn sẽ gửi dữ liệu nhấp chuột được ghi lại bởi tập lệnh trên trang web; nó không gửi ctwa_clid của quảng cáo Click-to-WhatsApp. Đối với các quảng cáo đó và đối với Google Ads, bạn chuyển tiếp dữ liệu thông qua Zapier/Make/Pabbly. Nếu bạn muốn có tích hợp gốc, hãy thông báo cho bộ phận hỗ trợ tại hi@youraiconnector.com.
• Dữ liệu thuộc tính được thu thập từ thời điểm tính năng này hoạt động. Dữ liệu không thể được bổ sung cho các cuộc trò chuyện đã diễn ra trước đó.

Các bước tiếp theo #

• Webhooks — xem toàn bộ payload và những sự kiện nào bao gồm ad_referral.
• Sử dụng Thẻ để Gắn nhãn Liên hệ — thiết lập các thẻ mang theo các giai đoạn phễu của bạn.
• Gán thuộc tính nhấp chuột quảng cáo cho WhatsApp: khớp các lượt nhấp vào quảng cáo dẫn đến trang web của riêng bạn với cuộc trò chuyện trên WhatsApp.