Diese Dokumentation gilt für Universal Analytics. Measurement Protocol (Google Analytics 4) bei Verwendung von Google Analytics 4

Mit dem Measurement Protocol arbeiten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

In diesem Dokument wird beschrieben, wie häufig verwendete Treffer an das Measurement Protocol gesendet werden.

Übersicht

In diesem Dokument wird gezeigt, wie HTTP-Anfragen so formatiert werden, dass gängige Treffertypen an das Measurement Protocol von Google Analytics gesendet werden. Lesen:

  • Protokollreferenz: Eine vollständige Beschreibung der Formatierung von Protokollanfragen.
  • Parameterverweis: Eine Liste aller vom Protokoll akzeptierten Parameter.

Erforderliche Werte werden gesendet

Senden Sie eine HTTP-POST-Anfrage an diesen Endpunkt, um Daten zu Nutzerinteraktionen zu senden.

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

payload_data

Für jede Nutzlast sind die folgenden Parameter 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 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

Die folgenden Abschnitte enthalten Beispiele für häufig verwendete Treffertypen.

Mehrere Treffer in einer 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 Treffer für Seitenaufrufe für die Seiten „Über uns“ und „Über uns“ und für „Kontakt“ 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

Batch-Einschränkungen

Neben den standardmäßigen Einschränkungen von Measurement Protocol-Treffern bestehen für Batchanfragen folgende zusätzliche Einschränkungen:

  • Pro Anfrage können maximal 20 Treffer angegeben werden.
  • Die Gesamtgröße aller Treffernutzlasten darf 16.000 Byte nicht überschreiten.
  • Eine einzelne Treffernutzlast darf nicht größer als 8.000 Byte sein.

Häufige Treffertypen senden

Unten sehen Sie, wie gängige Treffertypen an Google Analytics gesendet werden. Neben diesen Beispielen können Sie verschiedene Parameter mischen und abgleichen, um neue Datenbeziehungen zu schaffen. Wenn Sie beispielsweise wissen möchten, auf welcher Seite ein Ereignis aufgetreten ist, senden Sie den Parameter „pagePath“ 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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Erweitertes E-Commerce-Tracking

Statt E-Commerce-Treffer sollten erweiterte E-Commerce-Treffer 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 erweiterte E-Commerce-Treffer an die neue Property senden.

Vorhandene Property migrieren

Migrieren Sie alle E-Commerce-Treffer anhand der folgenden Beispiele zu erweiterten E-Commerce-Treffern. Transaktions- und Artikeldaten, die zuvor mit E-Commerce-Treffern erfasst wurden, sind davon nicht betroffen und weiterhin 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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.
    

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.
   

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Käufe analysieren

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.
    

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Rückerstattungen messen

Wenn Sie Erstattungsdaten über ein Ereignis senden müssen und dieses Ereignis nicht Teil des normalerweise gemessenen Verhaltens der Website ist (d.h. nicht vom Nutzer initiiert), sollten Sie ein Ereignis vom Typ ohne Interaktion senden. Dadurch wird verhindert, dass Messwerte wie Absprungrate, Sitzungsdauer usw. vom Ereignis betroffen sind.

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

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Bezahlvorgang analysieren

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

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

2. Kassenoptionen analysieren
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.
    

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.
    

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.
    

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

E-Commerce-Tracking

Zum Senden von E-Commerce-Daten senden Sie einen transaction-Treffer für eine komplette Transaktion und senden dann einen item-Treffer für jedes Element in der Transaktion. Die Transaktions-ID ti verknüpft alle Treffer und stellt den gesamten Kauf dar.

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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Artikeltreffer

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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Ausnahmeverfolgung

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?

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

Tracking von 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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.

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 unternehmensinterne Intranets hinter einer Firewall nicht ausgeführt werden können. In diesem Fall werden Anfragen in der Regel an einen Proxyserver gesendet, der die Treffer dann mit dem Measurement Protocol an Google Analytics weiterleitet.

Wenn du die IP-Adresse und den User-Agent vom Clientgerät und nicht vom Proxyserver erfassen möchtest, kannst du 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.

Sehen Sie sich diesen Treffer im Measurement Protocol Hit Builder an.