전자상거래 이벤트 호환성 및 변환 참조(태그 관리자)

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

배경

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

목적

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

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

장단점

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

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

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

변환 작동 방식

GA4 이벤트 태그

  • GA4 전자상거래 이벤트를 전송할 때 gtag를 사용하는 것이 좋습니다. 그러나 GA4 이벤트 태그는 데이터 영역으로 푸시된 전자상거래 데이터를 읽을 수 있습니다.
  • GA4 이벤트 태그에서 직접 구성된 GA4 이벤트 매개변수는 모든 gtag/데이터 영역 또는 맞춤 변수 제공 데이터보다 우선합니다.
  • GA4 이벤트 태그는 유니버설 애널리틱스에 사용되는 전자상거래 이벤트 데이터의 이전 버전과 호환됩니다. 다음과 같은 우선순위가 적용됩니다.
    • GA4 전자상거래 이벤트를 사용합니다.
    • GA4 전자상거래 이벤트가 없으면 UA 전자상거래 이벤트를 찾아 사용합니다.
  • UA 전자상거래 이벤트를 GA4 이벤트 태그와 함께 사용하는 경우 이벤트가 GA4 속성으로 전송되기 전에 먼저 동등한 GA4 전자상거래 이벤트로 변환됩니다. gtag, 데이터 영역, 맞춤 객체 중 어느 것을 사용하거나 마찬가지입니다.

유니버설 애널리틱스 태그

  • 유니버설 애널리틱스 태그는 GA4 전자상거래 이벤트(gtag를 사용하여 전송된 데이터 포함)를 읽을 수 있습니다.
  • 태그에서 GA4 전자상거래 이벤트를 읽을 수 있도록 사용 설정된 경우 다음과 같은 우선순위가 적용됩니다.
    • GA4 전자상거래 이벤트를 사용합니다.
    • GA4 전자상거래 이벤트가 없으면 UA 전자상거래 이벤트를 찾아 사용합니다.
  • GA4 전자상거래 이벤트를 유니버설 애널리틱스 태그와 함께 사용하는 경우 이벤트가 UA 속성으로 전송되기 전에 먼저 동등한 UA 전자상거래 이벤트로 변환됩니다. gtag, 데이터 영역, 맞춤 객체 중 어느 것을 사용하거나 마찬가지입니다.

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로 전송)
제품 노출수(impressions) 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 보고서는 완료/변경되지 않습니다.
제품 클릭수(click) 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 이벤트 조회generalevent_category, select_itemevent_action으로 하여 전송됩니다. items 데이터는 전송되지 않습니다.
프로모션 클릭수(promoClick) GA4 전용:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

UA 전용:
content_type
promotions
호환되지 않음

select_content 맞춤 이벤트는 content_typepromotions를 맞춤 매개변수로 하여 전송됩니다. promotions 맞춤 매개변수에는 유용한 데이터가 포함되지 않습니다.
호환되지 않음.

UA 이벤트 조회generalevent_category, select_promotionevent_action으로 하여 전송됩니다. promotions 데이터는 전송되지 않습니다.
제품 세부정보 조회수(detail) 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 전용 매개변수 중에서 currencyvalue는 조회를 각각 currencyTransaction revenue로 하여 전송됩니다. event_valuevalue 매개변수(정수)로 설정됩니다. GA4에서 UA로의 변환에는 event_value가 포함되지만 UA 조회의 경우 일반적으로 설정되지 않습니다.

GA4의 데이터로 채워진 UA 보고서는 대부분 완료/변경되지 않습니다. 상품 목록 이름이 누락됩니다.
add_to_wishlist*

*UA에서는 items 데이터가 지원되지 않습니다.
GA4 전용:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
호환 가능.

모든 UA 매개변수가 동등한 GA4 매개변수로 변환되어 전송됩니다.

GA4 전용 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.
호환 가능.

동등한 이벤트 조회ecommerceevent_category, add_to_wishlistevent_action, value 매개변수를 event_value로 하여 전송됩니다.

GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
장바구니에 제품 추가(add) 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) 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 보고서는 완료/변경되지 않습니다.
해당 사항 없음 GA4에서만 권장되는 이벤트입니다.
호환되지 않음*.

*이 이벤트는 권장 이벤트가 아니므로 UA 구현에서 전송할 가능성이 작습니다. GA4 보고서를 완료하려면 GA4 형식을 사용하여 UA에서 이 이벤트를 구현하세요.

UA에서 GA4 이벤트를 구현하면 items 데이터가 없는 이벤트로 표시되므로 그다지 유용하지 않을 수도 있습니다. UA 전자상거래 보고에는 영향을 미치지 않습니다.
호환되지 않음.

이벤트 조회generalevent_category, view_cartevent_action, value 매개변수를 event_value로 하여 전송됩니다. items 데이터는 전송되지 않습니다.

이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
결제 단계(checkout, checkout_option) 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_checkoutcheckout_step1로 설정하여 checkout_progress 이벤트를 전송하는 것과 사실상 동일합니다.

GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다.
add_payment_info GA4 전용:
currency
value
coupon
payment_type
items

UA:
해당 사항 없음: 매개변수가 지원되지 않습니다.
호환되지 않음*.

*UA는 이 이벤트의 매개변수를 지원하지 않으므로 아무 이벤트도 전송되지 않습니다. 작동하지만 그다지 유용하지 않습니다.

이벤트 매개변수가 필요한 GA4 보고서는 완료되지 않습니다.
호환 가능.

동등한 이벤트 조회ecommerceevent_category, add_to_wishlistevent_action, value 매개변수(정수로 변환됨)를 event_value로 하여 전송됩니다. GA4에서 UA로의 변환에는 event_value가 포함되지만 UA 조회의 경우 일반적으로 설정되지 않습니다.

GA4 이벤트의 데이터로 채워진 UA 보고서는 완료/변경되지 않습니다. 이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
해당 사항 없음 GA4에서만 권장되는 이벤트입니다.
호환되지 않음*.

*이 이벤트는 권장 이벤트가 아니므로 UA 구현에서 전송할 가능성이 작습니다. GA4 보고서를 완료하려면 GA4 형식을 사용하여 UA에서 이 이벤트를 구현하세요.

UA에서 GA4 이벤트를 구현하면 items 데이터가 없는 이벤트로 표시되므로 그다지 유용하지 않을 수도 있습니다. UA 전자상거래 보고에는 영향을 미치지 않습니다.
호환되지 않음*.

이벤트 조회generalevent_category, add_shipping_infoevent_action, value 매개변수(정수로 변환됨)를 event_value로 하여 전송됩니다. GA4 currency 매개변수는 조회를 currency로 하여 전송됩니다.

이 이벤트는 일반적으로 UA 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
결제 단계(checkout, checkout_option) 해당 사항 없음 UA에서만 권장되는 이벤트입니다.
이벤트가 맞춤 이벤트로 처리됩니다. 이벤트 수준 매개변수만 전송되며 items 데이터는 전송되지 않습니다.

이 이벤트는 일반적으로 GA4 전자상거래 보고서에서 지원되지 않으므로 큰 영향을 미치지 않습니다.
해당 사항 없음
프로모션 노출수(promoView) GA4 전용:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

UA 전용:
promotions
호환되지 않음

view_promotion 맞춤 이벤트는 promotions를 맞춤 매개변수로 하여 전송됩니다. promotions 맞춤 매개변수에는 유용한 데이터가 포함되지 않습니다.
호환되지 않음.

UA 이벤트 조회engagementevent_category, view_promotionevent_action으로 하여 전송됩니다. promotions 데이터는 전송되지 않습니다. 이벤트가 비상호작용 이벤트로 표시됩니다.
구매 측정(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) 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 보고서는 완료/변경되지 않습니다.