Änderungsprotokoll der Google Analytics Core Reporting API

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

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

Zugehörige Änderungsprotokolle abonnieren

Umfasst alle Sammlungs-, Konfigurations- und Berichterstellungs-APIs.

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 über einen bestimmten Zeitraum verknüpft sind. Sie ist in erster Linie für Property-Inhaber gedacht, die diesem Nutzer automatisierten Zugriff auf seine Daten gewähren möchten. Weitere Informationen finden Sie im Handbuch zur User Activity API.

In dieser Version wurde die maximale Anzahl der Zeilen erhöht, die im Ergebnissatz der Analytics Reporting API Version 4 zurückgegeben werden.

Die maximale Anzahl der Zeilen,die im Objekt ReportData der Analytics Reporting API Version 4 zurückgegeben werden,wurde von 10.000 auf 100.000 erhöht.

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

In dieser Version werden 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. In den Richtlinien zur Einstellung von Daten finden Sie weitere Informationen zum Entfernen von Daten:

In dieser Version 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 dieser Version wird der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Definitionen finden Sie in der Referenz für Dimensionen und Messwerte. In dieser Version werden auch einige eingestellte Dimensionen und Messwerte entfernt. Weitere Informationen zum vollständigen Ablauf der Datenentfernung finden Sie in der Richtlinie zur Einstellung von Daten für Google Analytics APIs.

Zeit

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

Datenlöschung

In dieser Version werden die folgenden nicht mehr unterstützten 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 dieser Version werden vorhandene Messwerte und Dimensionen in der API aktualisiert. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Nutzermesswerte

Die Berechnung der Messwerte Nutzer und Aktive Nutzer wurde aktualisiert, um Nutzer effizienter zu erfassen. Es kann sein, dass sich Ihre Messwerte geringfügig ändern. Weitere Informationen finden Sie unter So werden Nutzer für Nutzermesswerte identifiziert.

Von der Aktualisierung der Berechnung betroffene Nutzermesswerte:

  • ga:users: Die Gesamtzahl der Nutzer für den angeforderten Zeitraum.
  • ga:1dayusers: Gesamtzahl der an einem Tag aktiven Nutzer für jeden Tag im angegebenen Zeitraum.
  • ga:7dayusers: Gesamtzahl der an 7 Tagen aktiven Nutzer für jeden Tag im angegebenen Zeitraum.
  • ga:14dayusers: Gesamtzahl der an 14 Tagen aktiven Nutzer für jeden Tag im angegebenen Zeitraum.
  • ga:30dayusers: Gesamtzahl der an 30 Tagen aktiven Nutzer für jeden Tag im angegebenen Zeitraum.

Einzelne Ereignisse

Der Einstellungszeitraum für ga:uniqueEvents nähert sich dem Ende. Nach dem 26. März 2017 wird die Definition für ga:uniqueEvents aktualisiert und der private Messwert ga:uniqueEventsTemporary wird aus der API entfernt. Weitere Informationen finden Sie in der Hilfedokumentation zu eindeutigen Ereignissen.

In dieser Version wird der API eine neue Dimension hinzugefügt, die Fehlermeldungen verbessert und die zuvor angekündigten Änderungen für Dimensionen und Messwerte in AdSense werden erzwungen.

Nutzerdimensionen

  • Dimension: ga:userBucket: Die Dimension „Nutzer-Bucket“ mit den Werten 1 bis 100 gibt für jeden Nutzer den Bucket an, dem er zugewiesen ist. Weitere Informationen finden Sie im Artikel Remarketing-Kampagnen testen.

Fehlermeldungen

Früher gab die API eine fehlerhafte Fehlermeldung zurück (Unknown dimension(s): oder Unknown metric(s):, wenn Daten mit nicht erfüllten Bedingungen angefordert wurden), gibt die API jetzt folgende Meldung zurück: Restricted metric(s): ... can only be queried under certain conditions.

AdSense-Dimensionen und -Messwerte

Verknüpfte Datenansichten, bei denen es sich nicht um AdSense handelt, können keine AdSense-Dimensionen und -Messwerte abfragen. Die Abfrage dieser Dimensionen und Messwerte in nicht mit AdSense verknüpften Datenansichten führt zu einem Fehler.

Mit dieser neuen Version zur Fehlerkorrektur wurde ein Problem mit AdSense-Dimensionen und -Messwerten behoben. Außerdem wird eine bevorstehende Änderung an diesen Dimensionen und Messwerten angekündigt.

AdSense-Dimensionen und -Messwerte

In dieser Version wurde ein Problem behoben, das seit dem 7. Januar 2017 dazu geführt hat, dass Abfragen von AdSense-Dimensionen und -Messwerten für nicht mit AdSense verknüpfte Datenansichten den Fehler "Unbekannter Messwert" zurückgeben.

Anstehende Änderungen

Ab dem 31. Januar 2017 können Datenansichten, bei denen es sich nicht um AdSense handelt, keine Möglichkeit mehr haben, AdSense-Dimensionen und -Messwerte abzufragen. Die Abfrage dieser Dimensionen und Messwerte in nicht mit AdSense verknüpften Datenansichten führt zu einem Fehler.

In diesem Release wird der API der folgende neue Messwert hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Berechnete Messwerte

In dieser Version werden berechnete Messwerte unterstützt.

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

In dieser Version wurde der API ein neuer Messwert hinzugefügt. Außerdem wird ein vorhandener Messwert verworfen. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Ereignis-Tracking

Die Definition von ga:uniqueEvents wird geändert, um die Anzahl der einzelnen Ereignisse genauer abzubilden. Um diese Änderung zu beeinflussen, werden wir den aktuellen Messwert „ga:uniqueEvents“ gemäß unserer Richtlinie zur Einstellung von Daten technisch einstellen. Wenn Sie die neue Definition ausprobieren möchten, können Sie auf den privaten Messwert ga:uniqueEventsTemporary verweisen, mit dem die Anzahl einzelner Ereignisse genauer berechnet wird. Außerdem wird der neue Messwert „ga:uniqueDimensionCombinations“ eingeführt, der die aktuelle Definition von „ga:uniqueEvents“ beibehält. Nach Ablauf des entsprechenden Zeitraums (ungefähr sechs Monate) wird der private Messwert „ga:uniqueEventsTemporary“ entfernt. Der ursprüngliche Messwert „ga:uniqueEvents“ wird dann die Anzahl der einzelnen Ereignisse korrekt darstellen. Weitere Informationen finden Sie in den Hilfeartikeln zu eindeutigen Ereignissen.

Einzelne Ereignisse

  • Messwert: ga:uniqueEvents: Die Definition von ga:uniqueEvents wird sich bald ändern, um die Anzahl der einzelnen Ereignisse genauer abzubilden. Verwenden Sie stattdessen ga:uniqueDimensionCombinations, wenn Sie die vorhandene Definition beibehalten möchten. Weitere Informationen finden Sie in der Hilfedokumentation zu eindeutigen Ereignissen.
  • Mit dem Messwert „ga:uniqueDimensionCombinations“ (Kombinationen eindeutiger Dimensionen) wird die Anzahl der Kombinationen aus einzelnen Dimensionswerten für jede Dimension in einem Bericht erfasst. 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 der Hilfedokumentation zu eindeutigen Ereignissen.

Übergangstests – privat

  • Messwert – ga:uniqueEventsTemporary: Anzahl der eindeutigen Ereignisse. Dies ist die neue Definition für „ga:uniqueEvents“. Anhand dieses Messwerts können Sie die neue Definition vor der Änderung nachvollziehen. Dieser Messwert ist privat und wird nicht im Referenztool für Dimensionen und Messwerte aufgeführt.

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

DoubleClick Bid Manager

  • Dimension: ga:dbmClickAdvertiser: Name des DBM-Werbetreibenden, 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 mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickCreativeId – DBM-Creative-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickExchange – Name der DBM-Anzeigenplattform des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickExchangeId – ID der DBM-Anzeigenplattform des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickInsertionOrder: Name des DBM-Anzeigenauftrags, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmClickInsertionOrderId – DBM-Anzeigenauftrags-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickLineItem – DBM-Werbebuchungsname des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickLineItemId – DBM-Werbebuchungs-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickSite – Name der DBM-Website, auf der das DBM-Creative ausgeliefert und für den mit der Google Analytics-Sitzung übereinstimmenden DBM-Klick angeklickt wurde (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickSiteId – DBM-Website-ID, auf der das DBM-Creative ausgeliefert und für den mit der Google Analytics-Sitzung übereinstimmenden DBM-Klick angeklickt wurde (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventAdvertiser: Name des DBM-Werbetreibenden des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmLastEventAdvertiserId – DBM-Werbetreibenden-ID des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmLastEventCreativeId – DBM-Creative-ID des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventExchange: Name der DBM-Anzeigenplattform des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventExchangeId: ID der DBM-Anzeigenplattform des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventInsertionOrder: Name des DBM-Anzeigenauftrags des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmLastEventInsertionOrderId – DBM-Anzeigenauftrags-ID des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventLineItem: Name der DBM-Werbebuchung des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventLineItemId: DBM-Werbebuchungs-ID des letzten DBM-Ereignisses (Impression oder Klick im Lookback-Window von DBM), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmLastEventSite: Name der DBM-Website, auf der das DBM-Creative für das letzte DBM-Ereignis (Impression oder Klick im Lookback-Window) angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur für Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmLastEventSiteId – DBM-Website-ID, auf der das DBM-Creative für das letzte DBM-Ereignis (Impression oder Klick im Lookback-Window) angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCPA – eCPA des DBM-Umsatzes (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCPC – auto-optimierter CPC des DBM-Umsatzes (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCPM – eCPM des DBM-Umsatzes (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCTR – DBM-CTR (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmClicks – DBM-Klicks insgesamt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmConversions – DBM-Conversions insgesamt (nur bei Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCost – DBM-Kosten (nur bei Analytics 360, Verknüpfung mit 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, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dsAdGroup – DS-Anzeigengruppe (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsAdGroupId – DS-Anzeigengruppen-ID (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsAdvertiser – DS-Werbetreibender (nur bei Analytics 360, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsAdvertiserId – DS-Werbetreibenden-ID (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsAgency – DS-Agentur (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsAgencyId – DS-Agentur-ID (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsCampaign – DS-Kampagne (nur bei Analytics 360, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsCampaignId – DS-Kampagnen-ID (nur bei Analytics 360, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsEngineAccount – DS-Engine-Konto (nur bei Analytics 360, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsEngineAccountId – DS-Engine-Konto-ID (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsKeyword – DS-Keyword (nur bei Analytics 360, Integration in DS erforderlich).
  • Dimension – ga:dsKeywordId – DS-Keyword-ID (nur bei Analytics 360, Integration in DS erforderlich).
  • ga:dsCPC – DS-Kosten des Werbetreibenden pro Klick (nur bei Analytics 360, Integration in DS erforderlich).
  • ga:dsCTR: DS-Klickrate (nur bei Analytics 360, Integration in DS erforderlich).
  • ga:dsClicks: DS-Klicks (nur bei Analytics 360, DS-Integration erforderlich).
  • ga:dsCost: DS-Kosten (nur bei Analytics 360, Integration in DS erforderlich).
  • ga:dsImpressions: DS-Impressionen (nur bei Analytics 360, DS-Integration erforderlich).
  • ga:dsProfit: DS-Profil (nur bei Analytics 360, Integration in DS erforderlich)
  • ga:dsReturnOnAdSpend: DS-ROAS (Return on Advertising Spend) (nur bei Analytics 360, Integration in DS erforderlich).
  • ga:dsRevenuePerClick – DS-Umsatz pro Klick (nur bei Analytics 360, Integration in DS erforderlich).

In diesem Release wird der API eine neue Dimension hinzugefügt. In dieser Version gelten außerdem bestimmte Einschränkungen für die Kombination von Dimensionen, die zusammen abgefragt werden können. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Geo-Netzwerk

  • Dimension – ga:continentId: Kontinent-ID des Nutzers, 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 abgefragt werden:

  • Zur Shopping-Informationsgruppe
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO-Testgruppe
    • ga:experimentVariant
    • ga:experimentId
  • Interessengruppe
    • ga:interestOtherCategory
  • Kaufbereite Interessengruppe
    • ga:interestInMarketCategory
  • Gruppe für interne Werbung:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Branding-Interessengruppe:
    • ga:interestAffinityCategory

Dieser Release führt neue Beschränkungen und Kontingente ein. Einzelheiten finden Sie in der Dokumentation zu Beschränkungen und Kontingenten.

Fehler melden

In dieser Version werden Beschränkungen für fehlgeschlagene (5XX) Berichtsanfragen erzwungen.

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

Limits für Pivot-Tabellen

In dieser Version werden Einschränkungen für Pivot-Anfragen erzwungen:

  • Eine Berichtsanfrage kann jetzt maximal zwei Pivots umfassen.
  • Ein Pivot kann maximal vier Dimensionen haben.
  • Pivot-Dimensionen sind Teil der Beschränkung der Gesamtzahl der in der Anfrage zulässigen Dimensionen.
  • Pivot-metrics sind Teil der Einschränkung der Gesamtzahl der in der Anfrage zulässigen Messwerte.

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Geo-Netzwerk

  • Dimension: ga:metroId: Der dreistellige DMA-Code (Designated Market Area) von der Quelle, über die die Zugriffe erfolgten, basierend auf den IP-Adressen oder geografischen IDs der Nutzer.

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 angezeigt (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:dfpCoverage. Die Abdeckung gibt den Prozentsatz der Anzeigenanfragen an, bei denen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über das DFP-Konto keine zielgerichteten Anzeigen bereitgestellt werden können. (Anzeigenimpressionen / Anzeigenanfragen insgesamt) * 100 (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:dfpMonetizedPageviews: Dieser Messwert gibt die Gesamtzahl der Seitenaufrufe auf der Property an, bei denen eine Anzeige aus dem verknüpften DFP-Konto eingeblendet wurde. Beachte, dass eine einzelne Seite mehrere Anzeigenblöcke enthalten kann (d. h., die DFP-Verknüpfung ist aktiviert und die Option "DFP-Umsatz ausblenden" ist 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: Dies ist der Prozentsatz der sichtbaren Anzeigenimpressionen. Eine Impression gilt als sichtbare Impression, wenn sie im Browser des Nutzers dargestellt wurde und die Möglichkeit hat, sichtbar zu werden (die DFP-Verknüpfung ist aktiviert und die Option „DFP-Umsatz ausblenden“ nicht aktiviert).“
  • Messwert – ga:dfpClicks: Gibt an, wie oft DFP-Anzeigen auf der Website angeklickt wurden. Die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsatz ist nicht aktiviert.
  • Messwert – ga:dfpCTR: Der Prozentsatz der Seitenaufrufe, die zu einem Klick auf eine DFP-Anzeige geführt haben (die DFP-Verknüpfung ist aktiviert und die Option „DFP-Umsatz ausblenden“ ist nicht aktiviert).“
  • Messwert: ga:dfpRevenue: Der DFP-Umsatz ist eine Schätzung des gesamten Werbeumsatzes basierend auf den erzielten Impressionen. Die DFP-Verknüpfung ist 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 und nicht auf Anzeigenimpressionen. Die DFP-Verknüpfung ist aktiviert und die Option „DFP-Umsatz ausblenden“ ist nicht aktiviert.“
  • Messwert: ga:dfpECPM: Der effektive Cost-per-1000-Impressions. Dieser Wert gibt den DFP-Umsatz pro 1.000 Seitenaufrufe an. Bei aktivierter DFP-Verknüpfung und deaktivierter Option „DFP-Umsatz ausblenden“ ist die Option deaktiviert.“
  • Messwert: ga:backfillImpressions: Backfill-Impressionen ist die Summe aller AdSense- oder Ad Exchance-Anzeigenimpressionen, die über DFP als Backfill ausgeliefert wurden. Eine Anzeigenimpression wird erfasst, sobald auf der Website eine Einzelanzeige erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen angezeigt (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillCoverage: 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 (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillMonetizedPageviews: Dieser Messwert gibt die Gesamtzahl der Seitenaufrufe auf der Property an, bei denen mindestens eine Anzeige aus den verknüpften Backfill-Konten ausgeliefert wurde. Beachten Sie, dass ein einzelner monetarisierter Seitenaufruf mehrere Anzeigenimpressionen umfassen kann. Die DFP-Verknüpfung ist aktiviert und die Option "DFP-Umsatz ausblenden" ist deaktiviert."
  • 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, ist dieser Messwert die Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillViewableImpressionsPercent: Das ist der Prozentsatz der Backfill-Anzeigenimpressionen, die sichtbar waren. Eine Impression wird als sichtbare Impression bezeichnet, wenn sie im Browser dargestellt wurde und die Möglichkeit bestand, dass die Anzeige vom Nutzer gesehen wurde. Wenn AdSense und Ad Exchange beide Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillClicks. Gibt an, wie oft Backfill-Anzeigen auf der Website angeklickt wurden. Wenn AdSense und Ad Exchange beide Backfill-Anzeigen bereitstellen, ist dieser Messwert die Summe der beiden Backfill-Konten (DFP-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 AdSense und Ad Exchange beide Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillRevenue: Der geschätzte Gesamtumsatz aus Backfill-Anzeigen. Wenn AdSense und Ad Exchange beide Backfill-Anzeigen bereitstellen, ist dieser Messwert die Summe der beiden Backfill-Konten (DFP-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, ist dieser Messwert die Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“
  • Messwert: ga:backfillECPM: Der effektive Cost-per-1000-Impressions. Er entspricht dem Umsatz pro 1.000 Seitenaufrufen von Backfill-Anzeigen in DFP. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert die Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und DFP-Umsatz ausblenden nicht aktiviert).“

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

Segmente

In dieser Version 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, bei dem für einen Teil der Anfragen aus benutzerdefinierten Tabellen Stichprobendaten zurückgegeben wurden.

Mit dieser Version wird eine neue Version der API angekündigt: Version 4 der Analytics Reporting API. Diese neue API ist die fortschrittlichste programmatische Methode für den Zugriff auf Berichtsdaten in Google Analytics.

Wichtigste Features

Google Analytics basiert auf einer leistungsfähigen Infrastruktur zur Berichterstellung. Über das API erhalten Entwickler Zugriff auf die leistungsstarken Funktionen der Google Analytics-Plattform. Zu den wichtigsten Funktionen der Analytics Reporting API Version 4 gehören:

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

Erste Schritte

In der Entwicklerdokumentation finden Sie alle Details zu den ersten Schritten mit der API.

Kontingentrichtlinie

Für die Analytics Reporting API V4 gelten eigene Kontingente und Limits. Da dies eine neue API ist, können diese Limits und Kontingente geändert werden.

Migration

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

Dimensionen und Messwerte

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

  • Dimension – ga:cohort: Name der Kohorte, zu der ein Nutzer gemäß der Kohortendefinition gehört. 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: 0-basierte Abweichung pro Tag bezogen auf das Datum der Kohortendefinition. Wenn beispielsweise eine Kohorte mit dem Datum des ersten Besuchs als 01.09.2015 definiert ist, wird für das Datum 2015-09-04 ga:cohortNthDay den Wert 3 haben.

  • ga:cohortNthMonth: 0-basierter Monatsversatz bezogen auf das Datum der Kohortendefinition.

  • Dimension – ga:cohortNthWeek: 0-basierte Wochenverschiebung im Verhältnis zum Datum der Kohortendefinition.

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

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

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

  • Dimension: ga:acquisitionSourceMedium: Der Gesamtwert von „ga:userAcquisitionSource“ und „ga:AcquisitionMedium“.

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

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

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

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

  • Messwert – ga:cohortGoalCompletionsPerUser – Abschlüsse für Zielvorhaben pro Nutzer für eine Kohorte.

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

  • Messwert – ga:cohortRetentionRate – Bindungsrate der Kohorte.

  • 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: Dieser Wert ist im Kontext einer Anfrage mit den Dimensionen ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium oder ga:acquisitionCampaign relevant. Sie stellt die Anzahl der Nutzer in den Kohorten dar, die über den aktuellen Channel, die aktuelle Quelle, das aktuelle Medium oder die aktuelle Kampagne akquiriert wurden. Für ga:acquisitionTrafficChannel=Direct entspricht er beispielsweise der Anzahl der Nutzer in der Kohorte, die direkt akquiriert wurden. Wenn keine der genannten Dimensionen vorhanden ist, ist der Wert gleich ga:cohortTotalUsers.

  • Messwert – ga:cohortAppviewsPerUserWithLifetimeCriteria – App-Aufrufe pro Nutzer für die Dimension „Akquisition“ für eine Kohorte.

  • Messwert – ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – Abschlüsse für Zielvorhaben pro Nutzer für die 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 Dimension „Akquisition“ für eine Kohorte.

  • Messwert – ga:cohortSessionsPerUserWithLifetimeCriteria – Sitzungsdauer pro Nutzer für die Dimension „Akquisition“ für eine Kohorte.

Die Dimensionen und Messwerte im Hub für soziale Interaktionsdaten wurden eingestellt. Sie können nur noch Berichte zu Verlaufsdaten ab dem 30. April 2016 erstellen. 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 im Referenztool für Dimensionen und Messwerte.

Soziale Aktivitäten

Diese Dimensionen und Messwerte wurden eingestellt und werden nach dem 30. September 2016 entfernt. In den Richtlinien zur Einstellung von Daten finden Sie weitere Informationen zum Entfernen 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 Aktivität, die von den Nutzern sozialer Netzwerke gepostet wurde.
  • Dimension – ga:socialActivityPost: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies der Inhalt der sozialen Aktivität (z.B. der Inhalt einer auf Google+ geposteten Nachricht), die von Nutzern sozialer Netzwerke gepostet wurde.
  • 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 erfolgte.
  • Dimension: ga:socialActivityUserHandle: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist das der Alias der Nutzer in sozialen Netzwerken (z.B. Name oder ID) von Nutzern, die die soziale Aktivität gestartet haben.
  • Dimension: ga:socialActivityUserPhotoUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist das die URL des Fotos, das den Profilen der Nutzer in sozialen Netzwerken zugeordnet ist.
  • Dimension: ga:socialActivityUserProfileUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies die URL der entsprechenden Nutzerprofile in sozialen Netzwerken.
  • Dimension: ga:socialActivityTagsSummary: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies eine durch Kommas getrennte Gruppe von Tags, die der sozialen Aktivität zugeordnet sind.
  • Dimension: ga:socialActivityAction: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dies die Art der sozialen Interaktion dar, die der Aktivität zugeordnet ist (z. B. Abstimmung, Kommentar oder +1).
  • Dimension: ga:socialActivityNetworkAction: Bei einer Aktivität im Hub für soziale Interaktionsdaten sind dies die Art der sozialen Interaktion und das soziale Netzwerk, von 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 entsprechenden Nutzern sozialer Netzwerke geteilt wird.
  • Messwert: ga:socialActivities: Gesamtzahl der Aktivitäten, bei denen eine Content-URL in einem Partnernetzwerk im Hub für soziale Interaktionsdaten geteilt oder erwähnt wurde.

In diesem Release wird der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Plattform oder Gerät

  • Dimension: ga:browserSize: Die Größe des Darstellungsbereichs der Browser der Nutzer. Die Browsergröße ist eine Dimension auf Sitzungsebene, mit der die anfänglichen Abmessungen des Darstellungsbereichs in Pixeln erfasst werden. Sie wird im Format Breite × Höhe angegeben. Beispiel: 1920 × 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 gesetzt ist, werden Zeilen ohne Daten in der Antwort ausgelassen. Der Standardwert ist true. Dabei handelt es sich um eine abwärtskompatible Änderung, die daher keine Codeaktualisierung erfordert. Weitere Informationen finden Sie in der Referenzdokumentation zur Core Reporting API.

In dieser Version werden der API neue Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Nutzer

  • Messwert – ga:1dayUsers: Gesamtzahl der an 1 Tag aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zum Abfragen dieses Messwerts muss mindestens entweder „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension festgelegt sein. Für das angegebene Datum wird der Wert der einzelnen Nutzer insgesamt für einen Zeitraum von einem Tag bis zum angegebenen Datum zurückgegeben.
  • Messwert – ga:7dayUsers: Gesamtzahl der in den letzten 7 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zum Abfragen dieses Messwerts muss mindestens entweder „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension festgelegt sein. Der zurückgegebene Wert entspricht der Gesamtzahl der einzelnen Nutzer in einem Zeitraum von 7 Tagen bis zum angegebenen Datum.
  • Messwert – ga:14dayUsers: Gesamtzahl der in den letzten 14 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zum Abfragen dieses Messwerts muss mindestens entweder „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension festgelegt sein. Der zurückgegebene Wert entspricht der Gesamtzahl der einzelnen Nutzer für einen Zeitraum von 14 Tagen bis zum angegebenen Datum.
  • Messwert – ga:30dayUsers: Gesamtzahl der in den letzten 30 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zum Abfragen dieses Messwerts muss mindestens entweder „ga:nthDay“, „ga:date“ oder „ga:day“ als Dimension festgelegt sein. Der zurückgegebene Wert entspricht der Gesamtzahl der einzelnen Nutzer für einen Zeitraum von 30 Tagen bis zum angegebenen Datum.

In dieser Version werden der API neue Messwerte hinzugefügt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

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: Anzahl der Klicks auf AdX-Anzeigen auf Ihrer Website.
  • Messwert: ga:adxCoverage. Die Abdeckung gibt den Prozentsatz der Anzeigenanfragen an, bei denen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über Ihr AdX-Konto keine zielgerichteten Anzeigen bereitgestellt werden können. (Anzeigenimpressionen ÷ Gesamtzahl der Anzeigenanfragen) × 100
  • Messwert: ga:adxECPM: Der effektive Cost-per-1000-Impressions. Hierbei handelt es sich um Ihren AdX-Umsatz pro 1.000 Seitenaufrufen.
  • 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 erfasst.
  • Messwert: ga:adxImpressionsPerSession: Das Verhältnis von AdX-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen).
  • Der Messwert "ga:adxMonetizedPageviews" – "Monetarisierte Seitenaufrufe" misst die Gesamtzahl der Seitenaufrufe auf Ihrer Property, bei denen eine Anzeige aus Ihrem verknüpften AdX-Konto eingeblendet 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: Dies ist 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 dieser Version werden vorhandene Dimensionen oder Messwerte eingestellt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Eingestellte Dimensionen

Diese Dimensionen wurden eingestellt. In den Richtlinien zur Einstellung von Daten finden Sie weitere Informationen zum Entfernen 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 im Referenztool für Dimensionen und Messwerte.

AdWords

  • Dimension: ga:adQueryWordCount: Die Anzahl der Wörter in der Suchanfrage.

In dieser Version werden der API neue Dimensionen hinzugefügt. Eine vollständige Liste der Dimensionen und Messwerte finden Sie im Referenztool für Dimensionen und Messwerte.

Plattform oder Gerät

  • Dimension: ga:dataSource: Die Datenquelle eines Treffers. Treffer von ga.js und analytics.js werden als „Web“ und von mobilen SDKs gesendete Treffer als „app“ erfasst. Diese Werte können überschrieben werden.
  • Dimension: ga:searchAfterDestinationPage: Die Seite, die der Nutzer besucht hat, nachdem er eine interne Suche auf Ihrer Website durchgeführt hat.

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt und zwei vorhandene Messwerte werden eingestellt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

ECommerce

  • Messwert – ga:transactionsPerUser: Die Gesamtzahl der Transaktionen geteilt durch die Gesamtzahl der Nutzer.
  • Messwert: ga:revenuePerUser: Der Gesamtumsatz 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 IDs der Städte der Nutzer, die aus IP-Adressen oder geografischen IDs abgeleitet wurden.
  • Dimension: ga:countryIsoCode: Der ISO-Ländercode der Nutzer, der aus IP-Adressen oder geografischen IDs abgeleitet wird. Die Werte werden als Alpha-2-Code gemäß ISO-3166-1 angegeben.
  • Dimension: ga:regionId: Die Regions-ID der Nutzer, die aus IP-Adressen oder geografischen IDs abgeleitet ist. In den USA ist jeder Staat eine Region, beispielsweise Nevada.
  • Dimension: ga:regionIsoCode: Der ISO-Ländercode der Nutzer, der aus IP-Adressen oder geografischen IDs abgeleitet wird. Die Werte werden als ISO-3166-2-Code angegeben.
  • Dimension: ga:subContinentCode: Der Subkontinentcode der Nutzer, der von IP-Adressen oder geografischen IDs abgeleitet wird. Beispiel: Polynesien oder Nordeuropa. Die Werte werden als UN M.49-Code angegeben.

DoubleClick Campaign Manager

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

Verworfene Messwerte

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

In dieser Version wird ein neuer Messwert zur API hinzugefügt und zwei vorhandene Messwerte werden eingestellt. Die vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

AdWords

  • Messwert – ga:ROAS – Return on Advertising Spend (ROAS) ist der gesamte Transaktionsumsatz und der Zielwert geteilt durch die abgeleiteten Werbekosten.

Eingestellte Dimensionen und Messwerte

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

In dieser Version werden der API neue Messwerte hinzugefügt. Die vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

AdSense

  • Messwert: ga:adsenseCoverage: Der Prozentsatz der Anzeigenanfragen, bei denen mindestens eine Anzeige zurückgegeben wurde.
  • Messwert – ga:adsenseViewableImpressionPercent: Dies ist der Prozentsatz der Impressionen, die sichtbar waren.

In dieser Version sind ein neuer Sitzungsmesswert, eine neue Dimension für Besucherquellen sowie neue Dimensionen und Messwerte in DoubleClick Campaign Manager verfügbar.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

Sitzung

  • Messwert: ga:hits: Gesamtzahl der Treffer, die an Google Analytics gesendet wurden. In diesem Messwert werden alle Treffertypen (z. B. Seitenaufruf, Ereignis, Timing usw.) zusammengefasst.

Besucherquellen

  • Dimension: ga:campaignCode: der Wert des Kampagnen-Tracking-Parameters „utm_id“ bei manuellem Kampagnen-Tracking

DoubleClick Campaign Manager

  • Dimension: ga:dcmClickAd: DCM-Anzeigenname des DCM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (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 für den DCM-Klick, der mit der Google Analytics-Sitzung übereinstimmt (nur Premium).
  • Dimension: ga:dcmClickAdTypeId: ID des DCM-Anzeigentyps für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickAdvertiser: Name des DCM-Werbetreibenden, der mit der Google Analytics-Sitzung übereinstimmt (nur Premium).
  • Dimension: ga:dcmClickAdvertiserId: DCM-Werbetreibenden-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCampaign: Name der DCM-Kampagne für den DCM-Klick, der mit der Google Analytics-Sitzung übereinstimmt (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, der mit der Google Analytics-Sitzung übereinstimmt (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 mit der Google Analytics-Sitzung übereinstimmt (nur Premium).
  • Dimension: ga:dcmClickCreativeTypeId: ID des DCM-Creative-Typs für den DCM-Klick, 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 ausgeliefert und für den DCM-Klick, der der Google Analytics-Sitzung entspricht, angeklickt wurde (nur Premium).
  • Dimension: ga:dcmClickSiteId: ID der DCM-Website, auf der das DCM-Creative zu sehen war und auf die für den DCM-Klick geklickt wurde, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickSitePlacement: Name des DCM-Website-Placements für den DCM-Klick, der mit der Google Analytics-Sitzung übereinstimmt (nur Premium).
  • Dimension: ga:dcmClickSitePlacementId: DCM-Website-Placement-ID des DCM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Premium).
  • Dimension: ga:dcmClickSpotId: DCM-Floodlight-Konfigurations-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmFloodlightActivity: Name der DCM-Floodlight-Aktivität, die mit der Floodlight-Conversion verknüpft ist (nur Premium).
  • Dimension: ga:dcmFloodlightActivityAndGroup: Name der DCM-Floodlight-Aktivität und der Gruppenname, die mit der Floodlight-Conversion verknüpft sind (nur Premium).
  • Dimension: ga:dcmFloodlightActivityGroup: Name der DCM-Floodlight-Aktivitätsgruppe, der mit der Floodlight-Conversion verknüpft ist (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 DCM-Floodlight-Aktivität, die mit der Floodlight-Conversion verknüpft ist (nur Premium)
  • Dimension: ga:dcmFloodlightAdvertiserId: Mit der Floodlight-Conversion verknüpfte DCM-Floodlight-Werbetreibenden-ID (nur Premium)
  • Dimension: ga:dcmFloodlightSpotId: DCM-Floodlight-Konfigurations-ID, die mit der Floodlight-Conversion verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventAd: DCM-Anzeigenname des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft 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 im DCM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventAdvertiser: Name des DCM-Werbetreibenden des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das mit der Google Analytics-Sitzung (nur Premium) verknüpft ist
  • Dimension: ga:dcmLastEventAdvertiserId: DCM-Werbetreibenden-ID des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension (ga:dcmLastEventAttributionType): Es gibt zwei mögliche Werte (ClickThrough und ViewThrough). Wenn das letzte der Google Analytics-Sitzung zugeordnete DCM-Ereignis ein Klick war, lautet der Wert „ClickThrough“. Wenn das letzte der Google Analytics-Sitzung zugeordnete DCM-Ereignis eine Anzeigenimpression war, lautet der Wert „ViewThrough“ (nur Premium).
  • Dimension: ga:dcmLastEventCampaign: Name der DCM-Kampagne des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventCampaignId: DCM-Kampagnen-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: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 des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), 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 im Lookback-Window von DCM), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventRenderingId: DCM-Rendering-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:dcmLastEventSite: Name der Website, auf der das DCM-Creative beim letzten DCM-Ereignis (Impression oder Klick im DCM-Lookback-Window) zu sehen war und auf das es geklickt wurde, das der Google Analytics-Sitzung zugeordnet ist (nur Premium).
  • Dimension: ga:dcmLastEventSiteId: DCM-Website-ID, auf der das DCM-Creative zu sehen war und auf die das letzte DCM-Ereignis (Impression oder Klick im DCM-Lookback-Window) geklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventSitePlacement: Name des DCM-Website-Placements des letzten mit der Google Analytics-Sitzung (nur Premium) verknüpften DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window).
  • Dimension: ga:dcmLastEventSitePlacementId: DCM-Website-Placement-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:dcmLastEventSpotId: DCM-Floodlight-Konfigurations-ID des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Messwert: ga:dcmFloodlightQuantity: Die 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 im Referenztool für Dimensionen und Messwerte.

Gruppierung nach Content

  • Dimension: ga:landingContentGroupXX: Die erste übereinstimmende Contentgruppe in der Sitzung eines Nutzers.
  • Dimension: ga:nextContentGroupXX: Bezieht sich auf die Contentgruppe, die nach einer anderen Contentgruppe besucht wurde.
  • Dimension – ga:contentGroupXX – Contentgruppe für eine Property Eine Contentgruppe ist eine Sammlung von Inhalten mit einer logischen Struktur, die durch Tracking-Code oder Übereinstimmungen mit Regex für Seitentitel/URL oder vordefinierte Regeln festgelegt werden kann.
  • Dimension: ga:previousContentGroupXX: Bezieht sich auf die Contentgruppe, die vor einer anderen Contentgruppe besucht wurde.
  • Messwert – ga:contentGroupUniqueViewsXX: Die Anzahl der verschiedenen (einzelnen) Seiten innerhalb einer Sitzung für die angegebene Contentgruppe. Dabei werden sowohl „pagePath“ als auch „pageTitle“ berücksichtigt, um die Eindeutigkeit zu bestimmen.

Diese Version enthält eine neue dateOfSession-Bedingung für Segmente und zusätzliche neue Dimensionen und Messwerte für erweiterte E-Commerce-Berichte.

Segmente

Für Segmente wird jetzt eine neue dateOfSession-Bedingung unterstützt, mit der ein Segment auf eine Gruppe von Nutzern beschränkt werden kann, die eine Sitzung in einem bestimmten Zeitraum gestartet haben. Weitere Informationen finden Sie im Entwicklerleitfaden für Segmente.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen für den erweiterten E-Commerce finden Sie im Referenztool für Dimensionen und Messwerte.

Erweiterte E-Commerce-Berichte

  • Dimension: ga:internalPromotionCreative: Der Creative-Inhalt für eine Werbeaktion.
  • Dimension: ga:internalPromotionId: Die ID, die Sie für das Angebot verwenden.
  • Dimension: ga:internalPromotionName: Der Name des Angebots.
  • Dimension – ga:internalPromotionPosition: Die Position des Angebots auf der Webseite oder in der App.
  • 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 klassifiziert wurde (erweiterter E-Commerce).
  • Dimension – ga:productCategoryLevelXX – Ebene (1–5) in der Produktkategoriehierarchie, beginnend von oben.
  • Dimension – ga:productCouponCode – Code für den Gutschein auf Produktebene.
  • Dimension: ga:productListName: Der Name der Produktliste, in der das Produkt angezeigt wird.
  • 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 die Größe oder Rot, Blau, Grün, Schwarz für Farbe.
  • Dimension – ga:checkoutOptions – Nutzeroptionen, die während des Bezahlvorgangs festgelegt werden, z.B. FedEx, DHL, UPS für Versandoptionen oder Visa, MasterCard, AmEx für Zahlungsoptionen. Diese Dimension sollte zusammen mit der Phase „Shopping“ verwendet werden.
  • Dimension – ga:shoppingStage – verschiedene Phasen des Einkaufserlebnisses, die Nutzer in einer Sitzung abgeschlossen haben, z.B. „PRODUCT_VIEW“, „ADD_TO_CART“, „CHECKOUT“ usw.
  • Messwert – ga:internalPromotionCTR – Die Rate, mit der Nutzer auf die Anzeige geklickt haben, um die interne Werbung anzusehen (Anzahl der Klicks ÷ Häufigkeit, mit der die Werbung angezeigt wurde).
  • Messwert – ga:internalPromotionClicks – Die Anzahl der Klicks auf eine interne Werbung.
  • Messwert: ga:internalPromotionViews: Die Anzahl der Aufrufe einer internen Werbung.
  • Messwert: ga:localProductRefundAmount: Erstattungsbetrag für ein bestimmtes Produkt in der lokalen Währung.
  • Messwert – ga:localRefundAmount – Gesamtbetrag der Erstattung für die Transaktion in der lokalen Währung.
  • Messwert – ga:productAddsToCart: gibt an, wie oft das Produkt in den Einkaufswagen gelegt wurde.
  • Messwert – ga:productCheckouts: gibt an, wie oft das Produkt in den Bezahlvorgang einbezogen wurde.
  • Messwert – ga:productDetailViews – Anzahl, wie oft Nutzer die Produktdetailseite aufgerufen haben.
  • Messwert – ga:productListClicks – Gibt an, wie oft Nutzer auf das Produkt geklickt haben, wenn es in der Produktliste angezeigt wurde.
  • Messwert – ga:productListViews – Häufigkeit, mit der 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 – Anzahl der Erstattungen für das Produkt.
  • Messwert – ga:productRefundAmount – Gesamterstattungsbetrag für das Produkt.
  • Messwert – ga:productRemovesFromCart: gibt an, wie oft das Produkt aus dem Einkaufswagen entfernt wurde.
  • Messwert – ga:productRevenuePerPurchase – durchschnittlicher Produktumsatz pro Kauf (wird häufig mit Produktgutscheincodes verwendet).
  • Messwert – ga:buyToDetailRate – Einzelne Käufe geteilt durch Aufrufe von Produktdetailseiten.
  • Messwert – ga:cartToDetailRate – Anzahl der hinzugefügten Produkte geteilt durch die Anzahl der Aufrufe der Produktdetails.
  • Messwert – ga:quantityAddedToCart – Anzahl der Produkteinheiten, die in den Einkaufswagen gelegt wurden.
  • Messwert – ga:quantityCheckedOut – Anzahl der Produkteinheiten, die an der Kasse enthalten sind.
  • 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 erfolgten Erstattungen.

Diese Version umfasst eine Fehlerkorrektur für Spaltenüberschriften sowie neue Dimensionen und Messwerte.

Dimensionen und Messwerte

Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

System

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

Channelgruppierung

  • Dimension: ga:channelGrouping: Dies ist die Standard-Channelgruppierung innerhalb der Datenansicht (Profil).
  • Dimension – ga:correlationModelId – Korrelationsmodell-ID für ähnliche Produkte.
  • Dimension – ga:queryProductId – ID des abgefragten Produkts
  • Dimension – ga:queryProductName – Name des Produkts, das abgefragt wird
  • Dimension – ga:queryProductVariation: Variante des abgefragten Produkts
  • Dimension – ga:relatedProductId – ID des zugehörigen Produkts.
  • Dimension – ga:relatedProductName: Name des zugehörigen Produkts.
  • Dimension: ga:relatedProductVariation: Variante des ähnlichen Produkts.
  • Messwert – ga:correlationScore – Korrelationswert für ähnliche Produkte.
  • Messwert – ga:queryProductQuantity – Menge des abgefragten Produkts.
  • Messwert – ga:relatedProductQuantity: Menge des ähnlichen Produkts.

Korrektur des Namens der Kopfzeile

  • In der Version vom 16.04.2014 gab es einen Fehler. Wenn Sie eine nicht mehr unterstützte Dimension oder einen nicht mehr unterstützten Messwert abgefragt haben, gab die API Spaltenüberschriften mit der neuen Dimension oder dem neuen Messwert zurück. Jetzt wird korrekt wieder derselbe Dimensions- oder Messwertname zurückgegeben wie in der Anfrage.

In dieser Version wurden Dimensionen und Messwerte hinzugefügt und umbenannt. Eine vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

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 bei der Anzeige 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. das Startdatum) im Zeitraum ist 0, 1 für die nächste Stunde usw.

Umbenannte Dimensionen und Messwerte

Alle Dimensionen und Messwerte, die auf Besuchern und Besuchen basieren, wurden umbenannt und verwenden nun Nutzer bzw. Sitzung.

Die folgenden Dimensionen und Messwerte wurden umbenannt. In den Richtlinien zur Einstellung von Daten finden Sie weitere Informationen zur Umbenennung 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 v2.4 und v3.0

In der Core Reporting API werden neue Segmente unterstützt.

  • Der Parameter segment unterstützt jetzt Nutzer- und Sequenzsegmente. Segmente auf Nutzerebene und Sitzungsebene, die in der Weboberfläche erstellt wurden, können mit dem Parameter segment abgefragt werden.
  • Für dynamische Segmente ist eine neue Syntax für die Verwendung mit dem Parameter segment verfügbar. Weitere Informationen finden Sie im Entwicklungsleitfaden für Segmente.
  • Das Präfix dynamic:: wurde verworfen. Wir empfehlen, so schnell wie möglich zur neuen Syntax zu migrate.

Dieser Release beinhaltet ein neues Datentabellen-Antwortformat sowie die Ergänzung und Einstellung von Dimensionen und Messwerten. Eine vollständige Liste der Definitionen finden Sie in der Referenz für Dimensionen und Messwerte.

Datentabellenausgabe

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

  • Der API wurde der optionale output-Abfrageparameter hinzugefügt. Damit kann das Ausgabeformat der Analytics-Daten in der Antwort ausgewählt werden. Standardmäßig ist das JSON-Format. Wenn dieser Parameter auf datatable gesetzt ist, wird ein dataTable-Attribut, das ein Datentabellenobjekt enthält, in die Antwort aufgenommen. Dieses Objekt kann direkt mit Google Charts verwendet werden. Weitere Informationen finden Sie in der Referenz zur Core Reporting API.

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 zurück. 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. das Startdatum) im Zeitraum ist 0, 1 für die nächste Minute usw.

Zielgruppe

  • Dimension: ga:visitorAgeBracket: Altersgruppe des Besuchers.
  • Dimension – ga:visitorGender – Geschlecht des Besuchers
  • Dimension (ga:interestAffinityCategory): Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit an Informationen zur angegebenen Kategorie interessiert sind.
  • Dimension: ga:interestInMarketCategory: Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit bereit sind, Produkte oder Dienstleistungen in der angegebenen Kategorie zu kaufen.
  • Dimension (ga:interestOtherCategory): Gibt an, dass Nutzer mit höherer Wahrscheinlichkeit an Informationen zur angegebenen Kategorie interessiert und kaufbereit sind.

Zulässige Dimensionen und Messwerte in Segmenten

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

  • Dimension – ga:sourceMedium: kombinierte Werte aus „ga:source“ und „ga:medium
  • Messwert – ga:localItemRevenue – Produktumsatz in lokaler Währung.

Eingestellte Dimensionen und Messwerte

Diese Dimensionen und Messwerte wurden eingestellt. In den Richtlinien zur Einstellung von Daten finden Sie weitere Informationen zum Entfernen von Daten:

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

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt. Die vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

AdSense

  • Der Zugriff auf AdSense-Daten wurde hinzugefügt:

    • Met – ga:adsenseRevenue – Der Gesamtumsatz aus AdSense-Anzeigen.
    • Met - ga:adsenseAdUnitsViewed - Die Anzahl der AdSense-Anzeigenblöcke angesehen. Ein Anzeigenblock ist eine Gruppe von Anzeigen, die als Ergebnis eines AdSense-Anzeigencodes geschaltet werden. Details: https://support.google.com/adsense/answer/32715
    • Met - ga:adsenseAdsViewed - Die Anzahl der AdSense-Anzeigen angesehen. In einem Anzeigenblock können mehrere Anzeigen erscheinen.
    • Met – ga:adsenseAdsClicks – Gibt an, wie oft auf AdSense-Anzeigen auf Ihrer Website geklickt wurde.
    • Met - ga:adsensePageImpressions - Die Anzahl der Seitenaufrufe, während derer eine AdSense-Anzeige geschaltet wurde. Eine Seitenimpression kann mehrere Anzeigenblöcke enthalten.
    • Met – 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).
    • Met – ga:adsenseExits – Die Anzahl der Sitzungen, die beendet wurden, weil ein Nutzer auf eine AdSense-Anzeige geklickt hat.

Zeit

  • Dim – ga:isoYear: Das ISO-Jahr des Besuchs. Details: 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.
  • Gedimmt – ga:isoYearIsoWeek: Kombinierte Werte von ga:isoYear und ga:isoWeek.

AdWords

  • Diese Daten befinden sich in AdWords-Berichten:

    • Gedimmt – ga:adKeywordMatchType: die auf Ihre Keywords angewendeten Keyword-Optionen („Wortgruppe“, „Genau passend“, „Weitgehend passend“). Weitere Informationen finden Sie im Bericht zu Suchbegriffen.

Neue Steuerung der Stichprobengröße und Funktionen für relative Datumsangaben

Relative Datumsangaben
  • In der Core Reporting API werden jetzt auch relative Zeiträume unterstützt. 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) bestimmt, die in der Abfrage angegeben ist. Weitere Informationen finden Sie in der API-Referenz.
Stichprobenebene
  • Der neue Parameter samplingLevel wurde eingeführt, mit dem Sie die Stichprobenebene (d.h. die zur Berechnung des Ergebnisses verwendete Anzahl der Besuche) für eine Berichtsabfrage festlegen können. Zulässige Werte sind DEFAULT, FASTER und HIGHER_PRECISION.
  • Der API-Antwort wurden zwei neue Felder hinzugefügt: sampleSize und sampleSpace. Anhand dieser Werte können Sie den Prozentsatz der Besuche berechnen, die für eine Stichprobenantwort verwendet wurden.
  • Weitere Informationen finden Sie in der API-Referenz und unter Probenahme.

Fehlerkorrekturen

  • Die ga:adwordsCustomerID gibt jetzt korrekt die zehnstellige AdWords-Kundennummer zurück, die der AccountInfo.customerId der AdWords API entspricht. Durch diese Korrektur können Analytics-Daten mit mehreren AdWords-Konten zusammengeführt werden.

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 der Management API zurückgegeben wird.
  • Die aktuellen numerischen IDs für benutzerdefinierte Segmente werden jetzt eingestellt. Diese alten IDs werden noch sechs Monate lang unterstützt. Wir empfehlen Anwendungen, die Nutzersegment-IDs speichern, um zu den neuen alphanumerischen IDs zu wechseln. Nach Ablauf des Einstellungszeitraums wird bei Abfragen mit den alten numerischen IDs ein Fehler zurückgegeben.
  • Derzeit können nur die Segmente auf Besuchsebene, die in der Weboberfläche erstellt wurden, über den Parameter segment abgefragt werden.
  • Die vorhandenen Standardsegmente mit negativen numerischen IDs sind davon nicht betroffen. Die neuen Standardsegmente werden derzeit jedoch nicht unterstützt.

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt. Die vollständige Liste der Definitionen finden Sie im Referenztool für Dimensionen und Messwerte.

App-Tracking

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

Eingestellte Funktionen

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

  • Met – ga:appviews – Verwenden Sie stattdessen ga:screenviews.
  • Met – ga:uniqueAppviews – Verwenden Sie stattdessen ga:uniqueScreenviews.
  • Met – ga:appviewsPerVisit – Verwenden Sie stattdessen ga:screenviewsPerSession.

Benutzerdefinierte Variablen oder Spalten

  • Zugriff auf benutzerdefinierte Dimensionen und Messwerte:

    • Gedimmt: ga:dimensionXX: Name der angeforderten benutzerdefinierten Dimension, wobei XX für die Anzahl bzw. den Index der benutzerdefinierten Dimension steht.
    • Met – ga:metricXX: Der Name des angeforderten benutzerdefinierten Messwerts, wobei XX für die Anzahl bzw. den Index des benutzerdefinierten Messwerts steht.

Änderungen der Dokumentation

Die folgende Dimension und der Messwert für benutzerdefinierte Variablen wurden umbenannt. Diese Änderung dient lediglich der Dokumentation. Sie müssen Ihre Abfragen nicht aktualisieren.

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

E-Commerce

  • Dim – ga:currencyCode: Der lokale Währungscode der Transaktion gemäß ISO 4217-Standard.
  • Met – ga:localItemRevenue – Produktumsatz in lokaler Währung.
  • Met – ga:localTransactionRevenue – Transaktionsumsatz in lokaler Währung
  • Met – ga:localTransactionShipping – Versandkosten der Transaktion in lokaler Währung.
  • Met – ga:localTransactionTax – Transaktionssteuer in Landeswährung.

Ausnahmen

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

Zielvorhaben-Conversions

  • Gedimmt – ga:goalCompletionLocation: Seitenpfad oder Bildschirmname, der mit einem beliebigen Zielvorhabentyp vom Typ „Ziel“ übereinstimmt.
  • Gedimmt: ga:goalPreviousStep1: Seitenpfad oder Bildschirmname, der mit einem Zielvorhaben vom Typ „Ziel“ übereinstimmt, einen Schritt vor dem Abschluss des Zielvorhabens
  • Gedimmt: ga:goalPreviousStep2: Seitenpfad oder Bildschirmname, der mit einem Zielvorhaben vom Typ „Ziel“ übereinstimmt, zwei Schritte vor dem Abschluss des Zielvorhabens.
  • Gedimmt: ga:goalPreviousStep3: Seitenpfad oder Bildschirmname, der einem Ziel vom Typ „Ziel“ entspricht, drei Schritte vor dem Abschluss des Zielvorhabens

Änderungen der Dokumentation

Die folgende Dimension und die folgenden Messwerte für Zielvorhaben-Conversions wurden umbenannt. Diese Änderung dient lediglich der Dokumentation. 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
  • Met – ga:percentSearchRefinements: Prozentsatz der Häufigkeit, mit der eine Suchfilterung (d.h. ein Wechsel) zwischen Keywords für interne Suchanzeigen innerhalb einer Sitzung erfolgt.

Seiten-Tracking

  • Met – ga:pageValue: Der durchschnittliche Wert für diese Seite oder Seitengruppe. Der Seitenwert ergibt sich aus ((Transaktionsumsatz + gesamter Zielwert) geteilt durch die eindeutigen Seitenaufrufe für die Seite oder Seitengruppe.

Plattform oder Gerät

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

    • Gedimmt: ga:deviceCategory: Der Gerätetyp: Computer, Tablet oder Mobilgerät.
    • Gedimmt – ga:isTablet: zeigt Tablet-Besucher an. Mögliche Werte sind Yes und No.
    • Dim – ga:mobileDeviceMarketingName – Marketingname für Mobilgerät.

Soziale Interaktionen

  • Diese Daten stammen aus dem Tracking von sozialen Interaktionen auf der Website.

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

Zeit

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

Besucherquellen

  • Dim – ga:fullReferrer: Die vollständige Verweis-URL, einschließlich Hostname und Pfad.
  • Dim – ga:sourceMedium: Die kombinierten Werte von ga:source und ga:medium.
  • In diesem Release werden zwei neue Testmesswerte hinzugefügt: – ga:experimentIdga:experimentVariant
  • In dieser Version gibt es fünf neue Messwerte für die Websitegeschwindigkeit:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • In dieser Version wird ein neues Standardsegment für Zugriffe über Tablets hinzugefügt: gaid::-13.

In dieser Version werden der API neue Dimensionen und Messwerte hinzugefügt. Die Definitionen finden Sie in der Referenz für Dimensionen und Messwerte.

App-Tracking

  • Diese Daten sind in den Berichten zum Mobile App Tracking SDK enthalten:
    • Met – ga:uniqueAppviews – Anzahl der App-Aufrufe pro Sitzung
    • Met – 'ga:appviews – Gesamtzahl der App-Aufrufe
    • Met – ga:appviewsPerVisit: Die durchschnittliche Anzahl der App-Aufrufe pro Sitzung.

Besucherquellen

  • Dim – ga:socialNetwork: Ein String, der den Namen des sozialen Netzwerks darstellt. Dies kann mit dem verweisenden sozialen Netzwerk (für Besucherquellen) oder mit dem sozialen Netzwerk (für Aktivitäten im Hub für soziale Interaktionsdaten) zusammenhängen. z.B. Google+, Blogger oder reddit.
  • Verdunkeln – ga:hasSocialSourceReferral: zeigt Besuche an, die über eine Quelle der sozialen Interaktion auf die Website gelangt sind, zum Beispiel über ein soziales Netzwerk wie Google+, Facebook oder Twitter. Mögliche Werte sind „Yes“ oder „No“, wobei der erste Buchstabe großgeschrieben werden muss.

Soziale Aktivitäten

  • Diese Daten stammen von externen Aktivitäten, die von Partnern im Hub für soziale Interaktionsdaten importiert wurden.
    • Dim – ga:socialActivityDisplayName: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String den Titel der sozialen Aktivität dar, die vom Nutzer des sozialen Netzwerks gepostet wurde.
    • 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 die URL des Blogkommentars.
    • Dim – ga:socialActivityPost: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String den Inhalt der sozialen Aktivität dar, die vom Nutzer des sozialen Netzwerks gepostet wurde (z. B. der Inhalt eines Google+ Beitrags).
    • Dim – ga:socialActivityTimestamp: Bei einer Aktivität im Hub für soziale Interaktionsdaten gibt dieser String an, 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 dem Profil des Nutzers in einem sozialen Netzwerk zugeordnet ist.
    • Dim – ga:socialActivityUserProfileUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die URL des zugehörigen Nutzerprofils in sozialen Netzwerken dar.
    • Dim – ga:socialActivityContentUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die URL dar, die vom zugehörigen Nutzer eines sozialen Netzwerks geteilt wurde.
    • Dim – ga:socialActivityTagsSummary: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies eine durch Kommas getrennte Gruppe von Tags, die der sozialen Aktivität zugeordnet werden.
    • Dim – ga:socialActivityUserHandle: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String den Alias des sozialen Netzwerks (d.h. den Namen) des Nutzers dar, der die soziale Aktivität initiiert hat.
    • Dim – ga:socialActivityAction: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String die Art der sozialen Interaktion dar, die mit der Aktivität verknüpft ist (z. B. Votum, Kommentar, +1).
    • Dim – ga:socialActivityNetworkAction: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String den Typ der sozialen Interaktion und das soziale Netzwerk dar, von dem die Aktivität stammt.
    • Met – ga:socialActivities – Anzahl der Aktivitäten, bei denen eine Content-URL in einem Partnernetzwerk im Hub für soziale Interaktionsdaten geteilt/erwähnt wurde.

Soziale Interaktionen

  • Diese Daten stammen aus dem Tracking von sozialen Interaktionen auf der Website.
    • Dim – ga:socialInteractionAction: ein String für soziale Interaktionen, der die erfasste soziale Interaktion darstellt (z.B. +1, „Gefällt mir“, Lesezeichen)
    • Dim – ga:socialInteractionNetwork: ein String für soziale Interaktionen, der das erfasste soziale Netzwerk darstellt (z.B. Google, Facebook, Twitter, LinkedIn)
    • Dim – ga:socialInteractionNetworkAction: Für soziale 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: String für soziale Interaktionen, der die URL (oder Ressource) darstellt, der die soziale Netzwerkaktion empfängt.
    • Met – ga:socialInteractions – Gesamtzahl der sozialen Interaktionen auf Ihrer Website
    • Met – ga:uniqueSocialInteractions – Gesamtzahl der einzelnen sozialen Interaktionen auf Ihrer Website Basierend auf dem Wertepaar ga:socialInteractionNetwork und ga:socialInteractionAction
    • Met – ga:socialInteractionsPerVisitga:socialInteractions / ga:uniqueSocialInteractions. Die durchschnittliche Anzahl der sozialen Interaktionen pro Besuch auf Ihrer Website.

Geografie / Netzwerk

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

Seiten-Tracking

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

Ausnahmen-Tracking

  • Diese Daten stammen aus Tracking-Daten für Ausnahmen.

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

Nutzertiming

  • Diese Daten stammen aus Nutzertiming-Daten.

    • Dim – ga:userTimingCategory: Ein String zur Kategorisierung aller Nutzertiming-Variablen in logische Gruppen, um die Berichterstellung zu erleichtern.
    • Dim – ga:userTimingLabel: Ein String zum Angeben des Namens der Aktion für die erfasste Ressource.
    • Dim – ga:userTimingVariable: Ein String, mit dem Nutzertimings in Berichten flexibler dargestellt werden können.
    • Gedimmt – ga:userTimingValue Dies ist die Anzahl der Millisekunden, die verstrichene Zeit an Google Analytics gesendet wird.
    • Met – ga:userTimingSample – Die Anzahl der gesendeten Stichproben.
    • Met – ga:avgUserTimingValue – Das durchschnittliche Nutzertiming. ga:userTimiingValue / ga:userTimiingSample.

Gerät / Plattform

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

Fehlerkorrekturen

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

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

In dieser Version werden zwei Fehler behoben:

Fehlerkorrekturen

  • Abfragefilter, die Sonderzeichen in regulären Ausdrücken enthalten, geben keine Serverfehler mehr zurück.

  • Bei der Kombination eines Messwertfilters mit einem erweiterten Segment wird kein Fehler mehr zurückgegeben.

In dieser Version werden der API neue Messwerte für die Websitegeschwindigkeit hinzugefügt.

Neue Messwerte

  • Die folgenden Messwerte zur 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

Die Definitionen finden Sie in der Referenz für Dimensionen und Messwerte.

Erinnerung: API-Version 2.3 wird eingestellt

  • Version 2.3 der API für den Datenexport wurde für zwei Monate eingestellt. In etwa vier weiteren Monaten werden wir diesen Dienst einstellen und nur noch die neue Core Reporting API in Version 3.0 und Version 2.4 unterstützen.

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

  • In vier Monaten werden Anfragen an die alte Version 2.3 des XML-Datenfeeds an Version 2.4 weitergeleitet und eine XML-Antwort der Version 2.4 zurückgegeben. Ab diesem Zeitpunkt gelten alle Kontingentrichtlinien der Version 2.4 auch für Anfragen der Version 2.3.

  • Bei allen Anfragen für die JSON-Version 2.3 oder die Google Data JavaScript-Clientbibliothek, die die JSON-Ausgabe der Version 2.3 verwendet, wird der Statuscode 404 zurückgegeben.

  • Um das volle Kontingent zu nutzen, ist es sowohl in Version 3.0 als auch in Version 2.4 erforderlich, dass Sie Ihre Anwendung in der Google APIs-Konsole registrieren und bei jeder Anfrage einen API-Schlüssel (oder ein OAuth 2.0-Token) verwenden.

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

Diese Version betrifft alle Google Analytics API-Entwickler. Es werden zwei neue Versionen der API angekündigt, Anwendungen müssen registriert werden, eine neue Kontingentrichtlinie wird eingeführt und der API-Name wird in die Core Reporting API geändert. Schließlich wird die vorhandene API-Version 2.3 für den Datenexport verworfen.

Version 3.0

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

  • Neue Funktionen

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

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

Version 2.4

  • Version 2.4 der Core Reporting API ist eine Nebenversion, die mit Version 2.3 der API für den Datenexport weitgehend abwärtskompatibel ist.

  • Updates

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

Anmeldung

  • Alle Anwendungen, die mit der Google Analytics API erstellt wurden, müssen über die Google APIs-Konsole 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 Analytics APIs (Management API und Datenexport API)

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

    • 10.000 Anfragen pro Profil und Tag
    • 10 gleichzeitige Anfragen pro Profil
  • Für nicht registrierte Anwendungen bieten wir ein sehr geringes Kulanzkontingent, um eine kleine Anzahl von Tests zu ermöglichen.

Einstellung von Produkten und Funktionen

  • In dieser Version werden auch die Einstellung von Version 2.3 und die bevorstehende Einstellung des Konto-Feeds 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 geben eine Antwort der Version 2.4 zurück. Ab diesem Zeitpunkt gelten alle Kontingentrichtlinien der Version 2.4 auch 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 den Statuscode 404 Not Found zurück. Wenn Sie eine JSON-Antwort benötigen, führen Sie ein Upgrade auf Version 3.0 durch.

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

Mit dieser Version werden aktuellere AdWords-Daten und mehr Kombinationen für AdWords-Dimensionen und -Messwerte hinzugefügt.

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

  • Wir haben einige Einschränkungen hinsichtlich gültiger Kombinationen für AdWords-Daten aufgehoben.

Vor einigen Wochen haben wir eine Änderung vorgenommen, um API-Abfragen, bei denen ga:adGroup oder ga:adContent abgefragt wurde, mit ga:impressions nicht mehr zuzulassen, da diese Kombination 0 zurückgegeben hat. Durch diese Änderung ist diese Kombination nun wieder verfügbar. Das Problem wurde behoben, sodass korrekte Daten zurückgegeben werden.

In dieser Version wurden einige ungültige Kombinationen von Dimensionen und Messwerten behoben

Ungültige Kombinationen aus Messwerten und Dimensionen korrigiert

  • Letzten Monat haben wir einige bevorstehende Änderungen an der API angekündigt, durch die einige ungültige Abfragen im Datenfeed, die keine Daten zurückgeben, nicht mehr zulässig sind. Wir haben diese Änderungen nun 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.

    Anstatt eine Antwort mit 0 Ergebnissen zurückzugeben, gibt die API nun für alle Abfragen, die diese Kombinationen anfordern, einen 400-Fehlercode zurück.

In diesem Release wird der Wert des Konfidenzintervalls in Messwerten verworfen.

Einstellung des Konfidenzintervalls

  • Sofern noch nicht geschehen, sollten Sie keine Konfidenzintervallwerte für Messwerte verwenden. Ab dieser Version gibt der Datenfeed der Datenexport-API den Wert 0, 0 für alle Konfidenzintervallwerte zurück. In etwa einem Monat werden wir dieses Attribut vollständig aus allen Messwertelementen entfernen.

    Um festzustellen, ob eine Antwort auf Stichproben basiert, verwenden Sie das Feld "containsSampledData" in der Antwort.

In dieser Version werden drei neue Messwerte hinzugefügt und der Rückgabewert von zwei wird aktualisiert.

Neue Datenaktualisierungen

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

Messwertaktualisierungen

  • Zur Angabe von Währungswerten in Filtern müssen Sie den tatsächlichen Wert angeben, der über den Tracking-Code übergeben wird (z.B. wird 1 Einheit als 1 angegeben).

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

In dieser Version wurde die Leistung des Datenfeeds verbessert und es werden neue Daten hinzugefügt:

Leistungssteigerung

  • In dieser Version wird die Datenfeed-Latenz um 30 bis 35 % verbessert.

Neue Datenaktualisierungen

  • Wir haben die Liste der Dimensionen und Messwerte aktualisiert, die in erweiterten Segmenten zulässig sind. Anhand der aktualisierten Liste können Sie prüfen, ob Ihre Anträge gültig sind.

Anstehende Änderungen

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

  • Derzeit ist ga:CTR ein percent-Wert und gibt den Wert 0, 02 zurück. Demnächst wird der tatsächliche Prozentsatz (z.B. 2) zurückgegeben.

In dieser Version werden weitere Daten zum Datenfeed hinzugefügt:

Neue Datenaktualisierungen

  • Die folgende Dimension „Zeit“ wurde hinzugefügt: ga:dayOfWeek

  • Der folgende interne Messwert für die 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. In den nächsten Wochen wird der Status 401 ausschließlich für ungültige Tokens verwendet. So haben Entwickler die Möglichkeit, diese spezielle Ausnahme zu korrigieren.

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

Neue Datenaktualisierungen

  • Die Berechnung von ga:visitors wurde geändert, um die Anzahl der einzelnen Besucher für den Zeitraum zurückzugeben. 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 und ga:adDestinationUrl.

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

  • Der Messwert "ga:searchResultViews" wurde der Gruppe für die interne Websitesuche hinzugefügt.

  • Drei neue zeitbasierte Dimensionen wurden hinzugefügt: ga:nthDay, ga:nthWeek und ga:nthMonth.

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

Neue berechnete Messwerte

Die folgenden berechneten Messwerte werden aus Berechnungen mit den Basismesswerten abgeleitet. Hinweis: Jeder Name mit (n) unterstützt die Werte 1 bis 20.

  • Basiert auf Zielvorhaben: 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-Suche basierend: 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 dieser Version wurde dem Datenfeed eine neue Funktion hinzugefügt:

Neue Funktionen

  • Ein neues XML-Element wurde hinzugefügt, das Nutzer darüber informiert, ob die Daten einer Stichprobe unterzogen wurden. true. Dieses Element gibt immer zurück, ob für die Daten eine Stichprobe mit true oder false erhoben wurde. Die Java- und JavaScript-Bibliotheken wurden ebenfalls mit Hilfsmethoden aktualisiert, um auf dieses Element zuzugreifen.

In dieser Version werden zwei Fehler behoben:

Fehlerkorrekturen

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

  • Einige der API-Fehlermeldungen für ungültige Filter wurden aktualisiert. Sie enthalten nun NICHT mehr, ob es sich um einen Dimensions- oder Messwertfilter handelte, der den Fehler verursacht hat. Der tatsächlich fehlerhafte Filterausdruck wird jedoch weiterhin zurückgegeben.

In dieser Version werden drei Fehler behoben:

Fehlerkorrekturen

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

  • Ein Fehler, der verhinderte, dass der Kontofeed nicht angezeigt wurde, wenn ein Zielname, ein Zielpfad, ein Zielvergleichswert oder ein Zielvergleichstyp falsch festgelegt wurde, wurde behoben.

  • Es ist nicht zulässig, eine Dimension und einen Messwert im Abfrageparameter für den Datenfeed mit ODER zu verknüpfen. Beispiel: ga:source==google,ga:visits>5. Die Fehlermeldung für diese ungültige Abfrage wurde aktualisiert und lautet jetzt: Cannot OR dimension filter(s) with metric filter.

In dieser Version werden neue Daten hinzugefügt und ein Fehler behoben:

Neue Funktionen

  • In der neuen Kategorie „D8. Adwords“ wurden die folgenden fünf Dimensionen hinzugefügt:

    • ga:adwordsAdGroupId: entspricht der AdWords API-AdGroup.id
    • ga:adwordsCampaignId: entspricht der Campaign.id der AdWords API
    • ga:adwordsCreativeId: entspricht der AdWords API-Ad.id
    • ga:adwordsCriteriaId: Entspricht der AdWords API-Criterion.id
    • ga:adwordsCustomerId: entspricht der AdWords API AccountInfo.customerId

Fehlerkorrekturen

  • Wir haben ein Problem behoben, bei dem für den Kontofeed keine Daten zurückgegeben wurden, wenn eines der Profile ein falsch konfiguriertes Ziel oder einen falsch konfigurierten Schritt enthielt.

Diese Version enthält eine Reihe neuer Funktionen und behebt einen Fehler:

Neue Funktionen

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

  • Die von der API verwendete Abtastrate entspricht jetzt der Rate der Weboberfläche. Dadurch werden die Daten für Stichprobenberichte direkt in der Weboberfläche angezeigt und die Konsistenz zwischen den beiden erhöht.

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

    • Eine einzelne Web-Property kann maximal 10.000 Anfragen pro 24 Stunden senden.
    • Eine Anwendung kann pro Sekunde maximal 10 Anfragen stellen.
    • Für eine Anwendung können jeweils nur vier ausstehende Anfragen vorhanden sein.
  • Einige Einschränkungen für Kombinationen aus Dimensionen und Messwerten wurden aufgehoben. ga:nextPagePath und ga:previousPagePath gehören jetzt zur Gruppe D3. Content. Die Gruppe „D8. Custom Variable“ wird jetzt als Gruppe „D6. Custom Variable“ bezeichnet. Diese neuen Kombinationen finden Sie im aktualisierten Referenzleitfaden.

Fehlerkorrekturen

  • Wir haben einen Programmfehler behoben, bei dem die API den confidenceInterval-Wert für Messwerte meldet. Bisher konnten Konfidenzintervalle entweder den Wert INF oder eine Zahl von 0 bis 1 haben. Jetzt haben alle Konfidenzintervalle entweder den Wert INF oder eine Zahl, die größer oder gleich 0 ist.

  • ga:itemQuantity und ga:uniquePurchases wurden zuvor vertauscht und haben gegenseitig ihre Werte zurückgegeben. Sie wurden nun korrigiert, sodass die richtigen Daten zurückgegeben werden.

Erinnerung an die Einstellung von Dimensionen und Messwerten

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

Diese Version enthält eine Reihe neuer Funktionen:

In diesem Release wird die Hauptversionsnummer auf 2 erhöht

  • Für einige Funktionen müssen die neuesten Clientbibliotheken verwendet werden. Offizielle Unterstützung für Java und JavaScript. Bibliotheken von Drittanbietern werden möglicherweise noch nicht aktualisiert.

    • Sie können Version 2 anfordern, indem Sie jeder Konto- oder Datenfeed-Anfrage die Kopfzeile GData-Version: 2 hinzufügen. Weitere Informationen finden Sie in der Dokumentation.
    • Dem Konto und den Datenfeeds wurde ein neuer XML-Namespace hinzugefügt:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Die API unterstützt jetzt das Google-Datenprotokoll Version 2.

Erweiterter Support für die Segmentierung

  • Suchparameter für dynamische Segmente:

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

    • ...&segment=gaid::Nummer
    • Hierbei ist number eine ID, die auf ein erweitertes Segment verweist, das in der Google Analytics-Weboberfläche definiert wird.
    • Die ID finden Sie im Kontofeed.
  • Im Kontofeed werden Segmentdaten mithilfe der folgenden XML-Elemente und -Attribute beschrieben:

    • ga:visitorType==Returning Visitor
  • Der Datenfeed enthält außerdem 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 Daten zu Zielvorhaben verfügbar

  • Im Kontofeed verfügbare Zielvorhaben vom Typ „Ziel“ und „Engagement“:

  • Für die Ziele 5 bis 20 wurden 48 neue Zielmesswerte hinzugefügt, die alle der Konvention goal(n)Completions folgen, 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 Daten zu Zielvorhaben zu berücksichtigen.

Neue Daten zu benutzerdefinierten Variablen

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

  • Für benutzerdefinierte Variablen wurden 10 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 Messwerte werden entfernt.

  • Sofern noch nicht geschehen, sollten Sie die zuvor eingestellten Dimensionen und Messwerte nicht mehr verwenden. 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

In dieser Version werden neue Funktionen hinzugefügt und einige alte Funktionen werden eingestellt:

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

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

    • ga:countOfVisits ist jetzt ga:visitCount
    • ga:countOfVisitsToATransaction heißt jetzt ga:visitsToTransaction
  • Alle Ereignis-Tracking-Daten werden jetzt in zwei neuen Gruppen angezeigt:

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

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

  • Die gesamten Daten zur Websitenavigation werden jetzt anhand der folgenden Dimensionen dargestellt:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

  • Die Navigation auf der Landingpage wird jetzt mit den folgenden Dimensionen dargestellt:

    D3. Content * ga:landingPagePath * ga:secondPagePath

  • Die maximale Länge regulärer Ausdrücke im Filtersuchparameter des Datenfeeds wurde von 32 auf 128 Zeichen erhöht.

  • Der Bericht "Länge des Besuchs" (zu finden über die Benutzeroberfläche unter Besucher -> Besuchertreue) wird jetzt über die neue Dimension angezeigt:

    • ga:visitLength

In dieser Version wird das Google Analytics-API für den Datenexport wie folgt aktualisiert:

  • Einige Einschränkungen für Kombinationen aus Dimensionen und Messwerten wurden aufgehoben. Sie können jetzt die meisten Dimensionen auf Content- und Besucherebene abfragen. Beispiel: ga:pagePath und ga:source sind jetzt eine gültige Kombination. Informationen zu diesen neuen Kombinationen erhalten Sie im aktualisierten Referenzhandbuch unter 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 der zurückgegebenen Zeilen beträgt immer noch 1.000, kann jedoch durch Festlegen des Abfrageparameters max-results erhöht werden.

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

  • Ab sofort müssen Datenabfragen mindestens einen gültigen Messwert enthalten.

  • Alle bisherigen Änderungen an der Einstellung sind wirksam.

Mit diesem Release werden eingestellte Funktionen aus unserer nicht öffentlichen Betaversion entfernt:

  • Die Konto-Feed-Anfragen unterstützen dann keinen Nutzernamen mehr darin. 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. Hier finden Sie eine Anleitung zur Berechnung dieser Werte: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

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

    Dimensionen * ga:subContinentRegion Food ga:subContinent * ga:organization auszuführen ‒ ga:networkLocation * ga:domain + ga:networkDomain * ga:visitNumber teile ga:runningOfVisits * ga:platform Eisdiele ga:OperatingSystem * ga:platformVersion Eisdiele ga

    Messwerte * ga:newBesucher *Abschlussziel 1