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

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

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

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

소개

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

시작하기 전에

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

향상된 전자상거래에 관해
데이터 가져오기 개발자 가이드

개요

제품 데이터에 데이터 가져오기를 사용하려면 다음 단계를 따르세요.

데이터 세트 만들기
업로드용 제품 데이터 CSV 준비
Management API를 사용하여 제품 데이터 업로드하기
제품 SKU를 전송하도록 전자상거래 코드 업데이트

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

데이터 세트 만들기

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

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

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

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

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

데이터 가져오기 개발자 가이드에 따라 첫 번째 열의 키로 제품 SKU를 사용하여 가져올 제품 데이터 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

참고: 제품 카테고리에는 5가지 수준의 계층 구조가 지원됩니다. 계층 구조에서 각 수준의 구분 기호로 / (예: 의류/남성/셔츠)을 사용합니다.

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

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

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

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

제품 데이터를 업로드한 후 전자상거래 코드를 각 조회와 함께 제품 SKU를 전송하도록 맞춤 측정기준 또는 측정항목과 같이 보고서에 원하는 추가 데이터를 업데이트하세요.

참고: 전자상거래 데이터를 Google 애널리틱스로 전송할 때 제품 SKU라는 이름의 특정 필드는 없지만 대신 아래 예와 같이 id 필드로 표시됩니다.

// 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와 일치하며, 업로드된 추가 제품 데이터가 보고서에 자동으로 입력됩니다.