Mit dem Measurement Protocol arbeiten

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 gängige Treffertypen an das Measurement Protocol von Google Analytics zu senden. Lesen Sie die folgenden Informationen:

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.

Batch-Verarbeitung mehrerer Treffer in einer einzelnen Anfrage

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 Kontaktseiten 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 von Measurement Protocol-Treffern 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

Im Folgenden finden Sie Beispiele dafür, wie gängige Treffertypen an Google Analytics gesendet werden. Neben 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.

Diesen Treffer können Sie sich 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.

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

Erweitertes E-Commerce-Tracking

Erweiterte E-Commerce-Treffer sollten anstelle von E-Commerce-Treffern verwendet werden. Wenn Sie E-Commerce-Tracking bereits implementiert haben und erweitertes E-Commerce-Tracking verwenden möchten, haben Sie zwei Möglichkeiten:

Neue Property verwenden

Sie können eine neue Property erstellen und Treffer für erweiterte E-Commerce-Berichte an diese 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 erfasst wurden, sind davon nicht betroffen und bleiben in den Properties und Datenansichten verfügbar, an die sie ursprünglich gesendet wurden.

Messen von Impressionen

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.

Diesen Treffer können Sie sich 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.
    

Diesen Treffer können Sie sich 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.
   

Diesen Treffer können Sie sich 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.
    

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

Erfassen von Erstattungen

Wenn Sie Erstattungsdaten mithilfe eines Ereignisses senden müssen und das Ereignis nicht Teil des normalerweise gemessenen Verhaltens auf der Website ist (d.h. nicht vom Nutzer initiiert), wird empfohlen, 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.
    

Diesen Treffer können Sie sich 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.
    

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

Messen des Bezahlvorgangs

1. Bezahlvorgang-Schritte 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.
    

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

2. Bezahlvorgang-Optionen messen
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.
    

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

Interne Werbung messen

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

Diesen Treffer können Sie sich 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.
    

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

E-Commerce-Tracking

Wenn Sie E-Commerce-Daten senden möchten, senden Sie einen transaction-Treffer für eine vollständige Transaktion. Senden Sie dann einen item-Treffer für jeden Artikel in der Transaktion. 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.

Diesen Treffer können Sie sich 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.

Diesen Treffer können Sie sich 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.

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.

Ausnahmen-Tracking

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?

Diesen Treffer können Sie sich 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.

Diesen Treffer können Sie sich 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.

Diesen Treffer können Sie sich 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. Dadurch werden die Werte überschrieben, 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.

Diesen Treffer können Sie sich im Measurement Protocol Hit Builder ansehen.