Sử dụng các mối liên kết trong bảng để liên kết một yêu cầu thu thập dữ liệu Measurement Protocol (/mp/collect) với yêu cầu tương đương IngestEventsRequest trong Data Manager API.
Trường yêu cầu
Yêu cầu /mp/collect (Measurement Protocol) |
IngestEventsRequest (Data Manager API) |
Ghi chú |
|---|---|---|
measurement_id (Tham số truy vấn) |
destinations |
Ánh xạ đến product_destination_id cho sự kiện trên web. Hãy xem Các trường đích để biết thông tin chi tiết. |
firebase_app_id (Tham số truy vấn) |
destinations |
Ánh xạ đến product_destination_id cho sự kiện ứng dụng. Hãy xem Các trường đích để biết thông tin chi tiết. |
api_secret (Tham số truy vấn) |
Không có phiên bản mới | Hãy xem phần Thiết lập quyền truy cập API để tìm hiểu cách xác thực các yêu cầu trong Data Manager API |
consent |
consent |
Đặt thành một đối tượng Consent. |
events |
events |
Đặt thành danh sách các tài nguyên Event. Hãy xem mục Trường sự kiện để biết thông tin chi tiết. |
client_id |
events.client_id |
Bắt buộc đối với sự kiện trên web. |
app_instance_id |
events.app_instance_id |
Bắt buộc đối với sự kiện trong ứng dụng. |
user_id |
events.user_id |
Không bắt buộc. Giá trị nhận dạng riêng biệt cho một người dùng. |
timestamp_micros |
events.event_timestamp |
Trong Measurement Protocol, bạn có thể cung cấp thông tin này ở cấp yêu cầu hoặc cho một sự kiện riêng lẻ. Trong Data Manager API, không có dấu thời gian ở cấp yêu cầu. Đặt event_timestamp cho mỗi sự kiện thành thời gian sự kiện xảy ra.
Hãy xem phần Định dạng dấu thời gian để biết thông tin chi tiết. |
user_properties |
events.user_properties |
Đặt thành một đối tượng UserProperties. Data Manager API không hỗ trợ đặt dấu thời gian cho từng thuộc tính người dùng. Dấu thời gian liên quan đến các thay đổi đối với thuộc tính người dùng được suy luận từ dấu thời gian của sự kiện (event_timestamp). |
user_data |
events.user_data |
Đặt thành một đối tượng UserData. Hãy xem phần Trường giá trị nhận dạng người dùng để biết thông tin chi tiết. |
non_personalized_ads |
events.consent.ad_personalization |
Nếu non_personalized_ads là true, hãy đặt ad_personalization thành DENIED. |
user_location |
events.event_location |
Hãy xem phần Các trường vị trí của người dùng để biết thông tin chi tiết. |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
Hãy xem phần Các trường thiết bị để biết thông tin chi tiết. |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
Không có phiên bản mới | Sử dụng Chẩn đoán để truy xuất trạng thái của tệp tải lên cũng như các lỗi và cảnh báo cho từng sự kiện trong quá trình xử lý tiếp theo. Nếu IngestEventsRequest thất bại (ví dụ: do thiếu các trường bắt buộc), thì không có sự kiện nào được xử lý và bạn sẽ cần giải quyết lỗi rồi thử lại yêu cầu. Hãy xem bài viết Tìm hiểu về lỗi API để biết thêm thông tin. |
/debug/mp/collect |
validate_only |
Đặt validate_only thành true để xác thực các sự kiện mà không cần nhập bất kỳ dữ liệu nào, tương tự như máy chủ xác thực Measurement Protocol. |
| Không có phiên bản mới | encoding |
Bắt buộc đối với tệp tải lên UserData. Đặt thành Encoding dùng cho các giá trị UserIdentifier. |
Trường đích đến
Measurement Protocol gửi trực tiếp các sự kiện đến một luồng dữ liệu cụ thể bằng cách sử dụng tham số truy vấn measurement_id hoặc firebase_app_id.
Data Manager API sử dụng một đối tượng Destination để chỉ định nơi gửi dữ liệu.
Hãy xem phần Định cấu hình đích đến để biết thêm thông tin về đích đến.
Sau đây là cách liên kết các trường Measurement Protocol với các trường tương đương trong Destination:
| Measurement Protocol | Destination (Data Manager API) |
Ghi chú |
|---|---|---|
measurement_id (Tham số truy vấn) |
product_destination_id |
Đặt thành mã đo lường của luồng dữ liệu web Google Analytics |
firebase_app_id (Tham số truy vấn) |
product_destination_id |
Đặt thành Mã ứng dụng Firebase của luồng dữ liệu ứng dụng Google Analytics |
| Không có phiên bản mới | operating_account |
Đặt account_id thành mã nhận dạng tài sản Google Analytics. Đặt account_type thành GOOGLE_ANALYTICS_PROPERTY. |
| Không có phiên bản mới | login_account |
Đặt account_id thành mã nhận dạng tài sản Google Analytics. Đặt account_type thành GOOGLE_ANALYTICS_PROPERTY. |
Trường sự kiện
Measurement Protocol events[] |
Event (Data Manager API) |
Ghi chú |
|---|---|---|
name |
event_name |
Nếu event_name sử dụng tên dành riêng, thì API sẽ từ chối sự kiện này và trả về lỗi INVALID_EVENT_NAME. |
| Không có phiên bản mới | event_source |
Đặt thành WEB nếu sự kiện được tạo từ một trình duyệt web và APP nếu sự kiện được tạo từ một ứng dụng. |
| Không có phiên bản mới | destination_references |
Bắt buộc nếu danh sách destinations ở cấp yêu cầu chứa nhiều Destination Google Analytics. Thêm một mục để chỉ định đích đến nào sẽ nhận được sự kiện. |
timestamp_micros |
event_timestamp |
Hãy xem phần Định dạng dấu thời gian để biết thông tin chi tiết. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
Trong Measurement Protocol, thông số customer_type được đặt làm thông số sự kiện. Trong Data Manager API, hãy đặt tham số này trong trường customer_type trong đối tượng UserProperties trên sự kiện. |
params.transaction_id |
transaction_id |
Bắt buộc đối với một số sự kiện và trường hợp sử dụng. Hãy xem phần Chuyển đổi dữ liệu thành các đối tượng Event để biết thêm thông tin chi tiết. |
params.items |
cart_data.items |
Hãy xem bài viết Các trường mặt hàng cho dữ liệu giỏ hàng để biết thông tin chi tiết. |
params.coupon |
cart_data.coupon_codes |
Sử dụng trường coupon_codes để cung cấp các phiếu giảm giá đã được áp dụng cho giỏ hàng. Chỉ cung cấp một phiếu giảm giá cho Google Analytics. Điều này độc lập với phiếu giảm giá ở cấp Item. Bạn có thể đặt phiếu giảm giá ở cấp này bằng cách sử dụng cart_data.items.additional_item_parameters cho từng mặt hàng. |
params.session_id |
additional_event_parameters |
Ánh xạ đến một mục có parameter_name được đặt thành session_id. |
params.engagement_time_msec |
additional_event_parameters |
Ánh xạ đến một mục có parameter_name được đặt thành engagement_time_msec. |
params khác |
additional_event_parameters |
Liên kết các thông số khác dưới dạng danh sách các đối tượng có |
Trường giá trị nhận dạng người dùng
Measurement Protocol user_data |
UserIdentifier (Data Manager API) |
Ghi chú |
|---|---|---|
sha256_email_address[] |
email_address |
Đặt thành địa chỉ email đã định dạng và băm. Bạn cũng có thể mã hoá địa chỉ email đã băm. |
sha256_phone_number[] |
phone_number |
Đặt thành số điện thoại đã định dạng và băm. Bạn cũng có thể mã hoá số điện thoại đã băm. |
address[] |
address |
Đặt thành một đối tượng AddressInfo. Tuân thủ nguyên tắc định dạng và băm. |
address[].sha256_first_name |
address.given_name |
Đặt thành tên đã định dạng và băm. Bạn cũng có thể mã hoá tên được băm. |
address[].sha256_last_name |
address.family_name |
Đặt thành tên gia đình đã định dạng và băm. Bạn cũng có thể mã hoá tên gia đình đã băm. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
Không có phiên bản mới | Không được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
address[].region |
Không có phiên bản mới | Không được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
address[].sha256_street |
Không có phiên bản mới | Không được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
Các trường mặt hàng cho dữ liệu giỏ hàng
Measurement Protocol items[] |
Item (Data Manager API) |
Ghi chú |
|---|---|---|
item_id |
item_id |
Bắt buộc. |
item_name |
additional_item_parameters |
Ánh xạ đến một mục có parameter_name được đặt thành item_name. |
quantity |
quantity |
Bắt buộc. |
price |
unit_price |
Bắt buộc. |
| Các trường khác của mặt hàng | additional_item_parameters |
Ánh xạ các thông số mặt hàng khác (chẳng hạn như |
Trường vị trí của người dùng
Measurement Protocol user_location |
EventLocation (Data Manager API) |
Ghi chú |
|---|---|---|
city |
city |
Tên thành phố nơi diễn ra sự kiện. |
country_id |
region_code |
Đặt thành mã vùng CLDR gồm 2 chữ cái. |
region_id |
subdivision_code |
Đặt thành mã phân vùng ISO 3166-2. |
continent_id |
continent_code |
Đặt thành mã lục địa ở định dạng UN M49. |
subcontinent_id |
subcontinent_code |
Đặt thành mã tiểu lục địa ở định dạng UN M49. |
Trường thiết bị
Measurement Protocol device |
DeviceInfo (Data Manager API) |
Ghi chú |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height và screen_width |
Trong Measurement Protocol, screen_resolution được cung cấp dưới dạng một chuỗi ("1280x720"). Trong Data Manager API, hãy gửi screen_height và screen_width dưới dạng các giá trị số nguyên riêng biệt. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |