Z tego dokumentu dowiesz się, jak przesyłać typowe działania do platformy Measurement Protocol.
Przegląd
Z tego dokumentu dowiesz się, jak formatować żądania HTTP, by wysyłać typowe rodzaje działań do platformy Google Analytics Measurement Protocol. Przeczytaj:
- Dokumentacja protokołu – pełny opis formatowania żądań protokołu.
- Parametr referencyjny – lista wszystkich parametrów akceptowanych przez protokół.
Wysyłanie wymaganych wartości
Aby wysłać dane o interakcji użytkownika, wyślij żądanie HTTP POST do tego punktu końcowego.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
Dla każdego ładunku wymagane są te parametry:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
Każdy ładunek musi zawierać prawidłowy typ działania, a każdy typ działania ma własny zestaw wymaganych pól. Aby wysłać odsłonę /home
, musisz użyć tego ładunku:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
W sekcjach poniżej znajdziesz przykłady typowych rodzajów działań.
Grupowanie wielu działań w jednym żądaniu
Aby wysłać wiele działań w jednym żądaniu, użyj punktu końcowego /batch
zamiast /collect
i określ każdy ładunek w osobnym wierszu.
Aby np. przesyłać działania związane z odsłoną stron dla stron „Strona główna”, „O nas” i „Kontakt” w witrynie, możesz przesłać następujące żądanie zbiorcze.
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
Ograniczenia wsadu
Oprócz standardowych ograniczeń działań Measurement Protocol żądania zbiorcze mają te dodatkowe ograniczenia:
- W żądaniu można określić maksymalnie 20 działań.
- Łączny rozmiar wszystkich ładunków działań nie może przekraczać 16 tys. bajtów.
- Żaden ładunek w postaci pojedynczego działania nie może być większy niż 8 tys. bajtów.
Wysyłanie częstych typów działań
Poniżej znajdziesz przykłady przesyłania typowych rodzajów działań do Google Analytics.
Poza tymi przykładami możesz mieszać i dopasowywać różne parametry, aby tworzyć nowe relacje oparte na danych. Aby np. dowiedzieć się, na której stronie wystąpiło zdarzenie, wyślij parametr pagePath (p
) razem z parametrami śledzenia zdarzeń zgodnie z poniższym opisem.
Pełną listę wszystkich parametrów, które możesz przesyłać do Google Analytics, znajdziesz w dokumentacji parametrów.
Śledzenie strony
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie zdarzeń
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie Ulepszonego e-commerce
Zamiast działań e-commerce należy używać działań Ulepszonego e-commerce. Jeśli masz już zaimplementowane śledzenie e-commerce i chcesz zacząć korzystać ze śledzenia Ulepszonego e-commerce, masz 2 możliwości:
Użyj nowej usługi
Możesz utworzyć nową usługę i wysyłać do niej działania ulepszonego e-commerce.
Migracja istniejącej usługi
Przenieś wszystkie działania e-commerce do działań Ulepszonego e-commerce zgodnie z poniższymi przykładami. Nie będzie to miało wpływu na dane o transakcjach i produktach zebrane wcześniej za pomocą działań e-commerce. Będą one nadal dostępne w usługach i widokach, do których zostały pierwotnie wysłane.
Pomiar wyświetleń
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Pomiary działań
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Łączenie wyświetleń i działań
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Mierzenie zakupów
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Pomiar zwrotów
Jeśli chcesz wysyłać dane o zwrotach środków za pomocą zdarzenia, które nie jest częścią normalnie mierzonego zachowania w witrynie (tj. nie jest inicjowane przez użytkownika), zalecamy wysyłanie zdarzenia bez interakcji. Dzięki temu zdarzenie nie będzie miało wpływu na dane takie jak współczynnik odrzuceń, czas trwania sesji itp.
// 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.
Zobacz to działanie w Kreatorze działań 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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Pomiary procesu płatności
1. Pomiary kroków procesu płatności
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
2. Pomiar opcji realizacji transakcji
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Pomiary reklam wewnętrznych
Wyświetlenia promocji
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Kliknięcia promocji
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie e-commerce
Aby wysłać dane e-commerce, wyślij jedno działanie transaction
, które będzie reprezentować całą transakcję, a następnie wyślij działanie item
dla każdego elementu w transakcji. Identyfikator transakcji ti
łączy wszystkie działania, aby reprezentować cały zakup.
Działanie w ramach transakcji
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Działanie związane z produktem
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Interakcje społecznościowe
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie wyjątków
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?
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie czasu działań użytkowników
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Śledzenie aplikacji / ekranu
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.
Korzystanie z serwera proxy
Niektóre środowiska nie mogą wysyłać działań bezpośrednio do Google Analytics. Przykładami są starsze telefony komórkowe, na których nie można uruchamiać JavaScriptu ani firmowych intranetów za zaporą sieciową. W takich przypadkach często jest wysyłane żądania do serwera proxy, który następnie za pomocą Measurement Protocol przekazuje działania do Google Analytics.
Aby pobierać adresy IP i klienta użytkownika z urządzenia klienckiego, a nie z serwera proxy, możesz określić obie wartości w usłudze Measurement Protocol. Zastąpią one wartości, które Google Analytics zwykle otrzymuje z nagłówków żądań.
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.
Zobacz to działanie w Kreatorze działań Measurement Protocol.