향상된 전자상거래

이 페이지에서는 gtag.js를 사용하여 향상된 전자상거래 데이터를 수집하는 방법을 설명합니다. gtag.js에서 Google 애널리틱스를 구성하고 Google 애널리틱스에서 향상된 전자상거래를 사용 설정한 경우 gtag.js를 사용하여 노출 데이터, 제품 데이터, 프로모션 데이터, 작업 데이터를 Google 애널리틱스로 전송할 수 있습니다.

향상된 전자상거래 데이터 유형 및 작업

다음과 같이 여러 가지 유형의 전자상거래 데이터를 전송할 수 있습니다.

노출 데이터

조회한 제품에 대한 정보를 나타냅니다. impressionFieldObject라고 하며 다음 값을 포함합니다.

키 값 유형 필수 설명
id 텍스트 *예

제품 ID 또는 SKU입니다(예: P67890).

* id 또는 name 중 하나를 설정해야 합니다.

name 텍스트 *예

제품의 이름입니다(예: Android 티셔츠).

* id 또는 name 중 하나를 설정해야 합니다.

list 텍스트 아니요 제품이 속한 목록 또는 컬렉션입니다(예: 검색결과).
list_name 텍스트 아니요 제품이 속한 목록 또는 컬렉션입니다(예: 검색결과).
brand 텍스트 아니요 제품과 연결된 브랜드입니다(예: Google).
category 텍스트 아니요 제품이 속한 카테고리입니다(예: 의류). /를 구분 기호로 사용하여 최대 5개 수준의 계층 구조를 지정합니다(예: 의류/남성/티셔츠).
variant 텍스트 아니요 제품의 옵션(예: 블랙)입니다.
position 정수 아니요 목록 또는 컬렉션에서 제품의 위치입니다(예: 2).
list_position 정수 아니요 목록 또는 컬렉션에서 제품의 위치입니다(예: 2).
price 숫자 아니요 제품의 가격입니다(예: 29.20).

제품 데이터

제품 데이터는 조회, 장바구니에 추가 등의 작업이 실행된 개별 제품을 나타냅니다. productFieldObject라고 하며 다음 값을 포함합니다.

키 값 유형 필수 설명
id 텍스트 *예

제품 ID 또는 SKU입니다(예: P67890).

* ID 또는 name 중 하나를 설정해야 합니다.

name 텍스트 *예

제품의 이름입니다(예: Android 티셔츠).

* ID 또는 name 중 하나를 설정해야 합니다.

brand 텍스트 아니요 제품과 연결된 브랜드입니다(예: Google).
category 텍스트 아니요 제품이 속한 카테고리입니다(예: 의류). 구분 기호로 /를 사용하여 계층 구조를 최대 5개 수준 (예: 의류/남성/티셔츠)으로 지정합니다.
variant 텍스트 아니요 제품의 옵션(예: 블랙)입니다.
price 숫자 아니요 제품의 가격입니다(예: 29.20).
quantity 정수 아니요 제품의 수량입니다(예: 2).
coupon 텍스트 아니요 제품과 연결된 쿠폰 코드입니다(예: SUMMER_SALE13).
position 정수 아니요 목록 또는 컬렉션에서 제품의 위치입니다(예: 2).
list_position 정수 아니요 목록 또는 컬렉션에서 제품의 위치입니다(예: 2).

프로모션 데이터

조회한 프로모션에 대한 정보를 나타냅니다. promoFieldObject라고 하며 다음 값을 포함합니다.

키 값 유형 필수 설명
id 텍스트 *예

프로모션 ID입니다(예: PROMO_1234).

* id 또는 name 중 하나를 설정해야 합니다.

name 텍스트 *예

프로모션의 이름입니다(예: 여름 세일).

* id 또는 name 중 하나를 설정해야 합니다.

creative 텍스트 아니요 프로모션과 연결된 광고 소재입니다(예: summer_banner2).
creative_name 텍스트 아니요 광고 소재의 이름입니다(예: summer_banner2).
position 텍스트 아니요 광고 소재의 위치입니다(예: banner_slot_1).
creative_slot 텍스트 아니요 광고 소재 슬롯의 이름입니다(예: banner_slot_1).

작업 데이터

발생한 전자상거래 관련 활동에 대한 정보를 나타냅니다. actionFieldObject라고 하며 다음 값을 포함합니다.

키 값 유형 필수 설명
id 텍스트 *예

거래 ID입니다(예: T1234).

* 작업 유형이 purchase 또는 refund인 경우 필수입니다.

affiliation 텍스트 아니요 거래가 발생한 매장 또는 제휴사입니다(예: Google 스토어).
revenue 숫자 아니요

거래와 연결된 총 수익 또는 총 합계를 지정합니다(예: 11.99). 이 값에는 배송비, 세금 또는 기타 수익 계산에 포함하려는 총 수익 조정 금액이 포함될 수 있습니다.

값 숫자 아니요 이벤트와 연결된 가치(수익)입니다.
tax 숫자 아니요 거래와 연결된 총 세금입니다.
shipping 숫자 아니요 거래와 연결된 배송비입니다.
coupon 텍스트 아니요 거래에 사용된 거래 쿠폰입니다.
list 텍스트 아니요 연결된 제품이 속한 목록입니다. 선택사항입니다.
items 배열 아니요 연결된 제품이 포함된 배열입니다.
step 정수 아니요 결제 과정의 단계를 나타내는 숫자입니다. '결제' 작업 시 선택사항입니다.
checkout_step 정수 아니요 결제 과정의 단계를 나타내는 숫자입니다.
option 텍스트 아니요 선택한 결제 수단과 같이 결제 페이지의 옵션 정보를 설명할 수 있는 checkout 및 checkout_option 작업의 추가 필드입니다.
checkout_option 텍스트 아니요 결제 옵션입니다(예: 선택한 결제 수단).
키 값 유형 필수 설명
coupon 문자열 아니요 구매 가능한 상품의 쿠폰 코드입니다.

제품 및 프로모션 작업

작업은 Google 애널리틱스로 전송하는 제품 및 프로모션 데이터를 해석하는 방법을 지정합니다.

작업 이벤트 설명
click 하나 이상의 제품에 대한 제품 또는 제품 연결을 클릭합니다.
detail 제품 세부정보를 봅니다.
add 장바구니에 하나 이상의 제품을 추가합니다.
remove 장바구니에서 하나 이상의 제품을 삭제합니다.
checkout 하나 이상의 제품에 대한 결제 절차를 시작합니다.
checkout_option 지정된 결제 단계의 옵션 값을 전송합니다.
purchase 하나 이상의 제품에 대한 판매입니다.
refund 하나 이상의 제품에 대한 환불입니다.
promo_click 내부 프로모션에 대한 클릭입니다.
add_to_cart 사용자가 장바구니에 하나 이상의 제품을 추가합니다.
begin_checkout 사용자가 하나 이상의 제품에 대한 결제 절차를 시작합니다.
checkout_progress 사용자가 첫 번째 결제 단계 후 결제 단계를 완료합니다.
purchase 사용자가 구매를 완료합니다.
refund 사용자가 하나 이상의 제품에 대한 환불을 받습니다.
remove_from_cart 사용자가 장바구니에서 하나 이상의 제품을 삭제합니다.
select_content 사용자가 제품 또는 제품 연결을 클릭합니다.
set_checkout_option 사용자가 완료하는 결제 단계입니다.
view_item 사용자가 제품의 세부정보를 봅니다.
view_item_list 사용자가 하나 이상의 제품 목록을 봅니다.
view_promotion 사용자가 내부 프로모션을 클릭합니다.
view_refund 사용자가 하나 이상의 제품에 대한 환불 정보를 봅니다.

예

제품 노출수 측정

제품 노출수를 측정하려면 제품 정보와 함께 view_item_list를 전송합니다.

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

제품 클릭수 측정

제품 클릭수를 측정하려면 select_content 이벤트를 전송하고 product를 content_type로 지정하고 제품 정보를 제공합니다.

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

제품 세부정보 보기 측정

제품 등록정보를 클릭한 후 사용자가 제품 세부정보 페이지를 볼 수 있습니다. 제품 세부정보 보기를 측정하려면 view_item 이벤트를 제품 세부정보와 함께 전송합니다.

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

장바구니에서의 추가 및 삭제 측정

장바구니에 제품 추가를 측정하려면 add_to_cart 이벤트를 제품 정보와 함께 전송합니다.

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

장바구니에서 제품 삭제를 측정하려면 remove_from_cart 이벤트를 제품 정보와 함께 전송합니다.

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

결제 측정

결제 절차의 각 단계를 측정하는 방법은 다음과 같습니다.

  1. 결제 절차의 각 단계를 측정하는 측정 코드를 추가합니다.
  2. 해당하는 경우 측정 코드를 추가하여 결제 옵션을 기록합니다.

1. 결제 단계 측정

첫 번째 결제 단계를 측정하려면 begin_checkout 이벤트를 결제 항목과 함께 전송합니다.

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

이후의 각 결제 단계를 측정하려면 결제 항목이 포함된 checkout_progress 이벤트를 전송합니다.

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. 결제 옵션 측정

결제 옵션을 측정하려면 set_checkout_option 이벤트를 결제 옵션과 함께 전송합니다.

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

프로모션 노출수 측정

프로모션 노출수를 측정하려면 view_promotion 이벤트를 프로모션 정보와 함께 전송합니다.

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

프로모션 클릭수 측정

프로모션 클릭수를 측정하려면 select_content 이벤트를 전송하고 프로모션을 제공합니다.

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

구매 측정

거래를 측정하려면 purchase 이벤트를 거래에 포함된 상품과 함께 전송합니다.

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

환불 측정

거래의 전액 환불을 측정하려면 refund 이벤트를 거래 ID와 함께 전송합니다.

gtag('event', 'refund', { "transaction_id": "T12345" })

부분 환불을 측정하려면 refund 이벤트를 거래 ID 및 환불할 상품과 함께 전송합니다.

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});