측정 프로토콜 다루기

이 문서에서는 일반적인 조회수를 측정 프로토콜로 전송하는 방법을 설명합니다.

개요

이 문서에서는 일반적인 조회 유형을 Google 애널리틱스 측정 프로토콜로 전송하도록 HTTP 요청의 형식을 지정하는 방법을 보여줍니다. 다음을 읽어보세요.

  • 프로토콜 참조 - 프로토콜 요청의 형식을 지정하는 방법에 대한 자세한 설명입니다.
  • 매개변수 참조 - 프로토콜에서 허용하는 모든 매개변수의 목록입니다.

필수 값 전송

사용자 상호작용 데이터를 전송하려면 이 엔드포인트에 HTTP POST 요청을 수행합니다.

POST /collect HTTP/1.1
Host: www.google-analytics.com

payload_data

각 페이로드에는 다음 매개변수가 필요합니다.

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.
&t=              // Hit Type.

각 페이로드에는 유효한 조회 유형이 포함되어야 하며 각 조회 유형에는 자체 필수 필드 조합이 있습니다. 따라서 /home 페이지의 페이지 조회수를 보내려면 다음 페이로드를 사용합니다.

v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome

아래 섹션에서는 일반적인 조회 유형의 예를 보여줍니다.

단일 요청에 여러 조회 일괄 처리

단일 요청으로 여러 조회를 전송하려면 /collect 대신 /batch 엔드포인트를 사용하고 각 페이로드를 한 줄에 지정합니다.

예를 들어 웹사이트의 '홈', '회사 소개', '연락처' 페이지의 페이지 조회를 전송하려면 다음 일괄 요청을 전송할 수 있습니다.

POST /batch HTTP/1.1
Host: www.google-analytics.com

v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fabout
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fcontact

일괄 제한사항

일괄 처리 프로토콜 조회의 표준 제한사항 외에도 일괄 요청에는 다음과 같은 추가 제한사항이 있습니다.

  • 요청당 최대 20회의 조회를 지정할 수 있습니다.
  • 모든 조회 페이로드의 총 크기는 16,000바이트를 초과할 수 없습니다.
  • 단일 조회 페이로드는 8K를 초과할 수 없습니다.

일반적인 조회 유형 전송

다음은 일반적인 조회 유형을 Google 애널리틱스로 전송하는 방법의 예입니다. 이러한 예 외에도 다양한 매개변수를 조합하여 새로운 데이터 관계를 얻을 수 있습니다. 예를 들어 이벤트가 발생한 페이지를 알아보려면 아래에 설명된 대로 pagePath 매개변수 p를 이벤트 추적 매개변수와 함께 전송하세요.

Google 애널리틱스로 전송할 수 있는 모든 매개변수의 전체 목록은 매개변수 참조를 확인하세요.

페이지 추적

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=pageview      // Pageview hit type.
&dh=mydemo.com   // Document hostname.
&dp=/home        // Page.
&dt=homepage     // Title.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

이벤트 추적

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=event         // Event hit type
&ec=video        // Event Category. Required.
&ea=play         // Event Action. Required.
&el=holiday      // Event label.
&ev=300          // Event value.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

향상된 전자상거래 추적

전자상거래 조회 대신 향상된 전자상거래 조회를 사용해야 합니다. 전자상거래 추적을 이미 구현한 상태에서 향상된 전자상거래 추적을 사용하려는 경우 두 가지 방법이 있습니다.

새 속성 사용

새 속성을 만들고 향상된 전자상거래 조회를 새 속성으로 보낼 수 있습니다.

기존 속성 이전

아래 예를 따라 전자상거래 조회를 향상된 전자상거래 조회로 이전합니다. 이전에 전자상거래 조회를 사용하여 수집된 거래 및 항목 데이터는 영향을 받지 않으며 원래 전송된 속성 및 보기에서 계속 사용할 수 있습니다.

노출수 측정

v=1                                      // Version.
&tid=UA-XXXXX-Y                          // Tracking ID / Property ID.
&cid=555                                 // Anonymous Client ID.
&t=pageview                              // Pageview hit type.
&dh=mydemo.com                           // Document hostname.
&dp=/home                                // Page.
&dt=homepage                             // Title.

&il1nm=Search%20Results                  // Impression list 1. Required.
&il1pi1id=P12345                         // Product Impression 1 ID. Either ID or name must be set.
&il1pi1nm=Android%20Warhol%20T-Shirt     // Product Impression 1 name. Either ID or name must be set.
&il1pi1ca=Apparel%2FT-Shirts             // Product Impression 1 category.
&il1pi1br=Google                         // Product Impression 1 brand.
&il1pi1va=Black                          // Product Impression 1 variant.
&il1pi1ps=1                              // Product Impression 1 position.
&il1pi1cd1=Member                        // Custom dimension.

&il2nm=Recommended%20Products            // Impression list 2.
&il2pi1nm=Yellow%20T-Shirt               // Product Impression 1 name.
&il2pi2nm=Red%20T-Shirt                  // Product Impression 2 name.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

작업 측정

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=UX                                // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Results                           // Event label.

&pa=click                             // Product action (click). Required.
&pal=Search%20Results                 // Product Action List.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

노출수와 작업 결합

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID /  Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=UX                                // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Results                           // Event label.

&pa=detail                            // Product action (detail). Required.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.

&il1nm=Related%20Products             // Impression list.
&il1pi1id=P12345                      // Product Impression 1 ID.
&il1pi1nm=Android%20Warhol%20T-Shirt  // Product Impression 1 name.
&il1pi1ca=Apparel%2FT-Shirts          // Product Impression 1 category.
&il1pi1br=Google                      // Product Impression 1 brand.
&il1pi1va=Black                       // Product Impression 1 variant.
&il1pi1ps=1                           // Product Impression 1 position.
   

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

구매 측정

v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=pageview                           // Pageview hit type.
&dh=mydemo.com                        // Document hostname.
&dp=/receipt                          // Page.
&dt=Receipt%20Page                    // Title.

&ti=T12345                            // Transaction ID. Required.
&ta=Google%20Store%20-%20Online       // Affiliation.
&tr=37.39                             // Revenue.
&tt=2.85                              // Tax.
&ts=5.34                              // Shipping.
&tcc=SUMMER2013                       // Transaction coupon.

&pa=purchase                          // Product action (purchase). Required.
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1ps=1                              // Product 1 position.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

환불 측정

이벤트를 사용하여 환불 데이터를 보내야 하는데 이벤트가 일반적으로 측정되는 현장 동작에 포함되어 있지 않은 경우 (예: 사용자가 시작하지 않음) 비상호작용 이벤트를 전송하는 것이 좋습니다. 이렇게 하면 이탈률, 세션 시간 등의 측정항목이 이벤트의 영향을 받지 않습니다.

 // Refund an entire transaction and send with a non-interaction event.
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=Ecommerce                         // Event Category. Required.
&ea=Refund                            // Event Action. Required.
&ni=1                                 // Non-interaction parameter.

&ti=T12345                            // Transaction ID. Required.
&pa=refund                            // Product action (refund). Required.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

 // Refund a single product.
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type.
&ec=Ecommerce                         // Event Category. Required.
&ea=Refund                            // Event Action. Required.
&ni=1                                 // Non-interaction parameter.

&ti=T12345                            // Transaction ID. Required.
&pa=refund                            // Product action (refund). Required.
&pr1id=P12345                         // Product 1 ID. Required.
&pr1qt=1                              // Product 1 quantity. Required.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

결제 절차 측정

1. 결제 단계 측정
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=pageview                           // Pageview hit type.
&dh=mydemo.com                        // Document hostname.
&dp=/checkout                         // Page.
&dt=Checkout                          // Title.

&pa=checkout                          // Product action (checkout).
&pr1id=P12345                         // Product 1 ID. Either ID or name must be set.
&pr1nm=Android%20Warhol%20T-Shirt     // Product 1 name. Either ID or name must be set.
&pr1ca=Apparel                        // Product 1 category.
&pr1br=Google                         // Product 1 brand.
&pr1va=Black                          // Product 1 variant.
&pr1pr=29.20                          // Product 1 Price.
&pr1qt=1                              // Product 1 quantity.
&cos=1                                // Checkout step #1.
&col=Visa                             // Checkout step option.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

2. 결제 옵션 측정
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type
&ec=Checkout                          // Event Category. Required.
&ea=Option                            // Event Action. Required.

&pa=checkout_option                   // Product action (checkout_option).
&cos=2                                // Checkout step.
&col=FedEx                            // Checkout step option.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

내부 프로모션 측정

프로모션 노출수
v=1                                      // Version.
&tid=UA-XXXXX-Y                          // Tracking ID / Property ID.
&cid=555                                 // Anonymous Client ID.
&t=pageview                              // Pageview hit type.
&dh=mydemo.com                           // Document hostname.
&dp=/home                                // Page.
&dt=homepage                             // Title.

&promo1id=PROMO_1234                     // Promotion 1 ID. Either ID or name must be set.
&promo1nm=Summer%20Sale                  // Promotion 1 name. Either ID or name must be set.
&promo1cr=summer_banner2                 // Promotion Creative.
&promo1ps=banner_slot1                   // Promotion Position.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

프로모션 클릭수
v=1                                   // Version.
&tid=UA-XXXXX-Y                       // Tracking ID / Property ID.
&cid=555                              // Anonymous Client ID.
&t=event                              // Event hit type
&ec=Internal%20Promotions             // Event Category. Required.
&ea=click                             // Event Action. Required.
&el=Summer%20Sale                     // Event label.

&promoa=click                         // Promotion action (click). Required.
&promo1id=PROMO_1234                  // Promotion 1 ID. Either ID or name must be set.
&promo1nm=Summer%20Sale               // Promotion 1 name. Either ID or name must be set.
&promo1cr=summer_banner2              // Promotion Creative.
&promo1ps=banner_slot1                // Promotion Position.
    

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

전자상거래 추적

전자상거래 데이터를 전송하려면 transaction 거래를 1회 전송하여 전체 거래를 표시한 다음 거래의 각 상품에 item 조회를 전송합니다. 거래 ID ti는 전체 구매를 나타내기 위해 모든 조회를 연결합니다.

거래 조회수

v=1               // Version.
&tid=UA-XXXXX-Y   // Tracking ID / Property ID.
&cid=555          // Anonymous Client ID.

&t=transaction    // Transaction hit type.
&ti=12345         // transaction ID. Required.
&ta=westernWear   // Transaction affiliation.
&tr=50.00         // Transaction revenue.
&ts=32.00         // Transaction shipping.
&tt=12.00         // Transaction tax.
&cu=EUR           // Currency code.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

항목 조회수

v=1               // Version.
&tid=UA-XXXXX-Y   // Tracking ID / Property ID.
&cid=555          // Anonymous Client ID.

&t=item           // Item hit type.
&ti=12345         // Transaction ID. Required.
&in=sofa          // Item name. Required.
&ip=300           // Item price.
&iq=2             // Item quantity.
&ic=u3eqds43      // Item code / SKU.
&iv=furniture     // Item variation / category.
&cu=EUR           // Currency code.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

소셜 상호작용

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=social        // Social hit type.
&sa=like         // Social Action. Required.
&sn=facebook     // Social Network. Required.
&st=/home        // Social Target. Required.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

예외 추적

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=exception       // Exception hit type.
&exd=IOException   // Exception description.
&exf=1             // Exception is fatal?

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

사용자 시간 추적

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=timing        // Timing hit type.
&utc=jsonLoader  // Timing category.
&utv=load        // Timing variable.
&utt=5000        // Timing time.
&utl=jQuery      // Timing label.

 // These values are part of browser load times

&dns=100         // DNS load time.
&pdt=20          // Page download time.
&rrt=32          // Redirect time.
&tcp=56          // TCP connect time.
&srt=12          // Server response time.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

앱 / 화면 추적

v=1                         // Version.
&tid=UA-XXXXX-Y             // Tracking ID / Property ID.
&cid=555                    // Anonymous Client ID.

&t=screenview               // Screenview hit type.
&an=funTimes                // App name.
&av=1.5.0                   // App version.
&aid=com.foo.App            // App Id.
&aiid=com.android.vending   // App Installer Id.

&cd=Home                    // Screen name / content description.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.

프록시 서버 사용

일부 환경은 조회를 Google 애널리틱스로 직접 전송할 수 없습니다. 예를 들어 방화벽으로 보호되는 자바스크립트나 기업 인트라넷을 실행할 수 없는 구형 휴대전화가 이에 해당합니다. 이러한 경우 프록시 서버로 요청을 보낸 다음, 측정 프로토콜을 사용하여 조회를 Google 애널리틱스로 전달하는 것이 일반적입니다.

프록시 서버가 아닌 클라이언트 기기에서 IP와 사용자 에이전트를 수집하려면 측정 프로토콜에 두 값을 지정하면 됩니다. 그러면 Google 애널리틱스에서 일반적으로 요청 헤더에서 가져오는 값이 재정의됩니다.

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.

&t=pageview      // Pageview hit type.
&uip=1.2.3.4     // IP address override.
&ua=Opera/9.80   // User agent override.

이 조회는 측정 프로토콜 조회 빌더에서 확인하세요.