Làm việc với Measurement Protocol

Tài liệu này mô tả cách gửi các lượt truy cập phổ biến tới Measurement Protocol.

Tổng quan

Tài liệu này minh hoạ cách định dạng các yêu cầu HTTP để gửi các loại lượt truy cập phổ biến đến Measurement Protocol của Google Analytics. Hãy đọc:

Gửi giá trị bắt buộc

Để gửi dữ liệu tương tác của người dùng, hãy tạo một yêu cầu POST HTTP đến điểm cuối này.

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

payload_data

Các tham số sau đây là bắt buộc đối với mỗi tải trọng:

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

Mỗi tải trọng phải chứa một loại lượt truy cập hợp lệ và mỗi loại lượt truy cập có một tập hợp các trường bắt buộc riêng. Vì vậy, để gửi lượt xem trang cho trang /home, bạn sẽ sử dụng tải trọng sau:

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

Các phần dưới đây đưa ra ví dụ về các loại lượt truy cập phổ biến.

Gộp nhiều lượt truy cập trong một yêu cầu

Để gửi nhiều lượt truy cập trong một yêu cầu, hãy sử dụng điểm cuối /batch thay vì /collect và chỉ định mỗi tải trọng trên một dòng riêng.

Ví dụ: để gửi số lượt xem trang cho các trang "Trang chủ", "Giới thiệu về chúng tôi" và "Liên hệ" của một trang web, bạn có thể gửi yêu cầu theo lô sau đây.

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

Giới hạn về lô

Ngoài các hạn chế tiêu chuẩn về lượt truy cập trên Measurement Protocol, các yêu cầu hàng loạt còn có các hạn chế khác như sau:

  • Bạn có thể chỉ định tối đa 20 lượt truy cập cho mỗi yêu cầu.
  • Tổng kích thước của tất cả tải trọng lượt truy cập không được lớn hơn 16 nghìn byte.
  • Không có tải trọng lượt truy cập nào có thể lớn hơn 8 nghìn byte.

Gửi loại lượt truy cập phổ biến

Dưới đây là ví dụ về cách gửi các loại lượt truy cập phổ biến đến Google Analytics. Ngoài những ví dụ này, bạn có thể kết hợp và so khớp nhiều tham số để có được các mối quan hệ mới về dữ liệu. Ví dụ: để biết một sự kiện đã xảy ra trên trang nào, hãy gửi thông số pagePath, p, cùng với các thông số theo dõi sự kiện như mô tả bên dưới.

Đọc tài liệu tham khảo về thông số để biết danh sách đầy đủ tất cả các thông số mà bạn có thể gửi đến Google Analytics.

Theo dõi trang

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi sự kiện

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi thương mại điện tử nâng cao

Bạn nên sử dụng lượt truy cập Thương mại điện tử nâng cao thay cho lượt truy cập Thương mại điện tử . Nếu bạn đã triển khai tính năng Theo dõi thương mại điện tử và muốn bắt đầu sử dụng tính năng Theo dõi thương mại điện tử nâng cao, bạn có 2 lựa chọn:

Sử dụng tài sản mới

Bạn có thể tạo thuộc tính mới và gửi lượt truy cập Thương mại điện tử nâng cao đến thuộc tính mới.

Di chuyển tài sản hiện có

Di chuyển bất kỳ lượt truy cập Thương mại điện tử nào sang lượt truy cập Thương mại điện tử nâng cao, theo các ví dụ bên dưới. Dữ liệu giao dịch và mặt hàng đã thu thập trước đây bằng các lượt truy cập Thương mại điện tử sẽ không bị ảnh hưởng và vẫn có sẵn trong các tài sản và chế độ xem mà ban đầu chúng được gửi đến.

Đo lường số lượt hiển thị

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Hành động đo

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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Kết hợp lượt hiển thị và hành động

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.
   

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Đo lường giao dịch mua hàng

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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Đo lường khoản tiền hoàn lại

Nếu cần gửi dữ liệu hoàn tiền thông qua một sự kiện và sự kiện đó không thuộc hành vi được đo lường bình thường trên trang web (tức là không phải do người dùng khởi tạo), thì bạn nên gửi sự kiện không tương tác. Việc này sẽ ngăn sự kiện này ảnh hưởng đến các chỉ số như tỷ lệ thoát, thời lượng phiên, v. v.

 // 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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

 // 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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Đo lường quy trình thanh toán

1. Đo lường các bước thanh toán
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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

2. Đo lường các tuỳ chọn thanh toán
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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Đo lường quảng cáo nội bộ

Số lượt hiển thị quảng cáo
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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Số nhấp chuột vào quảng cáo
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.
    

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi thương mại điện tử

Để gửi dữ liệu thương mại điện tử, hãy gửi một lượt truy cập transaction để đại diện cho toàn bộ giao dịch, sau đó gửi một lượt truy cập item cho từng mục trong giao dịch. Mã giao dịch ti liên kết tất cả các lượt truy cập với nhau để thể hiện toàn bộ giao dịch mua.

Lượt truy cập giao dịch

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Lượt truy cập mục

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Tương tác trên mạng xã hội

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi ngoại lệ

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?

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi thời gian người dùng

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Theo dõi ứng dụng / màn hình

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.

Sử dụng máy chủ proxy

Một số môi trường không thể gửi lượt truy cập trực tiếp đến Google Analytics. Ví dụ về trường hợp này là các điện thoại di động đời cũ không thể chạy JavaScript hoặc mạng nội bộ của công ty sau tường lửa. Trong những trường hợp này, bạn nên gửi yêu cầu đến một máy chủ proxy. Sau đó, máy chủ proxy sẽ sử dụng Measurement Protocol để chuyển tiếp các lượt truy cập đến Google Analytics.

Để thu thập IP và tác nhân người dùng từ thiết bị khách chứ không phải máy chủ proxy, bạn có thể chỉ định cả hai giá trị trong Measurement Protocol và các giá trị này sẽ ghi đè các giá trị mà Google Analytics thường lấy từ các tiêu đề của yêu cầu.

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.

Xem lượt truy cập này trong Trình tạo lượt truy cập Measurement Protocol.