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.”

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ể xem thông tin này trên bảng xem nhanh của liên hệ nếu bạn đã định cấu hình trường tùy chỉnh cho nó, hoặc đọc trực tiếp thông qua webhook và API (xem bên dưới) — nó không được tách riêng thành một trường có nhãn trong bảng Danh bạ.

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.

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.

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 phân bổ và hiển thị dữ liệu đó, nhưng hiện tại nó không tự động đẩy chuyển đổi sang Meta hoặc Google cho bạn. Bạn cần chuyển tiếp dữ liệu bằng webhook kết hợp 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 Thẻ của tác nhân (hoặc chiến dịch) mà liên hệ đó thuộc về — chứ không phải trong Cài đặt. 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).
• Chưa có tích hợp Meta CAPI hoặc Google Ads gốc, chỉ cần một cú nhấp chuột — 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.
• Quyền phân bổ được ghi nhận kể từ thời điểm này trở đi, ngay khi tính năng này hoạt động. Nó không thể được áp dụng ngược lại 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ẻ chứa các giai đoạn phễu của bạn.