Google Analytics – Alle Reporting API-Änderungsprotokolle

Auf dieser Seite werden alle Änderungen dokumentiert, die an den Google Analytics Reporting APIs vorgenommen wurden. Er enthält Änderungsprotokolle für die Core Reporting API und die Multi-Channel Trichter Reporting API. 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 Collection-, Konfigurations- und Reporting 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 mit einer einzelnen Client-ID oder User-ID verknüpften Daten über einen bestimmten Zeitraum abrufen. Sie ist in erster Linie für Property-Inhaber gedacht, die diesem Nutzer automatisierten Zugriff auf die Daten eines Nutzers ermöglichen möchten. Weitere Informationen finden Sie im User Activity API Guide.

Mit dieser Version werden Änderungen an den Kontingenten und Limits für die Analytics Real Time API eingeführt.

Analytics Real Time Reporting API-Aufrufe werden verwendet, um zum Limit von 10.000 Aufrufen pro Datenansicht (Profil) pro Tag beizutragen, wie bei anderen Analytics API-Aufrufen. Aufrufe der Analytics Real Time Reporting API werden jetzt separat erfasst. Sie können also 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit der Analytics Real Time Reporting API ausführen UND weitere 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit anderen Analytics APIs ausführen. Weitere Informationen finden Sie auf der Seite Limits und Kontingente.

Diese Änderung ermöglicht eine detailliertere und sicherere Verwaltung von Kontingenten, damit häufige Aufrufe über die Analytics Real Time Reporting API nicht versehentlich alle anderen Analytics API-Aufrufe für den Rest des Tages für ein einzelnes Profil blockieren.

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

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

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

In diesem Release werden die Funktion Ähnliche Produkte und die zugehörigen Dimensionen und Messwerte eingestellt. Eine vollständige Liste der Definitionen finden Sie in der Referenz für Dimensionen und Messwerte. Weitere Informationen zur Entfernung von Daten finden Sie in den Richtlinien zur Einstellung 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 mehrere nicht mehr unterstützte Dimensionen und Messwerte entfernt. Lesen Sie die Richtlinie zur Einstellung von Daten für Google Analytics APIs, um den vollständigen Prozess der Datenentfernung zu verstehen.

Uhrzeit

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

Datenlöschung

In diesem Release 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 diesem Release werden vorhandene Messwerte und Dimensionen in der API aktualisiert. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Nutzermesswerte

Die Berechnung für die Messwerte Nutzer und Aktive Nutzer wurde aktualisiert, damit Nutzer effizienter gezählt werden. Es kann sein, dass sich die 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 ga:uniqueEventsTemporary-Messwert wird aus der API entfernt. Weitere Informationen finden Sie in den Dokumenten zu eindeutigen Ereignissen.

Mit diesem Release wird der API eine neue Dimension hinzugefügt, die Fehlermeldungen verbessert und die zuvor angekündigten Änderungen für AdSense-Dimensionen und -Messwerte werden erzwungen.

Nutzerdimensionen

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

Fehlermeldungen

Früher gab die API beim Anfordern von Daten mit nicht erfüllten Bedingungen eine fehlerhafte Fehlermeldung Unknown dimension(s): oder Unknown metric(s): aus. Jetzt gibt die API die folgende Meldung zurück: Restricted metric(s): ... can only be queried under certain conditions.

AdSense-Dimensionen und -Messwerte

In verknüpften Datenansichten, bei denen es sich nicht um AdSense handelt, können keine AdSense-Dimensionen und -Messwerte abgefragt werden. Bei Abfragen dieser Dimensionen und Messwerte für Datenansichten, die nicht mit AdSense verknüpft sind, wird ein Fehler ausgegeben.

Mit dieser Veröffentlichung 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

Mit dieser Version wurde ein Problem behoben, das seit dem 7. Januar 2017 begonnen hat. Bei der Abfrage von AdSense-Dimensionen und -Messwerten wurde für verknüpfte Datenansichten ohne AdSense der Fehler "Unbekannter Messwert" zurückgegeben.

Anstehende Änderungen

Ab dem 31. Januar 2017 werden in nicht mit AdSense verknüpften Datenansichten keine AdSense-Dimensionen und -Messwerte mehr abgefragt. Bei Abfragen dieser Dimensionen und Messwerte für Datenansichten, die nicht mit AdSense verknüpft sind, wird ein Fehler ausgegeben.

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

Berechnete Messwerte

In dieser Version werden berechnete Messwerte unterstützt.

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

In diesem Release wurde der API ein neuer Messwert hinzugefügt. Außerdem wird ein vorhandener Messwert verworfen. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Ereignis-Tracking

Die Definition von ga:uniqueEvents wird geändert, um die Anzahl der einzelnen Ereignisse genauer widerzuspiegeln. Aufgrund dieser Änderung werden wir den aktuellen Messwert „ga:uniqueEvents“ gemäß unserer Richtlinie zur Datenverwerfung technisch einstellen. Wenn Sie die neue Definition ausprobieren möchten, können Sie auf den privaten Messwert ga:uniqueEventsTemporary zurückgreifen. Er berechnet die Anzahl einzelner Ereignisse genauer. 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 6 Monate) wird der private Messwert „ga:uniqueEventsTemporary“ entfernt. Der ursprüngliche Messwert „ga:uniqueEvents“ gibt dann die Anzahl der einzelnen Ereignisse korrekt wieder. Weitere Informationen finden Sie in den Dokumenten zu eindeutigen Ereignissen.

Einzelne Ereignisse

  • Messwert: ga:uniqueEvents: Die Definition von „ga:uniqueEvents“ ändert sich bald, um die Anzahl der einzelnen Ereignisse genauer widerzuspiegeln. Verwenden Sie stattdessen ga:uniqueDimensionCombinations, wenn Sie die vorhandene Definition beibehalten möchten. Weitere Informationen finden Sie in den Dokumenten 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 den Dokumenten zu eindeutigen Ereignissen.

Übergangstest – privat

  • Messwert: ga:uniqueEventsTemporary: Anzahl der einzelnen Ereignisse. Dies wird die neue Definition für „ga:uniqueEvents“ sein. 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. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

DoubleClick Bid Manager

  • Dimension: ga:dbmClickAdvertiser – Name des DBM-Werbetreibenden des mit der Google Analytics-Sitzung übereinstimmenden DBM-Klicks (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickAdvertiserId – DBM-Werbetreibenden-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur 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 – Plattformname der DBM-Plattform des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickExchangeId – ID der Anzeigenplattform für den DBM-Klick, 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 Analytics 360, Integration in DBM erforderlich).
  • Dimension: ga:dbmClickInsertionOrderId – DBM-Anzeigenauftrags-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickLineItem – Name der DBM-Werbebuchung des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickLineItemId – DBM-Werbebuchungs-ID des DBM-Klicks, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension: ga:dbmClickSite – Name der DBM-Website, auf der das DBM-Creative für den DBM-Klick ausgeliefert wurde, der mit der Google Analytics-Sitzung übereinstimmt (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Dimension – ga:dbmClickSiteId – DBM-Website-ID, auf der das DBM-Creative ausgeliefert und für den entsprechenden DBM-Klick mit der Google Analytics-Sitzung geklickt wurde (nur Analytics 360, Integration in 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, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventAdvertiserId – DBM-Werbetreibenden-ID 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:dbmLastEventCreativeId – DBM-Creative-ID des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventExchange – DBM-Anzeigenplattformname des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventExchangeId – DBM-Anzeigenplattform-ID des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventInsertionOrder – Name des DBM-Anzeigenauftrags des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventInsertionOrderId – DBM-Anzeigenauftrags-ID des letzten DBM-Ereignisses (Impression oder Klick im DBM-Lookback-Window), das mit der Google Analytics-Sitzung verknüpft ist (nur Analytics 360, Integration in 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, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventLineItemId – DBM-Werbebuchungs-ID 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:dbmLastEventSite – DBM-Websitename, auf der das DBM-Creative für das letzte DBM-Ereignis (Impression oder Klick im DBM-Lookback-Window) der Google Analytics-Sitzung ausgeliefert und angeklickt wurde (nur bei Analytics 360, Integration in DBM erforderlich).
  • Dimension – ga:dbmLastEventSiteId – DBM-Website-ID, auf der das DBM-Creative für das letzte DBM-Ereignis (Impression oder Klick im DBM-Lookback-Window) der Google Analytics-Sitzung ausgeliefert und angeklickt wurde (nur Analytics 360, Integration in DBM erforderlich).
  • Messwert – ga:dbmCPA – eCPA des DBM-Umsatzes (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCPC – eCPC des DBM-Umsatzes (nur Analytics 360, Verknüpfung mit DBM erforderlich).
  • Messwert – ga:dbmCPM – eCPM des DBM-Umsatzes (nur bei Analytics 360, Integration in 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, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsAdvertiser – DS-Werbetreibender (nur bei Analytics 360, Integration 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, Verknüpfung in DS erforderlich).
  • Dimension – ga:dsCampaign – DS-Kampagne (nur bei Analytics 360, DS-Integration 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, DS-Integration erforderlich).
  • Dimension – ga:dsEngineAccountId – DS-Engine-Konto-ID (nur bei Analytics 360, Verknüpfung 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 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, Integration in DS erforderlich)
  • ga:dsCost: DS-Kosten (nur bei Analytics 360, Integration in DS erforderlich)
  • ga:dsImpressions: DS-Impressionen (nur bei Analytics 360, Integration in DS erforderlich)
  • ga:dsProfit – DS Profie (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: Umsatz pro Klick in DS (nur bei Analytics 360, Integration in DS erforderlich)

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

Transaktions-ID

  • Dimension: mcf:transactionId: Transaktions-ID für den Kauf im Einkaufswagen, die über die E-Commerce-Tracking-Methode bereitgestellt wird

In diesem Release wurde 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. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Geo-Netzwerk

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

Einschränkungen

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

  • Zur Shopping-Infogruppe
    • 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 Limits und Kontingente ein. Einzelheiten finden Sie in der Dokumentation zu Limits und Kontingenten.

Fehler melden

In dieser Version werden Grenzwerte für fehlgeschlagene (5XX) Berichtsanfragen erzwungen.

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

Pivot-Limits

Ab dieser Version gelten Einschränkungen für Pivot-Anfragen:

  • Eine Berichtsanfrage kann jetzt maximal zwei Pivots umfassen.
  • Ein Pivot kann maximal vier Dimensionen haben.
  • Pivot-Dimensionen sind Teil der Einschränkung der Gesamtzahl der in der Anfrage zulässigen Dimensionen.
  • 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. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Geo-Netzwerk

  • Dimension: ga:metroId: Der dreistellige DMA-Code (Designated Market Area), von dem der Traffic stammt, der von den IP-Adressen oder geografischen IDs der Nutzer abgeleitet wird.

DoubleClick for Publishers

  • Messwert – ga:dfpImpressions: Eine DFP-Anzeigenimpression wird erfasst, sobald eine Einzelanzeige auf der Website erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen angezeigt (die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsätzen nicht aktiviert).“
  • Messwert: ga:dfpCoverage: Die Abdeckung gibt an, bei wie viel Prozent der Anzeigenanfragen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über das DFP-Konto keine Anzeigen mit Targeting bereitgestellt werden können. (Anzeigenimpressionen / Anzeigenanfragen insgesamt) * 100 (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz 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. Beachten Sie, dass eine einzelne Seite mehrere Anzeigenblöcke enthalten kann (die DFP-Verknüpfung ist aktiviert und die Option Ausblenden von DFP-Umsätzen nicht aktiviert).“
  • Messwert: ga:dfpImpressionsPerSession: Das Verhältnis von DFP-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen) (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).“
  • Messwert: ga:dfpViewableImpressionsPercent: Prozentsatz sichtbarer Anzeigenimpressionen. Eine Impression wird als sichtbare Impression angesehen, wenn sie im Browser des Nutzers ausgeliefert wurde und die Möglichkeit besteht, die Anzeige gesehen zu haben (d. h., die DFP-Verknüpfung ist aktiviert und die Option „Umsatz ausblenden“ nicht aktiviert).“
  • Messwert: ga:dfpClicks: Gibt an, wie oft auf der Website auf DFP-Anzeigen geklickt wurde (die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsatz 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“ nicht aktiviert).“
  • Messwert: ga:dfpRevenue: Der DFP-Umsatz ist eine Schätzung des gesamten Werbeumsatzes auf Grundlage der ausgelieferten Impressionen. Die Funktion ist aktiviert, weil die DFP-Verknüpfung aktiviert und die Option „DFP-Umsatz ausblenden“ nicht aktiviert ist.“
  • 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 (d. h., die DFP-Verknüpfung ist aktiviert und die Option „Umsatz ausblenden“ ist nicht aktiviert).“
  • Messwert: ga:dfpECPM: der effektive Cost-per-1000-Impressions. Es handelt sich um den Umsatz mit DFP pro 1.000 Seitenaufrufen (bei aktivierter DFP-Verknüpfung und deaktivierter Option: DFP-Umsatz ausblenden).“
  • Messwert – ga:backfillImpressions – Backfill-Impressionen ist die Summe aller AdSense- oder Ad Exchance-Anzeigenimpressionen, die als Backfill über DFP ausgeliefert wurden. Eine Anzeigenimpression wird erfasst, sobald eine Einzelanzeige auf der Website erscheint. Wird beispielsweise eine Seite mit zwei Anzeigenblöcken einmal aufgerufen, werden zwei Impressionen angezeigt (die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsätzen nicht aktiviert).“
  • Messwert: ga:backfillCoverage: Der Prozentsatz der Backfill-Anzeigenanfragen, bei denen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen lassen sich 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 zur Verfügung stellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsatz 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 enthalten kann (die DFP-Verknüpfung ist aktiviert und die Option zum Ausblenden von DFP-Umsätzen nicht aktiviert).
  • Messwert: ga:backfillImpressionsPerSession: Das Verhältnis von Backfill-Anzeigenimpressionen zu Analytics-Sitzungen (Anzeigenimpressionen ÷ Analytics-Sitzungen). Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).
  • Messwert: ga:backfillViewableImpressionsPercent: Prozentsatz der Backfill-Anzeigenimpressionen, die sichtbar waren. Eine Impression wird als sichtbare Impression bezeichnet, wenn sie im Browser des Nutzers ausgeliefert wurde und die Möglichkeit bestand, dass die Anzeige vom Nutzer gesehen wird. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (die Verknüpfung mit Google Ad Manager und die Option zum Ausblenden von DFP-Umsatz 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, entspricht dieser Messwert der Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).
  • Messwert: ga:backfillCTR: Der Prozentsatz der Backfill-Impressionen, die zu einem Klick auf eine Anzeige geführt haben. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, ist dieser Messwert der gewichtete Durchschnitt der beiden Backfill-Konten (die Verknüpfung mit Google Ad Manager und die Option zum Ausblenden von DFP-Umsatz nicht aktiviert).
  • Messwert: ga:backfillRevenue: Der geschätzte Gesamtumsatz aus Backfill-Anzeigen. Wenn AdSense und Ad Exchange beide Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).
  • Messwert: ga:backfillRevenuePer1000Sessions: Der geschätzte Gesamtumsatz aus Backfill-Anzeigen pro 1.000 Analytics-Sitzungen. Dieser Messwert basiert auf Sitzungen auf der Website und nicht auf Anzeigenimpressionen. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).
  • Messwert: ga:backfillECPM: der effektive Cost-per-1000-Impressions. Er gibt den Umsatz von Backfill-Anzeigen in DFP pro 1.000 Seitenaufrufen an. Wenn sowohl AdSense als auch Ad Exchange Backfill-Anzeigen bereitstellen, entspricht dieser Messwert der Summe der beiden Backfill-Konten (DFP-Verknüpfung aktiviert und Ausblenden von DFP-Umsatz nicht aktiviert).

Dies ist eine Version zur Fehlerkorrektur, die ein Problem mit Segmenten und Stichproben behebt.

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.

In diesem Release wird das neue Attribut addedInApiVersion hinzugefügt.

In API-Version hinzugefügt

  • addedInApiVersion ist ein numerisches Attribut, mit dem geprüft werden kann, ob eine Spalte in einer Reporting API einer bestimmten Version verwendet werden kann. Weitere Informationen finden Sie im Entwicklerleitfaden zur Metadata API.

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

Wichtigste Features

Google Analytics basiert auf einer leistungsstarken Infrastruktur für die Berichterstellung. Über die 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 der API können Sie nicht nur die integrierten Messwerte, sondern auch die mathematischen Messwertausdrü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 Daten für zwei Zeiträume in einer einzigen Anfrage vergleichen können.
  • Kohorten und Lifetime-Wert: Die API verfügt über ein umfangreiches Vokabular zum Anfordern von Kohorten- und Lifetime-Wert-Berichten.
  • Mehrere Segmente: Sie können jetzt in einer einzigen Anfrage mehrere Segmente anfordern.

Erste Schritte

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

Kontingentrichtlinie

Die Analytics Reporting API Version 4 hat eigene Kontingente und Limits. Da es sich um eine neue API handelt, können diese Limits und Kontingente geändert werden.

Migration

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

Dimensionen und Messwerte

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

  • Dimension – ga:cohort – 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. Beispiel: Wurde für eine Kohorte das Datum des ersten Besuchs als 2015-09-01 festgelegt, dann hat für das Datum 2015-09-04 den Wert ga:cohortNthDay den Wert 3.

  • ga:cohortNthMonth: 0-basierte Monatsverschiebung 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 auf Grundlage der Standardregeln für die Channelgruppierung (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. Tag/Woche/Monat der Kohorte entspricht. Für ga:cohortNthWeek = 1 beispielsweise 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 als Kohortengröße bezeichnet.

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

  • Messwert: ga:cohortGoalCompletionsPerUser – Abschlüsse für Zielvorhaben pro Nutzer 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 Messwert ist im Kontext einer Anfrage mit den Dimensionen ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium oder ga:acquisitionCampaign relevant. Sie entspricht der Anzahl der Nutzer in den Kohorten, die über den aktuellen Channel, die aktuelle Quelle, das aktuelle Medium oder die aktuelle Kampagne gewonnen 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 Akquisitionsdimension 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 Akquisitionsdimension für eine Kohorte.

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

Die Dimensionen und Messwerte im Hub für soziale Interaktionsdaten wurden eingestellt. Sie enthalten nur Berichte zu Verlaufsdaten ab dem 30. April 2016. Danach werden keine neuen Daten mehr angezeigt. Gemäß der Richtlinie zur Einstellung von Daten werden diese Dimensionen und Messwerte nach dem 30. September 2016 entfernt.

In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Soziale Aktivitäten

Diese Dimensionen und Messwerte wurden eingestellt und werden nach dem 30. September 2016 entfernt. Weitere Informationen zur Entfernung von Daten finden Sie in den Richtlinien zur Einstellung von Daten:

  • Dimension: ga:socialActivityEndorsingUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies die URL der Aktivität in sozialen Netzwerken, 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 in 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 stattgefunden hat.
  • Dimension: ga:socialActivityUserHandle: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies der Alias des sozialen Netzwerks (z.B. Name oder ID) der Nutzer, die die soziale Aktivität gestartet haben.
  • Dimension: ga:socialActivityUserPhotoUrl: Bei einer Aktivität im Hub für soziale Interaktionsdaten ist dies 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 verknüpften 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 (z. B. Abstimmung, Kommentar, +1), die mit der Aktivität verknüpft ist.
  • Dimension: ga:socialActivityNetworkAction: Bei einer Aktivität im Hub für soziale Interaktionen handelt es sich um den Typ der sozialen Interaktion und das soziale Netzwerk, von dem die Aktivität ausgeht.
  • Dimension: ga:socialActivityContentUrl: Bei einer Aktivität im Hub für soziale Netzwerke 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 wurde der API eine neue Dimension hinzugefügt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Plattform oder Gerät

  • Dimension: ga:browserSize: Die Größe des Darstellungsbereichs im Browser des Nutzers. 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 x Höhe“ angegeben. Beispiel: 1920 × 960.

In dieser Version 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 dieser auf false gesetzt ist, werden Zeilen ohne Daten in der Antwort ausgelassen. Der Standardwert ist true. Diese Änderung stellt eine abwärtskompatible Änderung dar und sollte daher keine Codeaktualisierung erfordern. Weitere Informationen finden Sie in der Referenzdokumentation zur Core Reporting API.

In diesem Release werden der API neue Messwerte hinzugefügt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Nutzer

  • Messwert: ga:1dayUsers: Gesamtzahl der an einem Tag aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zur Abfrage dieses Messwerts muss mindestens entweder ga:nthDay, ga:date oder ga:day als Dimension angegeben werden. Für das angegebene Datum wird der Wert der Gesamtzahl der einzelnen Nutzer 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. Zur Abfrage dieses Messwerts muss mindestens entweder ga:nthDay, ga:date oder ga:day als Dimension angegeben werden. Für das angegebene Datum wird der Wert der Gesamtzahl der einzelnen Nutzer in einem Zeitraum von sieben Tagen bis zum angegebenen Datum zurückgegeben.
  • Messwert: ga:14dayUsers: Gesamtzahl der an 14 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zur Abfrage dieses Messwerts muss mindestens entweder ga:nthDay, ga:date oder ga:day als Dimension angegeben werden. Für das angegebene Datum wird der Wert der Gesamtzahl der einzelnen Nutzer in einem Zeitraum von 14 Tagen bis zum angegebenen Datum zurückgegeben.
  • Messwert: ga:30dayUsers: Gesamtzahl der in den letzten 30 Tagen aktiven Nutzer für jeden Tag im angeforderten Zeitraum. Zur Abfrage dieses Messwerts muss mindestens entweder ga:nthDay, ga:date oder ga:day als Dimension angegeben werden. Für das angegebene Datum wird der Wert der Gesamtzahl der einzelnen Nutzer in einem Zeitraum von 30 Tagen bis zum angegebenen Datum zurückgegeben.

In diesem Release werden der API neue Messwerte hinzugefügt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

DoubleClick Ad Exchange (AdX)

  • Messwert: ga:adxCTR: Der Prozentsatz der Seitenaufrufe, die zu einem Klick auf eine AdX-Anzeige geführt haben.
  • Messwert: ga:adxClicks: gibt an, wie oft AdX-Anzeigen auf Ihrer Website angeklickt wurden.
  • Messwert: ga:adxCoverage: Die Abdeckung gibt an, bei wie viel Prozent der Anzeigenanfragen mindestens eine Anzeige zurückgegeben wurde. Im Allgemeinen können Sie mithilfe der Abdeckung Websites ermitteln, auf denen über Ihr AdX-Konto keine zielgerichteten Anzeigen bereitgestellt werden können. (Anzeigenimpressionen ÷ Gesamtzahl der Anzeigenanfragen) × 100
  • Messwert: ga:adxECPM: der effektive Cost-per-1000-Impressions. Er entspricht Ihrem 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).
  • Mit dem Messwert "ga:adxMonetizedPageviews" – "Monetarisierte Seitenaufrufe" wird die Gesamtzahl der Seitenaufrufe auf Ihrer Property gemessen, bei denen eine Anzeige aus Ihrem verknüpften AdX-Konto geschaltet 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: 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. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Eingestellte Dimensionen

Diese Dimensionen wurden eingestellt. Weitere Informationen zur Entfernung von Daten finden Sie in den Richtlinien zur Einstellung von Daten:

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

In diesem Release wurde der API eine neue Dimension hinzugefügt. Eine vollständige Liste der Dimensionen und Messwerte finden Sie in der Referenz 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 in der Referenz für Dimensionen und Messwerte.

Plattform oder Gerät

  • Dimension: ga:dataSource: Die Datenquelle eines Treffers. Treffer, die von ga.js und analytics.js gesendet werden, werden als „Web“ und von den 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.

Dies ist eine Version zur Fehlerkorrektur:

  • In dieser Version wurde ein Problem bei der Erzwingung von Filterbeschränkungen in der Real Time Reporting API-Abfrage behoben. Anfragen mit rt:activeUsers und einem Filter für eine Dimension auf Ereignisebene würden zu einem Fehler mit dem Grund badRequest und der Meldung OR operator not supported for a hit level filter führen. Weitere Informationen zu Abfrageeinschränkungen finden Sie im Entwicklerleitfaden zur Real Time Reporting API.

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

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 Orts-IDs von Nutzern, 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 ISO-3166-1-Alpha-2-Code angegeben.
  • Dimension: ga:regionId: Die Regions-ID der Nutzer, die aus IP-Adressen oder geografischen IDs abgeleitet wird. In den USA ist jeder Staat eine Region, beispielsweise Nevada.
  • Dimension: ga:regionIsoCode: Der ISO-Code der Nutzer für die Region, abgeleitet aus IP-Adressen oder geografischen IDs. Die Werte werden als ISO-3166-2-Code angegeben.
  • Dimension: ga:subContinentCode: Der Subkontinentcode von Nutzern, der aus IP-Adressen oder geografischen IDs abgeleitet wird. Zum 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).

Eingestellte Messwerte

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

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

AdWords

  • Der Messwert "ga:ROAS" – der 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. Weitere Informationen zum Entfernen von Daten finden Sie in der Richtlinie zur Einstellung von Daten: + Messwert – ga:ROI – Verwenden Sie stattdessen ga:ROAS. + Messwert – ga:margin – Verwenden Sie stattdessen ga:ROAS.

Diese Version enthält eine neue Dimension. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Uhrzeit

  • Dimension: rt:minutesAgo: vor wie vielen Minuten ein Treffer aufgetreten ist.

In diesem Release werden der API neue Messwerte hinzugefügt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

AdSense

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

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

Conversion-Pfade

  • Dimension: mcf:dcmAd: Der DCM-Anzeigenname des DCM-Ereignisses (Impression oder Klick), der mit der Google Analytics-Conversion übereinstimmt.
  • Dimension: mcf:dcmAdPath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Anzeigen dargestellt werden
  • Dimension: mcf:dcmAdType: Name des DCM-Anzeigentyps des DCM-Ereignisses (Impression oder Klick), das mit der Google Analytics-Conversion übereinstimmt.
  • Dimension: mcf:dcmAdvertiser: Name des DCM-Werbetreibenden des DCM-Ereignisses (Impression oder Klick), der mit der Google Analytics-Conversion übereinstimmt
  • Dimension: mcf:dcmAdvertiserPath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Werbetreibende dargestellt werden
  • Dimension: mcf:dcmCampaign: Name der DCM-Kampagne des DCM-Ereignisses (Impression oder Klick), der mit der Google Analytics-Conversion übereinstimmt
  • Dimension: mcf:dcmCampaignPath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Kampagnen dargestellt werden
  • Dimension: mcf:dcmCreative: Der DCM-Creative-Name des DCM-Ereignisses (Impression oder Klick), der mit der Google Analytics-Conversion übereinstimmt.
  • Dimension: mcf:dcmCreativePath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Creatives dargestellt werden
  • Dimension: mcf:dcmCreativeVersion: Die DCM-Creative-Version des DCM-Ereignisses (Impression oder Klick), die mit der Google Analytics-Conversion übereinstimmt.
  • Dimension: mcf:dcmCreativeVersionPath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Creative-Versionen dargestellt werden
  • Dimension: mcf:dcmNetwork: Das verwendete Werbenetzwerk.
  • Dimension: mcf:dcmPlacement: Name des DCM-Website-Placements des DCM-Ereignisses (Impression oder Klick), der mit der Google Analytics-Conversion übereinstimmt
  • Dimension: mcf:dcmPlacementPath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Placements dargestellt werden
  • Dimension: mcf:dcmSite: Name der DCM-Website, auf der das DCM-Creative für das DCM-Ereignis (Impression oder Klick) ausgeliefert wurde, das mit der Google Analytics-Conversion übereinstimmt
  • Dimension: mcf:dcmSitePath: Pfad zur Conversion, wobei die Interaktionen im Pfad durch DCM-Websites dargestellt werden
  • Messwert: mcf:firstImpressionConversions: Anzahl der Conversions, bei denen die Impression einer DCM-Kampagne die erste Conversion-Interaktion in einem 30-tägigen Lookback-Window war. Diese Dimension umfasst sowohl Abschlüsse für Zielvorhaben als auch Transaktionen.
  • Messwert: mcf:firstImpressionValue: Der Wert der Conversions, bei denen die Impression einer Kampagne in einer DCM-Kampagne die erste Conversion-Interaktion in einem 30-tägigen Lookback-Window war. Diese Dimension umfasst sowohl Abschlüsse für Zielvorhaben als auch Transaktionen.
  • Messwert: mcf:impressionAssistedConversions: Die Anzahl der Conversions, bei denen eine Impression einer DCM-Kampagne im Conversion-Pfad aufgetreten ist, aber nicht die letzte Interaktion vor der Conversion. Diese Dimension umfasst sowohl Abschlüsse für Zielvorhaben als auch Transaktionen.
  • Messwert: mcf:impressionAssistedValue: Der Wert der Conversions, bei denen die Impression einer Kampagne aus einer DCM-Kampagne zwar im Conversion-Pfad aufgetreten ist, aber nicht die letzte Interaktion vor der Conversion war. Diese Dimension umfasst sowohl Abschlüsse für Zielvorhaben als auch Transaktionen.

In dieser Version wurden ein neuer Sitzungsmesswert, eine neue Dimension für Besucherquellen sowie neue Dimensionen und Messwerte in DoubleClick Campaign Manager hinzugefügt.

Dimensionen und Messwerte

In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

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: bei manuellem Kampagnen-Tracking der Wert des Kampagnen-Tracking-Parameters „utm_id“

DoubleClick Campaign Manager

  • Dimension: ga:dcmClickAd – DCM-Anzeigenname des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmClickAdId – DCM-Anzeigen-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmClickAdType – Name des DCM-Anzeigentyps für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmClickAdTypeId – ID des DCM-Anzeigentyps des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickAdvertiser – Name des DCM-Werbetreibenden für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickAdvertiserId – DCM-Werbetreibenden-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCampaign – DCM-Kampagnenname des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmClickCampaignId – DCM-Kampagnen-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCreative – DCM-Creative-Name des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCreativeId – DCM-Creative-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCreativeType – Name des DCM-Creative-Typs für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickCreativeTypeId – ID des DCM-Creative-Typs 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 angeklickt wurde, um den DCM-Klick mit der Google Analytics-Sitzung zu vergleichen (nur Premium).
  • Dimension: ga:dcmClickSiteId – ID der DCM-Website, auf der das DCM-Creative ausgeliefert und für den DCM-Klick entsprechend der Google Analytics-Sitzung (nur Premium) angeklickt wurde
  • Dimension: ga:dcmClickSitePlacement – Name des DCM-Website-Placements für den DCM-Klick, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension: ga:dcmClickSitePlacementId – DCM-Website-Placement-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmClickSpotId – DCM-Floodlight-Konfigurations-ID des DCM-Klicks, der der Google Analytics-Sitzung entspricht (nur Premium).
  • Dimension – ga:dcmFloodlightActivity – 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 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 – DCM-Floodlight-Werbetreibenden-ID, die mit der Floodlight-Conversion verknüpft ist (nur Premium)
  • Dimension – ga:dcmFloodlightSpotId – ID der DCM-Floodlight-Konfiguration, die mit der Floodlight-Conversion verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventAd: DCM-Anzeigenname 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:dcmLastEventAdId: DCM-Anzeigen-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:dcmLastEventAdType: Name des DCM-Anzeigentyps des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das der Google Analytics-Sitzung zugeordnet ist (nur Premium).
  • Dimension – ga:dcmLastEventAdTypeId – DCM-Anzeigentyp-ID des letzten DCM-Ereignisses (Impression oder Klick im DCM-Lookback-Window), das der Google Analytics-Sitzung zugeordnet 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 verknüpft ist (nur Premium).
  • 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), der mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventCampaignId: DCM-Kampagnen-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:dcmLastEventCreative: DCM-Creative-Name 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:dcmLastEventCreativeId: DCM-Creative-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:dcmLastEventCreativeType: Name des DCM-Creative-Typs des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das der Google Analytics-Sitzung zugeordnet ist (nur Premium).
  • Dimension: ga:dcmLastEventCreativeTypeId: ID des letzten DCM-Creative-Typs des letzten DCM-Ereignisses (Impression oder Klick im Lookback-Window von DCM), das der Google Analytics-Sitzung zugeordnet 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 Lookback-Window von DCM), das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventSite: Name der Website, auf der das DCM-Creative für das letzte DCM-Ereignis (Impression oder Klick innerhalb des Lookback-Windows von DCM) ausgeliefert und angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventSiteId: DCM-Website-ID, auf der das DCM-Creative für das letzte DCM-Ereignis (Impression oder Klick im DCM-Lookback-Window) ausgeliefert und angeklickt wurde, das mit der Google Analytics-Sitzung verknüpft ist (nur Premium).
  • Dimension: ga:dcmLastEventSitePlacement: Name des DCM-Website-Placements 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:dcmLastEventSitePlacementId: 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: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 neue Dimensionen und Messwerte für die Gruppierung nach Content hinzugefügt.

Dimensionen und Messwerte

In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

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 Content mit einer logischen Struktur, die durch Tracking-Code, Übereinstimmung mit regulärem Ausdruck von 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 (eindeutigen) 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 sowie neue Dimensionen und Messwerte für erweiterte E-Commerce-Berichte.

Segmente

Für Segmente wird jetzt die 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 in der Referenz 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 der Werbung 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: Hierarchische Kategorie, der das Produkt zugeordnet ist (erweiterter E-Commerce).
  • Dimension – ga:productCategoryLevelXX – Ebene (1–5) in der Produktkategoriehierarchie, beginnend mit der obersten Ebene.
  • Dimension – ga:productCouponCode – Code für den Gutschein auf Produktebene.
  • Dimension: ga:productListName: der Name der Produktliste, in der das Produkt erscheint.
  • Dimension: ga:productListPosition: Die Position des Produkts in der Produktliste.
  • Dimension: ga:productVariant: Die spezifische Variante eines Produkts, z.B. XS, S, M, L für die Größe oder Rot, Blau, Grün oder Schwarz für Farbe.
  • Dimension – ga:checkoutOptions: Nutzeroptionen, die während des Bezahlvorgangs angegeben werden, z.B. FedEx, DHL, UPS als Versandoptionen oder Visa, MasterCard, AmEx als Zahlungsoptionen. Diese Dimension sollte zusammen mit der Shoppingphase verwendet werden.
  • Dimension: ga:shoppingStage: verschiedene Phasen des Kaufprozesses, 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 interne Werbung geklickt haben (Anzahl der Klicks ÷ Häufigkeit der Anzeigenschaltung).
  • Messwert – ga:internalPromotionClicks – Die Anzahl der Klicks auf interne Werbung.
  • Messwert: ga:internalPromotionViews: Die Anzahl der Aufrufe einer internen Werbung.
  • Messwert: ga:localProductRefundAmount: Erstattungsbetrag für ein bestimmtes Produkt in der Landeswährung.
  • Messwert – ga:localRefundAmount – Gesamtbetrag der Erstattung für die Transaktion in der Landeswährung.
  • Messwert: ga:productAddsToCart: gibt an, wie oft das Produkt in den Einkaufswagen gelegt wurde.
  • Messwert: ga:productCheckouts: Anzahl der Fälle, in denen das Produkt Teil des Bezahlvorgangs war.
  • 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: gibt an, wie oft das Produkt in einer Produktliste erschienen ist.
  • Messwert: ga:productListCTR: Die Rate, mit der Nutzer das Produkt in einer Produktliste angeklickt haben.
  • Messwert – ga:productRefunds: gibt an, wie oft eine Erstattung für das Produkt veranlasst wurde.
  • 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 in Verbindung mit Produktgutscheincodes verwendet).
  • Messwert – ga:buyToDetailRate – Einzelne Käufe geteilt durch Aufrufe von Produktdetailseiten.
  • Messwert: ga:cartToDetailRate: Anzahl der Produkteinträge 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 berücksichtigt wurden.
  • 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

In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

System

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

Channelgruppierung

  • Dimension: ga:channelGrouping: Die Standard-Channelgruppierung, die in der Datenansicht (Profil) verwendet wird.
  • Dimension – ga:correlationModelId – Korrelationsmodell-ID für ähnliche Produkte.
  • Dimension – ga:queryProductId – ID des abgefragten Produkts.
  • Dimension: ga:queryProductName: Name des abgefragten Produkts.
  • Dimension: ga:queryProductVariation: Variante des abgefragten Produkts.
  • Dimension – ga:relatedProductId – ID des zugehörigen Produkts.
  • Dimension: ga:relatedProductName: Name des ähnlichen 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 Ersatzdimension oder dem Ersatzmesswert zurück. Jetzt wird dieselbe Dimension oder derselbe Messwertname wie in der Anfrage zurückgegeben.

Diese Version enthält eine Änderung der Namenskonvention für das Attribut uiName.

Änderung der uiName

  • Das Attribut „uiName“ für vorlagenbasierte Spalten verwendet jetzt XX zur Darstellung des numerischen Index anstelle von 1. Beispiel: Goal 1 Value ist jetzt Goal XX Value.

Dies ist die erste Version der Embed API:

  • Die Google Analytics Embed API ist eine JavaScript-Bibliothek, mit der Sie in wenigen Minuten ein Dashboard erstellen und auf einer Drittanbieter-Website einbetten können. Weitere Informationen finden Sie in der Übersicht über die Embed API.
  • Enthält Komponenten: Authentifizierung, Ansichtsauswahl, Daten und Datendiagramm.

In diesem Release wurde das Attribut appUiName eingestellt. Weitere Informationen zum Entfernen von Attributen finden Sie in der Richtlinie zur Einstellung von Daten:

Einstellung von appUiName

  • appUiName wurde eingestellt. In der Metadata API ist sie nicht mehr erforderlich, da die UI-Namen für Web- und App-Datenansichten (Profile) vereinheitlicht wurden. Du solltest jeglichen Code entfernen, in dem das Attribut appUiName verwendet wird, und nur das Attribut uiName verwenden.

In dieser Version wurden Dimensionen und Messwerte umbenannt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Umbenannte Dimensionen und Messwerte

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

Nutzer

  • Dimension: rt:visitorType: Verwenden Sie stattdessen rt:userType.
  • Messwert: rt:activeVisitors: Verwenden Sie stattdessen rt:activeUsers.

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

Neue Dimensionen und Messwerte

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

AdWords

  • Dimension – ga:isTrueViewVideoAdYes oder No: Gibt an, ob die Anzeige eine TrueView-Videoanzeige von AdWords ist.

Uhrzeit

  • 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. Weitere Informationen zur Umbenennung von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

Zielgruppe

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

E-Commerce

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

Ereignis-Tracking

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

Zielvorhaben-Conversions

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

Seiten-Tracking

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

Sitzung

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

Soziale Interaktionen

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

Nutzer

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

Segmente: Core Reporting API v2.4 und v3.0

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

  • Der Parameter segment unterstützt jetzt Nutzer- und Sequenzsegmente. In der Weboberfläche erstellte Segmente auf Nutzerebene und Sitzungsebene können mit dem Parameter segment abgefragt werden.
  • Eine neue Syntax für dynamische Segmente ist verfügbar, die mit dem Parameter segment verwendet werden kann. Weitere Informationen finden Sie im Entwicklerleitfaden für Segmente.
  • Das Präfix dynamic:: wurde verworfen. Es wird empfohlen, so schnell wie möglich zur neuen Syntax zu migrate.

ga:-Präfix eingestellt

Das Präfix ga: wurde für alle Echtzeitdimensionen und ‐messwerte eingestellt und durch das neue Präfix rt: ersetzt. API-Anfragen mit dem Präfix ga: funktionieren noch sechs Monate. Danach wird ein Fehler zurückgegeben.

Neue Dimensionen und Messwerte

Durch dieses Update werden der Real Time Reporting API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste finden Sie in der Referenz für Dimensionen und Messwerte.

Ereignis-Tracking

  • Dimension – rt:eventAction: die Aktion des Ereignisses.
  • Dimension: rt:eventCategory ist die Kategorie des Ereignisses.
  • Dimension: rt:eventLabel ist das Label des Ereignisses.
  • Dimension – rt:totalEvents: Gesamtzahl der Ereignisse für das Profil in allen Kategorien.

Zielvorhaben-Tracking

  • Dimension: rt:goalId: ein String, der der Zielvorhaben-ID entspricht
  • Messwert: rt:goalXXValue: der numerische Gesamtwert für die angeforderte Zielnummer, wobei XX eine Zahl zwischen 1 und 20 ist.
  • Messwert: rt:goalValueAll: Der numerische Gesamtwert für alle für Ihr Profil definierten Ziele.
  • Messwert: rt:goalXXCompletions: Die Gesamtzahl der Abschlüsse für die angeforderte Zielzahl. XX ist dabei eine Zahl zwischen 1 und 20.
  • Messwert: rt:goalCompletionsAll: die Gesamtzahl der Abschlüsse für alle für Ihr Profil definierten Ziele.

Seiten-Tracking

  • Messwert – rt:pageViews – die Gesamtzahl der Seitenaufrufe.

App-Tracking

  • Messwert: rt:screenViews ist die Gesamtzahl der Bildschirmaufrufe.

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

Conversion-Pfade

  • Dimension – mcf:adwordsCustomerIDPath – Reihenfolge der AdWords-Kundennummer entlang der Conversion-Pfade.

Interaktionen

  • Dimension (mcf:adwordsCustomerID) entspricht der AdWords API-Customer.id.

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

Conversion-Pfade

  • Dimension – mcf:adwordsAdGroupIDPath – Reihenfolge der AdWords-Anzeigengruppen-ID entlang von Conversion-Pfaden.
  • Dimension – mcf:adwordsCampaignIDPath – Reihenfolge der AdWords-Kampagnen-ID entlang der Conversion-Pfade.
  • Dimension – mcf:adwordsCreativeIDPath – Reihenfolge der AdWords-Creative-ID entlang der Conversion-Pfade.
  • Dimension – mcf:adwordsCriteriaIDPath – Reihenfolge der AdWords-Kriterien-ID entlang der Conversion-Pfade.

Interaktionen

  • Dimension (mcf:adwordsAdGroupID) entspricht der AdWords API-AdGroup.id.
  • Dimension (mcf:adwordsCampaignID) entspricht der AdWords API-Campaign.id.
  • Dimension (mcf:adwordsCreativeID) entspricht der AdWords API-Ad.id.
  • Dimension (mcf:adwordsCriteriaID) entspricht der AdWords API-Criterion.id.

Diese Version umfasst 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-Diagrammen zu vereinfachen, kann die API optional ein Datentabellenobjekt in der Antwort zurückgeben.

  • Der API wurde der optionale output-Abfrageparameter hinzugefügt. Damit lässt sich das Ausgabeformat der Analytics-Daten in der Antwort auswählen. Standardmäßig ist das JSON-Format. Wenn datatable festgelegt 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:

Uhrzeit

  • Dimension (ga:minute): gibt die Minute in der Stunde zurück. Mögliche 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 größerer Wahrscheinlichkeit bereit sind, Produkte oder Dienstleistungen in der angegebenen Kategorie zu kaufen.
  • Dimension: ga:interestOtherCategory: Gibt an, dass Nutzer mit größerer Wahrscheinlichkeit an Informationen zur angegebenen Kategorie interessiert und kaufbereit sind.

In Segmenten zulässige Dimensionen und Messwerte

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

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

Eingestellte Dimensionen und Messwerte

Diese Dimensionen und Messwerte wurden eingestellt. Weitere Informationen zur Entfernung von Daten finden Sie in den Richtlinien zur Einstellung 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. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

AdSense

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

    • Erfüllt - ga:adsenseRevenue - Der Gesamtumsatz aus AdSense-Anzeigen.
    • Met - ga:adsenseAdUnitsViewed - Die Anzahl der angezeigten AdSense-Anzeigenblöcke. Ein Anzeigenblock ist eine Gruppe von Anzeigen, die als Ergebnis eines AdSense-Anzeigencodes ausgeliefert werden. Details: https://support.google.com/adsense/answer/32715
    • Met - ga:adsenseAdsViewed - Die Anzahl der angesehenen AdSense-Anzeigen. In einem Anzeigenblock können mehrere Anzeigen erscheinen.
    • Met - ga:adsenseAdsClicks - Die Anzahl der Klicks auf AdSense-Anzeigen auf Ihrer Website.
    • 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)
    • Erfüllt – 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.

Uhrzeit

  • Dim – ga:isoYear – 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 einen 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“). Details finden Sie im Bericht zu Suchbegriffen.

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

Relative Datumsangaben
  • In der MCF 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.
  • Wenn Sie diese Werte verwenden, wird der Zeitraum automatisch anhand des aktuellen Datums zum Zeitpunkt der Abfrage und der Zeitzone der in der Abfrage angegebenen Datenansicht (Profil) bestimmt. Weitere Informationen finden Sie in der API-Referenz.
Stichprobenebene
  • Der neue Parameter samplingLevel wurde eingeführt, mit dem Sie die Stichprobenerhebung für eine Berichtsabfrage festlegen können, d.h. die Anzahl der Besuche, die zur Berechnung des Ergebnisses herangezogen werden. Zulässige Werte sind: DEFAULT, FASTER und HIGHER_PRECISION.
  • Der API-Antwort wurden zwei neue Felder hinzugefügt: sampleSize und sampleSpace. Anhand dieser Werte lässt sich der Prozentsatz der Besuche berechnen, die für eine Stichprobenantwort verwendet wurden.
  • Weitere Informationen finden Sie in der API-Referenz und unter Stichproben.

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

Relative Datumsangaben
  • In der Core Reporting API werden jetzt auch relative Datumsangaben unterstützt. today, yesterday und NdaysAgo sind jetzt gültige Werte für die Abfrageparameter start-date und end-date.
  • Wenn Sie diese Werte verwenden, wird der Zeitraum automatisch anhand des aktuellen Datums zum Zeitpunkt der Abfrage und der Zeitzone der in der Abfrage angegebenen Datenansicht (Profil) bestimmt. Weitere Informationen finden Sie in der API-Referenz.
Stichprobenebene
  • Der neue Parameter samplingLevel wurde eingeführt, mit dem Sie die Stichprobenerhebung für eine Berichtsabfrage festlegen können, d.h. die Anzahl der Besuche, die zur Berechnung des Ergebnisses herangezogen werden. Zulässige Werte sind: DEFAULT, FASTER und HIGHER_PRECISION.
  • Der API-Antwort wurden zwei neue Felder hinzugefügt: sampleSize und sampleSpace. Anhand dieser Werte lässt sich der Prozentsatz der Besuche berechnen, die für eine Stichprobenantwort verwendet wurden.
  • Weitere Informationen finden Sie in der API-Referenz und unter Stichproben.

Dies ist die erste Version der Metadata API:

  • Die Metadata API gibt Informationen zu den Dimensionen und Messwerten zurück, die in Google Analytics Reporting APIs verfügbar sind. Die zurückgegebenen Metadaten umfassen Attribute wie UI-Name, Beschreibung, Unterstützung für erweiterte Segmente und mehr. Mithilfe der Metadata API können Ihre Anwendungen automatisch die neuesten Daten zu den Dimensionen und Messwerten abrufen, die für Berichtsabfragen zur Verfügung stehen. Weitere Informationen finden Sie in der Übersicht zur Metadata API.

Dies ist die erste Version der Real Time Reporting API in einer eingeschränkten Betaversion:

  • Mit der Real Time Reporting API können Sie Berichte zu Aktivitäten erstellen, die derzeit auf Ihrer Property stattfinden. Mit der Real Time Reporting API können Sie Dimensionen und Messwerte abfragen, um kundenseitige Web-Widgets und -Dashboards zu erstellen. Weitere Informationen finden Sie in der Übersicht über die Real Time Reporting API.

Fehlerkorrekturen

  • ga:adwordsCustomerID gibt jetzt 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 „Segmente“ 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, in denen Nutzersegment-IDs gespeichert werden, um auf die neuen alphanumerischen IDs umzustellen. Nach Ablauf des Einstellungszeitraums geben alle Abfragen mit den alten numerischen IDs einen Fehler zurück.
  • Derzeit können nur die in der Weboberfläche erstellten Segmente auf Besuchsebene über den Parameter segment abgefragt werden.
  • Die vorhandenen Standardsegmente mit negativen numerischen IDs sind davon nicht betroffen. Allerdings werden die neuen Standardsegmente derzeit nicht unterstützt.

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

App-Tracking

  • Diese Daten sind in App-Profilberichten enthalten:
    • Dim – ga:appId – Die ID der Anwendung.
    • Dim – ga:appInstallerId – ID des Installationsprogramms (z.B. Google Play Store), von dem die App heruntergeladen wurde. Standardmäßig wird die ID des App-Installationsprogramms auf Grundlage der Methode PackageManager#getInstallerPackageName festgelegt.
    • 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 App beendet hat.
    • Gedimmt: ga:landingScreenName: Name des ersten aufgerufenen Bildschirms.
    • Gedimmt: ga:screenDepth: Die Anzahl der Bildschirmaufrufe pro Sitzung, die als String angegeben wird. Dieser Wert kann für Histogramme hilfreich sein.
    • Gedimmt: ga:screenName: Name des Bildschirms.
    • Erfüllt – ga:avgScreenviewDuration: Die durchschnittliche Zeit in Sekunden, die Nutzer auf einem Bildschirm verbringen.
    • Met – ga:timeOnScreen – Zeit für die Anzeige des aktuellen Bildschirms.
    • Erfüllt – ga:screenviews – Gesamtzahl der Bildschirmaufrufe. Verwende diese URL anstelle von ga:appviews.
    • Met – ga:uniqueScreenviews – Die Anzahl der unterschiedlichen (eindeutigen) ga:screenviews innerhalb einer Sitzung. Verwende diese URL anstelle von ga:uniqueAppviews.
    • Erfüllt – ga:screenviewsPerSession: Die durchschnittliche Anzahl von ga:screenviews pro Sitzung. Verwende diese URL anstelle von ga:appviewsPerVisit.

Eingestellte Funktionen

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

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

Benutzerdefinierte Variablen oder Spalten

  • Zugriff auf benutzerdefinierte Dimensionen und Messwerte:

    • Dim – ga:dimensionXX: Name der angeforderten benutzerdefinierten Dimension, wobei „XX“ auf die Anzahl oder den Index der benutzerdefinierten Dimension verweist.
    • Met – ga:metricXX: Der Name des angeforderten benutzerdefinierten Messwerts, wobei XX auf die Anzahl/den Index des benutzerdefinierten Messwerts verweist.

Änderungen in der Dokumentation

Die folgende Dimension und der folgende Messwert für benutzerdefinierte Variablen wurden umbenannt. Diese Änderung bezieht sich lediglich auf die 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.
  • Erfüllt – ga:localItemRevenue – Produktumsatz in Landeswährung
  • Erfüllt – ga:localTransactionRevenue – Transaktionsumsatz in Landeswährung
  • Erfüllt – ga:localTransactionShipping – Versandkosten der Transaktion in Landeswä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: 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, die bzw. der mit den Zielabschlüssen des Zieltyps übereinstimmt.
  • Gedimmt: ga:goalPreviousStep1: Seitenpfad oder Bildschirmname, der mit einem Ziel vom Typ „Ziel“ übereinstimmte, einen Schritt vor der Position des Abschlusses für das Zielvorhaben.
  • Gedimmt: ga:goalPreviousStep2: Seitenpfad oder Bildschirmname, die mit einem Ziel vom Typ „Ziel“ übereinstimmen, zwei Schritte vor der Position des Abschlusses für das Zielvorhaben.
  • Gedimmt: ga:goalPreviousStep3: Seitenpfad oder Bildschirmname, der bzw. der mit einem Ziel vom Typ „Ziel“ übereinstimmt, drei Schritte vor der Position des Abschlusses für das Zielvorhaben.

Änderungen in der Dokumentation

Die folgende Dimension und die folgenden Messwerte für Zielvorhaben-Conversions wurden umbenannt. Diese Änderung bezieht sich lediglich auf die 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: Gibt in Prozent an, wie oft eine Suchfilter (d.h. ein Wechsel) zwischen Keywords für interne Suchanzeigen innerhalb einer Sitzung erfolgt.

Seiten-Tracking

  • Met – ga:pageValue: Der durchschnittliche Wert dieser Seite oder dieser Seiten. Der Seitenwert ergibt sich aus ((Transaktionsumsatz + gesamter Zielwert) geteilt durch eindeutige 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 Besucher an, die das Tablet besucht haben. Mögliche Werte sind Yes und No.
    • Dim – ga:mobileDeviceMarketingName – Handelsbezeichnung für Mobilgerät verwendet.

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.

Uhrzeit

  • Gedimmt – ga:dateHour – kombinierte Werte von ga:date und ga:hour.
  • Dim – ga:dayOfWeekName: Name des Wochentags (auf Englisch).
  • Gedimmt: ga:isoWeek: ISO-Wochennummer, bei der 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 Hostnamen 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 zur Websitegeschwindigkeit:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • In diesem Release wird das neue Standardsegment gaid::-13 für Zugriffe über Tablets hinzugefügt.

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

App-Tracking

  • Diese Daten sind in Mobile App Tracking SDK-Berichten enthalten:
    • Erfüllt – ga:uniqueAppviews – Anzahl der App-Aufrufe pro Sitzung.
    • Erreicht – 'ga:appviews – Gesamtzahl der App-Aufrufe.
    • Erreicht – 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 sich auf das verweisende soziale Netzwerk für Besucherquellen oder auf das soziale Netzwerk für Aktivitäten im Hub für soziale Interaktionsdaten beziehen. Beispiele: Google+, Blogger, reddit usw.
  • Gedimmt - ga:hasSocialSourceReferral: Gibt Besuche an, die über eine Quelle der sozialen Interaktion auf die Website gelangt sind. Das kann ein soziales Netzwerk wie Google+, Facebook oder Twitter sein. Mögliche Werte sind „Yes“ und „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 Daten 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 Aktivität dar, die vom Nutzer des sozialen Netzwerks gepostet wurde (z. B. der Nachrichteninhalt eines Google+ Beitrags).
    • Dim: ga:socialActivityTimestamp: Bei einer Aktivität im Hub für soziale Interaktionsdaten stellt dieser String den Zeitpunkt dar, an dem die soziale Aktivität im sozialen Netzwerk stattgefunden hat.
    • Dim – ga:socialActivityUserPhotoUrl: Bei einer Aktivität im Hub für soziale Netzwerke 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 sind.
    • 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 den Typ der mit der Aktivität verknüpften sozialen Interaktion dar, z. B. Votum, Kommentar oder +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.
    • Erfüllt – ga:socialActivities – Die 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: ein String für soziale Interaktionen, 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 zugeordnet wird
    • Erfüllt – ga:socialInteractions – Gesamtzahl der sozialen Interaktionen auf Ihrer Website.
    • Erfüllt – ga:uniqueSocialInteractions – Gesamtzahl der einzelnen sozialen Interaktionen auf Ihrer Website. Basierend auf dem Wertpaar ga:socialInteractionNetwork und ga:socialInteractionAction
    • Erreicht – ga:socialInteractionsPerVisitga:socialInteractions / ga:uniqueSocialInteractions. Die durchschnittliche Anzahl der sozialen Interaktionen pro Besuch auf Ihrer Website.

Geografie / Netzwerk

  • Dim: ga:metro: Die DMA-Region (Designated Market Area), von der die Zugriffe stammen

Seiten-Tracking

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

Ausnahmenverfolgung

  • Diese Daten stammen aus Ausnahme-Tracking-Daten.

    • 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 vereinfachen.
    • Dim – ga:userTimingLabel: Ein String, der den Namen der Aktion der erfassten Ressource angibt.
    • Dim – ga:userTimingVariable: Ein String, mit dem sich Nutzertimings in Berichten flexibler visualisieren lassen.
    • Gedimmt: ga:userTimingValue Anzahl der Millisekunden für verstrichene Zeit, die an Google Analytics gesendet werden.
    • Met – ga:userTimingSample – Die Anzahl der gesendeten Stichproben.
    • Met – ga:avgUserTimingValue – Der durchschnittliche Wert für das Nutzertiming. ga:userTimiingValue / ga:userTimiingSample.

Gerät / Plattform

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

Dies ist die erste Version der Multi-Channel-Trichter Reporting API:

  • Mit dieser neuen API können Sie Multi-Channel-Trichterdaten für einen authentifizierten Nutzer anfordern. Die Daten werden aus Conversion-Pfaddaten abgeleitet, die Nutzerinteraktionen mit verschiedenen Besucherquellen über mehrere Besuche vor der Conversion hinweg darstellen. So lässt sich analysieren, wie sich verschiedene Marketingkanäle im Laufe der Zeit auf Conversions auswirken. Weitere Informationen zu den verfügbaren Daten und zur Verwendung der API finden Sie unter Multi-Channel Trichter Reporting API.

Fehlerkorrekturen

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

In 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 für die Websitegeschwindigkeit wurden hinzugefügt:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

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

Erinnerung an die Einstellung der API-Version 2.3

  • 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 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 den alten XML-Datenfeed 2.3 an Version 2.4 weitergeleitet und eine XML-Antwort der Version 2.4 zurückgegeben. Ab diesem Zeitpunkt gelten alle Kontingentrichtlinien von Version 2.4 für die Anfragen von 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.

  • Damit Sie das volle Kontingent nutzen können, ist es sowohl in Version 3.0 als auch in Version 2.4 erforderlich, dass Sie Ihre Anwendung in der Google APIs Console registrieren und in 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. Darin 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 Core Reporting API geändert. Außerdem wird die bisherige API-Version 2.3 für den Datenexport eingestellt.

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

    • Mit der neuen JSON-basierten Ausgabe verringert sich die Größe der Antwort im Vergleich zur vorherigen XML-Ausgabe um das 10-Fache.
    • 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….
    • Registrierungs- und Entwicklertokens 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 größtenteils abwärtskompatibel mit der bestehenden Version 2.3 der Datenexport API ist.

  • Updates

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

Anmeldung

  • Alle Anwendungen, die mit der Google Analytics API erstellt wurden, müssen über die Google APIs-Konsole als Projekt registriert werden.

  • Jede API-Anfrage 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 für beide Anlaytics 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 wird auch die Einstellung von Version 2.3 sowie die bevorstehende Einstellung des Konto-Feeds in der Datenexport-API angekündigt. In sechs Monaten:

    • Anfragen an den XML-Datenfeed der Version 2.3 werden an Version 2.4 weitergeleitet und eine Antwort der Version 2.4 zurückgeben. Ab diesem Zeitpunkt gelten alle Kontingentrichtlinien von Version 2.4 für die Anfragen von 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 Data Export API werden 404 Not Found-Statuscodes zurückgegeben. Alle Anfragen für Konfigurationsdaten sollten über die Management API erfolgen.

In 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 eine Reihe gültiger Kombinationseinschränkungen mit AdWords-Daten aufgehoben.

Vor einigen Wochen haben wir eine Änderung vorgenommen, um API-Abfragen, die ga:adGroup oder ga:adContent mit ga:impressions angefordert haben, nicht mehr zuzulassen, da diese Kombination 0 zurückgegeben hat. Durch diese Änderung ist diese Kombination nun wieder verfügbar und wurde korrigiert, 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 nicht mehr zulässig sind, die keine Daten zurückgeben. 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 jetzt für alle Abfragen, die diese Kombinationen anfordern, den Fehlercode 400 zurück.

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

Einstellung des Konfidenzintervalls

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

    Um herauszufinden, ob eine Antwort erfasst wurde, verwenden Sie das Feld „containsSampledData“ in der Antwort.

In dieser Version werden drei neue Messwerte hinzugefügt und der Rückgabewert von zwei 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 jetzt als 1 angegeben).

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

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

Leistungssteigerung

  • Diese Version verbessert die Datenfeed-Latenz um 30 bis 35%.

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 über den Tracking-Code übergeben wird (z.B. wird 1 Einheit jetzt als 1 angegeben).

  • Derzeit ist ga:CTR eine percent und gibt den Wert 0, 02 zurück. In naher Zukunft wird dieser Wert in den tatsächlichen Prozentsatz geändert (z.B. 2).

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

Neue Datenaktualisierungen

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

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

  • Die folgenden Messwerte für das Ereignis-Tracking 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 Ausnahmefehler zu beheben.

In dieser Version werden wesentlich mehr Daten zum Datenfeed hinzugefügt:

Neue Datenaktualisierungen

  • Die Berechnung von ga:visitors wurde geändert, um die Anzahl der einzelnen Besucher für den Zeitraum zurückzugeben. Ab sofort werden mehr Kombinationen aus Dimensionen und Messwerten unterstützt.

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

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

  • Der Messwert „ga:searchResultViews“ wurde der internen Site Search-Gruppe 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 auf Stichproben basieren. 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 für den Zugriff auf dieses Element aktualisiert.

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. Mit dem ODER-Operator werden jetzt konsistente Werte zurückgegeben.

  • Einige der API-Fehlermeldungen für ungültige Filter wurden aktualisiert und enthalten nun KEINE Informationen darüber, ob der Fehler durch einen Dimensions- oder Messwertfilter verursacht wurde. Der eigentliche 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

  • Der Fehler, der verhinderte, dass der Konto-Feed zurückgegeben wurde, wenn ein Zielname, ein Zielpfad, ein Zielvergleichswert oder ein Zielvergleichstyp falsch festgelegt wurde, wurde behoben.

  • Der Filterparameter der Datenfeed-Abfrage darf keine Dimension und einen Messwert mit ODER enthalten. Beispiel: ga:source==google,ga:visits>5. Die Fehlermeldung für diese ungültige Abfrage wurde geändert und lautet nun: 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 AdGroup.id der AdWords API
    • ga:adwordsCampaignId: entspricht der Campaign.id der AdWords API
    • ga:adwordsCreativeId: entspricht der Ad.id der AdWords API
    • ga:adwordsCriteriaId: entspricht der Criterion.id der AdWords API
    • ga:adwordsCustomerId: entspricht der AccountInfo.customerId der AdWords API

Fehlerkorrekturen

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

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

Neue Funktionen

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

  • Die von der API verwendete Abtastrate entspricht nun der von der Weboberfläche. Dadurch werden die Daten für Stichprobenberichte direkt in die Weboberfläche aufgenommen und die Konsistenz wird erhöht.

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

    • Eine einzelne Web-Property kann maximal 10.000 Anfragen pro 24 Stunden senden.
    • Eine Anwendung kann in einem 1-sekündigen Zeitraum nur 10 Anfragen senden.
    • Eine Anwendung kann jeweils nur 4 ausstehende Anfragen haben.
  • 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. Weitere Informationen zu diesen neuen Kombinationen finden Sie im aktualisierten Referenzleitfaden.

Fehlerkorrekturen

  • Ein Programmfehler bei der Meldung des confidenceInterval-Werts für Messwerte durch die API wurde behoben. Bisher konnten Konfidenzintervalle einen Wert von 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. Die Fehler sind nun korrigiert, sodass die richtigen Daten zurückgegeben werden.

Erinnerung an die Einstellung von Dimensionen und Messwerten

  • Verwenden Sie die zuvor eingestellten Dimensionen und Messwerte nicht mehr, falls Sie dies noch nicht getan haben

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 bieten Java und JavaScript. Bibliotheken von Drittanbietern wurden möglicherweise noch nicht aktualisiert.

    • Sie können Version 2 anfordern, indem Sie jeder Konto- oder Datenfeed-Anfrage den Header 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.

Erweiterte Unterstützung für die Segmentierung

  • Suchparameter für dynamische Segmente:

    • ...&segment=dynamic::Ausdruck
    • ermöglicht die spontane Erstellung erweiterter Segmente.
    • Ausdruck kann eine beliebige Dimension oder Kennzahl sein und muss derselben Syntax wie Filter folgen.
  • Abfrageparameter für Standard- und benutzerdefinierte Segmente:

    • ...&segment=gaid::Zahl
    • Dabei ist number eine ID, die auf ein erweitertes Segment verweist, das auf der Weboberfläche von Google Analytics definiert ist.
    • 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 in der API-Anfrage ein Segment 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 Messwerte für Zielvorhaben hinzugefügt, die alle der Konvention goal(n)Completions entsprechen, wobei (n) eine Zahl zwischen 1 und 20 ist.

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

Neue Daten zu benutzerdefinierten Variablen

  • Alle benutzerdefinierten Variablen, die jemals von einem Profil erfasst wurden, wurden als neues XML-Element zum Kontofeed 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.

  • Verwenden Sie die zuvor eingestellten Dimensionen und Messwerte bitte nicht mehr, falls Sie dies noch nicht getan haben. Sie werden bald entfernt und es werden auf Anfrage Fehler von unserer API zurückgegeben.

    • 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. Wir werden sie in einem Monat endgültig aus der API entfernen. 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 Gesamtdaten zur Websitenavigation werden jetzt anhand der folgenden Dimensionen dargestellt:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

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

    D3. Content * ga:landingPagePath * ga:secondPagePath

  • Die maximale Länge regulärer Ausdrücke im Suchparameter für den Datenfeed 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 die 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 zusammen abfragen. ga:pagePath und ga:source sind jetzt eine gültige Kombination. Weitere 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 weiterhin 1.000, kann aber jetzt 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 dieser Version werden eingestellte Funktionen aus unserer nicht öffentlichen Betaversion entfernt:

  • Die darin enthaltenen Nutzernamen werden in den Anfragen für den Kontofeed nicht mehr unterstützt. Stattdessen werden nur Anfragen im folgenden Format akzeptiert:
    https://www.google.com/analytics/feeds/accounts/default

  • Die folgenden Messwerte werden entfernt und funktionieren nicht mehr. Eine Anleitung zur Berechnung dieser Werte finden Sie unter 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:verlasseneTrichter1
    • ga:VerlasseneTrichter2
    • ga:VerlasseneTrichter3
    • ga:Verlassene Trichter4
    • ga:goalConversionRate
    • ga:ZielConversionRate1
    • ga:goalConversionRate2
    • ga:ZielConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Die folgenden Dimensionen und Messwerte wurden umbenannt. Die alten Namen funktionieren dann nicht mehr. Bitte überprüfen Sie, ob Sie die offiziellen Namen in unserer Dokumentation hier verwenden: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html.

    Dimensionen * ga:subContinentRegion Δ ga:subContinent * ga:organization INDEX g:networkLocation * ga:domain trägt sendung