Gán thuộc tính nhấp chuột quảng cáo cho WhatsApp #

Nếu bạn chạy quảng cáo Meta hoặc Google dẫn đến một trang trên trang web của riêng bạn và trang đó có nút WhatsApp, Your AI Connector có thể cho bạn biết mỗi cuộc trò chuyện WhatsApp đến từ lượt nhấp chuột quảng cáo nào. Bạn chỉ cần dán một đoạn mã nhỏ vào trang web của mình. Khi khách truy cập nhấn vào nút WhatsApp của bạn, lượt nhấp đó sẽ được ghi nhớ và khớp với tin nhắn đầu tiên họ gửi cho bạn. Sau đó, liên hệ sẽ hiển thị chiến dịch mà nó đến từ đó, và dữ liệu nhấp chuột sẽ đi kèm với liên hệ vào webhook, API và, nếu bạn muốn, gửi ngược lại Meta.

Tính năng này hoạt động với bất kỳ trang nào có nút WhatsApp: trang đích, trang đặt lịch, trang bảng giá hoặc bài kiểm tra kết thúc bằng “Gửi câu trả lời của tôi qua WhatsApp”.

Trang này nói về các quảng cáo dẫn người dùng đến trang web của bạn trước. Nếu quảng cáo của bạn mở trực tiếp WhatsApp (quảng cáo “Nhấp để trò chuyện qua WhatsApp” của Meta), điều đó sẽ được xử lý tự động mà không cần tập lệnh, trong phần Gán thuộc tính quảng cáo Nhấp để trò chuyện qua WhatsApp.

Thiết lập #

1. Đi tới Cài đặt → Theo dõi nhấp chuột quảng cáo (nhóm Tích hợp).
2. Nhấp vào Bật và lấy tập lệnh của tôi. Tài khoản của bạn sẽ nhận được khóa trang web riêng và một tập lệnh một dòng.
3. Sao chép tập lệnh và dán ngay trước thẻ đóng </body> trên mọi trang có nút WhatsApp:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Tùy chọn: trong phần Số WhatsApp, hãy nhập số mà các nút của bạn liên kết đến. Chỉ các liên kết đến số đó mới được theo dõi. Để trống nếu bạn muốn theo dõi mọi liên kết WhatsApp trên trang web.
5. Chọn cách diễn đạt cho số yêu cầu (xem bên dưới) và nhấp vào Lưu. Bạn không cần thay đổi tập lệnh trên trang web của mình sau khi thay đổi cài đặt.
6. Kiểm tra: mở trang của bạn từ một liên kết có gắn thẻ chiến dịch, ví dụ: https://yoursite.com/?utm_source=test&utm_campaign=setup-check, nhấn vào nút WhatsApp của chính bạn và gửi tin nhắn. Mở liên hệ đó trong phần Trò chuyện: bảng liên hệ sẽ hiển thị Đến từ một lượt nhấp quảng cáo cùng với chiến dịch.

Khóa trang web đã có sẵn trong tập lệnh. Đây không phải là mật khẩu, vì vậy việc để nó trên một trang công khai là hoàn toàn an toàn.

Tập lệnh thực hiện những gì #

• Khi trang tải, nó sẽ giữ lại các id nhấp chuột quảng cáo và thẻ chiến dịch (các tham số utm_) từ địa chỉ trang trong bộ nhớ phiên của tab trình duyệt, vì vậy chúng vẫn ở đó nếu khách truy cập xem trang khác trước. Nó không đặt cookie, không tải thêm bất cứ thứ gì và không gửi dữ liệu đi.
• Khi khách truy cập nhấn vào liên kết WhatsApp (wa.me, api.whatsapp.com/send hoặc whatsapp://send), nó sẽ thêm số yêu cầu vào tin nhắn, ghi lại lượt truy cập và cho phép lượt nhấn tiếp tục đến WhatsApp như bình thường.

Không có gì được gửi đến Your AI Connector trước khi lượt nhấn xảy ra.

Số yêu cầu #

Một số ngắn, giống như mã tham chiếu mà cửa hàng hoặc phòng khám cung cấp cho bạn, sẽ được thêm vào tin nhắn WhatsApp của khách truy cập. Đây là cách Your AI Connector biết chính xác lượt nhấp quảng cáo nào thuộc về cuộc trò chuyện nào. Một tin nhắn sẽ trông như thế này:

Hi, I would like to know more.
Enquiry no. 4827

• Cách diễn đạt: “Enquiry no.” là mặc định. Bạn có thể sử dụng bất kỳ dòng văn bản nào nghe có vẻ tự nhiên đối với doanh nghiệp của mình, chẳng hạn như “Booking ref” hoặc “Ref”. Không dùng chữ số.
• Vị trí: Trên dòng cuối cùng của riêng nó (mặc định) hoặc Ở cuối văn bản. Trang cài đặt hiển thị bản xem trước trực tiếp.
• Độ dài: 4 chữ số, hoặc 5 chữ số khi trang web của bạn có lưu lượng truy cập rất cao.
• Tác nhân AI của bạn không bao giờ nhìn thấy nó và không bao giờ lặp lại nó. Hộp thư đến hiển thị toàn bộ tin nhắn, bao gồm cả số.

Bạn có thể tắt số truy vấn. Khi đó, việc khớp dữ liệu chỉ dựa trên nội dung văn bản của tin nhắn, vì vậy hai khách truy cập gửi cùng một nội dung văn bản (ví dụ: cùng một câu trả lời trắc nghiệm) sẽ không thể phân biệt được và một số lượt nhấp sẽ không được khớp.

Mã trắc nghiệm hoặc nút của riêng bạn #

Nếu trang của bạn tự tạo tin nhắn WhatsApp (một bài trắc nghiệm đưa câu trả lời vào văn bản, hoặc mã nút của riêng bạn), hãy thêm data-manual vào thẻ script:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Với data-manual, tập lệnh sẽ không tự động thay đổi các liên kết WhatsApp nữa. Mã của riêng bạn sẽ gọi nó ngay trước khi mở WhatsApp, vì vậy mỗi lượt truy cập sẽ được ghi lại một lần:

• window.ChatAttribution.text(finalText, number) trả về văn bản của bạn kèm theo số truy vấn đã được thêm vào và ghi lại lượt truy cập. Hãy sử dụng văn bản được trả về trong liên kết WhatsApp của bạn.
• window.ChatAttribution.link(finalText, number) thực hiện tương tự và trả về một liên kết wa.me hoàn chỉnh với văn bản đó. Hãy bỏ qua số nếu muốn sử dụng số được đặt trong phần Số WhatsApp trong cài đặt.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

Nhánh else giúp nút vẫn hoạt động nếu tập lệnh chưa tải, ví dụ như khi một tiện ích mở rộng trình duyệt chặn nó. Một văn bản đã chứa số do tập lệnh cấp sẽ không bao giờ bị thay đổi lần thứ hai.

Những gì được ghi lại #

Tại thời điểm nhấn, bản ghi lượt truy cập bao gồm:

• các id nhấp chuột quảng cáo trong địa chỉ trang, chẳng hạn như fbclid (Meta) và gclid (Google)
• các cookie _fbc và _fbp, nếu pixel Meta của riêng bạn đã đặt chúng trên trang web của bạn (tập lệnh chỉ đọc, không bao giờ tự đặt chúng)
• các thẻ chiến dịch (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• trang đích, trang mà khách truy cập đã đến từ đó, trình duyệt và nội dung tin nhắn
• địa chỉ IP và thời gian, được Your AI Connector thêm vào khi lượt truy cập đến

Khi một lượt truy cập được khớp, Your AI Connector cũng tính toán từ dữ liệu đó vị trí tương đối của khách truy cập (thành phố và quốc gia, ước tính, từ địa chỉ IP) và thiết bị họ đã sử dụng (điện thoại, máy tính bảng hoặc máy tính, hệ điều hành và trình duyệt, ví dụ như trình duyệt trong ứng dụng Instagram). Vị trí sẽ để trống khi không thể xác định được, điều này thường xảy ra trên mạng di động.

Các bản ghi lượt truy cập được lưu giữ trong 90 ngày. Khi một lượt truy cập được khớp, một bản sao dữ liệu nhấp chuột của nó sẽ được lưu trữ trên liên hệ và gắn liền với liên hệ đó cho đến khi bạn xóa đi.

Thông báo về quyền riêng tư của bạn: tập lệnh chạy trên trang web của bạn, vì vậy thông báo về quyền riêng tư của trang web nên đề cập đến nó: những gì nó ghi lại (danh sách ở trên) và việc nó thực hiện điều đó khi khách truy cập nhấn vào nút WhatsApp.

Cách thức hoạt động của việc khớp dữ liệu #

Khi tin nhắn đầu tiên của một liên hệ đến, Your AI Connector sẽ tìm kiếm lượt truy cập trong khoảng thời gian 15 phút trước đó:

1. Trước tiên theo số truy vấn. Một tin nhắn mang số do tập lệnh cấp sẽ được khớp với lượt truy cập đó.
2. Nếu không, theo văn bản giống hệt nhau. Một tin nhắn có nội dung văn bản hoàn toàn trùng khớp với một lượt truy cập sẽ được khớp với lượt truy cập đó. Khi hai khách truy cập khác nhau gửi cùng một nội dung văn bản trong khoảng thời gian này, cả hai đều sẽ không được khớp (theo thiết kế), để đảm bảo một liên hệ không bao giờ bị gán nhầm cho sai quảng cáo.

Một tin nhắn gửi sau đó có chứa số truy vấn cũng sẽ được khớp, miễn là liên hệ đó chưa có dữ liệu khớp trước đó.

Khi một liên hệ đã có kết quả khớp quay lại thông qua một quảng cáo khác và gửi tin nhắn chứa số truy vấn mới hơn, lượt nhấp đó sẽ được lưu giữ làm lượt nhấp mới nhất của liên hệ. Kết quả khớp đầu tiên vẫn được giữ nguyên.

• Lượt nhấp đầu tiên, dành cho báo cáo của bạn: liên hệ vẫn hiển thị nguồn gốc ban đầu của khách hàng tiềm năng. Điều đó không bao giờ thay đổi.
• Lượt nhấp mới nhất, dành cho Meta: các sự kiện gửi đến Meta sử dụng lượt nhấp mới nhất, vì Meta ghi nhận quảng cáo đã đưa người dùng quay lại và chỉ trong cửa sổ phân bổ của nó. Việc báo cáo một lượt nhấp cũ sẽ ghi nhận sai quảng cáo, hoặc không ghi nhận gì cả.
• Lượt nhấp mới nhất chỉ được lấy từ số truy vấn, không bao giờ chỉ từ văn bản khớp, và một lượt truy cập cũ hơn sẽ không bao giờ thay thế lượt truy cập mới hơn.

Giới hạn:

• Kết quả khớp đầu tiên không bao giờ bị ghi đè. Các lượt nhấp mới hơn sẽ được đưa vào lượt nhấp mới nhất.
• Chỉ dành cho WhatsApp: các kênh WhatsApp Business API và WhatsApp Web.
• 15 phút: khách truy cập nhấn nút nhưng gửi tin nhắn muộn hơn nhiều sẽ không được khớp.
• Chỉ áp dụng từ thời điểm hiện tại: các liên hệ từ trước khi bạn cài đặt tập lệnh sẽ không có kết quả khớp.

Nơi bạn nhìn thấy nó #

• Bảng liên hệ: Đến từ một lượt nhấp quảng cáo cùng với chiến dịch hoặc nguồn và ngày nhấp đầu tiên. Di chuột qua để xem chi tiết: chiến dịch, Quảng cáo (utm_content) và Nhóm quảng cáo (utm_term), Vị trí và Thiết bị ước tính, mỗi thông tin chỉ hiển thị khi được biết, cộng với thông tin tương tự cho lượt nhấp gần nhất nếu có. Các thẻ chiến dịch chưa bao giờ được điền (một lần nhấn xem trước quảng cáo sẽ gửi mẫu thẻ thay vì tên) sẽ bị bỏ qua. Một lượt truy cập chỉ được tính là lượt nhấp quảng cáo khi trang được mở từ liên kết quảng cáo (id lượt nhấp của Meta hoặc Google, hoặc thẻ chiến dịch). Bất kỳ ai truy cập trang theo cách khác, ví dụ như từ tìm kiếm trên Google, bằng cách nhập địa chỉ của bạn hoặc bằng cách nhấp qua trang web của bạn, sẽ hiển thị Đến từ trang web của bạn cùng với nơi họ đến, chẳng hạn như Tìm kiếm trên Google, hoặc Lượt truy cập trang web, không ghi nhận nguồn giới thiệu khi trình duyệt không cung cấp thông tin.
• Trang liên hệ: dòng tương tự nằm dưới tên liên hệ trong Danh bạ, vì vậy bạn có thể thấy ngay lập tức, ngay cả trên điện thoại của mình. Di chuột hoặc nhấn vào đó để xem chi tiết.
• Hoạt động: dòng thời gian của liên hệ bắt đầu bằng Đã nhấn nút WhatsApp của bạn sau một quảng cáo (hoặc trên trang web của bạn) tại thời điểm nhấp, trước tin nhắn đầu tiên của họ. Bảng liên hệ của cuộc trò chuyện hiển thị cùng một dòng dưới mục Hoạt động.
• Webhooks: contact.ad_attribution trong webhooks thẻ đại lý và trong mọi sự kiện đăng ký webhook có chứa liên hệ.
• API: ad_attribution trên danh sách liên hệ và adAttribution trên một liên hệ đơn lẻ, trong phần Danh bạ của tài liệu tham khảo API.
• Công cụ MCP: cùng một đối tượng trên mọi liên hệ mà chúng trả về.

Giá trị là null khi liên hệ không có kết quả khớp. Các trường bên dưới mô tả lượt nhấp đầu tiên. Khi một lượt nhấp sau đó được khớp, latest sẽ lưu giữ nó với các trường tương tự; nó sẽ không xuất hiện cho đến lúc đó.

Gửi kết quả đến Meta (tùy chọn) #

Bạn có thể để Your AI Connector báo cáo kết quả lại cho tài khoản quảng cáo Meta của mình, để Meta tìm hiểu xem quảng cáo nào mang lại khách hàng tiềm năng và doanh số thực tế và tối ưu hóa theo đó. Việc này sử dụng chi tiết Conversions API Meta của riêng bạn.

1. Trong Meta Events Manager, hãy tìm ID pixel (còn gọi là tập dữ liệu) của bạn trong phần Data sources, và tạo mã truy cập trong phần Settings, Conversions API, Generate access token.
2. Trong Settings → Ad click tracking, tại mục Send results to Meta (optional), hãy nhập Pixel / dataset ID và Access token. Nhấp vào Save Meta details.
3. Tùy chọn: kiểm tra kết nối. Trong Meta Events Manager, hãy mở pixel của bạn và đi tới tab Test events, sao chép mã kiểm tra được hiển thị ở đó, dán vào mục Send a test event và nhấp vào Send test event. Dòng bên dưới nút sẽ hiển thị “Meta received 1 test event” (hãy tìm dòng này trong phần Test events trên Meta), hoặc hiển thị lý do của Meta nếu bị từ chối, ví dụ như sai mã truy cập. Mã này chỉ được sử dụng cho lần kiểm tra đó và không bao giờ được lưu lại.
4. Mở trình chỉnh sửa tác nhân (agent editor), đi tới tab Tags và mở một thẻ. Trong phần Send to Meta, hãy chọn sự kiện: Lead, Contact, Schedule, Purchase hoặc một tên tùy chỉnh. Tùy chọn thêm giá trị và đơn vị tiền tệ.

Kể từ đó, bất cứ khi nào thẻ đó được áp dụng cho một liên hệ (bởi AI, thủ công, thông qua API hoặc bằng tự động hóa), Your AI Connector sẽ gửi sự kiện đó đến Meta cùng với dữ liệu lượt nhấp mới nhất của liên hệ (fbc, fbp, địa chỉ IP, trình duyệt, trang đích, từ lượt nhấp mới nhất nếu có, nếu không thì lấy lượt đầu tiên) cộng với số điện thoại, email và tên của họ, đã được băm, để Meta có thể liên kết nó với quảng cáo. Một liên hệ không có kết quả khớp vẫn gửi sự kiện, chỉ với số điện thoại, email và tên đã được băm.

• Sự kiện trực tiếp luôn được tính: mã sự kiện kiểm tra không bao giờ được lưu cùng với thông tin chi tiết Meta của bạn, vì vậy các sự kiện mà thẻ và tự động hóa của bạn gửi đi sẽ luôn chuyển đến dữ liệu thực của bạn trong Meta, không bao giờ chuyển đến tab Test events.
• Không tính trùng lặp: mỗi sự kiện có một ID cố định được tạo từ ID liên hệ và tên thẻ. Nếu CRM của bạn gửi cùng một sự kiện đến Meta với cùng một ID, Meta sẽ chỉ giữ lại một sự kiện.
• Cửa sổ phân bổ của Meta: Meta chỉ ghi nhận một sự kiện cho quảng cáo trong cửa sổ phân bổ của nó, mặc định là 7 ngày sau khi nhấp chuột. Một giao dịch chốt sau vài tuần sẽ không tự động được tính, vì vậy hãy gửi thêm một sự kiện sớm hơn, ví dụ như thẻ cho cuộc tư vấn đã đặt hoặc đã thanh toán.

Gửi chuyển đổi từ các tự động hóa #

Một thẻ sẽ gửi sự kiện của nó khi thẻ đó được áp dụng. Khi kết quả xảy ra ở nơi khác, chẳng hạn như một giao dịch được chốt trong CRM của bạn hoặc một buổi tư vấn được đặt lịch, hãy sử dụng hành động Gửi chuyển đổi đến Meta trong một tự động hóa. Hành động này báo cáo một sự kiện tới tập dữ liệu Meta của bạn thông qua Conversions API, nhờ đó Meta tối ưu hóa quảng cáo của bạn dựa trên kết quả thực tế chứ không chỉ dựa trên tin nhắn.

Nó sử dụng cùng các chi tiết Meta như các thẻ: ID Pixel / tập dữ liệu và Mã truy cập trong mục Cài đặt → Theo dõi nhấp chuột quảng cáo. Nếu thiếu các thông tin này, bước này sẽ thất bại với thông báo “Meta chưa được kết nối”.

Các trường

Hãy điền ít nhất một trong các trường Liên hệ, Email hoặc Điện thoại. Cá nhân đó không nhất thiết phải là một liên hệ: một giao dịch HubSpot đạt trạng thái Closed Won (Đã chốt thành công) có thể gửi một sự kiện Purchase (Mua hàng) kèm theo giá trị giao dịch và email của người mua.

Khi bạn chọn một Liên hệ, số điện thoại, email và tên của họ sẽ được sử dụng. Nếu họ đến từ một lần nhấp chuột quảng cáo mà tập lệnh đã khớp, các chi tiết nhấp chuột cũng sẽ được gửi kèm, giúp Meta khớp sự kiện với quảng cáo. Email, số điện thoại và tên sẽ được băm (hash) trước khi gửi đi. ID nhấp chuột, địa chỉ IP và trình duyệt được gửi theo yêu cầu của Meta.

ID sự kiện và việc đếm trùng lặp

Meta đếm các sự kiện có cùng tên sự kiện và cùng ID sự kiện một lần duy nhất. Hãy sử dụng một ID cố định, chẳng hạn như ID giao dịch, khi một công cụ khác cũng báo cáo cùng một chuyển đổi, hoặc khi tự động hóa có thể chạy hai lần cho cùng một sự kiện đó. Nếu để trống, một ID mới sẽ được tạo mỗi khi chạy, vì vậy mỗi lần chạy sẽ được tính là một sự kiện.

Sự khác biệt so với các sự kiện thẻ

Sự kiện Gửi đến Meta của một thẻ sẽ được gửi một lần cho mỗi liên hệ đối với thẻ đó (tối đa một lần trong 30 ngày). Hành động này gửi đi mỗi khi nó chạy. ID sự kiện là yếu tố ngăn chặn việc một chuyển đổi bị đếm hai lần.

Ví dụ: một giao dịch đã chốt và một buổi tư vấn đã đặt lịch

1. Bắt đầu một quy trình tự động chạy khi một giao dịch được thắng: một trình kích hoạt Sự kiện ứng dụng (App event) dựa trên sự kiện giao dịch của CRM, với một Điều kiện (Condition) để chỉ các giao dịch thắng mới được tiếp tục. HubSpot chỉ gửi các sự kiện giai đoạn giao dịch tới các ứng dụng dành cho nhà phát triển, vì vậy đối với HubSpot, hãy sử dụng trình kích hoạt Lịch trình (Schedule) với tính năng tìm kiếm giao dịch của HubSpot cho các giao dịch đã đạt trạng thái Closed Won kể từ lần chạy cuối cùng, và sử dụng Vòng lặp (Loop) để xử lý chúng.
2. Thêm Gửi chuyển đổi tới Meta (Send conversion to Meta). Đặt Tên sự kiện (Event name) là Mua hàng (Purchase), Giá trị (Value) là số tiền giao dịch (chèn bằng nút +) và Tiền tệ (Currency) là loại tiền tệ của bạn. Nhập email của người mua vào mục Email và ID giao dịch vào mục ID sự kiện (Event ID) để đảm bảo cùng một giao dịch không bao giờ bị tính hai lần.
3. Đối với cuộc tư vấn đã đặt lịch, hãy bắt đầu một quy trình tự động thứ hai với trình kích hoạt Cuộc hẹn đã đặt (Appointment booked) và thêm Gửi chuyển đổi tới Meta với Tên sự kiện được đặt là Lịch trình (Schedule) và thông tin liên hệ từ trình kích hoạt trong mục Liên hệ (Contact). Nếu muốn, bạn có thể thêm bước Gửi chuyển đổi tới Meta thứ hai để gửi sự kiện Mua hàng với một giá trị cố định, chẳng hạn như giá của cuộc tư vấn.

Bạn cũng có thể gửi chuyển đổi qua API với POST https://api.youraiconnector.com/v1/ad-attribution/meta-event. Nó sử dụng các trường tương tự ở định dạng snake case: event_name, value, currency, contact_id, email, phone, first_name, last_name, external_id, event_id, event_time, event_source_url và test_event_code.

Câu hỏi thường gặp #

Việc này có hoạt động nếu quảng cáo của tôi mở trực tiếp WhatsApp không? Các quảng cáo đó không đi qua trang web của bạn, vì vậy tập lệnh không bao giờ chạy. Thay vào đó, Meta gửi chi tiết quảng cáo cùng với tin nhắn đầu tiên, xem Phân bổ quảng cáo Click-to-WhatsApp.

Tập lệnh có làm chậm trang web của tôi hoặc đặt cookie không? Nó tải trong nền (async), không đặt cookie và không tải thêm bất cứ thứ gì khác. Nó chỉ gửi dữ liệu khi khách truy cập nhấn vào nút WhatsApp.

Tôi có thể theo dõi Google Ads cũng như Meta ads không? Có. Các ID lượt nhấp Google (gclid, gbraid, wbraid) và bất kỳ thẻ chiến dịch nào đều được ghi lại và hiển thị trên liên hệ. Việc gửi kết quả lại chỉ khả dụng cho Meta.

Tại sao một liên hệ không có kết quả khớp? Các lý do phổ biến nhất: tin nhắn đến sau hơn 15 phút kể từ khi nhấn, số yêu cầu đã bị xóa khỏi tin nhắn, số yêu cầu bị tắt và một khách truy cập khác đã gửi cùng một văn bản, hoặc trang web không có tập lệnh.

Trang web của tôi liên kết đến hai số WhatsApp. Tôi có thể chỉ theo dõi một số không? Có. Nhập số đó vào mục Số WhatsApp trong phần cài đặt. Để trống nếu muốn theo dõi mọi liên kết WhatsApp.

Tôi có thể thay đổi cách diễn đạt sau này không? Có. Các thay đổi sẽ được áp dụng ngay lập tức cho trang web của bạn; bạn không cần phải dán lại tập lệnh.