Tài liệu này mô tả cách gửi các lượt truy cập phổ biến đến 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:
- Tài liệu tham khảo về giao thức – nội dung mô tả đầy đủ về cách định dạng các yêu cầu Giao thức.
- Tham khảo tham số – danh sách tất cả các thông số được Giao thức chấp nhận.
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 gửi yêu cầu POST qua 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ó
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 cung cấp ví dụ về các loại lượt truy cập phổ biến.
Tạo 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à "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 theo lô
Ngoài các giới hạn tiêu chuẩn đối với lượt truy cập trên Measurement Protocol, yêu cầu theo lô có các giới hạn bổ sung 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ả cá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 các 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.
Hãy đọc tài liệu tham khảo về thông số để biết danh sách đầy đủ tất cả những 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ó hai lựa chọn sau:
Sử dụng một 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ó
Hãy 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 về giao dịch và mặt hàng được thu thập trước đây bằng lượt truy cập Thương mại điện tử sẽ không bị ảnh hưởng và sẽ 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 lườ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=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 số 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 do người dùng thực hiện), thì bạn nên gửi sự kiện không tương tác. Khi đó, sự kiện sẽ không ả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 để
thể hiện 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 hàng.
Lượt 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 trực tiếp lượt truy cập đến Google Analytics. Ví dụ: điện thoại di động 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 thường gửi yêu cầu đến một máy chủ proxy. Sau đó, máy chủ này 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. 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.