일반 이벤트 데이터
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
다음은 여러 이벤트 유형에서 일반적인 이벤트 데이터입니다. 이 값은 이벤트 데이터 변수 또는 getEventData
API를 사용하여 가져올 수 있습니다.
매개변수 |
유형 |
예 |
설명 |
client_id |
string |
ABC_123 |
특정 사용자, 기기 또는 브라우저 인스턴스를 익명으로 나타내는 임의의 ID입니다. |
currency |
string |
USD |
이벤트와 연결된 구매 또는 상품의 통화(3자리 ISO_4217 형식)입니다. |
event_name |
string |
purchase |
이벤트의 이름입니다. |
ip_override |
string |
1.2.3.4 |
사용자의 IP 주소(IPv4 또는 IPv6 형식)입니다. |
language |
string |
en_us |
클라이언트의 언어(ISO 639-1 형식)입니다. |
page_encoding |
string |
UTF-8 |
페이지의 텍스트 인코딩입니다. |
page_hostname |
string |
example.com |
page_location의 호스트 이름 부분입니다. |
page_location |
string |
https://example.com |
페이지의 전체 문서 URL입니다. |
page_path |
string |
/path/to/page |
page_location의 경로 부분입니다. |
page_referrer |
string |
https://www.google.com |
이벤트가 발생한 페이지로 사용자를 연결한 페이지의 전체 URL입니다. 서버 컨테이너에 수신되는 요청의 리퍼러 헤더 값이 아닙니다. |
page_title |
string |
홈 |
페이지 제목입니다. |
screen_resolution |
string |
1024x768 |
사용자 기기의 전체 화면 해상도입니다. (너비x높이) |
user_agent |
string |
|
클라이언트의 사용자 에이전트입니다. |
user_data.email_address |
string |
foo@example.com |
사용자의 이메일 주소입니다. |
user_data.sha256_email_address |
string |
|
사용자의 해싱된 이메일 주소입니다. 자세히 알아보기 |
user_data.phone_number |
string |
+15551234567 |
사용자의 전화번호입니다. |
user_data.sha256_phone_number |
string |
|
사용자의 해싱된 전화번호입니다. 자세히 알아보기 |
user_data.address.first_name |
string |
Jane |
사용자의 이름입니다. |
user_data.address.sha256_first_name |
string |
|
사용자의 해싱된 이름입니다. 자세히 알아보기 |
user_data.address.last_name |
string |
Doe |
사용자의 성입니다. |
user_data.address.sha256_last_name |
string |
|
사용자의 해싱된 성입니다. 자세히 알아보기 |
user_data.address.street |
string |
123 Fake St |
사용자 주소의 도로 및 번지입니다. |
user_data.address.city |
string |
도시 |
사용자 주소의 도시입니다. |
user_data.address.region |
string |
CA |
사용자 주소의 주 또는 지역입니다. |
user_data.address.postal_code |
string |
54321 |
사용자 주소의 우편번호입니다. |
user_data.address.country |
string |
US |
사용자 주소의 국가 코드입니다. |
user_id |
string |
|
사이트 소유자/라이브러리 사용자가 제공한, 사용자의 식별자로 사용되는 임의의 ID입니다. |
value |
number |
10 |
발생한 이벤트의 금전적 가치입니다. |
viewport_size |
string |
725x345 |
콘텐츠 창의 크기입니다. 일반적으로 화면 해상도보다 작습니다. (너비x높이) |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-02-06(UTC)
[null,null,["최종 업데이트: 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). |"]]