Thông số sự kiện từ máy chủ

Bắt buộc.
Tên sự kiện tiêu chuẩn hoặc sự kiện tùy chỉnh. Trường này được dùng để loại bỏ các sự kiện trùng lặp nhận được từ cả web (qua Meta Pixel) hoặc ứng dụng (qua SDK hoặc API Sự kiện trong ứng dụng) lẫn API Chuyển đổi. Thông số event_id cũng được dùng để loại bỏ trùng lặp.

Đối với cùng một hành động của khách hàng, event của sự kiện từ trình duyệt hoặc sự kiện trong ứng dụng khớp với event_name của sự kiện trên máy chủ. Nếu nhận thấy các sự kiện được gửi trong vòng 48 giờ trùng khớp nhau, chúng tôi sẽ chỉ xem xét sự kiện đầu tiên. Nếu sự kiện trên máy chủ và trình duyệt/ứng dụng đến gần như cùng lúc (cách nhau trong vòng 5 phút), chúng tôi sẽ ưu tiên sự kiện từ trình duyệt/ứng dụng. Hãy tìm hiểu thêm về vấn đề Loại bỏ sự kiện trên máy chủ và sự kiện pixel trùng lặp.

Bắt buộc.
Bản đồ chứa dữ liệu thông tin của khách hàng. Hãy xem phần Thông số thông tin khách hàng để biết các tùy chọn. Hãy xem phần So khớp nâng cao để biết các tùy chọn tương đương dành cho dữ liệu được gửi qua Meta Pixel.

Không bắt buộc.
URL trình duyệt nơi sự kiện đã diễn ra. URL phải bắt đầu bằng http:// hoặc https://, đồng thời phải khớp với miền đã xác minh.

Lưu ý: Sự kiện trên trang web được chia sẻ bằng API Chuyển đổi cần phải có event_source_url.

Không bắt buộc.
ID này có thể là một chuỗi duy nhất bất kỳ do nhà quảng cáo chọn. Các thông số event_id và event_name được dùng để loại bỏ sự kiện trùng lặp nhận được từ cả web (qua Meta Pixel) hoặc ứng dụng (qua SDK hoặc API Sự kiện trong ứng dụng) lẫn API Chuyển đổi. Lưu ý rằng mặc dù event_id được đánh dấu là không bắt buộc nhưng bạn nên dùng thông số này để loại bỏ sự kiện trùng lặp.

Để loại bỏ sự kiện trùng lặp, eventID của sự kiện từ trình duyệt/ứng dụng phải khớp với event_id của sự kiện tương ứng trên máy chủ. Hãy tìm hiểu thêm về cách Xử lý vấn đề loại bỏ sự kiện trùng lặp từ Pixel và API Chuyển đổi.

Số đơn đặt hàng hoặc ID giao dịch là 2 thông tin nhận dạng mà bạn có thể dùng cho event_id. Ví dụ: nếu khách hàng thực hiện 2 giao dịch mua trên trang web của bạn với số đơn đặt hàng là 123 và 456, mỗi lệnh gọi API Chuyển đổi sẽ cần thêm số đơn đặt hàng tương ứng cho event_id. Nhờ vậy, chúng tôi sẽ phân biệt được chính xác 2 giao dịch mua này là các đơn đặt hàng khác nhau. 2 sự kiện mua hàng tương ứng từ trình duyệt (qua Pixel) cũng cần gửi chính số đơn đặt hàng đó trong thông số eventID để chúng tôi hiểu rằng chỉ có 2 sự kiện đã diễn ra, chứ không phải 4 giao dịch mua khác nhau.

Đối với những sự kiện khác không có số ID nội tại, bạn có thể dùng một số ngẫu nhiên (miễn là giống với số ngẫu nhiên được gửi giữa sự kiện trên trình duyệt và sự kiện trên máy chủ).

Không bắt buộc.
Tùy chọn xử lý mà bạn muốn bật cho sự kiện cụ thể. Giá trị hiện được chấp nhận là LDU cho chế độ Giới hạn sử dụng dữ liệu. Bạn có thể gửi một mảng trống để chỉ định rõ rằng sự kiện này không cần phải xử lý với chế độ Giới hạn sử dụng dữ liệu. Tìm hiểu thêm về tùy chọn Xử lý dữ liệu. Hãy xem ví dụ về cách triển khai API Chuyển đổi.

Bắt buộc trong một số trường hợp. (Hãy xem phần lưu ý bên dưới để biết chi tiết.)
Tiểu bang mà bạn muốn liên kết với tùy chọn xử lý dữ liệu này. Các giá trị hiện được chấp nhận là 1000 hoặc 0 đối với California để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó.

Lưu ý:

• Nếu đặt quốc gia, bạn cũng phải đặt tiểu bang. Nếu không, chúng tôi sẽ áp dụng logic vị trí địa lý của mình cho toàn bộ sự kiện đó.
• Bạn cần phải điền vào trường này nếu gửi LDU theo data_processing_options và không cung cấp địa chỉ IP.

Tìm hiểu thêm về các tùy chọn Xử lý dữ liệu. Hãy xem ví dụ về cách triển khai API Chuyển đổi.