전자상거래 이벤트 호환성 및 변환 참조(gtag.js)

이 문서에서는 유니버설 애널리틱스(UA)와 Google 애널리틱스 4(GA4) 간의 전자상거래 이벤트 호환성 및 변환을 설명합니다.

배경

GA4 전자상거래 이벤트는 UA 속성으로 전송할 때 동등한 UA 이벤트로 자동 변환됩니다. UA 전자상거래 이벤트를 GA4 속성으로 전송할 때도 변환이 발생합니다. 이 문서에서는 변환 작동 방식, 이벤트의 호환성, 자동 변환의 장단점을 설명합니다.

목적

UA와 GA4 전자상거래 이벤트 간의 변환은 다음과 같은 경우에 유용합니다.

구현이 용이함: 기존 UA 구현의 구성을 약간 업데이트하여 GA4 전자상거래를 도입할 수 있습니다.
이중 태그할 필요가 없음: 동일한 전자상거래 이벤트를 UA 및 GA4 속성으로 전송할 수 있습니다. 이를 통해 이중 태그 구성을 유지할 필요 없이 GA4로 변환하고 UA 전자상거래 구현을 유지할 수 있습니다.

절충사항

호환이 가능하면 UA 구현을 유지하기 위한 단기 및 장기 요구사항을 충족하는 데 가장 적합한 GA4 이전 경로를 유연하게 선택할 수 있습니다.

대부분의 GA4 전자상거래 이벤트/매개변수는 UA와 호환되며 그 반대의 경우도 마찬가지입니다. 일부 비호환성이 존재하는 경우 선택한 이전에 따라 UA 또는 GA4 전자상거래 보고서가 데이터로 완전히 채워지지 않을 수도 있습니다.

각 이전 옵션의 호환성 및 필수 구성에 관한 세부정보를 확인하는 것이 중요합니다.

변환 작동 방식

GA4 전자상거래 이벤트가 UA 속성으로 전송되면 이 이벤트는 동등한 UA(gtag.js) 전자상거래 이벤트로 변환됩니다.
- UA 이벤트 매개변수는 비슷한 GA4 매개변수의 값으로 채워집니다. GA4 이벤트에서 UA 매개변수를 채울 수 없는 경우(즉, 비슷한 매개변수가 없는 경우) 이벤트가 UA 속성으로 전송될 때 매개변수가 생략됩니다.
UA(gtag.js) 전자상거래 이벤트가 GA4 속성으로 전송되면 이벤트가 동등한 GA4 전자상거래 이벤트로 변환됩니다.
- GA4 이벤트 매개변수는 비슷한 UA 매개변수의 값으로 채워집니다. UA 이벤트에서 GA4 매개변수를 채울 수 없는 경우(즉, 상응하는 매개변수가 없는 경우) 이벤트가 GA4 속성으로 전송될 때 매개변수가 생략됩니다. UA 매개변수에 비슷한 GA4 매개변수가 없는 경우 해당 매개변수는 GA4 이벤트와 함께 맞춤 매개변수로 전송됩니다.
GA4에서 UA로 또는 그 반대로의 모든 변환은 클라이언트 측에서 수행됩니다.
이벤트/매개변수 변환은 기본적으로 사용 설정되며 사용자 구성이 필요하지 않으며 사용 중지할 수 없습니다.

UA와 GA4의 비슷한 매개변수

다음 표에는 유니버설 애널리틱스와 Google 애널리틱스 4에서 사용되는 비슷한 전자상거래 매개변수가 나와 있습니다.

유니버설 애널리틱스 매개변수 이름	Google 애널리틱스 4 매개변수 이름	참고
`affiliation`	`affiliation`
`checkout_step`
`checkout_option`
`content_type`
`coupon`	`coupon`
`currency`	`currency`	UA 이벤트를 GA4 속성으로 전송할 때 GA4 `items[].currency` 매개변수에 이 통화 값이 사용됩니다.
	`location_id`
	`payment_type`
`shipping`	`shipping`
`shipping_tier`
`tax`	`tax`
`transaction_id`	`transaction_id`
`value`	`value`
`items[]`	`items[]`
`items[].name`	`items[].item_name`
`items[].id`	`items[].item_id`
	`items[].affiliation`
`items[].brand`	`items[].item_brand`
`items[].category`	`items[].item_category` `items[].item_category2` `items[].item_category3` `items[].item_category4` `items[].item_category5`	상품의 카테고리입니다. 최대 5개 수준의 계층 구조를 지정할 수 있습니다. UA 및 GA4 이벤트 간에 카테고리 변환이 처리되는 방식에 관한 자세한 내용은 카테고리 매개변수 변환을 참고하세요.
	`items[].currency`
`items[].coupon`	`items[].coupon`
	`items[].discount`
`items[].list_name`	`items[].item_list_name`
`items[].list_position`	`items[].index`
	`items[].location_id`
`items[].price`	`items[].price`
`items[].quantity`	`items[].quantity`
`items[].variant`	`items[].item_variant`
`promotions[]`		GA4의 경우 `items[]`가 `items[].promotion_id`와 같은 프로모션 관련 매개변수와 함께 사용됩니다.
`promotions[].id`	`items[].promotion_id`	이 매개변수는 UA 이벤트를 GA4로 전송할 때 변환되지 않으며 그 반대의 경우도 마찬가지입니다.
`promotions[].name`	`items[].promotion_name`	이 매개변수는 UA 이벤트를 GA4로 전송할 때 변환되지 않으며 그 반대의 경우도 마찬가지입니다.
`promotions[].creative_name`
`promotions[].creative_slot`	`items[].creative_slot`	이 매개변수는 UA 이벤트를 GA4로 전송할 때 변환되지 않으며 그 반대의 경우도 마찬가지입니다.

카테고리 매개변수 변환

카테고리 매개변수 변환은 GA4 이벤트를 UA로 전송할 때 또는 그 반대로 전송할 때 특별한 경우로 처리됩니다.

유니버설 애널리틱스의 경우 items[].category 매개변수를 설정할 때 /를 구분 기호로 사용하여 최대 5개 수준의 계층 구조를 지정합니다. Google 애널리틱스 4에서는 열거형 카테고리 매개변수를 사용하여 최대 5개 수준의 계층 구조(items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4, items[].item_category5)를 지정합니다.

카테고리 변환은 다음과 같이 작동합니다.

GA4 이벤트를 UA로 변환하는 경우 열거형 카테고리가 단일 category 매개변수로 결합되며 각 카테고리는 /로 구분됩니다.
UA 이벤트를 GA4로 변환하는 경우 카테고리 매개변수 값을 분할하여 해당 GA4 열거형 카테고리를 채웁니다.
GA4 이벤트를 UA로 전송하려는 경우 카테고리 값에 / 문자를 사용하지 않는 것이 좋습니다. 이 문자는 UA로 변환할 때 카테고리 구분 기호로 해석됩니다.
정의된 수에 관계없이 처음 5개의 카테고리 수준만 사용됩니다.

카테고리 변환 예

다음 예는 GA4로 변환된 UA 카테고리 매개변수를 보여줍니다. GA4 이벤트를 UA로 변환할 때도 동일한 원칙이 적용됩니다.

5개 수준의 계층 구조를 정의하는 카테고리가 있는 UA 이벤트:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

열거형 카테고리가 있는 GA4 이벤트로 변환된 UA 이벤트:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

UA 및 GA4 이벤트 간의 호환성

아래 표에는 유니버설 애널리틱스와 Google 애널리틱스 4에서 사용되는 비슷한 전자상거래 매개변수 및 UA 이벤트를 GA4로 전송할 때 또는 그 반대로 전송할 때의 변환 동작이 나와 있습니다.

테이블 각 행의 각 열은 다음과 같은 정보를 제공합니다.

UA 이벤트 및 GA4 이벤트 열은 측정 목적별로 비슷한 이벤트를 나타냅니다.
매개변수에는 각 UA 및 GA4 이벤트 간에 동등한 매개변수가 없는 매개변수가 표시됩니다. GA4 전용에는 GA4 이벤트에만 사용되는 매개변수가 표시되고 UA 전용에는 UA 이벤트에만 사용되는 매개변수가 표시됩니다.
변환 동작(UA를 GA4로 전송)은 UA 이벤트를 GA4 속성으로 전송할 때의 변환 동작을 설명합니다. 참고사항에는 전송된 데이터, GA4 이벤트와의 차이, GA4 보고서에 미치는 주목할 만한 영향에 관한 세부정보가 표시됩니다.
변환 동작(GA4를 UA로 전송)은 GA4 속성을 UA 이벤트로 전송할 때의 변환 동작을 설명합니다. 참고사항에는 전송된 데이터, UA 이벤트와의 차이, UA 보고서에 미치는 주목할 만한 영향에 관한 세부정보가 표시됩니다.

UA 이벤트	GA4 이벤트	매개변수	변환 동작 (UA를 GA4로 전송)	변환 동작 (GA4를 UA로 전송)
`view_item_list`	`view_item_list`	GA4 전용: `item_list_id` `item_list_name` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다. GA4 전용 매개변수는 전송되지 않습니다. 이벤트 수준 `item_list_name` 매개변수는 무시되며 상품 수준 `item_list_name`만 전송됩니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
`select_content (items)`	`select_item`	GA4 전용: `item_list_id` `item_list_name` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id` UA 전용: `content_type`	호환되지 않음 `select_content` 맞춤 이벤트 및 `content_type` 맞춤 매개변수가 전송됩니다. `items` 데이터는 전송되지 않습니다.	호환되지 않음. UA 이벤트 조회는 general을 `event_category`, select_item을`event_action`으로 하여 전송됩니다. `items` 데이터는 전송되지 않습니다.
`select_content (promotions)`	`select_promotion`	GA4 전용: `creative_name` `creative_slot` `location_id` `promotion_id` `promotion_name` `items` UA 전용: `content_type` `promotions`	호환되지 않음 `select_content` 맞춤 이벤트는 `content_type` 및 `promotions`와 함께 전송됩니다.맞춤 매개변수로 사용해야 합니다. `promotions` 맞춤 매개변수에는 유용한 데이터가 포함되지 않습니다.	호환되지 않음. UA 이벤트 조회는 general을 `event_category`, select_promotion을 `event_action`으로 하여 전송됩니다. `promotions` 데이터는 전송되지 않습니다.
`view_item`	`view_item`	GA4 전용: `currency` `value` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다. `item_list_name`은 예외로 전송되지 않습니다. GA4 전용 매개변수 중에서 `currency` 및 `value`는 조회를 각각 currency 및 Transaction revenue로 하여 전송됩니다. `event_value`도 `value` 매개변수(정수)로 설정됩니다. GA4에서 UA로의 변환에는 `event_value`가 포함되지만 UA 조회의 경우 일반적으로 설정되지 않습니다. GA4의 데이터로 채워진 UA 보고서는 대부분 완료/변경되지 않습니다. 상품 목록 이름이 누락됩니다.
`add_to_wishlist` UA에서는 `items` 데이터가 지원되지 않습니다.	`add_to_wishlist`	GA4 전용: `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 이벤트 조회는 ecommerce를 `event_category`, add_to_wishlist를 `event_action`, `value` 매개변수를 `event_value`로 하여 전송됩니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
`add_to_cart`	`add_to_cart`	GA4 전용: `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다.* GA4 전용 매개변수는 전송되지 않습니다. *`item_list_name`은 전송되지 않지만 이 동작은 `list_name`을 전송하지 않는 gtag.js(UA)와 일치합니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
`remove_from_cart`	`remove_from_cart`	GA4 전용: `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다.* GA4 전용 매개변수는 전송되지 않습니다. *`item_list_name`은 전송되지 않지만 이 동작은 `list_name`을 전송하지 않는 gtag.js(UA)와 일치합니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
해당 없음	`view_cart`	GA4에서만 권장되는 이벤트입니다.	호환되지 않음. 이 이벤트는 권장 이벤트가 아니므로 UA 구현에서 전송할 가능성이 작습니다. GA4 보고서가 완료되도록 하려면 GA4 형식을 사용하여 UA에 이 이벤트를 구현하면 됩니다. UA에서 GA4 이벤트를 구현하면 `items` 데이터가 없는 이벤트로 표시되므로 그다지 유용하지 않을 수도 있습니다. UA 전자상거래 보고에는 영향을 미치지 않습니다.	호환되지 않음. 이벤트 조회는 general을 `event_category`, view_cart를 `event_action`, `value` 매개변수를 `event_value`로 하여 전송됩니다. `items` 데이터는 전송되지 않습니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
`begin_checkout`	`begin_checkout`	GA4 전용: `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다.* GA4 전용 매개변수는 전송되지 않습니다. *`item_list_name`은 전송되지 않지만 이 동작은 `list_name`을 전송하지 않는 gtag.js(UA)와 일치합니다. `begin_checkout`은 `checkout_step`을 `1`로 설정하여 `checkout_progress` 이벤트를 전송하는 것과 사실상 동일합니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
`add_payment_info`	`add_payment_info`	GA4 전용: `currency` `value` `coupon` `payment_type` `items` UA: 해당 사항 없음: 매개변수가 지원되지 않습니다.	호환되지 않음. UA는 이 이벤트의 매개변수를 지원하지 않으므로 아무 이벤트도 전송되지 않습니다. 작동하지만 그다지 유용하지 않습니다. 이벤트 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 이벤트 조회는 ecommerce를 `event_category`, add_to_wishlist를 `event_action`, `value` 매개변수(정수로 변환됨)를 `event_value`로 하여 전송됩니다. GA4에서 UA로의 변환에는 `event_value`가 포함되지만 UA 조회의 경우 일반적으로 설정되지 않습니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
해당 없음	`add_shipping_info`	GA4에서만 권장되는 이벤트입니다.	호환되지 않음. 이 이벤트는 권장 이벤트가 아니므로 UA 구현에서 전송할 가능성이 작습니다. GA4 보고서가 완료되도록 하려면 GA4 형식을 사용하여 UA에 이 이벤트를 구현하면 됩니다. UA에서 GA4 이벤트를 구현하면 `items` 데이터가 없는 이벤트로 표시되므로 그다지 유용하지 않을 수도 있습니다. UA 전자상거래 보고에는 영향을 미치지 않습니다.	호환되지 않음. 이벤트 조회는 general을 `event_category`, add_shipping_info를 `event_action`, `value` 매개변수(정수로 변환됨)를 `event_value`로 하여 전송됩니다. GA4 `currency` 매개변수는 조회를 currency*로 하여 전송됩니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
`checkout_progress` `set_checkout_option`	해당 없음	UA에서만 권장되는 이벤트입니다.	이벤트가 맞춤 이벤트로 처리됩니다. 이벤트 수준 매개변수만 전송되며 `items` 데이터는 전송되지 않습니다. 이 이벤트는 일반적으로 GA4 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.	해당 없음
`view_promotion`	`view_promotion`	GA4 전용: `creative_name` `creative_slot` `location_id` `promotion_id` `promotion_name` `items` UA 전용: `promotions`	호환되지 않음 `view_promotion` 맞춤 이벤트는 `promotions`를 맞춤 매개변수로 하여 전송됩니다. `promotions` 맞춤 매개변수에는 유용한 데이터가 포함되지 않습니다.	호환되지 않음. UA 이벤트 조회는 engagement를 `event_category`, view_promotion을 `event_action`으로 하여 전송됩니다. `promotions` 데이터는 전송되지 않습니다. 이벤트가 비 상호작용 이벤트로 표시됩니다.
`purchase`	`purchase`	GA4 전용: `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. 이벤트 수준 `currency`은 항목 수준 `currency`이 지원되지 않으므로 사용됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다.* GA4 전용 매개변수는 전송되지 않습니다. *`item_list_name`은 전송되지 않지만 이 동작은 `list_name`을 전송하지 않는 gtag.js(UA)와 일치합니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
`refund`	`refund`	GA4 전용: `affiliation` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	호환 가능. 모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다. 이벤트 수준 `currency`은 항목 수준 `currency`이 지원되지 않으므로 사용됩니다. GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.	호환 가능. 동등한 UA 매개변수가 있는 GA4 매개변수는 변환되어 전송됩니다.* GA4 전용 매개변수는 전송되지 않습니다. *`item_list_name`은 전송되지 않지만 이 동작은 `list_name`을 전송하지 않는 gtag.js(UA)와 일치합니다. GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.

전자상거래 이벤트 호환성 및 변환 참조(gtag.js)

배경

목적

절충사항

변환 작동 방식

UA와 GA4의 비슷한 매개변수

카테고리 매개변수 변환

UA 및 GA4 이벤트 간의 호환성

`view_item_list`

`select_item`

`select_promotion`

`view_item`

`add_to_wishlist`

`add_to_cart`

`remove_from_cart`

`view_cart`

`begin_checkout`

`add_payment_info`

`add_shipping_info`

`view_promotion`

`purchase`

`refund`