In diesem Dokument wird beschrieben, wie häufige Treffer an das Measurement Protocol gesendet werden.
Überblick
In diesem Dokument wird erläutert, wie HTTP-Anfragen formatiert werden, um häufige Treffertypen an das Measurement Protocol von Google Analytics zu senden. Lesen Sie die folgenden Informationen:
- Protokollreferenz – eine vollständige Beschreibung der Formatierung von Protokollanfragen.
- Parameterreferenz: Eine Liste aller vom Protokoll akzeptierten Parameter.
Erforderliche Werte senden
Wenn Sie Nutzerinteraktionsdaten senden möchten, stellen Sie eine HTTP-POST-Anfrage an diesen Endpunkt.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
Die folgenden Parameter sind für jede Nutzlast erforderlich:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
Jede Nutzlast muss einen gültigen Treffertyp enthalten und jeder Treffertyp hat seine eigenen Pflichtfelder. Um also einen Seitenaufruf für die Seite /home zu senden, verwenden Sie die folgende Nutzlast:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
In den folgenden Abschnitten finden Sie Beispiele für häufige Treffertypen.
Mehrere Treffer in einer einzigen Anfrage zusammenfassen
Wenn Sie mehrere Treffer in einer einzelnen Anfrage senden möchten, verwenden Sie den Endpunkt /batch anstelle von /collect und geben Sie jede Nutzlast in einer eigenen Zeile an.
Wenn Sie beispielsweise Seitenaufruftreffer für die Startseiten-, „Über uns“- und „Kontakt“-Seiten einer Website senden möchten, können Sie die folgende Batchanfrage senden.
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
Batcheinschränkungen
Neben den standardmäßigen Einschränkungen für Measurement Protocol-Treffer gelten für Batchanfragen die folgenden zusätzlichen Einschränkungen:
- Pro Anfrage können maximal 20 Treffer angegeben werden.
- Die Gesamtgröße aller Treffernutzlasten darf 16.000 Byte nicht überschreiten.
- Die Nutzlast eines einzelnen Treffers darf nicht größer als 8.000 Byte sein.
Häufige Treffertypen senden
Nachfolgend finden Sie Beispiele dafür, wie häufige Treffertypen an Google Analytics gesendet werden.
Abgesehen von diesen Beispielen können Sie verschiedene Parameter kombinieren und abgleichen, um neue Datenbeziehungen zu erhalten. Wenn Sie beispielsweise wissen möchten, auf welcher Seite ein Ereignis aufgetreten ist, senden Sie den pagePath-Parameter p zusammen mit den Ereignis-Tracking-Parametern wie unten beschrieben.
In der Parameterreferenz finden Sie eine vollständige Liste aller Parameter, die Sie an Google Analytics senden können.
Seiten-Tracking
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Ereignis-Tracking
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Erweitertes E-Commerce-Tracking
Anstelle von E-Commerce-Treffern sollten erweiterte E-Commerce-Treffer verwendet werden. Wenn Sie E-Commerce-Tracking bereits implementiert haben und das erweiterte E-Commerce-Tracking nutzen möchten, haben Sie zwei Möglichkeiten:
Neue Property verwenden
Sie können eine neue Property erstellen und erweiterte E-Commerce-Treffer an die neue Property senden.
Vorhandene Property migrieren
Migrieren Sie anhand der folgenden Beispiele alle E-Commerce-Treffer zu erweiterten E-Commerce-Treffern. Transaktions- und Artikeldaten, die zuvor mithilfe von E-Commerce-Treffern erhoben wurden, sind davon nicht betroffen und bleiben in den Properties und Datenansichten verfügbar, an die sie ursprünglich gesendet wurden.
Impressionen messen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Aktionen messen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Impressionen und Aktionen kombinieren
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Käufe messen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Analysieren von Erstattungen
Wenn Sie Erstattungsdaten mithilfe eines Ereignisses senden müssen und das Ereignis nicht Teil des normal gemessenen Verhaltens auf der Website ist (d.h. nicht vom Nutzer initiiert), empfehlen wir, ein Ereignis ohne Interaktion zu senden. Dadurch wird verhindert, dass Messwerte wie die Absprungrate und die Sitzungsdauer durch das Ereignis beeinflusst werden.
// 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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
// 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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Messen des Bezahlvorgangs
1. Schritte für den Bezahlvorgang messen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
2. Analysieren der Zahlungs- und Versandoptionen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Interne Werbung messen
Impressionen der Werbung
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Klicks auf die Werbung
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
E-Commerce-Tracking
Zum Senden von E-Commerce-Daten muss ein transaction-Treffer für eine ganze Transaktion gesendet werden. Anschließend wird für jeden Artikel in der Transaktion ein item-Treffer gesendet. Die Transaktions-ID ti verknüpft alle Treffer miteinander, um den gesamten Kauf darzustellen.
Transaktionstreffer
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Elementtreffer
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Soziale Interaktionen
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Ausnahmenverfolgung
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?
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Tracking des Nutzertimings
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
App-/Bildschirm-Tracking
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.
Proxyserver verwenden
In einigen Umgebungen können Treffer nicht direkt an Google Analytics gesendet werden. Beispiele dafür sind ältere Smartphones, auf denen JavaScript oder Unternehmens-Intranets nicht hinter einer Firewall ausgeführt werden können. In diesen Fällen werden Anfragen üblicherweise an einen Proxyserver gesendet, der die Treffer dann mithilfe des Measurement Protocol an Google Analytics weiterleitet.
Wenn Sie die IP-Adresse und den User-Agent vom Clientgerät und nicht vom Proxyserver erfassen möchten, können Sie beide Werte im Measurement Protocol angeben. Diese überschreiben dann die Werte, die Google Analytics normalerweise aus den Anfrageheadern erhält.
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.
Sie können sich diesen Treffer im Measurement Protocol Hit Builder ansehen.