API chuyển đổi

1. Vì sao cần phía máy chủ?

Pixel trình duyệt phải vượt qua ba điều trước khi báo cáo chuyển đổi: trình chặn quảng cáo, cài đặt chống theo dõi và việc khách đóng thẻ trước khi pixel được kích hoạt. Lệnh gọi phía máy chủ vượt qua cả ba vì hoàn toàn không diễn ra trong trình duyệt.

MousePlayer đã biết khi một mục tiêu được đạt - đó là mục đích của mục tiêu. API chuyển đổi chỉ chuyển tiếp sự kiện đó đến mạng quảng cáo từ máy chủ của chúng tôi.

2. Dữ liệu chúng tôi gửi - và không bao giờ gửi

Thứ duy nhất nhận diện khách trong các lệnh gọi này là cookie hoặc mã định danh lượt nhấp do chính mạng quảng cáo đặt. Không có thông tin nào khác về người đó rời máy chủ của chúng tôi.

Mạng	Mã định danh được dùng	Nguồn
Meta	_fbp, _fbc	Cookie bên thứ nhất do pixel Meta đặt
LinkedIn	li_fat_id	Cookie bên thứ nhất do LinkedIn Insight Tag đặt
TikTok	_ttp, ttclid	_ttp là cookie, ttclid đến từ URL lượt nhấp quảng cáo
Google Ads	gclid, wbraid, gbraid	Từ URL lượt nhấp quảng cáo hoặc cookie _gcl_aw sau đó
Microsoft Advertising	msclkid	Từ URL lượt nhấp quảng cáo hoặc cookie _uetmsclkid do thẻ UET ghi

Chỉ khi có sự đồng ý

Mọi lệnh gọi này đều qua cùng cổng đồng ý như chính việc ghi. Phiên không có sự đồng ý không tạo báo cáo chuyển đổi, bất kể công tắc trong cài đặt dự án.

3. Google Ads có ba mã định danh, không phải một

Điều này khiến nhiều người ngạc nhiên nên cần nói rõ. Google dùng gclid cho một lượt nhấp quảng cáo. Khi cơ chế chống theo dõi của Apple khiến không thể phân bổ một lượt nhấp, Google gửi wbraid hoặc gbraid thay thế, đại diện cho một nhóm lượt nhấp.

Ba mã loại trừ nhau - Google từ chối chuyển đổi chứa hai mã. Chúng tôi gửi đúng một mã và gclid được ưu tiên khi có nhiều mã vì chính xác nhất.

Chúng chỉ xuất hiện trong URL một lần

Mã định danh chỉ xuất hiện trong địa chỉ trên trang đầu tiên sau lượt nhấp quảng cáo. Sau đó thẻ Google lưu mã trong cookie _gcl_aw. Chúng tôi đọc cookie làm dự phòng - nếu không, chuyển đổi trên trang thứ ba của lượt truy cập sẽ không tìm thấy mã định danh nào.

4. Thiết lập

Meta, LinkedIn và TikTok

Mỗi mạng có hai trường: ID pixel hoặc quy tắc chuyển đổi và token truy cập bạn tạo trong giao diện của chính mạng đó. Cả hai được lưu có mã hóa AES-256-GCM và không bao giờ hiển thị lại sau khi lưu.

Google Ads cần sáu trường

Google là ngoại lệ và nên biết lý do trước khi bắt đầu: khác với ba mạng kia, Google không cấp token truy cập đơn giản. Việc truy cập dùng OAuth với token làm mới và Ads API còn yêu cầu token nhà phát triển.

Trường	Nơi tìm
ID khách hàng	Góc trên bên phải Google Ads. Chỉ chữ số, không có dấu gạch ngang.
ID hành động chuyển đổi	Mục tiêu và chuyển đổi, rồi hành động bạn muốn ghi nhận chuyển đổi vào.
Token nhà phát triển	Tài khoản người quản lý Google Ads, Trung tâm API.
ID và khóa bí mật máy khách OAuth	Google Cloud Console, Thông tin xác thực, máy khách OAuth loại “ứng dụng máy tính”.
Token làm mới	Bạn tự tạo một lần cho phạm vi adwords.

LinkedIn có hai cách và bạn cần cách ngắn

Trong Campaign Manager: Dữ liệu, Trình quản lý tín hiệu, API trực tiếp, Tạo token truy cập. Đó là cách dành cho nhà quảng cáo gửi dữ liệu của chính mình - không cần ứng dụng nhà phát triển hay xét duyệt. Token không hết hạn và Campaign Manager không hiển thị lần thứ hai nên hãy sao chép ngay.

Cách kia, ứng dụng nhà phát triển yêu cầu qua Developer Portal của LinkedIn, dành cho nền tảng gửi thay nhiều nhà quảng cáo. Cần xác minh trang công ty và trường hợp sử dụng được phê duyệt; ở đây bạn không cần những việc đó.

Microsoft Advertising là cách dễ

Sau Google Ads, bạn có thể nghĩ sẽ phức tạp tương tự - OAuth, token nhà phát triển, bước phê duyệt. Thực tế ngược lại: hai trường. ID thẻ UET bạn đã dùng trong trình duyệt và token sao chép từ Microsoft Advertising tại thẻ UET, “Sử dụng Conversions API”, “Sao chép token”. Không cần đăng ký xét duyệt.

Dùng ID thẻ giống thẻ trong trình duyệt của bạn. Đó là cách Microsoft nhận ra sự kiện phía máy chủ và sự kiện trình duyệt là một chuyển đổi thay vì hai.

5. Khi chuyển đổi được báo cáo

Đúng một lần cho mỗi mục tiêu và phiên. MousePlayer loại trùng trước khi gửi lệnh gọi và payload còn chứa ID để mạng có thể loại trùng lần nữa phía họ. Khách thêm năm món vào giỏ tạo một chuyển đổi, không phải năm.

Điều bạn sẽ thấy trong tài khoản quảng cáo

Chuyển đổi chứa tên mục tiêu, giá trị và loại tiền tệ nếu bạn đã đặt, cùng thời điểm xảy ra. Trong hoạt động bình thường, chuyển đổi được gửi đến trong một phút.

Nếu không nhận được

• Không có mã định danh lượt nhấp. Khách không đến qua quảng cáo của mạng đó hoặc đến trước khi pixel đặt cookie. Không gửi gì - đây là điều được dự kiến, không phải lỗi.
• Không có sự đồng ý. Cổng đồng ý được áp dụng trước.
• Mạng chấp nhận lệnh gọi nhưng từ chối chuyển đổi. Google, TikTok và một số mạng khác trả HTTP 200 nhưng có lỗi trong nội dung phản hồi. Chúng tôi đọc nội dung, không chỉ trạng thái và lý do xuất hiện trong nhật ký gửi nhận.