Thông số dữ liệu sự kiện gốc

Hãy sử dụng các thông số dưới đây để chia sẻ thông tin sự kiện gốc mà bạn muốn liên kết với API Chuyển đổi.

Thông sốMô tả
event_name
string

Không bắt buộc.
Tên sự kiện tiêu chuẩn hoặc sự kiện tùy chỉnh.

event_time
integer

Không bắt buộc.
Nhãn thời gian Unix tính bằng giây cho biết thời điểm sự kiện thực tế diễn ra. Thời gian đã chỉ định có thể sớm hơn thời gian bạn gửi sự kiện đến Facebook. Bạn phải gửi ngày này theo múi giờ GMT.

order_id
string

Không bắt buộc.
ID đơn đặt hàng dạng chuỗi cho giao dịch này.

event_id
string

Không bắt buộc.
ID này có thể là bất kỳ chuỗi duy nhất nào do nhà quảng cáo chọn. Các thông số event_idevent_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ủ).