Dữ liệu sự kiện phổ biến
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Sau đây là những dữ liệu sự kiện phổ biến trong các loại sự kiện khác nhau. Bạn có thể truy xuất các giá trị này bằng cách sử dụng biến Dữ liệu sự kiện hoặc getEventData
API.
Thông số |
Loại |
Ví dụ: |
Mô tả |
client_id |
string |
ABC_123 |
Mã tùy ý xác định ẩn danh một người dùng, thiết bị hoặc bản sao trình duyệt cụ thể. |
currency |
string |
USD |
Đơn vị tiền tệ của giao dịch mua hàng hoặc mặt hàng có liên quan đến sự kiện, ở định dạng ISO_4217 gồm 3 chữ cái. |
event_name |
string |
purchase |
Tên của sự kiện. |
ghi đè ip |
string |
1.2.3.4 |
Địa chỉ IP của người dùng ở định dạng IPv4 hoặc IPv6. |
language |
string |
en_us |
Ngôn ngữ dành cho ứng dụng khách theo ISO 639-1. |
mã hóa trang |
string |
UTF-8 |
Mã hoá văn bản của trang. |
page_hostname |
string |
example.com |
Phần tên máy chủ của page_location. |
page_location |
string |
https://example.com |
URL tài liệu đầy đủ của trang. |
page_path |
string |
/path/to/page |
Phần đường dẫn của page_location. |
page_referrer |
string |
https://www.google.com |
URL đầy đủ của trang đã giới thiệu người dùng đến trang đã diễn ra sự kiện. Đây không phải là giá trị của tiêu đề Người giới thiệu theo yêu cầu đưa vào vùng chứa của máy chủ. |
page_title |
string |
Trang chủ |
Tiêu đề của trang. |
screen_resolution |
string |
1024x768 |
Tổng độ phân giải màn hình cho thiết bị của người dùng. (chiều rộng x chiều cao). |
tác_dụng_người_dùng |
string |
|
Tác nhân người dùng của ứng dụng. |
user_data.email_address |
string |
foo@example.com |
Địa chỉ email của người dùng. |
user_data.sha256_email_address |
string |
|
Địa chỉ email đã băm của người dùng. Tìm hiểu thêm |
user_data.phone_number |
string |
+15551234567 |
Số điện thoại của người dùng. |
user_data.sha256_phone_number |
string |
|
Số điện thoại đã băm của người dùng. Tìm hiểu thêm |
user_data.address.first_name (tên người dùng |
string |
Jane |
Tên của người dùng. |
user_data.address.sha256_tên_tên |
string |
|
Đã băm tên của người dùng. Tìm hiểu thêm |
user_data.address.last_name |
string |
A |
Họ của người dùng. |
user_data.address.sha256_last_name |
string |
|
Đã băm họ của người dùng. Tìm hiểu thêm |
user_data.address.street |
string |
123 Fake St |
Đường phố và số cho địa chỉ của người dùng. |
user_data.address.city |
string |
Thành phố |
Thành phố cho địa chỉ của người dùng. |
user_data.address.region |
string |
CA |
Tiểu bang hoặc lãnh thổ cho địa chỉ của người dùng. |
user_data.address.postal_code |
string |
54321 |
Mã bưu điện cho địa chỉ của người dùng. |
user_data.address.country |
string |
US |
Mã quốc gia cho địa chỉ của người dùng. |
user_id |
string |
|
Mã tùy ý dự định là một giá trị nhận dạng xác định cho một người dùng do chủ sở hữu trang web/người dùng thư viện cung cấp. |
value |
number |
10 |
Giá trị bằng tiền của sự kiện đã xảy ra. |
kích thước khung nhìn |
string |
725x345 |
Kích thước của cửa sổ nội dung. Thường nhỏ hơn độ phân giải màn hình. (chiều rộng x chiều cao). |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-02-06 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-02-06 UTC."],[[["\u003cp\u003eThis page outlines common event data parameters available across various event types in Google Tag Manager.\u003c/p\u003e\n"],["\u003cp\u003eThese parameters provide information about users, their devices, page details, and event specifics, like currency and value.\u003c/p\u003e\n"],["\u003cp\u003eYou can access event data using the \u003ccode\u003eEvent Data\u003c/code\u003e variable or the \u003ccode\u003egetEventData\u003c/code\u003e API.\u003c/p\u003e\n"],["\u003cp\u003eEvent data can include sensitive information like personally identifiable information (PII) such as email, address, and phone number.\u003c/p\u003e\n"],["\u003cp\u003eFor security and privacy, hashed versions of PII are available, using SHA256 for encryption, in line with Google's data policies.\u003c/p\u003e\n"]]],["Event data, retrievable via the `Event Data` variable or `getEventData` API, includes user, device, and event details. Key parameters are `client_id` (user identifier), `currency`, and `event_name`. Page information like `page_location`, `page_title`, and `page_referrer` is available. User data includes `email_address`, `phone_number`, and address details, with options for hashed versions. Device details include `screen_resolution` and `viewport_size`. Additional fields are `user_agent`, `user_id`, and `value`.\n"],null,["# Common event data\n\nThe following are event data common across different types of events. These\nvalues can be retrieved using the **Event Data** variable or the\n[`getEventData`](/tag-platform/tag-manager/server-side/api#get_event_data) API.\n\n| Parameter | Type | Example | Description |\n|-------------------------------------|----------|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| client_id | `string` | ABC_123 | Arbitrary ID that anonymously identifies a particular user, device, or browser instance. |\n| currency | `string` | USD | Currency of the purchase or items associated with the event, in 3-letter ISO_4217 format. |\n| event_name | `string` | purchase | The name of the event. |\n| ip_override | `string` | 1.2.3.4 | The IP address of the user in IPv4 or IPv6 format. |\n| language | `string` | en_us | The language for the client in ISO 639-1. |\n| page_encoding | `string` | UTF-8 | The text encoding of the page. |\n| page_hostname | `string` | example.com | The hostname portion of page_location. |\n| page_location | `string` | https://example.com | The full document URL of the page. |\n| page_path | `string` | /path/to/page | The path portion of page_location. |\n| page_referrer | `string` | https://www.google.com | Full URL of the page that referred to the user to the page where the event occurred. This is not the value of the Referrer header on the request coming into the server container. |\n| page_title | `string` | Home | The title of the page. |\n| screen_resolution | `string` | 1024x768 | Total screen resolution for the user's device. (width by height). |\n| user_agent | `string` | | The client's user agent. |\n| user_data.email_address | `string` | foo@example.com | Email address of the user. |\n| user_data.sha256_email_address | `string` | | Hashed email address of the user. [Learn more](https://support.google.com/google-ads/answer/12785474?sjid=4543074023400780070-NA) |\n| user_data.phone_number | `string` | +15551234567 | Phone number of the user. |\n| user_data.sha256_phone_number | `string` | | Hashed phone number of the user. [Learn more](https://support.google.com/google-ads/answer/12785474?sjid=4543074023400780070-NA) |\n| user_data.address.first_name | `string` | Jane | First name of the user. |\n| user_data.address.sha256_first_name | `string` | | Hashed first name of the user. [Learn more](https://support.google.com/google-ads/answer/12785474?sjid=4543074023400780070-NA) |\n| user_data.address.last_name | `string` | Doe | Last name of the user. |\n| user_data.address.sha256_last_name | `string` | | Hashed last name of the user. [Learn more](https://support.google.com/google-ads/answer/12785474?sjid=4543074023400780070-NA) |\n| user_data.address.street | `string` | 123 Fake St | Street and number for the address of the user. |\n| user_data.address.city | `string` | City Town | City for the address of the user. |\n| user_data.address.region | `string` | CA | State or territory for the address of the user. |\n| user_data.address.postal_code | `string` | 54321 | Postal code for the address of the user. |\n| user_data.address.country | `string` | US | Country code for the address of the user. |\n| user_id | `string` | | Arbitrary ID that is intended to be a known identifier for a user provided by the site owner/library user. |\n| value | `number` | 10 | Monetary value of the event that occurred. |\n| viewport_size | `string` | 725x345 | Size of the content window. Usually smaller than the screen resolution. (width by height). |"]]