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와 일치하며, 업로드한 추가 제품 데이터가 보고서에 자동으로 채워집니다.