이 페이지는 Cloud Translation API를 통해 번역되었습니다.

향상된 전자상거래

이 페이지에서는 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. 결제 단계 측정

첫 번째 결제 단계를 측정하려면 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'
    }
  ]
});