event_name string | 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. |
event_time integer | 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. Nhờ thế, hệ thống có thể xử lý hàng loạt và tối ưu hóa hiệu quả của máy chủ. Bạn phải gửi ngày này theo múi giờ GMT.
event_time có thể sớm hơn thời điểm bạn gửi sự kiện đến Facebook tối đa 7 ngày. Nếu bất kỳ event_time nào trong data sớm hơn thời điểm bạn gửi quá 7 ngày, chúng tôi sẽ trả về lỗi đối với toàn bộ yêu cầu và không xử lý sự kiện nào.
|
user_data object | 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. |
custom_data object | Không bắt buộc. Bản đồ có thêm dữ liệu về sự kiện do doanh nghiệp cung cấp. Hãy xem phần Thông số dữ liệu tùy chỉnh để biết thêm thông tin. |
event_source_url string | Không bắt buộc. URL trình duyệt nơi sự kiện đã diễn ra. URL 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 . |
opt_out boolean | Không bắt buộc. Cờ cho biết chúng tôi không sử dụng sự kiện này để tối ưu hóa phân phối quảng cáo. Nếu bạn đặt là true , chúng tôi chỉ dùng sự kiện đó để phân bổ. |
event_id string | 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ủ). |
action_source string | Bắt buộc. Thông qua trường này, bạn có thể chỉ định nơi diễn ra chuyển đổi. Việc nắm được nơi sự kiện diễn ra sẽ góp phần đảm bảo quảng cáo của bạn hiển thị với đúng người. Bằng cách sử dụng API Chuyển đổi, bạn đồng ý rằng thông số action_source là chính xác theo hiểu biết của bạn.
Sau đây là các giá trị mà bạn có thể gửi trong trường action_source :
email - Chuyển đổi diễn ra qua email.
website - Chuyển đổi được thực hiện trên trang web của bạn.
app - Chuyển đổi được thực hiện trên ứng dụng di động của bạn.
phone_call - Chuyển đổi được thực hiện qua điện thoại.
chat - Chuyển đổi được thực hiện qua ứng dụng nhắn tin, SMS hoặc tính năng nhắn tin online.
physical_store - Chuyển đổi được thực hiện trực tiếp tại cửa hàng thực của bạn.
system_generated - Chuyển đổi tự động diễn ra. Ví dụ: việc gia hạn gói đăng ký được đặt là tự động thanh toán hàng tháng.
business_messaging - Chuyển đổi được thực hiện từ quảng cáo click đến Messenger, Instagram hoặc WhatsApp.
other - Chuyển đổi diễn ra theo cách chưa nêu ở trên.
Lưu ý: Tất cả giá trị nguồn hành động đều hỗ trợ các tính năng đo lường quảng cáo và tạo đối tượng tùy chỉnh. Ngoại trừ physical_store , tất cả nguồn hành động đều hỗ trợ các tính năng tối ưu hóa quảng cáo. |
data_processing_options array | 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. |
data_processing_options_country integer | Bắt buộc nếu bạn gửi LDU theo data_processing_options . Quốc gia 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à 1 hoặc 0 đối với Hoa Kỳ để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó. 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. |
data_processing_options_state integer | 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ề tùy chọn Xử lý dữ liệu. Hãy xem ví dụ về cách triển khai API Chuyển đổi. |
app_data
object | Bắt buộc đối với sự kiện trong ứng dụng Các thông số để chia sẻ dữ liệu ứng dụng và thông tin thiết bị với API Chuyển đổi. extinfo là thông số phụ của app_data .
|
extinfo
object | Bắt buộc đối với sự kiện trong ứng dụng Thông tin mở rộng về thiết bị, chẳng hạn như chiều rộng và chiều cao của màn hình. Thông số này là một mảng và các giá trị được phân tách bằng dấu phẩy. Khi sử dụng thông tin mở rộng, mọi giá trị đều là bắt buộc và phải theo thứ tự được lập chỉ mục ở bên dưới. Nếu thiếu một giá trị, hãy điền một chuỗi trống làm phần giữ chỗ.
Lưu ý:
version phải là a2 đối với Android
version phải là i2 đối với iOS
|
0
string | Bắt buộc phiên bản extinfo
Ví dụ: i2 |
1
string | tên gói ứng dụng
Ví dụ: com.facebook.sdk.samples.hellofacebook |
2
string | phiên bản ngắn (int hoặc string)
Ví dụ: 1.0 |
3
string | phiên bản dài
Ví dụ: 1.0 long |
4
string | Bắt buộc Phiên bản hệ điều hành
Ví dụ: 13.4.1 |
5
string | tên kiểu thiết bị
Ví dụ: iPhone5,1 |
6
string | ngôn ngữ
Ví dụ: En_US |
7
string | ký hiệu viết tắt múi giờ
Ví dụ: PDT |
8
string | nhà mạng
Ví dụ: AT&T |
9
int64 | chiều rộng màn hình
Ví dụ: 320 |
10
int64 | chiều cao màn hình
Ví dụ: 568 |
11
string | độ phân giải của màn hình
Ví dụ: 2 |
12
int64 | số nhân CPU
Ví dụ: 2 |
13
int64 | dung lượng bộ nhớ ngoài tính bằng GB
Ví dụ: 13 |
14
int64 | dung lượng trống trên bộ nhớ ngoài tính bằng GB
Ví dụ: 8 |
15
string | múi giờ của thiết bị
Ví dụ: USA/New York |
referrer_url string | Không bắt buộc. Tiêu đề giới thiệu HTTP mà trang kích hoạt API Chuyển đổi hoặc sự kiện Meta Pixel quan sát được. Đây thường là trang trước đó trong trình duyệt. |
original_event_data object | Không bắt buộc. Mọi trường siêu dữ liệu mà nhà quảng cáo có thể dùng để chỉ định cách liên kết một sự kiện "bị chậm trễ" với sự kiện chinh phục khách hàng trước đây. Bạn nên sử dụng original_event_data khi thời điểm gửi một sự kiện bị chậm trễ so với sự kiện chinh phục khách hàng trước đây mà sự kiện đó cần được liên kết. Hãy xem phần Thông số dữ liệu sự kiện ban đầu để biết thêm thông tin. |