Management API를 통해 제품 데이터 가져오기

앤드류 웨일스, Google 애널리틱스 개발자 관계팀 – 2014년 5월

이 가이드에서는 Management API를 사용하여 제품 데이터를 가져와 향상된 전자상거래 구현을 간소화하는 방법을 설명합니다. 제품 데이터 가져오기에 대한 자세한 내용은 제품 데이터 가져오기의 예를 참조하세요.

소개

제품 데이터를 Google 애널리틱스로 가져오면 페이지 조회 및 이벤트와 같은 조회와 함께 전송해야 하는 전자상거래 데이터의 양이 간소화되고 줄어듭니다. 수집 시 Google 애널리틱스로 전송된 단일 제품 ID 또는 SKU를 가져온 제품 데이터와 결합하여 보고서의 제품 측정기준 및 측정항목을 채울 수 있습니다.

시작하기 전에

이 솔루션 가이드를 완료하기 전에 다음을 읽어보세요.

개요

제품 데이터에 대한 데이터 가져오기를 사용 설정하는 방법은 다음과 같습니다.

  1. 데이터 세트 만들기
  2. 업로드할 제품 데이터 CSV 준비
  3. Management API를 사용하여 제품 데이터 업로드
  4. 전자상거래 코드를 업데이트하여 제품 SKU 전송

웹 인터페이스를 사용하여 Google 애널리틱스에 데이터 세트를 업로드하는 방법을 알아보려면 향상된 전자상거래 사용자 가이드를 참조하세요.

데이터 세트 만들기

제품 데이터를 가져오는 첫 번째 단계는 제품 데이터의 데이터 세트를 만들고 가져올 측정기준과 측정항목을 정의하는 스키마를 설정하는 것입니다.

데이터 가져오기 개발자 가이드에 따라 데이터 세트를 만들고 데이터 세트 유형으로 제품 데이터를, 키로 제품 SKU를 선택합니다.

그림 1: 제품 데이터 세트 만들기

데이터 세트를 만든 후 맞춤 데이터 소스 ID를 기록해 둡니다. 이 ID는 다음 단계에서 Management API를 사용하여 Google 애널리틱스로 제품 데이터를 가져올 때 사용됩니다.

업로드할 제품 데이터 CSV 준비

제품 데이터 CSV에는 헤더 행, 제품 SKU 열, 데이터 세트 스키마에서 정의한 대로 가져올 각 측정기준 및 측정항목의 열이 포함되어야 합니다.

데이터 가져오기 개발자 가이드에 따라 제품 SKU를 첫 번째 열의 키로 사용하여 가져올 제품 데이터 CSV를 준비합니다.

그림 2: CSV 파일로 업로드할 제품 데이터 준비

CSV 파일은 다음과 같습니다.

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

Management API를 사용하여 제품 데이터 업로드

데이터 세트를 만들고, 스키마를 정의하고, CSV로 업로드할 제품 데이터를 준비했다면 Management API를 사용하여 제품 데이터를 업로드할 수 있습니다.

제품 데이터가 업로드, 검증, 처리된 후 속성에서 Google 애널리틱스로 전송된 수신 조회가 일치할 때 제품 SKU가 업로드된 제품 데이터와 결합됩니다.

전자상거래 코드를 업데이트하여 제품 SKU 전송

제품 데이터를 업로드한 후 전자상거래 코드를 업데이트하여 맞춤 측정기준 또는 측정항목과 같이 보고서에 포함하려는 추가 데이터와 함께 각 조회수와 함께 제품 SKU를 전송합니다.

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

이제 향상된 전자상거래 구현에서 전송된 제품 ID가 가져온 제품 데이터 세트의 제품 SKU와 일치하며, 업로드한 추가 제품 데이터가 보고서에 자동으로 입력됩니다.