관리 API를 이용해 비용 데이터 가져오기

이 가이드에서는 Management API를 사용하여 비용 데이터를 가져오는 방법을 설명합니다.

소개

Google 이외의 유료 캠페인에 대한 비용 및 클릭 데이터를 가져오면 Google 애널리틱스 플랫폼을 활용하여 ROI 분석을 수행하고 모든 온라인 광고 및 마케팅 투자에 대한 캠페인 실적을 비교할 수 있습니다.

시작하기 전에

이 가이드를 시작하기 전에 개발자는 다음을 실행해야 합니다.

개요

Management API를 사용하여 Google 애널리틱스로 비용 데이터를 가져오려면 다음 단계를 따라야 합니다.

  1. 캠페인 URL에 태그 추가하기
  2. 데이터 세트를 만듭니다.
  3. 업로드할 비용 데이터 CSV 파일을 준비합니다.
  4. Management API를 사용하여 비용 데이터를 업로드합니다.

캠페인 URL에 태그 추가

Google 이외의 광고 시스템에서 모든 도착 URL에 캠페인 추적 매개변수를 추가하여 외부 소스의 비용 데이터를 Google 애널리틱스의 세션 데이터와 결합하면 유료 캠페인에 대한 ROI 분석을 수행할 수 있습니다.

아래의 광고 예에서는 도착 URL에 캠페인 추적 매개변수 (utm_campaign, utm_source, utm_medium, utm_term) 태그가 추가됩니다. 이렇게 하면 광고 클릭을 통한 웹사이트 방문이 Google 애널리틱스의 여름 세일 캠페인과 연결됩니다.

그림 1: 광고 예시

이 광고에 사용한 애완동물 가게의 도착 URL은 다음과 같습니다.

http://www.examplepetstore.com?utm_campaign=Summer%2BSale&utm_source=ad%2Bnetwork&utm_medium=cpc&utm_term=dogbone

사용자가 광고를 클릭하면 애완동물 전문점 웹사이트로 연결되고 Google 애널리틱스에서 해당 세션에 대해 다음 값이 설정됩니다.

Google 애널리틱스 웹 인터페이스에 표시되는 측정기준 이름 캠페인 추적 매개변수 Google 애널리틱스에서 설정된 값
캠페인 이름 utm_campaign 여름 세일
소스 utm_source 광고 네트워크
보통 utm_medium cpc
키워드 utm_term 개껌

이렇게 하면 Google 애널리틱스에서 캠페인 추적 매개변수를 세션과 연결하고 Google 애널리틱스 데이터를 외부 비용 데이터 소스와 조인할 수 있습니다.

데이터 세트 만들기

비용 데이터를 가져오려면 데이터 세트를 만들어야 합니다. 데이터 세트는 Google 애널리틱스에서 하나 이상의 외부 데이터 소스를 나타내는 데 사용됩니다. 데이터 세트는 웹 인터페이스를 통해서만 만들 수 있습니다.

관리 페이지의 속성 탭에서 다음 단계를 따르세요.

  1. 데이터 가져오기 탭을 선택합니다.
  2. 새 데이터 세트 버튼을 클릭합니다.
  3. 유형의 비용 데이터를 선택하고 다음 단계를 클릭합니다.
  4. 데이터 세트의 이름을 지정하고 보고서에서 비용 분석을 사용 설정할 보기 (프로필)를 하나 이상 선택한 후 다음 단계를 클릭합니다.
  5. 업로드하려는 측정기준 및 측정항목을 선택합니다.
  6. 원하는 Import Behavior를 선택합니다.
    • 이 설정은 중복 키가 발견된 경우 비용 데이터를 덮어쓸지 아니면 합산할지 제어합니다. 가져오기 동작에 대한 자세한 내용은 데이터 가져오기 개발자 가이드의 비용 데이터 합계와 덮어쓰기 비교 섹션을 참조하세요.
  7. 저장을 클릭합니다.
그림 2: 비용 데이터 세트 만들기

업로드할 비용 데이터 CSV 파일 준비

Google 애널리틱스에서는 비용 데이터가 특정 값이 있는 특정 형식으로 업로드될 것으로 예상합니다. 외부 소스에서 내보낸 비용 데이터를 업로드하기 전에 이러한 요구사항을 충족하는지 확인해야 합니다.

CSV 파일에 대해 수행해야 하는 기본 수정 및 유효성 검사는 다음과 같습니다.

  • Google 애널리틱스에서 인식하는 열 헤더와 일치하도록 열 헤더의 이름을 바꿉니다. 웹 인터페이스의 데이터 세트 세부정보 페이지에서 헤더를 검색할 수 있습니다.
  • 누락된 필수 값을 추가합니다.
  • 해당되는 경우 CSV 파일의 값은 캠페인 추적 매개변수에 사용된 값과 일치해야 합니다.

반려동물 매장의 예에서는 데이터를 종합적으로 내보내고 CSV 파일로 저장됩니다.

그림 3: 내보낸 비용 데이터 CSV 파일

그러면 CSV 파일이 Google 애널리틱스에서 요구하는 형식에 맞게 수정됩니다.

그림 4: 형식이 지정된 비용 데이터 CSV 파일

CSV 파일이 준비되면 다음 예시와 비슷한 형식이 됩니다.

ga:date,ga:source,ga:medium,ga:campaign,ga:keyword,ga:impressions,ga:adClicks,ga:adCost
20140615,ad network,cpc,Summer Sale,dogbone,9387,288,100.3
20140615,ad network,cpc,Summer Sale,dog treat,1684,52,19.35
20140615,ad network,cpc,Summer Sale,pet store,3187,143,76.23
20140616,ad network,cpc,Summer Sale,dogbone,8754,188,86.21

일반 파일 형식 제약 조건은 데이터 가져오기 개발자 가이드를 참고하세요.

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

데이터 세트를 만들고 비용 데이터를 CSV로 업로드할 준비가 되면 Management API 또는 웹 인터페이스를 통해 비용 데이터를 업로드할 수 있습니다.

보고서

업로드된 비용 데이터는 Google 애널리틱스의 획득 아래에 있는 비용 분석 보고서와 Core Reporting API의 일부로 제공됩니다.