Änderungsprotokoll der Google Analytics Core Reporting API

Wir aktualisieren regelmäßig die Core Reporting API von Google Analytics, um neue Funktionen bereitzustellen und Fehler aus früheren Versionen zu beheben. In den meisten Fällen sind diese Änderungen für API-Entwickler transparent. Gelegentlich müssen wir jedoch Änderungen vornehmen, bei denen Entwickler ihre vorhandenen Anwendungen ändern müssen.

Auf dieser Seite werden alle Änderungen dokumentiert, die an der Google Analytics Core Reporting API vorgenommen werden und sich auf Ihre Anwendung auswirken können. Wir empfehlen API-Entwicklern, diese Liste regelmäßig auf neue Ankündigungen zu prüfen. Änderungen können Sie auch über die unten im Abschnitt Abonnieren aufgeführten Feeds abschließen.

Zugehörige Änderungsprotokolle abonnieren

Umfasst alle APIs für die Erfassung, Konfiguration und Berichterstellung.

Umfasst die Core Reporting API, die Multi-Channel Trichter Reporting API und die Real Time Reporting API.

Dies ist die erste Version der User Activity API

  • Mit der User Activity API können Sie alle Daten abrufen, die mit einer einzelnen Client-ID oder User-ID in einem bestimmten Zeitraum verknüpft sind. Sie ist in erster Linie für Property-Inhaber vorgesehen, die dem Nutzer direkt automatischen Zugriff auf die Daten eines Nutzers gewähren möchten. Weitere Informationen finden Sie im Leitfaden zur User Activity API.

In diesem Release wird die maximale Anzahl der Zeilen erhöht, die im Ergebnisbericht der Analytics Reporting API Version 4 zurückgegeben werden.

Die maximale Anzahl von Zeilen,die im Data Reporting API v4 ReportData-Objekt zurückgegeben werden,wurde von 10.000 auf 100.000 erhöht.

In dieser Version wird eine Vorschau des ressourcenbasierten Kontingentsystems für die Google Analytics Reporting API Version 4 hinzugefügt, wodurch für Analytics 360-Kunden (Premium) höhere Schwellenwerte für die Stichprobenerhebung verwendet werden können.

In diesem Release wird die Funktion Ähnliche Produkte und die zugehörigen Dimensionen und Messwerte eingestellt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

In diesem Release werden die folgenden Dimensionen und Messwerte eingestellt:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

In diesem Release wird der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten. In dieser Version wurden auch einige veraltete Dimensionen und Messwerte entfernt. In der Richtlinie zur Einstellung von Daten für Google Analytics APIs erfahren Sie mehr über den vollständigen Prozess der Datenentfernung.

Zeit

  • Neue Dimension ga:dateHourMinute, die ga:date, ga:hour und ga:minute kombiniert.

Datenentfernung

In diesem Release werden die folgenden eingestellten Dimensionen und Messwerte entfernt:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

In diesem Release werden vorhandene Messwerte und Dimensionen in der API aktualisiert. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Nutzermesswerte

Die Berechnung der Messwerte Nutzer und Aktive Nutzer wurde aktualisiert, um Nutzer effizienter zu erfassen. Möglicherweise ändern sich deine Messwerte geringfügig. Weitere Informationen finden Sie unter So werden Nutzer für Nutzermesswerte identifiziert.

Von der Aktualisierung betroffene Nutzermesswerte:

  • ga:users: Die Gesamtzahl der Nutzer im angeforderten Zeitraum.
  • ga:1dayusers: Gesamtzahl der in den letzten 24 Stunden aktiven Nutzer pro Tag im angeforderten Zeitraum.
  • ga:7dayusers: Gesamtzahl der in den letzten 7 Tagen aktiven Nutzer pro Tag im angeforderten Zeitraum.
  • ga:14dayusers: Gesamtzahl der in den letzten 24 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum.
  • ga:30dayusers: Gesamtzahl der in den letzten 30 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum.

Einzelne Ereignisse

Das Ende des Einstellungszeitraums für ga:uniqueEvents wird demnächst erreicht. Nach dem 26. März 2017 wird die Definition für ga:uniqueEvents aktualisiert und der private Messwert ga:uniqueEventsTemporary aus der API entfernt. Weitere Informationen finden Sie in den Hilfeartikeln zu eindeutigen Ereignissen.

In diesem Release wird die API um eine neue Dimension erweitert, Fehlermeldungen werden verbessert und die zuvor angekündigten Änderungen für AdSense-Dimensionen und -Messwerte werden erzwungen.

Nutzerdimensionen

  • Dimension: ga:userBucket – Die Dimension „Nutzer-Bucket“ (Werte von 1 bis 100) gibt für jeden Nutzer den Bucket an, dem der Nutzer zugewiesen ist. Weitere Informationen erhalten Sie im Artikel Remarketing-Kampagnen testen.

Fehlermeldungen

Wenn die API bei der Anforderung von Daten mit nicht erfüllten Bedingungen eine fehlerhafte Fehlermeldung (Unknown dimension(s): oder Unknown metric(s):) zurückgibt, gibt die API jetzt die folgende Meldung zurück: Restricted metric(s): ... can only be queried under certain conditions..

AdSense-Dimensionen und -Messwerte

Datenansichten, die nicht mit AdSense verknüpft sind, können nicht nach AdSense-Dimensionen und -Messwerten abgefragt werden. Wenn Sie diese Dimensionen und Messwerte mit nicht mit AdSense verknüpften Datenansichten abfragen, wird ein Fehler ausgegeben.

Es handelt sich um eine Fehlerkorrektur, durch die ein Problem mit AdSense-Dimensionen und -Messwerten behoben und eine bevorstehende Änderung dieser Dimensionen und Messwerte angekündigt wird.

AdSense-Dimensionen und -Messwerte

In dieser Version wurde ein Problem behoben, das am 07.01.2017 begann. Bei Abfragen nach AdSense-Dimensionen und -Messwerten wurde für nicht mit AdSense verknüpfte Datenansichten ein Fehler vom Typ „Unbekannter Messwert“ zurückgegeben.

Bevorstehende Änderungen

Ab dem 31.01.2017 sind für Datenansichten, die nicht mit AdSense verknüpft sind, keine Abfragen nach AdSense-Dimensionen und -Messwerten möglich. Wenn Sie diese Dimensionen und Messwerte mit nicht mit AdSense verknüpften Datenansichten abfragen, wird ein Fehler ausgegeben.

In diesem Release wird der API der folgende neue Messwert hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Berechnete Messwerte

In diesem Release werden berechnete Messwerte unterstützt.

  • Messwert – ga:calcMetric_ – der Wert des angeforderten berechneten Messwerts, wobei sich auf den benutzerdefinierten Namen des berechneten Messwerts bezieht Der Datentyp von ga:calcMetric_ kann FLOAT, INTEGER, currency, TIME oder PERCENT sein. Weitere Informationen finden Sie unter Berechnete Messwerte.

In diesem Release wird der API ein neuer Messwert hinzugefügt. Außerdem wird der bestehende Messwert eingestellt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Ereignis-Tracking

Die Definition von ga:uniqueEvents wird geändert, um die Anzahl der eindeutigen Ereignisse genauer widerzuspiegeln. Aufgrund dieser Änderung wird der aktuelle Messwert „ga:uniqueEvents“ gemäß unserer Richtlinie zur Einstellung von Daten technisch eingestellt. Wenn Sie die neue Definition ausprobieren möchten, können Sie auf den privaten Messwert ga:uniqueEventsTemporary verweisen, der die Anzahl der eindeutigen Ereignisse genauer berechnet. Außerdem führen wir einen neuen Messwert ga:uniqueDimensionCombinations ein, der die aktuelle Definition von ga:uniqueEvents beibehält. Nach Ablauf des Zeitraums von etwa sechs Monaten wird der private Messwert ga:uniqueEventsTemporary entfernt und der ursprüngliche Messwert ga:uniqueEvents entspricht der Anzahl der einzelnen Ereignisse. Weitere Informationen finden Sie in den Hilfeartikeln zu eindeutigen Ereignissen.

Einzelne Ereignisse

  • Messwert: ga:uniqueEvents. Die Definition von ga:uniqueEvents wird bald geändert, um die Anzahl der eindeutigen Ereignisse genauer widerzuspiegeln. Verwenden Sie stattdessen ga:uniqueDimensionCombinations, wenn Sie die vorhandene Definition beibehalten möchten. Weitere Informationen finden Sie in den Hilfeartikeln zu eindeutigen Ereignissen.
  • Messwert – ga:uniqueDimensionCombinations – Kombinationen eindeutiger Dimensionen – Anzahl der eindeutigen Kombinationen aus Dimensionswerten für jede Dimension in einem Bericht. Dadurch haben Sie die Möglichkeit, eine kombinierte (zusammengefasste) Nachverarbeitung von Dimensionen einzurichten. So haben Sie größere Flexibilität bei der Berichterstellung, ohne dass Sie die Tracking-Implementierung aktualisieren oder zusätzliche Slots für benutzerdefinierte Dimensionen verwenden müssen. Weitere Informationen finden Sie in den Hilfeartikeln zu eindeutigen Ereignissen.

Übergangstests – privat

  • Messwert: ga:uniqueEventsTemporary – die Anzahl der eindeutigen Ereignisse; dies ist die neue Definition für ga:uniqueEvents. Mit diesem Messwert können Sie die neue Definition vor der Änderung nachvollziehen. Dieser Messwert ist privat und wird nicht in der Referenz zu Dimensionen und Messwerten angezeigt.

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

DoubleClick Bid Manager

  • Dimension: ga:dbmClickAdvertiser – der Name des DBM-Werbetreibenden für den DBM-Klick, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension – ga:dbmClickAdvertiserId – DBM-Werbetreibenden-ID des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmClickCreativeId – DBM-Creative-ID des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360, Integration mit DBM erforderlich)
  • Dimension: ga:dbmClickExchange – Name der DBM-Anzeigenplattform des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmClickExchangeId – ID der DBM-Anzeigenplattform des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmClickInsertionOrder – Der Name des DBM-Anzeigenauftrags für den DBM-Klick, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension – ga:dbmClickInsertionOrderId – ID des DBM-Anzeigenauftrags für den DBM-Klick, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension – ga:dbmClickLineItem – Der Name der DBM-Werbebuchung des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension – ga:dbmClickLineItemId – DBM-Werbebuchungs-ID des DBM-Klicks, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmClickSite – Name der DBM-Website, auf der das DBM-Creative zu sehen war und auf das für den DBM-Klick geklickt wurde, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmClickSiteId – ID der DBM-Website, auf der das DBM-Creative zu sehen war und auf das für den DBM-Klick geklickt wurde, der der Google Analytics-Sitzung entspricht (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmLastEventAdvertiser – Der Name des DBM-Werbetreibenden des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmLastEventAdvertiserId – DBM-Werbetreibenden-ID des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration in DBM)
  • Dimension: ga:dbmLastEventCreativeId – DBM-Creative-ID des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension: ga:dbmLastEventExchange – Name der DBM-Anzeigenplattform des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration in DBM)
  • Dimension: ga:dbmLastEventExchangeId – ID der DBM-Anzeigenplattform des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360; Integration in DBM erforderlich)
  • Dimension – ga:dbmLastEventInsertionOrder – Name des DBM-Anzeigenauftrags des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration mit DBM)
  • Dimension – ga:dbmLastEventInsertionOrderId – ID des DBM-Anzeigenauftrags des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration mit DBM)
  • Dimension: ga:dbmLastEventLineItem – Der Name der DBM-Werbebuchung des letzten DBM-Ereignisses (Impression oder Klick innerhalb des DBM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration mit DBM)
  • Dimension: ga:dbmLastEventLineItemId – ID der DBM-Werbebuchung des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration in DBM)
  • Dimension: ga:dbmLastEventSite – der Name der DBM-Website, auf der das DBM-Creative angezeigt wurde und auf das für das letzte DBM-Ereignis (Impression oder Klick im DBM-Lookback-Window) geklickt wurde, das der Google Analytics-Sitzung zugeordnet ist (nur bei Analytics 360, erfordert Integration in DBM)
  • Dimension: ga:dbmLastEventSiteId – ID der DBM-Website, auf der das DBM-Creative zu sehen war und für das letzte DBM-Ereignis (Impression oder Klick im DBM-Lookback-Window) angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, erfordert Integration in DBM)
  • Messwert: ga:dbmCPA – eCPA des DBM-Umsatzes (nur bei Analytics 360, Integration in DBM erforderlich)
  • Messwert – ga:dbmCPC – eCPC des DBM-Umsatzes (nur bei Analytics 360, Integration in DBM erforderlich)
  • Messwert – ga:dbmCPM – eCPM des DBM-Umsatzes (nur bei Analytics 360, Integration mit DBM erforderlich).
  • Messwert: ga:dbmCTR – DBM-CTR (nur bei Analytics 360, Integration in DBM erforderlich)
  • Messwert – ga:dbmClicks – DBM-Klicks insgesamt (nur bei Analytics 360, Integration in DBM erforderlich).
  • Messwert – ga:dbmConversions – DBM-Conversions insgesamt (nur bei Analytics 360, Integration in DBM erforderlich).
  • Messwert: ga:dbmCost – DBM-Kosten (nur bei Analytics 360, Integration in DBM erforderlich)
  • Messwert – ga:dbmImpressions – DBM-Impressionen insgesamt (nur bei Analytics 360, Integration in DBM erforderlich).
  • Messwert – ga:dbmROAS – DBM-ROAS (nur bei Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dsAdGroup – DS-Anzeigengruppe (nur bei Analytics 360, ist in DS erforderlich)
  • Dimension – ga:dsAdGroupId – Anzeigengruppen-ID in DS (nur bei Analytics 360, muss in DS eingebunden werden)
  • Dimension: ga:dsAdvertiser – DS-Werbetreibender (nur bei Analytics 360, muss in DS eingebunden werden)
  • Dimension – ga:dsAdvertiserId – DS-Werbetreibenden-ID (nur bei Analytics 360, ist in DS erforderlich)
  • Dimension – ga:dsAgency – DS-Agentur (nur bei Analytics 360, muss in DS eingebunden werden)
  • Dimension – ga:dsAgencyId – DS-Agentur-ID (nur bei Analytics 360, ist in DS erforderlich).
  • Dimension – ga:dsCampaign – DS-Kampagne (nur bei Analytics 360, ist in DS erforderlich).
  • Dimension – ga:dsCampaignId – DS-Kampagnen-ID (nur bei Analytics 360, ist in DS erforderlich)
  • Dimension – ga:dsEngineAccount – DS-Engine-Konto (nur bei Analytics 360, muss in DS integriert werden)
  • Dimension – ga:dsEngineAccountId – DS-Engine-Konto-ID (nur bei Analytics 360, muss mit DS verknüpft werden)
  • Dimension – ga:dsKeyword – DS-Keyword (nur bei Analytics 360, muss in DS eingebunden werden).
  • Dimension – ga:dsKeywordId: DS-Keyword-ID (nur bei Analytics 360, kann mit DS verknüpft werden)
  • ga:dsCPC – DS-Kosten an Werbetreibenden pro Klick (nur bei Analytics 360, ist in DS erforderlich).
  • ga:dsCTR: DS-Klickrate (nur bei Analytics 360, ist in DS erforderlich).
  • ga:dsClicks – DS-Klicks (nur bei Analytics 360, erfordert Integration mit DS)
  • ga:dsCost – DS-Kosten (nur bei Analytics 360, ist in DS erforderlich)
  • ga:dsImpressions – DS-Impressionen (nur bei Analytics 360, ist in DS erforderlich).
  • ga:dsProfit – DS-Experte (nur bei Analytics 360, erfordert Integration mit DS)
  • ga:dsReturnOnAdSpend: DS – Return on Advertising Spend (nur bei Analytics 360, nur mit DS).
  • ga:dsRevenuePerClick – DS-Umsatz pro Klick (nur bei Analytics 360, ist in DS erforderlich).

In diesem Release wird der API eine neue Dimension hinzugefügt. Dieser Release beinhaltet außerdem bestimmte Einschränkungen für die Kombination von Dimensionen, die gemeinsam aufgerufen werden können. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Geo-Netzwerk

  • Dimension – ga:continentId – die Kontinent-ID der Nutzer, abgeleitet aus den IP-Adressen oder geografischen IDs der Nutzer

Einschränkungen

Die folgenden Dimensionen in den folgenden Gruppen können nicht mit Dimensionen in den anderen Gruppen abgerufen werden:

  • Zur Shopping-Infogruppe
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO-Testgruppe
    • ga:experimentVariant
    • ga:experimentId
  • Interessengruppe
    • ga:interestOtherCategory
  • Kaufbereite Interessengruppe
    • ga:interestInMarketCategory
  • Interne Werbung:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Branding-Interessengruppe:
    • ga:interestAffinityCategory

Dieser Release enthält neue Limits und Kontingente. Weitere Informationen finden Sie in der Dokumentation zu Beschränkungen und Kontingenten.

Fehler melden

In diesem Release werden Beschränkungen für Fehlerberichte (5XX) erzwungen.

  • 10 fehlgeschlagene Anfragen pro Projekt, Profil und Stunde.
  • 50 fehlgeschlagene Anfragen pro Projekt, Profil und Tag.

Pivot-Limits

In diesem Release werden Limits für Pivot-Anfragen erzwungen:

  • Eine Berichtsanfrage kann nun maximal zwei Pivots enthalten.
  • Ein Pivot kann maximal vier Dimensionen haben.
  • Pivot-Dimensionen sind Teil der Beschränkung der Gesamtzahl von Dimensionen, die in der Anfrage zulässig sind.
  • Pivot-Messwerte sind Teil der Einschränkung der Gesamtzahl von Messwerten in der Anfrage.

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Geo-Netzwerk

  • Dimension: ga:metroId – Der dreistellige Code (Designated Market Area, DMA) für den Traffic, der anhand der IP-Adressen oder geografischen IDs der Nutzer ermittelt wird.

DoubleClick for Publishers

  • Messwert: ga:dfpImpressions – Eine DFP-Anzeigenimpression wird erfasst, sobald eine Einzelanzeige auf der Website erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen erfasst. In diesem Fall ist die DFP-Verknüpfung aktiviert und die Option "Ad Manager-Umsatz ausblenden" ist nicht aktiviert.
  • Messwert: ga:dfpCoverage Die Abdeckung gibt an, bei wie viel Prozent der Anzeigenanfragen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen keine Anzeigen mit Targeting über das DFP-Konto bereitgestellt werden können. (Anzeigenimpressionen ÷ Anzeigenanfragen insgesamt) × 100 (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:dfpMonetizedPageviews Eine einzelne Seite kann mehrere Anzeigenblöcke enthalten (die DFP-Verknüpfung ist aktiviert und der DFP-Umsatz nicht aktiviert).“
  • Messwert: ga:dfpImpressionsPerSession – Das Verhältnis von DFP-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen) – DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert.“
  • Messwert: ga:dfpViewableImpressionsPercent – Der Prozentsatz der sichtbaren Anzeigenimpressionen. Eine Impression wird als sichtbare Impression gezählt, wenn sie im Browser der Nutzer ausgeliefert wurde und die Möglichkeit besteht, dass die Anzeige gesehen wird (die DFP-Verknüpfung ist aktiviert und der DFP-Umsatz nicht aktiviert).“
  • Messwert: ga:dfpClicks – Gibt an, wie oft die DFP-Anzeigen auf der Website angeklickt wurden (Verknüpfung mit DFP aktiviert und DFP-Umsatz ausblenden nicht aktiviert)“
  • Messwert: ga:dfpCTR – Der Prozentsatz der Seitenaufrufe, die zu einem Klick auf eine DFP-Anzeige geführt haben (Verknüpfung mit DFP aktiviert und DFP-Umsatz nicht aktiviert).“
  • Messwert: ga:dfpRevenue – Der DFP-Umsatz ist eine Schätzung des Gesamtumsatzes, der auf den ausgelieferten Impressionen basiert. Die DFP-Verknüpfungen sind aktiviert und der DFP-Umsatz ist nicht aktiviert.
  • Messwert: ga:dfpRevenuePer1000Sessions – der geschätzte Gesamtumsatz aus DFP-Anzeigen pro 1.000 Analytics-Sitzungen Dieser Messwert basiert auf Sitzungen auf der Website, nicht auf Anzeigenimpressionen (Verknüpfung mit DFP aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:dfpECPM – der effektive Cost-per-1000-Impressions. Es handelt sich um den DFP-Umsatz pro 1.000 Seitenaufrufe (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert – ga:backfillImpressions – Backfill-Impressionen sind die Summe aller AdSense- oder Ad Exchange-Anzeigenimpressionen, die über DFP als Backfill ausgeliefert wurden. Eine Anzeigenimpression wird erfasst, sobald eine Einzelanzeige auf der Website erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen erfasst. In diesem Fall ist die DFP-Verknüpfung aktiviert und die Option "Ad Manager-Umsatz ausblenden" ist nicht aktiviert.
  • Messwert: ga:backfillCoverage – Die Backfill-Abdeckung ist der Prozentsatz der Backfill-Anzeigenanfragen, bei denen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über das Publisher-Konto keine zielgerichteten Anzeigen bereitgestellt werden können. (Anzeigenimpressionen ÷ Gesamtzahl der Anzeigenanfragen) × 100 Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillMonetizedPageviews Ein einzelner monetarisierter Seitenaufruf kann mehrere Anzeigenimpressionen umfassen (die DFP-Verknüpfung ist aktiviert und der DFP-Umsatz nicht aktiviert).“
  • Messwert: ga:backfillImpressionsPerSession – Das Verhältnis von Backfill-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen). Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillViewableImpressionsPercent – Der Prozentsatz der sichtbaren Backfill-Anzeigenimpressionen. Eine Impression wird als sichtbar bezeichnet, wenn sie im Browser sichtbar war und die Möglichkeit bestand, dass die Anzeige vom Nutzer gesehen wurde. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert – ga:backfillClicks – die Anzahl der Klicks auf Backfill-Anzeigen auf der Website Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (Google Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillCTR – Der Prozentsatz der Backfill-Impressionen, die zu einem Klick auf eine Anzeige geführt haben. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillRevenue – der geschätzte Gesamtumsatz aus Backfill-Anzeigen Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (Google Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillRevenuePer1000Sessions – der geschätzte Gesamtumsatz aus Backfill-Anzeigen pro 1.000 Analytics-Sitzungen. Dieser Messwert basiert auf Sitzungen auf der Website und nicht auf Anzeigenimpressionen. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillECPM – der effektive Cost-per-1000-Impressions. Es handelt sich dabei um den Umsatz aus Backfill-Anzeigen pro 1.000 Seitenaufrufen. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (Ad Manager-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“

Das ist eine Version zur Fehlerkorrektur, durch die ein Problem mit Segmenten und Stichproben behoben wurde.

Segmente

In diesem Release wurde ein Problem behoben, durch das ein Teil der Anfragen mit dem Segment Alle Nutzer (gaid::-1) in der Core Reporting API V3 zu wenig gezählt und in der Analytics Reporting API V4 in zwei Segmente aufgeteilt wurde.

Probenahme

In dieser Version wurde ein Problem behoben, durch das ein Teil der Anfragen aus benutzerdefinierten Tabellen stichprobenbasierte Daten zurückgegeben hat.

In diesem Release wird eine neue Version der API, die Analytics Reporting API V4, angekündigt. Diese neue API ist die fortschrittlichste programmatische Methode, um auf Berichtsdaten in Google Analytics zuzugreifen.

Wichtigste Features

Google Analytics basiert auf einer leistungsstarken Infrastruktur für Datenberichte. Über die API erhalten Entwickler Zugriff auf die leistungsstarken Funktionen der Google Analytics-Plattform. Zu den wichtigsten Funktionen der Analytics Reporting API V4 gehören:

  • Messwertausdrücke: Mit der API können Sie nicht nur die integrierten Messwerte, sondern auch mathematische Messwerte anfordern. Beispiel: Abschlüsse für Zielvorhaben pro Anzahl von Sitzungen können in der Anfrage als ga:goal1completions/ga:sessions ausgedrückt werden.
  • Mehrere Zeiträume - Unterstützung für die Anforderung von zwei Zeiträumen, damit Sie Daten für zwei Zeiträume in einer einzigen Anfrage vergleichen können.
  • Kohorten und Lifetime-Wert: Die API hat ein umfangreiches Vokabular, um Kohorten- und Lifetime-Wert-Berichte anzufordern.
  • Mehrere Segmente: Sie können jetzt mehrere Segmente in einer Anfrage anfordern.

Erste Schritte

Weitere Informationen zu den ersten Schritten mit der API finden Sie in der Entwicklerdokumentation.

Kontingentrichtlinie

Für die Analytics Reporting API V4 gelten eigene Kontingente und Limits. Da es sich hierbei um eine neue API handelt, können sich diese Limits und Kontingente ändern.

Migration

Zusammen mit einer Migrationsanleitung stellen wir auch eine Python-Kompatibilitätsbibliothek auf GitHub zur Verfügung.

Dimensionen und Messwerte

In dieser Version werden außerdem eine Reihe von Dimensionen und Messwerten speziell für die Analytics Reporting API V4 hinzugefügt. Die vollständigen Listendefinitionen finden Sie im Explorer für Dimensionen und Messwerte.

  • Dimension – ga:cohort – der Name der Kohorte, zu der ein Nutzer gehört, basierend auf der Kohortendefinition. Je nachdem, wie Kohorten definiert sind, kann ein Nutzer mehreren Kohorten angehören, ähnlich wie ein Nutzer mehreren Segmenten angehören kann.

  • Dimension: ga:cohortNthDay – Versatz von 0 Tagen relativ zum Kohortendefinitionsdatum. Wenn beispielsweise eine Kohorte mit dem Datum des ersten Besuchs am 01.09.2015 definiert ist, dann lautet für den Tag 2015-09.04 ga:cohortNthDay 3.

  • ga:cohortNthMonth: 0-basierter Monatsversatz im Verhältnis zum Kohortendefinitionsdatum.

  • Dimension: ga:cohortNthWeek – 0-basierter Wochenversatz im Verhältnis zum Kohortendefinitionsdatum.

  • Dimension: ga:acquisitionTrafficChannel – Traffic-Kanal, über den der Nutzer akquiriert wurde. Sie wird aus der ersten Sitzung des Nutzers extrahiert. Der Traffic-Channel wird anhand der Standard-Channelgruppierungsregeln (auf Datenansichtsebene, sofern verfügbar) zum Zeitpunkt der Nutzergewinnung berechnet.

  • Dimension: ga:acquisitionSource – Die Quelle, über die der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.

  • Dimension: ga:acquisitionMedium – Das Medium, über das der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.

  • Dimension – ga:acquisitionSourceMedium – Der kombinierte Wert von „ga:userAcquisitionSource“ und „ga:acquisitionMedium“.

  • Dimension: ga:acquisitionCampaign Die Kampagne, über die der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.

  • Messwert: ga:cohortActiveUsers – Dieser Messwert ist im Zusammenhang mit den 0-basierten Offset-Dimensionen (ga:cohortNthDay, ga:cohortNthWeek oder ga:cohortNthMonth) relevant. Es gibt die Anzahl der Nutzer in der Kohorte an, die im Zeitfenster der Kohorte vom n. Tag/Woche/Monat aktiv sind. Beispiel: Für ga:cohortNthWeek = 1 die Anzahl der Nutzer (in der Kohorte), die in der zweiten Woche aktiv waren. Wenn eine Anfrage weder ga:cohortNthDay noch ga:cohortNthWeek oder ga:cohortNthMonth enthält, hat dieser Messwert denselben Wert wie ga:cohortTotalUsers.

  • Messwert: ga:cohortTotalUsers – Anzahl der Nutzer, die zur Kohorte gehören, auch als Kohortengröße bezeichnet.

  • Messwert: ga:cohortAppviewsPerUser – App-Aufrufe pro Nutzer für eine Kohorte

  • Messwert: ga:cohortGoalCompletionsPerUser – Abschlüsse für Zielvorhaben pro Nutzer in einer Kohorte

  • Messwert: ga:cohortPageviewsPerUser – Seitenaufrufe pro Nutzer für eine Kohorte.

  • Messwert – ga:cohortRetentionRate – Kohortenbindungsrate.

  • Messwert: ga:cohortRevenuePerUser – Umsatz pro Nutzer für eine Kohorte.

  • Messwert: ga:cohortVisitDurationPerUser – Sitzungsdauer pro Nutzer für eine Kohorte.

  • Messwert: ga:cohortSessionsPerUser – Sitzungen pro Nutzer für eine Kohorte.

  • Messwert: ga:cohortTotalUsersWithLifetimeCriteria – Dies ist im Kontext einer Anfrage relevant, die die Dimensionen ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium oder ga:acquisitionCampaign hat. Er steht für die Anzahl der Nutzer in den Kohorten, die über den aktuellen Channel, die Quelle, das Medium oder die Kampagne akquiriert wurden. Für ga:acquisitionTrafficChannel=Direct steht er beispielsweise für die Anzahl der Nutzer in der Kohorte, die direkt akquiriert wurden. Wenn keine der genannten Dimensionen vorhanden ist, ist der Wert ga:cohortTotalUsers.

  • Messwert – ga:cohortAppviewsPerUserWithLifetimeCriteria – App-Aufrufe pro Nutzer für die Akquisitionsdimension für eine Kohorte.

  • Messwert: ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – Abschlüsse für Zielvorhaben pro Nutzer in der Akquisitionsdimension für eine Kohorte

  • Messwert: ga:cohortPageviewsPerUserWithLifetimeCriteria – Seitenaufrufe pro Nutzer für die Akquisitionsdimension für eine Kohorte.

  • Messwert – ga:cohortRevenuePerUserWithLifetimeCriteria – Umsatz pro Nutzer für die Akquisitionsdimension für eine Kohorte.

  • Messwert – ga:cohortSessionsPerUserWithLifetimeCriteria – Sitzungsdauer pro Nutzer für die Akquisitionsdimension für eine Kohorte.

Die Dimensionen und Messwerte in sozialen Netzwerken wurden eingestellt. Ab dem 30. April 2016 werden in Berichten nur noch Daten zu bisherigen Daten angezeigt. Nach diesem Datum werden keine neuen Daten mehr angezeigt. Gemäß der Richtlinie zur Einstellung von Daten werden diese Dimensionen und Messwerte nach dem 30. September 2016 entfernt.

Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Soziale Aktivitäten

Diese Dimensionen und Messwerte wurden eingestellt und werden nach dem 30. September 2016 entfernt. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

  • Dimension: ga:socialActivityEndorsingUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies die URL der sozialen Aktivität, z. B. die URL des Google+ Beitrags oder die URL des Blogkommentars.
  • Dimension: ga:socialActivityDisplayName – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies der Titel der von den Nutzern des sozialen Netzwerks geposteten sozialen Aktivität.
  • Dimension: ga:socialActivityPost – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist das der Inhalt der sozialen Aktivität (z.B. der Inhalt einer auf Google+ geposteten Nachricht), der von Nutzern des sozialen Netzwerks gepostet wird.
  • Dimension: ga:socialActivityTimestamp – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies der Zeitpunkt, zu dem die soziale Aktivität im sozialen Netzwerk stattgefunden hat.
  • Dimension: ga:socialActivityUserHandle – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies der Alias (ID oder ID) des Nutzers, der die soziale Aktivität initiiert hat.“
  • Dimension: ga:socialActivityUserPhotoUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist das die URL des Fotos, das mit den Profilen der Nutzer in den sozialen Netzwerken verknüpft ist.“
  • Dimension: ga:socialActivityUserProfileUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist das die URL der Profile der zugehörigen Nutzer in sozialen Netzwerken.
  • Dimension: ga:socialActivityTagsSummary – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies ein durch Kommas getrennter Satz von Tags, die mit der Aktivität in sozialen Netzwerken verknüpft sind.“
  • Dimension: ga:socialActivityAction – Bei einer Aktivität im Hub für soziale Interaktionsdaten handelt es sich um die Art der sozialen Interaktion (z. B. Abstimmung, Kommentar, +1), die der Aktivität zugeordnet ist.
  • Dimension: ga:socialActivityNetworkAction – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies die Art der sozialen Interaktion und das soziale Netzwerk, aus dem die Aktivität stammt.
  • Dimension: ga:socialActivityContentUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies die URL, die von den zugehörigen Nutzern des sozialen Netzwerks geteilt wird.
  • Messwert: ga:socialActivities – Gesamtzahl der Aktivitäten, bei denen eine Content-URL in einem Partnernetzwerk im Hub für soziale Daten geteilt oder erwähnt wurde

In diesem Release wird der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Plattform oder Gerät

  • Dimension – ga:browserSize – die Größe des Darstellungsbereichs im Browser des Nutzers Die Browsergröße ist eine sitzungsbezogene Dimension, die die anfänglichen Abmessungen des Darstellungsbereichs in Pixeln erfasst. Sie ist als Breite x Höhe formatiert. Beispiel: 1920 x 960.

In diesem Release wird der API ein neuer Parameter hinzugefügt.

Leere Zeilen einschließen

  • In diesem Release wird der neue optionale Parameter include-empty-rows hinzugefügt. Wenn er auf false Zeilen ohne Daten festgelegt ist, wird er in der Antwort weggelassen. Der Standardwert ist true. Dies ist eine nicht funktionsgefährdende Änderung, weshalb keine Codeaktualisierung erforderlich ist. Weitere Informationen finden Sie in der Referenzdokumentation zur Core Reporting API.

In diesem Release werden der API neue Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Nutzer

  • Messwert: ga:1dayUsers – Gesamtzahl der in den letzten 24 Stunden aktiven Nutzer pro Tag im angeforderten Zeitraum. Für die Abfrage dieses Messwerts muss mindestens eine „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension angegeben werden. Für den angegebenen Tag entspricht der zurückgegebene Wert der Gesamtzahl der einzelnen Nutzer für den eintägigen Tag am angegebenen Datum.
  • Messwert – ga:7dayUsers – Gesamtzahl der in den letzten 7 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Für die Abfrage dieses Messwerts muss mindestens eine „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension angegeben werden. Für den angegebenen Tag entspricht der zurückgegebene Wert der Gesamtzahl der einzelnen Nutzer für den siebentägigen Zeitraum, der am angegebenen Datum endet.
  • Messwert: ga:14dayUsers – Gesamtzahl der in den letzten 14 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Für die Abfrage dieses Messwerts muss mindestens eine „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension angegeben werden. Für den angegebenen Tag entspricht der zurückgegebene Wert der Gesamtzahl der einzelnen Nutzer für den Zeitraum von 14 Tagen, der am angegebenen Datum endet.
  • Messwert: ga:30dayUsers – Gesamtzahl der in den letzten 30 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Für die Abfrage dieses Messwerts muss mindestens eine „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension angegeben werden. Für den angegebenen Tag entspricht der zurückgegebene Wert der Gesamtzahl der einzelnen Nutzer für den Zeitraum von 30 Tagen, der am angegebenen Datum endet.

In diesem Release werden der API neue Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

DoubleClick Ad Exchange (AdX)

  • Messwert: ga:adxCTR – Der Prozentsatz der Seitenaufrufe, die zu einem Klick auf eine AdX-Anzeige geführt haben.
  • Messwert: ga:adxClicks – Gibt an, wie oft AdX-Anzeigen auf Ihrer Website angeklickt wurden.
  • Messwert: ga:adxCoverage Die Abdeckung gibt an, bei wie viel Prozent der Anzeigenanfragen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über Ihr AdX-Konto keine Anzeigen mit Targeting bereitgestellt werden können. (Anzeigenimpressionen ÷ Anzeigenanfragen insgesamt) × 100
  • Messwert: ga:adxECPM – der effektive Cost-per-1000-Impressions. Es handelt sich dabei um Ihren AdX-Umsatz pro 1.000 Seitenaufrufe.
  • Messwert: ga:adxImpressions – Eine AdX-Anzeigenimpression wird erfasst, sobald eine Einzelanzeige auf Ihrer Website erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen gezählt.
  • Messwert: ga:adxImpressionsPerSession – Das Verhältnis von AdX-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen).
  • Messwert – ga:adxMonetizedPageviews – Monetarisierte Seitenaufrufe messen die Gesamtzahl der Seitenaufrufe auf Ihrer Property, bei denen eine Anzeige aus Ihrem verknüpften AdX-Konto ausgeliefert wurde. Hinweis: Eine einzelne Seite kann mehrere Anzeigenblöcke enthalten.
  • Messwert: ga:adxRevenue – der geschätzte Gesamtumsatz aus AdX-Anzeigen
  • Messwert: ga:adxRevenuePer1000Sessions – der geschätzte Gesamtumsatz aus AdX-Anzeigen pro 1.000 Analytics-Sitzungen. Er basiert auf Sitzungen auf Ihrer Website, nicht auf Anzeigenimpressionen.
  • Messwert: ga:adxViewableImpressionsPercent – Der Prozentsatz der Anzeigenimpressionen, die sichtbar waren. Eine Impression wird als sichtbar bezeichnet, wenn sie im Browser bereitgestellt wurde und die Möglichkeit bestand, dass die Anzeige vom Nutzer gesehen wurde.

In diesem Release werden vorhandene Dimensionen oder Messwerte verworfen. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Eingestellte Dimensionen

Diese Dimensionen wurden eingestellt. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

  • Dimension – ga:adSlotPosition – Verwenden Sie stattdessen ga:adSlot.
  • Dimension – ga:nextPagePath – Verwenden Sie stattdessen ga:pagePath.
  • Dimension – ga:nextContentGroupXX – Verwenden Sie stattdessen ga:contentGroupXX.

In diesem Release wird der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Dimensionen und Messwerte finden Sie in der Referenz zu Dimensionen und Messwerten.

AdWords

  • Dimension – ga:adQueryWordCount – die Anzahl der Wörter in der Suchanfrage

In diesem Release werden der API neue Dimensionen hinzugefügt. Eine vollständige Liste der Dimensionen und Messwerte finden Sie in der Referenz zu Dimensionen und Messwerten.

Plattform oder Gerät

  • Dimension – ga:dataSource – Die Datenquelle eines Treffers. Treffer, die von ga.js und analytics.js gesendet wurden, werden als „Web“ gemeldet. Von den mobilen SDKs gesendete Treffer werden als „App“ gemeldet. Diese Werte können überschrieben werden.
  • Dimension: ga:searchAfterDestinationPage – die Seite, die der Nutzer nach einer internen Suche auf Ihrer Website besucht hat

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Außerdem werden zwei vorhandene Messwerte eingestellt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

E-Commerce

  • Messwert – ga:transactionsPerUser – Die Gesamtzahl der Transaktionen geteilt durch die Gesamtzahl der Nutzer.
  • Messwert: ga:revenuePerUser – Der Gesamtumsatz aus der Transaktion ohne Versandkosten und Steuern geteilt durch die Gesamtzahl der Nutzer.

Nutzer

  • Messwert – ga:sessionsPerUser – Die Gesamtzahl der Sitzungen geteilt durch die Gesamtzahl der Nutzer.

Geo-Netzwerk

  • Dimension – ga:cityId – Die Stadt-IDs der Nutzer, basierend auf IP-Adressen oder geografischen IDs.
  • Dimension – ga:countryIsoCode – der ISO-Ländercode der Nutzer (abgeleitet von IP-Adressen oder geografischen IDs). Die Werte sind als Alpha-2-Code gemäß ISO-3166-1 angegeben.
  • Dimension – ga:regionId – Die Regions-ID der Nutzer, basierend auf den IP-Adressen oder geografischen IDs. In den USA ist jeder Staat eine Region, beispielsweise Nevada.
  • Dimension – ga:regionIsoCode – der regionale ISO-Code der Nutzer, basierend auf IP-Adressen oder geografischen IDs. Die Werte werden als ISO-3166-2-Code angegeben.
  • Dimension – ga:subContinentCode – Der Subkontinentcode der Nutzer, basierend auf den IP-Adressen oder geografischen IDs. Beispiel: Polynesien oder Nordeuropa. Die Werte werden als UN-M.49-Code angegeben.

DoubleClick Campaign Manager

  • Messwert: ga:dcmROAS – Return on Advertising Spend (ROAS) in DCM (nur Premium)

Eingestellte Messwerte

Diese Messwerte wurden eingestellt. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten: + Messwert – ga:dcmROI. Verwenden Sie stattdessen ga:dcmROAS. + Messwert – ga:dcmMargen – Verwenden Sie stattdessen ga:dcmROAS.

In diesem Release wird der API ein neuer Messwert hinzugefügt und es werden zwei vorhandene Messwerte verworfen. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

AdWords

  • Messwert – ga:ROAS – Return on Advertising Spend (ROAS) ist der Gesamtumsatz aus Transaktionen und der Zielvorhabenwert geteilt durch die abgeleiteten Werbekosten.

Eingestellte Dimensionen und Messwerte

Diese Dimensionen und Messwerte wurden eingestellt. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten: + Messwert – ga:ROI. Verwenden Sie stattdessen ga:ROAS. + Messwert – ga:margin – Verwenden Sie stattdessen ga:ROAS.

In diesem Release werden der API neue Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

AdSense

  • Messwert: ga:adsenseCoverage – Der Prozentsatz der Anzeigenanfragen, bei denen mindestens eine Anzeige zurückgegeben wurde.
  • Messwert: ga:adsenseViewableImpressionPercent – Der Prozentsatz der sichtbaren Impressionen.

In dieser Version haben wir einen neuen Sitzungsmesswert, eine neue Dimension für Besucherquellen sowie neue Dimensionen und Messwerte in DoubleClick Campaign Manager hinzugefügt.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Sitzung

  • Messwert: ga:hits – Gesamtzahl der Treffer, die an Google Analytics gesendet wurden In diesem Messwert werden alle Treffertypen (z.B. Seitenaufrufe, Ereignisse und Timing) zusammengefasst.

Besucherquellen

  • Dimension: ga:campaignCode – bei Verwendung von manuellem Kampagnen-Tracking der Wert des Kampagnen-Tracking-Parameters utm_id

DoubleClick Campaign Manager

  • Dimension: ga:dcmClickAd – DCM-Anzeigenname des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickAdId – DCM-Anzeigen-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickAdType – Name des DCM-Anzeigentyps des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickAdTypeId – ID des DCM-Anzeigentyps des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickAdvertiser – Name des DCM-Werbetreibenden des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickAdvertiserId – DCM-Werbetreibenden-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCampaign – DCM-Kampagnenname des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCampaignId – DCM-Kampagnen-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCreative – Name des DCM-Creatives für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCreativeId – DCM-Creative-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCreativeType – Name des DCM-Creative-Typs für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCreativeTypeId – ID des DCM-Creative-Typs des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickCreativeVersion – DCM-Creative-Version des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickRenderingId – DCM-Rendering-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickSite – Name der Website, auf der das DCM-Creative zu sehen war und auf das für den DCM-Klick geklickt wurde, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickSiteId – DCM-Website-ID, bei der das DCM-Creative angezeigt und angeklickt wurde, wenn der DCM-Klick mit der Google Analytics-Sitzung übereinstimmt (nur Premium)
  • Dimension: ga:dcmClickSitePlacement – Name des DCM-Website-Placements für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickSitePlacementId – DCM-Website-Placement-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmClickSpotId – DCM-Floodlight-Konfigurations-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium)
  • Dimension: ga:dcmFloodlightActivity – Der Name der DCM-Floodlight-Aktivität, der mit der Floodlight-Conversion verknüpft ist (nur Premium)
  • Dimension: ga:dcmFloodlightActivityAndGroup – Der Floodlight-Aktivitätsname und der Gruppenname aus DCM, die der Floodlight-Conversion zugeordnet sind (nur Premium)
  • Dimension: ga:dcmFloodlightActivityGroup – Der Name der DCM-Floodlight-Aktivitätsgruppe der Floodlight-Conversion (nur Premium).
  • Dimension – ga:dcmFloodlightActivityGroupId – ID der DCM-Floodlight-Aktivitätsgruppe, die mit der Floodlight-Conversion verknüpft ist (nur Premium)
  • Dimension: ga:dcmFloodlightActivityId – ID der mit der Floodlight-Conversion verknüpften DCM-Floodlight-Aktivität (nur Premium).
  • Dimension – ga:dcmFloodlightAdvertiserId – ID des mit der Floodlight-Conversion verknüpften DCM-Floodlight-Werbetreibenden (nur Premium).
  • Dimension – ga:dcmFloodlightSpotId – ID der mit der Floodlight-Conversion verknüpften DCM-Floodlight-Konfiguration (nur Premium).
  • Dimension: ga:dcmLastEventAd – DCM-Anzeigenname des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventAdId – DCM-Anzeigen-ID des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventAdType – Name des DCM-Anzeigentyps des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventAdTypeId – DCM-Anzeigentyp-ID des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventAdvertiser – Name des DCM-Werbetreibenden des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventAdvertiserId – DCM-Werbetreibenden-ID des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension – ga:dcmLastEventAttributionType – Es gibt zwei mögliche Werte (Click-through und ViewThrough). Wenn das letzte DCM-Ereignis, das der Google Analytics-Sitzung zugeordnet ist, ein Klick war, lautet der Wert ClickThrough. Wenn das letzte DCM-Ereignis, das mit der Google Analytics-Sitzung verknüpft ist, eine Anzeigenimpression war, lautet der Wert ViewThrough (nur Premium).
  • Dimension: ga:dcmLastEventCampaign – Der DCM-Kampagnenname des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventCampaignId – DCM-Kampagnen-ID des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventCreative – DCM-Creative-Name des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventCreativeId – DCM-Creative-ID des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventCreativeType – Name des DCM-Creative-Typs für das letzte DCM-Ereignis (Impression oder Klick innerhalb des DCM-Lookback-Windows), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventCreativeTypeId – ID des DCM-Creative-Typs des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventCreativeVersion – DCM-Creative-Version des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventRenderingId – DCM-Rendering-ID des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventSite – Websitename, auf dem das DCM-Creative für das letzte DCM-Ereignis angezeigt oder angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur Premium) (Impression oder Klick im DCM-Lookback-Window).
  • Dimension: ga:dcmLastEventSiteId – DCM-Website-ID, bei der das DCM-Creative angezeigt und angeklickt wurde, während das letzte DCM-Ereignis (Impression oder Klick innerhalb des DCM-Lookback-Windows) der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventSitePlacement – Name der DCM-Website-Placement des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium)
  • Dimension: ga:dcmLastEventSitePlacementId – DCM-Website-Placement-ID des letzten DCM-Ereignisses (Impression oder Klick innerhalb des DCM-Lookback-Windows), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Dimension: ga:dcmLastEventSpotId – DCM-Floodlight-Konfigurations-ID des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das der Google Analytics-Sitzung zugeordnet ist (nur Premium)
  • Messwert: ga:dcmFloodlightQuantity – Anzahl der DCM-Floodlight-Conversions (nur Premium)
  • Messwert: dcmFloodlightRevenue – DCM-Floodlight-Umsatz (nur Premium)

In dieser Version wurden die neuen Dimensionen und Messwerte für die Gruppierung nach Content hinzugefügt.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Gruppierung nach Content

  • Dimension: ga:landingContentGroupXX – die erste übereinstimmende Contentgruppe in der Nutzersitzung
  • Dimension – ga:nextContentGroupXX: Bezieht sich auf eine Contentgruppe, die nach einer anderen Contentgruppe aufgerufen wurde.
  • Dimension – ga:contentGroupXX – Contentgruppe einer Property. Eine Contentgruppe ist eine Zusammenstellung von Inhalten mit logischer Struktur, die anhand von Tracking-Code, Übereinstimmung mit Regex/Seitentitel oder vordefinierten Regeln ermittelt werden kann.
  • Dimension – ga:previousContentGroupXX – Bezieht sich auf eine Contentgruppe, die vor einer anderen Contentgruppe aufgerufen wurde.
  • Messwert: ga:contentGroupUniqueViewsXX – Die Anzahl der verschiedenen (eindeutigen) Seiten innerhalb einer Sitzung für die angegebene Contentgruppe Zur Bestimmung der Eindeutigkeit werden sowohl pagePath als auch pageTitle berücksichtigt.

Diese Version enthält eine neue dateOfSession-Bedingung für Segmente sowie neue Dimensionen und Messwerte im erweiterten E-Commerce.

Segmente

Segmente unterstützen jetzt eine neue dateOfSession-Bedingung, mit der ein Segment auf eine Gruppe von Nutzern beschränkt werden kann, die innerhalb eines bestimmten Zeitraums eine Sitzung gestartet haben. Weitere Informationen

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen für den erweiterten E-Commerce finden Sie in der Referenz zu Dimensionen und Messwerten.

Erweiterte E-Commerce-Berichte

  • Dimension: ga:internalPromotionCreative – der Creative-Content, der für eine Werbeaktion entwickelt wurde
  • Dimension: ga:internalPromotionId – Die ID, die Sie für das Angebot verwenden.
  • Dimension – ga:internalPromotionName – Der Name der Werbeaktion.
  • Dimension – ga:internalPromotionPosition – Die Position der Werbung auf der Webseite oder im App-Bildschirm.
  • Dimension – ga:orderCouponCode – Code für den Gutschein auf Bestellebene.
  • Dimension – ga:productBrand – der Markenname, unter dem das Produkt verkauft wird.
  • Dimension – ga:productCategoryHierarchy – die Kategorieebene, der das Produkt zugewiesen ist (erweiterter E-Commerce).
  • Dimension – ga:productCategoryLevelXX – Ebene (1–5) in der Produktkategoriehierarchie, beginnend mit oben.
  • Dimension – ga:productCouponCode – Code für den Gutschein auf Produktebene
  • Dimension – ga:productListName – der Name der Produktliste, in der das Produkt erscheint
  • Dimension – ga:productListPosition – die Position des Produkts in der Produktliste.
  • Dimension – ga:productVariant – Die spezifische Variante eines Produkts, z.B. XS, S, M, L für Größe oder Rot, Blau, Grün, Schwarz für Farbe.
  • Dimension: ga:checkoutOptions – Während des Bezahlvorgangs angegebene Nutzeroptionen, z.B. FedEx, DHL, UPS für Lieferoptionen oder Visa, Mastercard, AmEx für Zahlungsoptionen. Diese Dimension sollte zusammen mit der Phase „Shopping“ verwendet werden.
  • Dimension: ga:shoppingStage – verschiedene Phasen des Kaufprozesses, die Nutzer während einer Sitzung abgeschlossen haben, z.B. PRODUCT_VIEW, ADD_TO_CART, CHECKOUT usw.
  • Messwert: ga:internalPromotionCTR – Die Rate, mit der Nutzer das interne Angebot angeklickt haben (Anzahl der Klicks ÷ Anzahl der Auslieferungen).
  • Messwert: ga:internalPromotionClicks – Anzahl der Klicks auf ein internes Angebot
  • Messwert: ga:internalPromotionViews – die Anzahl der Aufrufe einer internen Werbung
  • Messwert: ga:localProductRefundAmount – Erstattungsbetrag für ein bestimmtes Produkt in der Landeswährung
  • Messwert: ga:localRefundAmount – Gesamtbetrag der Erstattung für die Transaktion in der Landeswährung
  • Messwert – ga:productAddsToCart – die Häufigkeit, mit der das Produkt in den Einkaufswagen gelegt wurde
  • Messwert: ga:productCheckouts – Gibt an, wie oft das Produkt in den Bezahlvorgang aufgenommen wurde.
  • Messwert: ga:productDetailViews Anzahl der Aufrufe der Produktdetailseite.
  • Messwert: ga:productListClicks – Gibt an, wie oft Nutzer auf das Produkt geklickt haben, als es in der Produktliste aufgeführt wurde.
  • Messwert: ga:productListViews – Gibt an, wie oft das Produkt in einer Produktliste angezeigt wurde.
  • Messwert: ga:productListCTR – Die Rate, mit der Nutzer auf das Produkt in einer Produktliste geklickt haben.
  • Messwert – ga:productRefunds – die Anzahl der Erstattungen für das Produkt
  • Messwert: ga:productRefundAmount – Der mit dem Produkt verknüpfte Gesamtbetrag der Erstattung.
  • Messwert – ga:productRemovesFromCart – Gibt an, wie oft das Produkt aus dem Einkaufswagen entfernt wurde.
  • Messwert: ga:productRevenuePerPurchase – Durchschnittlicher Produktumsatz pro Kauf (wird normalerweise mit Produktgutscheincodes verwendet).
  • Messwert – ga:buyToDetailRate – Einzelne Käufe geteilt durch die Anzahl der Aufrufe von Produktdetailseiten.
  • Messwert – ga:cartToDetailRate – Produkt addiert durch Aufrufe von Produktdetails
  • Messwert: ga:quantityAddedToCart – Anzahl der in den Einkaufswagen gelegten Produkteinheiten
  • Messwert – ga:quantityCheckedOut – Anzahl der Produkteinheiten, die an der Kasse waren.
  • Messwert – ga:quantityRefunded – Anzahl der erstatteten Produkteinheiten
  • Messwert – ga:quantityRemovedFromCart – Anzahl der Produkteinheiten, die aus dem Einkaufswagen entfernt wurden.
  • Messwert: ga:refundAmount – Währungsbetrag, der für eine Transaktion erstattet wurde
  • Messwert – ga:totalRefunds – Anzahl der Erstattungen, die ausgeführt wurden

Diese Version enthält eine Fehlerkorrektur für Spaltenüberschriften sowie neue Dimensionen und Messwerte.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

System

  • Dimension: ga:sourcePropertyDisplayName – Anzeigename der Quell-Property von Sammel-Properties. Dies gilt nur für Sammel-Properties.
  • Dimension – ga:sourcePropertyTrackingId – Tracking-ID der Quell-Property von Sammel-Properties. Gilt nur für Sammel-Properties

Channelgruppierung

  • Dimension: ga:channelGrouping – Die Standard-Channelgruppierung, die in der Datenansicht (Profil) freigegeben ist.
  • Dimension – ga:correlationModelId – Korrelationsmodell-ID für ähnliche Produkte.
  • Dimension – ga:queryProductId – ID des abgefragten Produkts.
  • Dimension – ga:queryProductName – Name des abgefragten Produkts.
  • Dimension – ga:queryProductVariation – Die Variante des abgefragten Produkts.
  • Dimension – ga:relatedProductId – ID des ähnlichen Produkts.
  • Dimension – ga:relatedProductName – Name des ähnlichen Produkts.
  • Dimension – ga:relatedProductVariation – Variante des ähnlichen Produkts
  • Messwert: ga:correlationScore – Korrelationsfaktor für ähnliche Produkte
  • Messwert: ga:queryProductQuantity – Menge des abgefragten Produkts.
  • Messwert: ga:relatedProductQuantity – Menge des ähnlichen Produkts

Korrektur des Namens der Kopfzeilenspalte

  • In der Version vom 16.04.2014 gab es einen Programmfehler. Wenn Sie eine eingestellte Dimension oder einen eingestellten Messwert abfragen, gibt die API Spaltenüberschriften mit der Ersatzdimension oder dem Ersatzmesswert zurück. Jetzt wird korrekt der Dimensions- oder Messwertname zurückgegeben, der in der Anfrage verwendet wurde.

In dieser Version wurden Dimensionen und Messwerte hinzugefügt und umbenannt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Neue Dimensionen und Messwerte

Die folgenden Dimensionen wurden der Core Reporting API hinzugefügt:

AdWords

  • Dimension – ga:isTrueViewVideoAdYes oder No – Gibt an, ob es sich um eine AdWords-TrueView-Videoanzeige handelt.

Zeit

  • Dimension: ga:nthHour – Index für jede Stunde im angegebenen Zeitraum Der Index für die erste Stunde des ersten Tages (d.h. Startdatum) im Zeitraum ist 0, 1 für die nächste Stunde und so weiter.

Dimensionen und Messwerte umbenannt

Alle Dimensionen und Messwerte, die auf Besuchern und Besuchen basieren, wurden umbenannt, sodass stattdessen Nutzer und Sitzung verwendet werden.

Die folgenden Dimensionen und Messwerte wurden umbenannt. Weitere Informationen zur Umbenennung von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

Zielgruppe

  • Dimension – ga:visitorAgeBracket – Verwenden Sie stattdessen ga:userAgeBracket.
  • Dimension – ga:visitorGender – Verwenden Sie stattdessen ga:userGender.

E-Commerce

  • Messwert: ga:transactionRevenuePerVisit. Verwenden Sie stattdessen ga:transactionRevenuePerSession.
  • Messwert: ga:transactionsPerVisit. Verwenden Sie stattdessen ga:transactionsPerSession.

Ereignis-Tracking

  • Messwert: ga:eventsPerVisitWithEvent. Verwenden Sie stattdessen ga:eventsPerSessionWithEvent.
  • Messwert: ga:visitsWithEvent. Verwenden Sie stattdessen ga:sessionsWithEvent.

Zielvorhaben-Conversions

  • Messwert: ga:goalValuePerVisit. Verwenden Sie stattdessen ga:goalValuePerSession.
  • Messwert: ga:percentVisitsWithSearch. Verwenden Sie stattdessen ga:percentSessionsWithSearch.
  • Messwert: ga:searchVisits. Verwenden Sie stattdessen ga:searchSessions.

Seiten-Tracking

  • Messwert: ga:pageviewsPerVisit. Verwenden Sie stattdessen ga:pageviewsPerSession.

Sitzung

  • Dimension – ga:visitLength – Verwenden Sie stattdessen ga:sessionDurationBucket.
  • Messwert: ga:avgTimeOnSite. Verwenden Sie stattdessen ga:avgSessionDuration.
  • Messwert: ga:timeOnSite. Verwenden Sie stattdessen ga:sessionDuration.
  • Messwert: ga:visitBounceRate. Verwenden Sie stattdessen ga:bounceRate.
  • Messwert: ga:visits. Verwenden Sie stattdessen ga:sessions.

Soziale Interaktionen

  • Dimension – ga:socialInteractionNetworkActionVisit – Verwenden Sie stattdessen ga:socialInteractionNetworkActionSession.
  • Messwert: ga:socialInteractionsPerVisit. Verwenden Sie stattdessen ga:socialInteractionsPerSession.

Nutzer

  • Dimension – ga:daysSinceLastVisit – Verwenden Sie stattdessen ga:daysSinceLastSession.
  • Dimension – ga:visitCount – Verwenden Sie stattdessen ga:sessionCount.
  • Dimension – ga:visitorType – Verwenden Sie stattdessen ga:userType.
  • Dimension – ga:visitsToTransaction – Verwenden Sie stattdessen ga:sessionsToTransaction.
  • Messwert: ga:newVisits. Verwenden Sie stattdessen ga:newUsers.
  • Messwert: ga:percentNewVisits. Verwenden Sie stattdessen ga:percentNewSessions.
  • Messwert: ga:visitors. Verwenden Sie stattdessen ga:users.

Segmente: Core Reporting API Version 2.4 &v3.0

Unterstützung neuer Segmente in der Core Reporting API

  • Der Parameter segment unterstützt jetzt Nutzer- und Sequenzsegmente. Auf der Weboberfläche erstellte Segmente auf Nutzerebene und Sitzungsebene können mit dem Parameter segment abgefragt werden.
  • Für den segment-Parameter ist eine neue Syntax für dynamische Segmente verfügbar. Weitere Informationen
  • Das Präfix dynamic:: wurde eingestellt. Wir empfehlen Ihnen, so schnell wie möglich zur neuen Syntax zu migrieren.

Dieser Release enthält ein neues Antwortformat für Datentabellen sowie das Hinzufügen und Verwerfen von Dimensionen und Messwerten. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Ausgabe der Datentabelle

Um das Rendern Ihrer Google Analytics-Daten mithilfe von Google Charts-Visualisierungen zu erleichtern, kann die API optional ein Datentabellenobjekt in der Antwort zurückgeben.

  • Der API wurde der optionale Abfrageparameter output hinzugefügt. Damit kann das Ausgabeformat der Analytics-Daten in der Antwort ausgewählt werden (standardmäßig JSON). Wenn datatable festgelegt ist, wird eine dataTable-Property mit einem Datentabellenobjekt in die Antwort aufgenommen. Dieses Objekt kann direkt mit Google Charts verwendet werden. Weitere Informationen finden Sie in der Core Reporting API-Referenz.

Neue Dimensionen und Messwerte

Die folgenden Dimensionen und Messwerte wurden der Core Reporting API hinzugefügt:

Zeit

  • Dimension – ga:minute – Gibt die Minute in der Stunde an. Die möglichen Werte liegen zwischen 00 und 59.
  • Dimension: ga:nthMinute – Index für jede Minute im angegebenen Zeitraum Der Index für die erste Minute des ersten Tages (d.h. Startdatum) im Zeitraum ist 0, 1 für die nächste Minute und so weiter.

Zielgruppe

  • Dimension – ga:visitorAgeBracket – Altersgruppe der Besucher.
  • Dimension – ga:visitorGender – Geschlecht des Besuchers
  • Dimension – ga:interestAffinityCategory: Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit daran interessiert sind, mehr über die angegebene Kategorie zu erfahren.
  • Dimension – ga:interestInMarketCategory: Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit Produkte oder Dienstleistungen in der angegebenen Kategorie kaufen.
  • Dimension – ga:interestOtherCategory: Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit mehr über die angegebene Kategorie erfahren und kaufbereit sind.

In Segmenten zulässige Dimensionen und Messwerte

Diese Dimensionen und Messwerte können jetzt in Segmenten verwendet werden:

  • Dimension – ga:sourceMedium – kombinierte Werte von ga:source und ga:medium.
  • Messwert: ga:localItemRevenue – Produktumsatz in der Landeswährung

Eingestellte Dimensionen und Messwerte

Diese Dimensionen und Messwerte wurden eingestellt. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

  • Dimension – ga:isMobile – Verwenden Sie stattdessen ga:deviceCategory (z.B. ga:deviceCategory==mobile) verwenden.
  • Dimension – ga:isTablet – Verwenden Sie stattdessen ga:deviceCategory (z.B. ga:deviceCategory==tablet) verwenden.
  • Messwert: ga:entranceBounceRate. Verwenden Sie stattdessen ga:visitBounceRate.

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

AdSense

  • Zugriff auf AdSense-Daten wurde hinzugefügt:

    • Erfüllt: ga:adsenseRevenue – Der Gesamtumsatz aus AdSense-Anzeigen
    • Erfüllt: ga:adsenseAdUnitsViewed – Anzahl der aufgerufenen AdSense-Anzeigenblöcke Ein Anzeigenblock ist eine Gruppe von Anzeigen, die aus einem Teil des AdSense-Anzeigencodes resultieren. Weitere Informationen: https://support.google.com/adsense/answer/32715.
    • Erfüllt: ga:adsenseAdsViewed – Anzahl der aufgerufenen AdSense-Anzeigen In einem Anzeigenblock können mehrere Anzeigen ausgeliefert werden.
    • Erfüllt: ga:adsenseAdsClicks – Gibt an, wie oft AdSense-Anzeigen auf Ihrer Website angeklickt wurden
    • Erfüllt: ga:adsensePageImpressions – die Anzahl der Seitenaufrufe, bei denen eine AdSense-Anzeige ausgeliefert wurde Eine Seitenimpression kann mehrere Anzeigenblöcke enthalten.
    • Erfüllt: ga:adsenseCTR – Der Prozentsatz der Seitenimpressionen, die zu einem Klick auf eine AdSense-Anzeige geführt haben. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Met – ga:adsenseECPM – die geschätzten Kosten pro 1.000 Seitenimpressionen Hierbei handelt es sich um den AdSense-Umsatz pro 1000 Seitenimpressionen. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Erfüllt – ga:adsenseExits – Die Anzahl der Sitzungen, die aufgrund eines Klicks auf eine AdSense-Anzeige beendet wurden.

Zeit

  • Dim – ga:isoYear – Das ISO-Jahr des Besuchs. Weitere Informationen: http://en.wikipedia.org/wiki/ISO_week_date ga:isoYear sollte nur mit ga:isoWeek verwendet werden, da ga:week für den gregorianischen Kalender steht.
  • Dimm – ga:isoYearIsoWeek – Kombinierte Werte von ga:isoYear und ga:isoWeek.

AdWords

  • Diese Daten sind in den AdWords-Berichten verfügbar:

    • Dim – ga:adKeywordMatchType – Die Keyword-Optionen, die auf Ihre Keywords angewendet wurden („Passende Wortgruppe“, „Genau passend“, „Weitgehend passend“). Details: Bericht zu Suchbegriffen

Neue Funktionen für die Stichprobengröße und relative Daten

Relative Zeiträume
  • Die Core Reporting API unterstützt jetzt relative Daten. today, yesterday und NdaysAgo sind jetzt gültige Werte für die Abfrageparameter start-date und end-date.
  • Mit diesen Werten wird der Zeitraum automatisch anhand des aktuellen Datums zum Zeitpunkt der Abfrage und der Zeitzone der Datenansicht (Profil) festgelegt, die in der Abfrage angegeben ist. Weitere Informationen finden Sie in der API-Referenz.
Abtastebene
  • Es wurde ein neuer Parameter eingeführt: samplingLevel. Damit können Sie die Stichprobenebene (d. h. die Anzahl der Besuche, die zur Berechnung des Ergebnisses verwendet werden) für eine Berichtsabfrage festlegen. Zulässige Werte sind: DEFAULT, FASTER und HIGHER_PRECISION.
  • Der API-Antwort wurden zwei neue Felder hinzugefügt: sampleSize und sampleSpace. Sie können diese Werte verwenden, um den Prozentsatz der Besuche zu berechnen, die für eine Antwort verwendet wurden.
  • Weitere Informationen finden Sie in der API-Referenz und in Stichproben.

Fehlerkorrekturen

  • ga:adwordsCustomerID gibt nun die 10-stellige AdWords-Kundennummer zurück, die der AdWords API AccountInfo.customerId entspricht. So ist es möglich, Analytics-Daten mit mehreren AdWords-Konten zu verknüpfen.

Im Rahmen der Einführung neuer Segmente führen wir die folgenden Änderungen an der Core Reporting API ein.

  • Der Parameter segment unterstützt jetzt die neue alphanumerische ID für benutzerdefinierte erweiterte Segmente, die in der Sammlung von Segmenten in der Management API zurückgegeben wird.
  • Die aktuellen numerischen IDs für benutzerdefinierte Segmente werden jetzt eingestellt. Diese bisherigen IDs werden noch sechs Monate lang unterstützt. Wir empfehlen, Anwendungen, die Nutzersegment-IDs speichern, auf die neuen alphanumerischen IDs umzustellen. Nach Ablauf des Einstellungszeitraums wird bei Abfragen mit den alten numerischen IDs ein Fehler zurückgegeben.
  • Derzeit können nur über die in der Weboberfläche erstellten Segmente auf Besuchsebene über den Parameter segment abgefragt werden.
  • Die bestehenden Standardsegmente mit negativen numerischen IDs sind davon nicht betroffen. Die neuen Standardsegmente werden derzeit jedoch nicht unterstützt.

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

App-Tracking

  • Diese Daten sind in App-Profilberichten enthalten:
    • Dim – ga:appId – Die ID der Anwendung.
    • Dimm – ga:appInstallerId – ID des Installationsprogramms (z.B. Google Play Store), aus dem die App heruntergeladen wurde. Standardmäßig wird die App-Installations-ID anhand der PackageManager#getInstallerPackageName-Methode festgelegt.
    • Dim – ga:appName – Der Name der Anwendung.
    • Dim – ga:appVersion – Die Version der Anwendung.
    • Dim: ga:exitScreenName – der Name des Bildschirms, wenn der Nutzer die App beendet hat.
    • Dimm – ga:landingScreenName – Name des ersten angezeigten Bildschirms.
    • Dim: ga:screenDepth – Die Anzahl der Bildschirmaufrufe pro Sitzung als String. Dieser Wert kann für Histogramme hilfreich sein.
    • Dimm – ga:screenName – der Name des Bildschirms.
    • Met – ga:avgScreenviewDuration – Die durchschnittliche Zeit, die Nutzer in Sekunden auf einem Bildschirm verbracht haben.
    • Met – ga:timeOnScreen – Die Zeit, die Sie mit dem Ansehen des aktuellen Bildschirms verbracht haben.
    • Met – ga:screenviews – Die Gesamtzahl der Bildschirmaufrufe. Verwende dieses anstelle von ga:appviews.
    • Met – ga:uniqueScreenviews – die Anzahl der verschiedenen (eindeutigen) ga:screenviews innerhalb einer Sitzung. Verwende dieses anstelle von ga:uniqueAppviews.
    • Met – ga:screenviewsPerSession – die durchschnittliche Anzahl von ga:screenviews pro Sitzung. Verwende dieses anstelle von ga:appviewsPerVisit.

Verworfen

Die folgenden Messwerte wurden eingestellt. Verwenden Sie stattdessen den neuen Messwertnamen.

  • Erfüllt – ga:appviews – Verwenden Sie stattdessen ga:screenviews.
  • Erfüllt – ga:uniqueAppviews – Verwenden Sie stattdessen ga:uniqueScreenviews.
  • Erfüllt – ga:appviewsPerVisit – Verwenden Sie stattdessen ga:screenviewsPerSession.

Benutzerdefinierte Variablen oder Spalten

  • Zugriff auf benutzerdefinierte Dimensionen und Messwerte:

    • Dim – ga:dimensionXX – Der Name der angeforderten benutzerdefinierten Dimension, wobei XX sich auf die Zahl oder den Index der benutzerdefinierten Dimension bezieht.
    • Met – ga:metricXX – der Name des angeforderten benutzerdefinierten Messwerts, wobei XX die Zahl/den Index des benutzerdefinierten Messwerts angibt

Änderungen an der Dokumentation

Die folgende Dimension und der folgende benutzerdefinierte Messwert wurden umbenannt. Dies ist nur eine Dokumentationsänderung. Sie müssen Ihre Abfragen nicht aktualisieren.

  • ga:customVarName(n) → ga:customVarNameXX
  • ga:customVarValue(n) → ga:customVarValueXX

E-Commerce

  • Dim – ga:currencyCode: Der Code der lokalen Währung der Transaktion gemäß ISO-4217-Standard.
  • Erfüllt: ga:localItemRevenue – Produktumsatz in der Landeswährung
  • Erfüllt – ga:localTransactionRevenue – Transaktionsumsatz in der Landeswährung
  • Erfüllt: ga:localTransactionShipping – Versandkosten für die Transaktion in Landeswährung
  • Erfüllt – ga:localTransactionTax – Transaktionssteuer in der Landeswährung

Ausnahmen

  • Diese Daten stammen aus dem Ausnahme-Tracking.
    • Dimm – ga:exceptionDescription – Die Beschreibung der Ausnahme.
    • Met – ga:exceptionsPerScreenview – Anzahl der ausgelösten Ausnahmen geteilt durch die Anzahl der Bildschirmaufrufe.
    • Met – ga:fatalExceptionsPerScreenview – Die Anzahl der schwerwiegenden Ausnahmen geteilt durch die Anzahl der Bildschirmaufrufe.

Zielvorhaben-Conversions

  • Dim – ga:goalCompletionLocation – Der Seitenpfad oder Bildschirmname, der mit einem beliebigen Abschlüsse für Zieltyp übereinstimmt.
  • Dim – ga:goalPreviousStep1 – Der Seitenpfad oder Bildschirmname, der einem Ziel vom Typ „Ziel“ entspricht, einen Schritt vor dem Abschluss des Ziels.
  • Dim – ga:goalPreviousStep2 – Der Seitenpfad oder Bildschirmname, der mit einem beliebigen Zielvorhaben vom Typ „Ziel“ übereinstimmte, zwei Schritte vor der Position des Zielvorhabenabschlusses.
  • Dim – ga:goalPreviousStep3 – Der Seitenpfad oder Bildschirmname, der mit einem beliebigen Zielvorhaben vom Typ „Ziel“ übereinstimmte, drei Schritte vor der Position des Zielvorhabenabschlusses.

Änderungen an der Dokumentation

Die folgende Dimension und die Zielvorhaben „Ziel-Conversions“ wurden umbenannt. Dies ist nur eine Dokumentationsänderung. Sie müssen Ihre Abfragen nicht aktualisieren.

  • ga:goal(n)AbandonRate → ga:goalXXAbandonRate
  • ga:goal(n)Abandons → ga:goalXXAbandons
  • ga:goal(n)Completions → ga:goalXXCompletions
  • ga:goal(n)ConversionRate → ga:goalXXConversionRate
  • ga:goal(n)Starts → ga:goalXXStarts
  • ga:goal(n)Value → ga:goalXXValue
  • ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate
  • Erfüllt: ga:percentSearchRefinements – Der Prozentsatz der Suchfilter, d.h. die Umstellung, zwischen Keywords für die interne Suche innerhalb einer Sitzung.

Seiten-Tracking

  • Met – ga:pageValue – der durchschnittliche Wert dieser Seite oder einer Gruppe von Seiten Seitenwert ist ((Transaktionsumsatz + Gesamtzielwert) geteilt durch eindeutige Seitenaufrufe für die Seite oder Seitengruppe).

Plattform oder Gerät

  • Diese Daten werden aus dem HTTP-User-Agent-String abgeleitet.

    • Dimm: ga:deviceCategory – Gerätetyp: Computer, Tablet oder Smartphone.
    • Dimm – ga:isTablet – Gibt Tablet-Besucher an. Mögliche Werte sind Yes und No.
    • Dimm – ga:mobileDeviceMarketingName – Marketingname des Mobilgeräts.

Soziale Interaktionen

  • Diese Daten stammen aus dem Tracking von sozialen Interaktionen vor Ort.

    • Dimm – ga:socialEngagementType – Interaktionstyp. Mögliche Werte sind Socially Engaged und Not Socially Engaged.

Zeit

  • Dimm – ga:dateHour – Kombinierte Werte von ga:date und ga:hour.
  • Dimm – ga:dayOfWeekName – der Name des Wochentags (auf Englisch).
  • Dim – ga:isoWeek – Die ISO-Wochennummer, wobei jede Woche mit einem Montag beginnt. Weitere Informationen: http://en.wikipedia.org/wiki/ISO_week_date
  • Dimm – ga:yearMonth – Kombinierte Werte von ga:year und ga:month.
  • Dimm – ga:yearWeek – Kombinierte Werte von ga:year und ga:week.

Besucherquellen

  • Dim – ga:fullReferrer – Die vollständige Verweis-URL, einschließlich Hostname und Pfad.
  • Dimm – ga:sourceMedium – Die kombinierten Werte von ga:source und ga:medium.
  • Dieser Release umfasst zwei neue Testmesswerte: ga:experimentId bis ga:experimentVariant
  • In diesem Release werden fünf neue Messwerte zur Websitegeschwindigkeit hinzugefügt:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • In diesem Release wird ein neues Standardsegment für Tablet-Traffic hinzugefügt: gaid::-13.

In diesem Release werden der API neue Dimensionen und Messwerte hinzugefügt. Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

App-Tracking

  • Diese Daten sind in Berichten des Mobile App Tracking SDK enthalten:
    • Erfüllt: ga:uniqueAppviews – Anzahl der App-Aufrufe pro Sitzung
    • Erfüllt: 'ga:appviews – die Gesamtzahl der App-Aufrufe
    • Met – ga:appviewsPerVisit – die durchschnittliche Anzahl der App-Aufrufe pro Sitzung.

Besucherquellen

  • Dim – ga:socialNetwork: ein String für den Namen des sozialen Netzwerks. Das kann sich auf das verweisende soziale Netzwerk für Besucherquellen oder auf das soziale Netzwerk für Aktivitäten im Hub für soziale Interaktionsdaten beziehen. z.B. Google+, Blogger, Reddit usw.
  • Dim – ga:hasSocialSourceReferral: Gibt Besuche an, die von einer sozialen Quelle (z. B. einem sozialen Netzwerk wie Google+, Facebook oder Twitter) auf die Website gelangt sind. Mögliche Werte sind „Ja“ und „Nein“, wobei der erste Buchstabe großgeschrieben werden muss.

Soziale Aktivitäten

  • Diese Daten stammen aus externen Aktivitäten, die von Social Data Hub-Partnern importiert wurden.
    • Dim – ga:socialActivityDisplayName – Bei einer Hub für soziale Interaktionsdaten enthält dieser String den Titel der vom Nutzer des sozialen Netzwerks geposteten sozialen Aktivität.
    • Dim – ga:socialActivityEndorsingUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die URL der sozialen Aktivität dar, z.B. die URL des Google+ Beitrags oder des Kommentars im Blog.
    • Dim – ga:socialActivityPost – Bei einer Aktivität im Hub für soziale Interaktionsdaten enthält dieser String den Inhalt der vom Nutzer des sozialen Netzwerks geposteten sozialen Aktivität (z.B. den Nachrichteninhalt eines Google+ Beitrags)
    • Dim – ga:socialActivityTimestamp – Bei einer Hub-Aktivität im sozialen Netzwerk wird mit diesem String angegeben, wann die soziale Aktivität im sozialen Netzwerk stattgefunden hat.
    • Dim – ga:socialActivityUserPhotoUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die URL des Fotos dar, das mit dem Profil des Nutzers im sozialen Netzwerk verknüpft ist.
    • Dim – ga:socialActivityUserProfileUrl – Bei einer Hub-ID im sozialen Netzwerk steht dieser String für die URL des Profils des zugehörigen Nutzers.
    • Dim – ga:socialActivityContentUrl – Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die URL dar, die vom zugehörigen Nutzer des sozialen Netzwerks geteilt wird.
    • Dim – ga:socialActivityTagsSummary – Bei einer Aktivität im Hub für soziale Interaktionen ist dies ein durch Kommas getrennter Satz von Tags, die mit der Social-Media-Aktivität verknüpft sind.
    • Dim – ga:socialActivityUserHandle – Bei einer Hub-Adresse im sozialen Netzwerk steht dieser String für den Alias des Nutzers im sozialen Netzwerk, der die soziale Aktivität initiiert hat.
    • Dim – ga:socialActivityAction – Bei einer Hub für soziale Interaktionsdaten stellt dieser String die Art der sozialen Interaktion dar, die mit der Aktivität verknüpft ist (z. B. Abstimmen, Kommentieren, +1).
    • Dim – ga:socialActivityNetworkAction – Bei einer Hub für soziale Interaktionsdaten enthält dieser String die Art der sozialen Interaktion und das soziale Netzwerk, aus dem die Aktivität stammt.
    • Erfüllt – ga:socialActivities – Die Anzahl der Aktivitäten, bei denen eine Content-URL in einem Partnernetzwerk im Hub für soziale Daten geteilt/erwähnt wurde

Soziale Interaktionen

  • Diese Daten stammen aus dem Tracking von sozialen Interaktionen vor Ort.
    • Dimmen – ga:socialInteractionAction – Bei sozialen Interaktionen ein String, der die zu verfolgende soziale Interaktion darstellt (z. B. +1, z. B. „Lesezeichen“)
    • Dim – ga:socialInteractionNetwork – Bei sozialen Interaktionen ein String, der das erfasste soziale Netzwerk darstellt (z.B. Google, Facebook, Twitter, LinkedIn)
    • Dim – ga:socialInteractionNetworkAction – Bei sozialen Interaktionen ein String, der die Verkettung der erfassten ga:socialInteractionNetwork und ga:socialInteractionAction darstellt (z.B. Google: +1, Facebook: „Gefällt mir“)
    • Dim – ga:socialInteractionTarget: Bei sozialen Interaktionen ein String, der die URL (oder Ressource) darstellt, die die Aktion für das soziale Netzwerk empfängt.
    • Erfüllt: ga:socialInteractions – die Gesamtzahl der sozialen Interaktionen auf Ihrer Website
    • Erfüllt: ga:uniqueSocialInteractions – die Gesamtzahl einzelner sozialer Interaktionen auf Ihrer Website Basierend auf dem Wertpaar ga:socialInteractionNetwork und ga:socialInteractionAction
    • Erfüllt: ga:socialInteractionsPerVisitga:socialInteractions/ga:uniqueSocialInteractions. Die durchschnittliche Anzahl sozialer Interaktionen pro Besuch auf Ihrer Website.

Geografie / Netzwerk

  • Dim – ga:metro – Der Designated Market Area (DMA), aus dem der Traffic stammt.

Seiten-Tracking

  • Dim – ga:pagePathLevel1: Mit dieser Dimension werden alle „pagePaths“ auf der ersten Hierarchieebene in „pagePath“ zusammengefasst.
  • Dim – ga:pagePathLevel2: Mit dieser Dimension werden alle „pagePaths“ auf der zweiten hierarchischen Ebene in „pagePath“ zusammengefasst.
  • Dim – ga:pagePathLevel3: Mit dieser Dimension werden alle „pagePaths“ auf der dritten Hierarchieebene in „pagePath“ zusammengefasst.
  • Dim – ga:pagePathLevel4: Mit dieser Dimension werden alle „pagePaths“ auf der vierten hierarchischen Ebene in „pagePath“ zusammengefasst. Alle weiteren Ebenen in der „pagePath“-Hierarchie werden ebenfalls in dieser Dimension zusammengefasst.

Ausnahmeverfolgung

  • Diese Daten stammen aus Ausnahmeverfolgungsdaten.

    • Erfüllt: ga:exceptions – Anzahl der Ausnahmen, die an Google Analytics gesendet wurden
    • Met – ga:fatalExceptions – Die Anzahl der Ausnahmen, bei denen isFatal auf „true“ gesetzt ist.

Nutzertiming

  • Diese Daten stammen aus Nutzertiming-Daten.

    • Dim – ga:userTimingCategory – Ein String zum Kategorisieren aller Variablen für das Nutzertiming in logische Gruppen, um die Berichterstellung zu vereinfachen.
    • Dim – ga:userTimingLabel: ein String zur Angabe des Namens der Aktion der zu verfolgenden Ressource.
    • Dim – ga:userTimingVariable: ein String, mit dem Sie das Timing von Nutzern in den Berichten flexibel visualisieren können.
    • Dim: ga:userTimingValue Die Anzahl der Millisekunden, die vergangen sind und an Google Analytics gesendet wurden.
    • Met – ga:userTimingSample – die Anzahl der gesendeten Stichproben.
    • Met – ga:avgUserTimingValue – der durchschnittliche Wert für das Nutzertiming ga:userTimiingValue / ga:userTimiingSample.

Gerät / Plattform

  • Diese Daten stammen vom User-Agent der erhobenen Daten.
    • Dim – ga:mobileDeviceBranding – Hersteller oder Markenname des Mobilgeräts (Beispiele: Samsung, HTC, Verizon, T-Mobile).
    • Dimm – ga:mobileDeviceModel – Modell des Mobilgeräts (Beispiel: Nexus S)
    • Dimmen – ga:mobileInputSelector – Eingabemethode des Mobilgeräts (z. B. Touchscreen, Joystick, Klickrad oder Eingabestift)
    • Dim - ga:mobileDeviceInfo – Branding-, Modell- und Marketingname des Mobilgeräts.

Fehlerkorrekturen

  • Die API verarbeitet UTF-8-Zeichen in einem Filter oder einem dynamischen Segment jetzt korrekt.

In dieser Version können Google Analytics Premium-Konten auf bis zu 50 benutzerdefinierte Variablen zugreifen.

In dieser Version wurden zwei Programmfehler behoben:

Fehlerkorrekturen

  • Bei Abfragefiltern, die Sonderzeichen in regulären Ausdrücken enthalten, werden keine Serverfehler mehr zurückgegeben.

  • Wenn Sie einen Messwertfilter mit einem erweiterten Segment kombinieren, wird kein Fehler mehr zurückgegeben.

In diesem Release werden der API neue Messwerte zur Websitegeschwindigkeit hinzugefügt.

Neue Messwerte

  • Die folgenden Messwerte für die Websitegeschwindigkeit wurden hinzugefügt:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Erinnerung: Einstellung der API-Version 2.3

  • Version 2.3 der Datenexport API wurde zwei Monate lang eingestellt. In etwa vier weiteren Monaten wird dieser Dienst eingestellt und wir unterstützen nur noch die neue Core Reporting API Version 3.0 und Version 2.4.

  • Wir empfehlen Ihnen dringend, Ihre Anwendungen auf Version 3.0 zu migrieren.

  • In einem Zeitraum von vier Monaten werden Anfragen an den alten XML-Datenfeed an Version 2.3 an Version 2.4 weitergeleitet und dann wird eine XML-Antwort aus Version 2.4 zurückgegeben. Dann gelten alle Kontingentrichtlinien der Version 2.4 für Anfragen der Version 2.3.

  • Alle Anfragen für JSON in Version 2.3 oder die Google Data JavaScript-Clientbibliothek, die die JSON-Ausgabe in Version 2.3 verwendet, geben 404-Statuscodes zurück.

  • Sie müssen sowohl in Version 3.0 als auch in Version 2.4 Ihre Anwendung in der Google APIs Console registrieren und in jeder Anfrage einen API-Schlüssel (oder ein OAuth 2.0-Token) verwenden, um das volle Kontingent zu erhalten.

Wir haben einen kleinen Fehler mit ga:visitLength behoben. Für diese Dimension werden jetzt die korrekten Daten zurückgegeben.

Dieser Release betrifft alle Google Analytics API-Entwickler. Darin werden zwei neue Versionen der API angekündigt, Anwendungen müssen registriert werden, es wird eine neue Kontingentrichtlinie eingeführt und der API-Name wird in die Core Reporting API geändert. Außerdem wird Version 2.3 der Datenexport API eingestellt.

Version 3.0

  • Die Core Reporting API Version 3.0 ist die neueste Hauptversion unserer API und nicht abwärtskompatibel. Die zukünftige Entwicklung der API erfolgt mit dieser Version.

  • Neue Funktionen

    • Eine neue JSON-basierte Ausgabe reduziert die Größe der Antwort um etwa das 10-Fache der vorherigen XML-Ausgabe.
    • Neue Google API-Clientbibliotheken, die Java, JavaScript, Python, PHP, Ruby und .Net unterstützen.
    • Unterstützung für die Google Discovery API.
    • Unterstützung von OAuth 2.0 als neue, empfohlene Methode zur Autorisierung von Nutzern
  • Aktuell

    • Neue URL für Anfragen: https://www.googleapis.com/analytics/v3/data/ga….
    • Registrierungs- und Entwicklertoken erforderlich.
    • Alle Anfragen für Konfigurationsdaten sollten über die Management API erfolgen.

Version 2.4

  • Die Core Reporting API Version 2.4 ist ein Nebenversionsupgrade, das hauptsächlich abwärtskompatibel mit der vorhandenen Data Export API-Version 2.3 ist.

  • Aktuell

    • Neue URL für Anfragen: https://www.googleapis.com/analytics/v2.4/data…
    • Registrierungs- und Entwicklertoken erforderlich.
    • XML-Ausgabe in Übereinstimmung mit Version 2.3, sodass die anderen vorhandenen Google Data-Clientbibliotheken weiterhin funktionieren
    • Fehlercode für Kontingentfehler wurde von 503 zu 403 geändert
    • JSON-Antworten werden nicht unterstützt.
    • Die Google Data JavaScript-Clientbibliothek wird nicht unterstützt.
    • Kein Kontofeed. Alle Anfragen für Konfigurationsdaten sollten über die Management API erfolgen.

Anmeldung

  • Alle mit der Google Analytics API erstellten Anwendungen müssen über die Google APIs Console als Projekt registriert werden.

  • Jede Anfrage an die API muss entweder einen API-Schlüssel oder für OAuth 2.0 eine Client-ID und einen Clientschlüssel enthalten.

Kontingentrichtlinie

  • Das folgende Kontingent gilt sowohl für die Anlaytics APIs (Management API als auch die Datenexport-API)

    • 50.000 Anfragen pro Projekt und Tag
    • 10 Abfragen pro Sekunde pro IP-Adresse
  • Das folgende Kontingent gilt für die Datenexport-API

    • 10.000 Anfragen pro Profil und Tag
    • 10 gleichzeitige Anfragen pro Profil
  • Für nicht registrierte Anwendungen bieten wir ein sehr geringes Kulanzzeitraum für eine kleine Anzahl von Tests an.

Eingestellte Produkte und Funktionen

  • In dieser Version wird auch die Einstellung von Version 2.3 und die bevorstehende Einstellung des Kontofeeds in der Datenexport API angekündigt. In 6 Monaten:

    • Anfragen an den XML-Datenfeed der Version 2.3 werden an Version 2.4 weitergeleitet und enthalten eine Antwort aus Version 2.4. Dann gelten alle Kontingentrichtlinien der Version 2.4 für Anfragen der Version 2.3.

    • Anfragen an die JSON-Ausgabe der Version 2.3 werden von der Antwort der Version 2.4 nicht unterstützt und geben 404 Not Found-Statuscodes zurück. Wenn Sie eine JSON-Antwort benötigen, führen Sie ein Upgrade auf Version 3.0 aus.

    • Bei Anfragen an den Kontofeed in der Datenexport-API werden 404 Not Found-Statuscodes zurückgegeben. Alle Anfragen für Konfigurationsdaten sollten über die Management API erfolgen.

In dieser Version sind aktuellere AdWords-Daten und mehr Kombinationen für AdWords-Dimensionen und -Messwerte verfügbar.

  • Die AdWords-Daten werden innerhalb einer Stunde aktualisiert. Vor der täglichen Aktualisierung der Daten

  • Wir haben einige gültige Kombinationen von AdWords-Daten eingeschränkt.

Vor einigen Wochen haben wir eine Änderung vorgenommen, um API-Abfragen zu verhindern, die nach ga:adGroup oder ga:adContent mit ga:impressions gefragt wurden, da diese Kombination 0 zurückgegeben hat. Durch diese Änderung wurde die Kombination wiederhergestellt und die Daten wurden wiederhergestellt.

In diesem Release wurden einige ungültige Kombinationen von Dimensionen und Messwerten behoben

Ungültige Kombinationen von Messwerten und Dimensionen behoben

  • Letzten Monat haben wir einige Änderungen an der API angekündigt, um einige ungültige Abfragen im Datenfeed zu unterbinden, für die keine Daten zurückgegeben werden. Wir haben diese Änderungen an der API vorgenommen und die folgenden Kombinationen sind jetzt ungültig:

    • Produktdimensionen können nicht mit Transaktionsmesswerten kombiniert werden.
    • ga:adContent oder ga:adGroup können nicht mit ga:impressions kombiniert werden.

    Die API gibt jetzt für alle Abfragen, bei denen diese Kombinationen angefordert werden, einen 400-Fehlercode zurück.

In diesem Release wird der Konfidenzintervallwert in Messwerten verworfen.

Konfidenzintervall wird eingestellt

  • Verwenden Sie noch keine Konfidenzintervallwerte für Messwerte, falls noch nicht geschehen. In diesem Release gibt der Data Export API-Datenfeed für alle Konfidenzintervallwerte den Wert 0, 0 zurück. In etwa einem Monat werden wir dieses Attribut aus allen Messwertelementen entfernen.

    Um festzustellen, ob eine Stichprobe für eine Antwort verwendet wurde, verwenden Sie in der Antwort das Feld enthältSampledData.

In diesem Release werden drei neue Messwerte hinzugefügt und der Rückgabewert von zwei aktualisiert.

Neue Datenaktualisierungen

  • Wir haben der API drei neue Messwerte zur Websitegeschwindigkeit hinzugefügt:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Messwertaktualisierungen

  • Um Währungswerte in Filtern anzugeben, müssen Sie den tatsächlichen Wert angeben, der vom Tracking-Code übergeben wird. Beispiel: 1 Einheit wird jetzt als 1 angegeben.

  • ga:CTR gibt jetzt den tatsächlichen Prozentsatz zurück (z.B. wird ein Wert von 2% als 2 zurückgegeben).

Dieser Release verbessert die Leistung des Datenfeeds und fügt neue Daten hinzu:

Leistungssteigerung

  • Dieser Release verbessert die Latenz des Datenfeeds um 30 bis 35%.

Neue Datenaktualisierungen

  • Wir haben die Liste der Dimensionen und Messwerte aktualisiert, die in erweiterten Segmenten zulässig sind. Bitte sehen Sie in der aktualisierten Liste nach, ob Ihre Anfragen gültig sind.

Anstehende Änderungen

  • Derzeit müssen Sie einen Währungsfilterwert als Mikroeinheiten angeben, z. B. 1 Währungseinheit als 1000000. In naher Zukunft müssen Sie den tatsächlichen Wert angeben, der vom Tracking-Code übergeben wird (z.B. wird 1 jetzt als 1 angegeben).

  • Derzeit ist ga:CTR ein percent und gibt den Wert 0, 02 zurück. In naher Zukunft ändert sich dadurch der tatsächliche Prozentsatz (z.B. 2).

In diesem Release werden dem Datenfeed weitere Daten hinzugefügt:

Neue Datenaktualisierungen

  • Die folgende Zeitdimension wurde hinzugefügt: ga:dayOfWeek

  • Der folgende Messwert für die interne Suche wurde hinzugefügt: ga:percentVisitsWithSearch

  • Die folgenden Ereignis-Tracking-Messwerte wurden hinzugefügt:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Anstehende Änderungen

Derzeit gibt die API 401-Statuscodes für verschiedene Autorisierungsprobleme zurück. Innerhalb der nächsten Wochen wird der Status 401 ausschließlich für ungültige Tokens verwendet. So haben Entwickler die Möglichkeit, diese Ausnahme zu bearbeiten.

In dieser Version werden dem Datenfeed deutlich mehr Daten hinzugefügt:

Neue Datenaktualisierungen

  • Die Berechnung des Messwerts ga:visitors wurde geändert, um die Anzahl der einzelnen Besucher für den ausgewählten Zeitraum abzurufen. Jetzt werden mehr Kombinationen aus Dimensionen und Messwerten unterstützt.

  • Zehn neue AdWords-Dimensionen wurden hinzugefügt: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • Der Messwert „ga:organicSearches“ wurde der Kampagnengruppe hinzugefügt.

  • Der Messwert „ga:searchResultViews“ wurde der Gruppe der internen Websitesuche hinzugefügt.

  • Es wurden drei neue zeitbasierte Dimensionen hinzugefügt: ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Die Gruppierungen von Dimensionen und Messwerten wurden geändert, um die jeweiligen Funktionen besser widerzuspiegeln.

Neue berechnete Messwerte

Die folgenden berechneten Messwerte werden aus Berechnungen mithilfe der Basismesswerte abgeleitet. Hinweis: Jeder Name mit (n) unterstützt die Werte 1–20.

  • Zielbasiert: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Inhaltsbasiert: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Interne Website-basierte Basis: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • E-Commerce-basiert: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

In diesem Release wird dem Datenfeed eine neue Funktion hinzugefügt:

Neue Funktionen

  • Es wurde ein neues XML-Element hinzugefügt, das Nutzer darüber informiert, ob eine Stichprobe der Daten erstellt wurde. true. Dieses Element gibt immer zurück, ob eine Stichprobe der Daten mit true oder false erhoben wurde. Die Java- und JavaScript-Bibliotheken wurden außerdem mit Hilfsmethoden für den Zugriff auf dieses Element aktualisiert.

In dieser Version wurden zwei Programmfehler behoben:

Fehlerkorrekturen

  • Bisher wurde einem Filterausdruck mit einer Dimension (z.B. ga:keyword==store,ga:keyword==bar) können zu unterschiedlichen Werten führen, als wenn jeder Filter einzeln auf mehrere Abfragen angewendet werden würde. Dieses Problem wurde behoben und durch die Verwendung des ODER-Operators werden jetzt konsistente Werte zurückgegeben.

  • Einige der API-Fehlermeldungen für ungültige Filter wurden aktualisiert und enthalten jetzt NICHT mehr, ob der Fehler durch einen Dimensions- oder Messwertfilter verursacht wurde. Der tatsächliche Filterausdruck wird jedoch weiterhin zurückgegeben.

In dieser Version wurden 3 Fehler behoben:

Fehlerkorrekturen

  • Ein Codierungsproblem in der JavaScript-Clientbibliothek wurde behoben. Analytics-Problemverfolgung

  • Ein Fehler, der dazu geführt hat, dass der Kontofeed nicht zurückgegeben wurde, wenn ein Zielvorhabenname, ein Zielvorhabenpfad, ein Vergleichswert oder ein Zielvergleichstyp falsch festgelegt wurde, wurde behoben.

  • Die Dimension oder der Messwert im Parameter für den Datenfeed-Abfragefilter ODER ist ungültig. Beispiel: ga:source==google,ga:visits>5. Die Fehlermeldung für diese ungültige Abfrage wurde aktualisiert: Cannot OR dimension filter(s) with metric filter.

In diesem Release werden neue Daten hinzugefügt und ein Fehler behoben:

Neue Funktionen

  • Die folgenden fünf Dimensionen wurden zur neuen Kategorie D8. Adwords hinzugefügt:

Fehlerkorrekturen

  • Im Kontofeed wurden keine Daten zurückgegeben, wenn in einem der Profile ein falsch konfiguriertes Zielvorhaben oder ein falscher Schritt vorhanden war. Dieses Problem wurde behoben.

In dieser Version wurden einige neue Funktionen hinzugefügt und ein Fehler behoben:

Neue Funktionen

  • Das iPhone-Standardsegment (gaid::-11) wurde optimiert. Jetzt können Berichte für alle Mobilgeräte erstellt werden. Die ID ist die gleiche wie zuvor (-11), aber der Name des Segments lautet jetzt: Mobile Traffic.

  • Die Abtastrate, die von der API verwendet wird, entspricht jetzt der Weboberfläche. Dadurch werden die Daten für die Stichprobenberichte inline in die Weboberfläche eingebunden.

  • Die Kontingentrichtlinie wurde aktualisiert, um sicherzustellen, dass alle Nutzer unterbrechungsfreien Zugriff auf Ressourcen erhalten. Weitere Informationen finden Sie in der Dokumentation zu Kontingentrichtlinien. Die neue Richtlinie lautet:

    • Eine einzelne Web-Property kann maximal 10.000 Anfragen innerhalb von 24 Stunden senden.
    • Eine Anwendung kann in einem bestimmten Zeitraum nur 10 Anfragen senden.
    • Eine App kann immer nur vier ausstehende Anfragen gleichzeitig haben.
  • Einige Einschränkungen bei Kombinationen von Dimensionen und Messwerten wurden gelockert. ga:nextPagePath und ga:previousPagePath sind jetzt Teil der Gruppe D3. Content. Die Gruppe D8. Custom Variable heißt jetzt D6. Custom Variable. Informationen zu diesen neuen Kombinationen finden Sie im aktualisierten Referenzleitfaden.

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, durch den die API den confidenceInterval-Wert für Messwerte gemeldet hat. Bisher konnten Konfidenzintervalle den Wert INF oder eine Zahl von 0 bis 1 haben. Jetzt haben alle Konfidenzintervalle einen Wert von INF oder eine Zahl größer oder gleich 0.

  • ga:itemQuantity und ga:uniquePurchases wurden zuvor ausgetauscht und die Werte der jeweils anderen zurückgegeben. Sie wurden nun korrigiert, um die richtigen Daten zurückzugeben.

Erinnerung an die Deaktivierung von Dimensionen und Messwerten

  • Falls noch nicht geschehen, verwenden Sie die zuvor eingestellten Dimensionen und Messwerte nicht mehr.

Dieser Release umfasst eine Reihe neuer Funktionen:

Dieser Release erhöht die Hauptversionsnummer auf 2

  • Für einige Funktionen sind die neuesten Clientbibliotheken erforderlich. Wir unterstützen offiziell Java und JavaScript. Bibliotheken von Drittanbietern werden möglicherweise noch nicht aktualisiert.

    • Version 2 kann angefordert werden, indem jedem Header oder jeder Datenfeed-Anfrage der Header GData-Version: 2 hinzugefügt wird. Weitere Informationen finden Sie in der Dokumentation.
    • Sowohl Konto- als auch Datenfeeds wurden um einen neuen XML-Namespace erweitert:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Die API unterstützt jetzt die Datenversion 2 des Google-Datenprotokolls.

Unterstützung erweiterter Segmentierung

  • Suchparameter für dynamische Segmente:

    • ...&segment=dynamic::Ausdruck
    • ermöglicht die Erstellung erweiterter Segmente im laufenden Betrieb.
    • Der Ausdruck kann eine beliebige Dimension oder ein beliebiger Messwert sein und sollte der Syntax der Filter entsprechen.
  • Abfrageparameter für Standard- und benutzerdefinierte Segmente:

    • ...&segment=gaid::Zahl
    • Dabei ist die ID eine ID, die auf ein erweitertes Segment verweist, das in der Google Analytics-Weboberfläche definiert ist.
    • Die ID finden Sie im Kontofeed.
  • Der Kontofeed beschreibt Segmentdaten mithilfe der folgenden XML-Elemente und Attribute:

    • ga:visitorType==Returning Visitor
  • Der Datenfeed enthält auch ein XML-Element, das angibt, ob ein Segment in der API-Anfrage angewendet wurde.

  • Weitere Informationen zu erweiterten Segmenten finden Sie in unserer Dokumentation.

Neue Zielvorhabendaten verfügbar

  • Im Kontofeed verfügbare Zielvorhaben für Zielvorhaben und Interaktionen:

  • Für die Zielvorhaben 5–20 wurden 48 neue Zielvorhabenmesswerte hinzugefügt, die alle der Konvention goal(n)Completions entsprechen, wobei (n) eine Zahl zwischen 1 und 20 ist.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll, GoalStartsAll und GoalValueAll wurden aktualisiert, um die neuen Zielvorhabendaten zu berücksichtigen.

Neue Daten zu benutzerdefinierten Variablen

  • Alle benutzerdefinierten Variablen, die jemals von einem Profil erfasst wurden, wurden dem Kontofeed als neues XML-Element hinzugefügt:

  • Für benutzerdefinierte Variablen wurden zehn neue Dimensionen hinzugefügt. Sie folgen der Konvention customVar(n), wobei (n) eine Zahl zwischen 1 und 5 sein kann.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Eingestellte Dimensionen und zu entfernende Messwerte

  • Falls noch nicht geschehen, verwenden Sie die zuvor eingestellten Dimensionen und Messwerte nicht mehr. Sie werden bald entfernt und geben auf Anfrage Fehler von unserer API zurück.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Die folgenden Dimensionen wurden umbenannt:

    • ga:countOfVisits ist jetzt ga:visitCount
    • ga:countOfVisitsToATransaction ist jetzt ga:visitsToTransaction

Dieser Release umfasst neue Funktionen und stellt einige ältere Funktionen ein:

  • Die folgenden Dimensionen und Messwerte wurden eingestellt. Sie werden in einem Monat endgültig aus der API entfernt. Aktualisieren Sie Ihren Code, damit Ihre Apps weiterhin funktionieren:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Die folgenden Dimensionen wurden umbenannt:

    • ga:countOfVisits heißt jetzt ga:visitCount
    • ga:countOfVisitsToATransaction ist jetzt ga:visitsToTransaction
  • Alle Ereignis-Tracking-Daten werden jetzt als zwei neue Gruppen dargestellt:

    D7. Ereignisse (Dimensionen) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Ereignisse (Messwerte) * ga:eventValue * ga:totalEvents * ga:UniqueEvents

  • Die Daten zur Navigation auf der Website sind jetzt über folgende Dimensionen verfügbar:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

  • Die Navigation auf der Landingpage umfasst jetzt folgende Dimensionen:

    D3. Inhalt * ga:landingPagePath * ga:secondPagePath

  • Die maximale Länge regulärer Ausdrücke im Filterparameter „Datenfeed“ wurde von 32 auf 128 Zeichen erhöht.

  • Der Bericht „Länge des Besuchs“ wird über die neue Dimension angezeigt:

    • ga:visitLength

In dieser Version wird die Google Analytics-API für den Datenexport so aktualisiert:

  • Einige Einschränkungen bei Kombinationen von Dimensionen und Messwerten wurden gelockert. Sie können jetzt die meisten Dimensionen für Content und Besucherebene gemeinsam abfragen. Beispielsweise ist ga:pagePath und ga:source jetzt eine gültige Kombination. Im aktualisierten Referenzhandbuch finden Sie die folgenden neuen Kombinationen: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • Die Gesamtzahl der Zeilen, die in einer Anfrage angefordert werden können, wurde auf 10.000 erhöht. Die Standardanzahl von zurückgegebenen Zeilen beträgt weiterhin 1.000. Sie kann jetzt jedoch durch Festlegen des Suchparameters max-results erhöht werden.

  • Der Kontofeed gibt jetzt zwei neue Datenelemente für jede Tabellen-ID (Währung und Zeitzone) zurück.

  • Jetzt erzwingen wir, dass Datenabfragen mindestens einen gültigen Messwert enthalten müssen.

  • Alle vorherigen Änderungen an der Einstellung wurden übernommen.

In dieser Version werden eingestellte Funktionen aus unserer nicht öffentlichen Betaversion entfernt:

  • In Anfragen für den Kontofeed wird kein Nutzername mehr unterstützt. Stattdessen werden nur Anfragen im folgenden Format akzeptiert:
    https://www.google.com/analytics/feeds/accounts/default

  • Die folgenden Messwerte werden entfernt und funktionieren nicht mehr. Stattdessen finden Sie hier eine Anleitung zur Berechnung dieser Werte: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgSeitenaufrufe
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:verlasseneTrichter1
    • ga:verlasseneTrichter2
    • ga:verlasseneTrichter3
    • ga:verlasseneTrichter4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Die folgenden Dimensionen und Messwerte wurden umbenannt. Die alten Namen funktionieren nicht mehr. Überprüfen Sie, ob Sie die offiziellen Namen in unserer Dokumentation verwenden: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Die Seite

    Die Seite