Änderungsprotokoll

Wenn Sie offizielle Ankündigungen zur Google Analytics API erhalten möchten, abonnieren Sie die Google Analytics API Notify Group.

14.09.2026: Unterstützung für konversationelle Abfragen in v1 Alpha hinzugefügt

Die Methode properties.chat wurde hinzugefügt, um mit Google Analytics-Daten über Abfragen in natürlicher Sprache zu interagieren.

14.09.2026: Gründe für das Abschneiden von Daten zu Berichtsantworten hinzugefügt

Das Feld dataTruncationReasons wurde in v1 Beta und v1 Alpha zu ResponseMetaData hinzugefügt. Wenn die Daten eines Berichts gekürzt werden, enthält dieses Feld eine Liste von DataTruncationReason-Objekten, die den Kürzungstyp, eine beschreibende Nachricht und die betroffenen Daten enthalten.

23.04.2026: Unterstützung für Conversion-Berichte in v1 Alpha hinzugefügt

Unterstützung für das Abrufen von Daten aus dem Bericht zur Conversion-Leistung mit der Methode runReport in der Data API v1 Alpha hinzugefügt. So können Sie auf dieselben Conversion-Daten zugreifen, die in der Google Analytics-Benutzeroberfläche unter Werbung > Conversion-Leistung verfügbar sind.

  • Das Feld ConversionSpec wurde zu RunReportRequest hinzugefügt. Damit können Conversions mithilfe von conversionActions (Conversion-Aktions-IDs) gefiltert und ein AttributionModel (DATA_DRIVEN oder LAST_CLICK) ausgewählt werden.
  • Das Feld Section wurde zu ResponseMetaData hinzugefügt, um anzugeben, ob die Daten im Bericht aus Standardberichten (SECTION_REPORT) oder Conversion-Berichten (SECTION_ADVERTISING) stammen.

Die Methode getMetadata in der Data API v1 Alpha wurde aktualisiert, um Informationen für Conversion-Berichte bereitzustellen:

  • Das Feld conversions wurde der Antwort hinzugefügt. Es gibt eine Liste von ConversionMetadata-Objekten zurück, die Conversion-Aktions-IDs Anzeigenamen zuordnen.
  • Das Feld sections wurde zu DimensionMetadata und MetricMetadata hinzugefügt, um anzugeben, ob ein bestimmtes Feld mit Standardberichten, Conversion-Berichten oder beidem kompatibel ist.

20.10.2024: Der Dimensionsfiltertyp EmptyFilter wurde hinzugefügt.

Mit dem Dimensionsfilter EmptyFilter können Sie Filterbedingungen erstellen, um einen Vergleich mit einem leeren Wert durchzuführen.

15.10.2024: Die Methode reportTasks wurde um die Funktion „Stichprobenebene“ erweitert.

Mit dem Feld samplingLevel der Methode properties.runReportTask können Sie die Stichprobenebene des Berichts steuern.

Mit dieser Funktion erhalten Google Analytics 360-Properties Zugriff auf höhere Datenbegrenzungen bei der Stichprobenerhebung von 1 Milliarde Ereignissen. Außerdem können Stichprobenlimits auf UNSAMPLED festgelegt werden, um nicht stichprobenbasierte Ergebnisse für eine große Anzahl von Ereignissen zu erhalten.

18.09.2024: Funktion „Snapshot der Property-Kontingente“ hinzugefügt

Mit der Methode properties.getPropertyQuotasSnapshot können Sie einen aktuellen Snapshot aller Property-Kontingente für eine bestimmte Property abrufen, die nach Kontingentkategorie organisiert sind.

28.06.2024: Kontingent „Clientfehler pro Projekt und Property“ hinzugefügt

Pro Projekt und Property sind innerhalb eines Zeitfensters von 15 Minuten maximal 10.000 API-Serverfehler zulässig. Dazu gehören alle Anfragen, die zu einer Antwort mit einem anderen Code als 500 oder 200 führen. Beispiele für Fehler, die unter dieses Kontingent fallen: Verwendung inkompatibler Kombinationen von Dimensionen und Messwerten, alle Authentifizierungsfehler.

Wenn dieses Limit überschritten wird, werden weitere API-Aufrufe für diese Property für das zugehörige Google Cloud-Projekt vorübergehend blockiert, bis das 15-Minuten-Fenster endet.

14.05.2024: Funktion „Vergleiche“ hinzugefügt

Mithilfe von Vergleichen können Sie Teilmengen Ihrer Daten gegenüberstellen und vergleichen.

Die wichtigsten Berichterstellungsmethoden der Data API v1beta wurden aktualisiert, um das Feld comparisons zu unterstützen. Wenn es enthalten ist, wird damit die Konfiguration der angeforderten Vergleiche angegeben.

In einer Anfrage können Sie entweder einen einfachen Vergleich angeben, indem Sie den Ausdruck dimensionFilter mit einer Anfrage angeben, oder einen gespeicherten Vergleich verwenden, indem Sie den Ressourcennamen des Vergleichs im Feld comparison angeben.

Die Methode getMetadata wurde aktualisiert, um alle gespeicherten Vergleiche, die für eine Property verfügbar sind, im Antwortfeld comparisons aufzulisten.

Wenn in einer Anfrage mindestens ein Vergleich angegeben ist, enthält die Antwort die Spalte comparison, in der die einzelnen Vergleiche aufgeführt sind.

Derzeit können gespeicherte Vergleiche nur über die Google Analytics-Benutzeroberfläche erstellt werden.

08.05.2024: Berichtsaufgaben, eine Funktion für asynchrone Berichte, wurden der Data API v1alpha hinzugefügt.

Mit Berichtsaufgaben können Sie eine asynchrone Anfrage mit langer Laufzeit initiieren, um einen benutzerdefinierten Bericht Ihrer Google Analytics-Ereignisdaten zu erstellen.

Die folgenden Methoden zur Bearbeitung von Berichtsaufgaben wurden der Data API v1alpha hinzugefügt:

06.05.2024: Neue Dimensionen für Schlüsselereignisse

Dimensionen und Messwerte für Schlüsselereignisse sind jetzt verfügbar.

Ändern Sie Ihre Berichtsanfragen, die die Dimension isConversionEvent verwenden, sodass stattdessen die Dimension isKeyEvent verwendet wird.

Ändern Sie alle Berichtsanfragen, die einen eingestellten Messwert aus der folgenden Tabelle verwenden, sodass stattdessen der Messwert für Schlüsselereignisse verwendet wird.

Eingestellter Messwert Messwert für Schlüsselereignisse
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Nehmen Sie ähnliche Änderungen an allen Verwendungen von Messwerten für Schlüsselereignisse für ein einzelnes Schlüsselereignis in Ihren Berichtsanfragen vor.

Die Antwort für die Methode properties/getMetadata spiegelt die Einführung von Dimensionen und Messwerten für Schlüsselereignisse in DimensionMetadata- und MetricMetadata-Objekten so wider:

  • apiName, uiName und description enthalten den API-Namen, den UI-Namen und die Beschreibung des Schlüsselereignisses.
  • Das wiederkehrende Feld deprecatedApiNames enthält einen Eintrag mit dem verworfenen Conversion-API-Namen.

25.03.2024: Primäre Channelgruppe, manuelle Besucherquelle und integrationsspezifische Dimensionen hinzugefügt.

Dem API-Schema der Data API wurden die Dimensionen „Primäre Channelgruppe“, „Manuelle Traffic-Quelle“ und die integrationsspezifischen Dimensionen für CM360, DV360 und SA360 hinzugefügt.

Zielgruppendimensionen:

  • audienceId Zielgruppen-ID. Die numerische Kennung einer Zielgruppe.

Dimensionen für die primäre Channelgruppe:

  • firstUserPrimaryChannelGroup Erste Nutzerinteraktion – primäre Channelgruppe

  • primaryChannelGroup Primäre Channelgruppe

  • sessionPrimaryChannelGroup Sitzung – primäre Channelgruppe

Dimensionen „Traffic-Quelle“ (manuell):

  • manualCampaignId Manuelle Kampagnen-ID

  • manualCampaignName Name der manuellen Kampagne

  • manualCreativeFormat – Creative-Format (manuell)

  • manualMarketingTactic – Manuelle Marketingtaktik

  • manualMedium Medium (manuell)

  • manualSource Quelle (manuell)

  • manualSourceMedium – Quelle/Medium (manuell)

  • manualSourcePlatform – Manuelle Quellplattform

  • firstUserManualCampaignId Erste Nutzerinteraktion – Kampagnen-ID (manuell)

  • firstUserManualCampaignName Erste Nutzerinteraktion – Kampagnenname (manuell)

  • firstUserManualCreativeFormat Erste Nutzerinteraktion – Creative-Format (manuell)

  • firstUserManualMarketingTactic Erste Nutzerinteraktion – manuelle Marketingtaktik

  • firstUserManualMedium Erste Nutzerinteraktion – Medium (manuell)

  • firstUserManualSource Erste Nutzerinteraktion – Quelle (manuell)

  • firstUserManualSourceMedium Erste Nutzerinteraktion – manuelle Quelle / Medium

  • firstUserManualSourcePlatform Erste Nutzerinteraktion – manuelle Quellplattform

  • sessionManualCampaignId Sitzung – Kampagnen-ID (manuell)

  • sessionManualCampaignName – Sitzung – Kampagnenname (manuell)

  • sessionManualCreativeFormat Sitzung – Creative-Format (manuell)

  • sessionManualMarketingTactic – Sitzung – manuelle Marketingtaktik

  • sessionManualMedium Sitzung – Medium (manuell)

  • sessionManualSource Sitzung – Quelle (manuell)

  • sessionManualSourceMedium Sitzung – Quelle/Medium (manuell)

  • sessionManualSourcePlatform Sitzung – Quellplattform (manuell)

Dimensionen für die Campaign Manager 360-Integration (CM360):

  • cm360AccountId CM360-Konto-ID

  • cm360AccountName – CM360-Kontoname

  • cm360AdvertiserId CM360-Werbetreibenden-ID

  • cm360AdvertiserName CM360-Werbetreibendenname

  • cm360CampaignId CM360-Kampagnen-ID

  • cm360CampaignName CM360-Kampagnenname

  • cm360CreativeFormat CM360-Creative-Format

  • cm360CreativeId CM360-Creative-ID

  • cm360CreativeName CM360-Creative-Name

  • cm360CreativeType CM360-Creative-Typ

  • cm360CreativeTypeId – CM360-Creative-Typ-ID

  • cm360CreativeVersion CM360-Creative-Version

  • cm360Medium CM360-Medium

  • cm360PlacementCostStructure – CM360-Placement-Kostenstruktur

  • cm360PlacementId CM360-Placement-ID

  • cm360PlacementName CM360-Placement-Name

  • cm360RenderingId – CM360-Rendering-ID

  • cm360SiteId CM360-Website-ID

  • cm360SiteName CM360-Websitename

  • cm360Source CM360-Quelle

  • cm360SourceMedium – CM360-Quelle/‑Medium

  • firstUserCm360AccountId Erste Nutzerinteraktion – CM360-Konto-ID

  • firstUserCm360AccountName Erste Nutzerinteraktion – CM360-Kontoname

  • firstUserCm360AdvertiserId Erste Nutzerinteraktion – CM360-Werbetreibenden-ID

  • firstUserCm360AdvertiserName Erste Nutzerinteraktion – CM360-Werbetreibendenname

  • firstUserCm360CampaignId Erste Nutzerinteraktion – CM360-Kampagnen-ID

  • firstUserCm360CampaignName Erste Nutzerinteraktion – CM360-Kampagnenname

  • firstUserCm360CreativeFormat Erste Nutzerinteraktion – CM360-Creative-Format

  • firstUserCm360CreativeId Erste Nutzerinteraktion – CM360-Creative-ID

  • firstUserCm360CreativeName Erste Nutzerinteraktion – CM360-Creative-Name

  • firstUserCm360CreativeType Erste Nutzerinteraktion – CM360-Creative-Typ

  • firstUserCm360CreativeTypeId Erste Nutzerinteraktion – CM360-Creative-Typ-ID

  • firstUserCm360CreativeVersion Erste Nutzerinteraktion – CM360-Creative-Version

  • firstUserCm360Medium Erste Nutzerinteraktion – CM360-Medium

  • firstUserCm360PlacementCostStructure Erste Nutzerinteraktion – CM360-Placement-Kostenstruktur

  • firstUserCm360PlacementId Erste Nutzerinteraktion – CM360-Placement-ID

  • firstUserCm360PlacementName Erste Nutzerinteraktion – CM360-Placement-Name

  • firstUserCm360RenderingId Erste Nutzerinteraktion – CM360-Rendering-ID

  • firstUserCm360SiteId Erste Nutzerinteraktion – CM360-Website-ID

  • firstUserCm360SiteName Erste Nutzerinteraktion – CM360-Websitename

  • firstUserCm360Source Erste Nutzerinteraktion – CM360-Quelle

  • firstUserCm360SourceMedium Erste Nutzerinteraktion – CM360-Quelle/‑Medium

  • sessionCm360AccountId Sitzung – CM360-Konto-ID

  • sessionCm360AccountName Sitzung – CM360-Kontoname

  • sessionCm360AdvertiserId Sitzung – CM360-Werbetreibenden-ID

  • sessionCm360AdvertiserName Sitzung – CM360-Werbetreibendenname

  • sessionCm360CampaignId Sitzung – CM360-Kampagnen-ID

  • sessionCm360CampaignName Sitzung – CM360-Kampagnenname

  • sessionCm360CreativeFormat Sitzung – CM360-Creative-Format

  • sessionCm360CreativeId Sitzung – CM360-Creative-ID

  • sessionCm360CreativeName Sitzung – CM360-Creative-Name

  • sessionCm360CreativeType Sitzung – CM360-Creative-Typ

  • sessionCm360CreativeTypeId Sitzung – CM360-Creative-Typ-ID

  • sessionCm360CreativeVersion Sitzung – CM360-Creative-Version

  • sessionCm360Medium Sitzung – CM360-Medium

  • sessionCm360PlacementCostStructure Sitzung – CM360-Placement-Kostenstruktur

  • sessionCm360PlacementId Sitzung – CM360-Placement-ID

  • sessionCm360PlacementName Sitzung – CM360-Placement-Name

  • sessionCm360RenderingId Sitzung – CM360-Rendering-ID

  • sessionCm360SiteId Sitzung – CM360-Website-ID

  • sessionCm360SiteName Sitzung – CM360-Websitename

  • sessionCm360Source Sitzung – CM360-Quelle

  • sessionCm360SourceMedium Sitzung – CM360-Quelle/‑Medium

Dimensionen für die Integration von Google Display & Video 360 (DV360):

  • dv360AdvertiserId DV360-Werbetreibenden-ID

  • dv360AdvertiserName Name des DV360-Werbetreibenden

  • dv360CampaignId DV360-Kampagnen-ID

  • dv360CampaignName DV360-Kampagnenname

  • dv360CreativeFormat – DV360-Creative-Format

  • dv360CreativeId DV360-Creative-ID

  • dv360CreativeName – DV360-Creative-Name

  • dv360ExchangeId DV360-Anzeigenplattform-ID

  • dv360ExchangeName – DV360-Anzeigenplattformname

  • dv360InsertionOrderId DV360-Anzeigenauftrags-ID

  • dv360InsertionOrderName – DV360-Anzeigenauftragsname

  • dv360LineItemId DV360-Werbebuchungs-ID

  • dv360LineItemName DV360-Werbebuchungsname

  • dv360Medium DV360-Medium

  • dv360PartnerId DV360-Partner-ID

  • dv360PartnerName – Name des DV360-Partners

  • dv360Source DV360-Quelle

  • dv360SourceMedium DV360-Quelle/-Medium

  • firstUserDv360AdvertiserId Erste Nutzerinteraktion – DV360-Werbetreibenden-ID

  • firstUserDv360AdvertiserName Erste Nutzerinteraktion – DV360-Werbetreibendenname

  • firstUserDv360CampaignId Erste Nutzerinteraktion – DV360-Kampagnen-ID

  • firstUserDv360CampaignName Erste Nutzerinteraktion – DV360-Kampagnenname

  • firstUserDv360CreativeFormat Erste Nutzerinteraktion – DV360-Creative-Format

  • firstUserDv360CreativeId Erste Nutzerinteraktion – DV360-Creative-ID

  • firstUserDv360CreativeName Erste Nutzerinteraktion – DV360-Creative-Name

  • firstUserDv360ExchangeId Erste Nutzerinteraktion – DV360-Anzeigenplattform-ID

  • firstUserDv360ExchangeName Erste Nutzerinteraktion – DV360-Anzeigenplattformname

  • firstUserDv360InsertionOrderId Erste Nutzerinteraktion – DV360-Anzeigenauftrags-ID

  • firstUserDv360InsertionOrderName Erste Nutzerinteraktion – DV360-Anzeigenauftragsname

  • firstUserDv360LineItemId Erste Nutzerinteraktion – DV360-Werbebuchungs-ID

  • firstUserDv360LinteItemName Erste Nutzerinteraktion – DV360-Werbebuchungsname

  • firstUserDv360Medium Erste Nutzerinteraktion – DV360-Medium

  • firstUserDv360PartnerId Erste Nutzerinteraktion – ID des DV360-Partners

  • firstUserDv360PartnerName Erste Nutzerinteraktion – Name des DV360-Partners

  • firstUserDv360Source Erste Nutzerinteraktion – DV360-Quelle

  • firstUserDv360SourceMedium Erste Nutzerinteraktion – DV360-Quelle/-Medium

  • sessionDv360AdvertiserId Sitzung – DV360-Werbetreibenden-ID

  • sessionDv360AdvertiserName Sitzung – DV360-Werbetreibendenname

  • sessionDv360CampaignId Sitzung – DV360-Kampagnen-ID

  • sessionDv360CampaignName Sitzung – DV360-Kampagnenname

  • sessionDv360CreativeFormat Sitzung – DV360-Creative-Format

  • sessionDv360CreativeId Sitzung – DV360-Creative-ID

  • sessionDv360CreativeName Sitzung – DV360-Creative-Name

  • sessionDv360ExchangeId Sitzung – DV360-Anzeigenplattform-ID

  • sessionDv360ExchangeName Sitzung – DV360-Anzeigenplattformname

  • sessionDv360InsertionOrderId Sitzung – DV360-Anzeigenauftrags-ID

  • sessionDv360InsertionOrderName Sitzung – DV360-Anzeigenauftragsname

  • sessionDv360LineItemId Sitzung – DV360-Werbebuchungs-ID

  • sessionDv360LineItemName Sitzung – DV360-Werbebuchungsname

  • sessionDv360Medium Sitzung – DV360-Medium

  • sessionDv360PartnerId Sitzung – ID des DV360-Partners

  • sessionDv360PartnerName Sitzung – Name des DV360-Partners

  • sessionDv360Source Sitzung – DV360-Quelle

  • sessionDv360SourceMedium Sitzung – DV360-Quelle/‑Medium

Dimensionen für die Integration von Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId Erste Nutzerinteraktion – SA360-Anzeigengruppen-ID

  • firstUserSa360AdGroupName Erste Nutzerinteraktion – SA360-Anzeigengruppenname

  • firstUserSa360CampaignId Erste Nutzerinteraktion – SA360-Kampagnen-ID

  • firstUserSa360CampaignName Erste Nutzerinteraktion – SA360-Kampagne

  • firstUserSa360CreativeFormat Erste Nutzerinteraktion – SA360-Creative-Format

  • firstUserSa360EngineAccountId Erste Nutzerinteraktion – SA360-Engine-Konto-ID

  • firstUserSa360EngineAccountName Erste Nutzerinteraktion – SA360-Engine-Kontoname

  • firstUserSa360EngineAccountType Erste Nutzerinteraktion – SA360-Engine-Kontotyp

  • firstUserSa360KeywordText Erste Nutzerinteraktion – SA360-Keyword-Text

  • firstUserSa360ManagerAccountId Erste Nutzerinteraktion – SA360-Verwaltungskonto-ID

  • firstUserSa360ManagerAccountName Erste Nutzerinteraktion – SA360-Verwaltungskontoname

  • firstUserSa360Medium Erste Nutzerinteraktion – SA360-Medium

  • firstUserSa360Query Erste Nutzerinteraktion – SA360-Suchanfrage

  • firstUserSa360Source Erste Nutzerinteraktion – SA360-Quelle

  • firstUserSa360SourceMedium Erste Nutzerinteraktion – SA360-Quelle/-Medium

  • sa360AdGroupId SA360-Anzeigengruppen-ID

  • sa360CampaignId SA360-Kampagnen-ID

  • sa360AdGroupName SA360-Anzeigengruppenname

  • sa360CampaignName SA360-Kampagne

  • sa360CreativeFormat SA360-Creative-Format

  • sa360EngineAccountId SA360-Engine-Konto-ID

  • sa360EngineAccountName SA360-Engine-Kontoname

  • sa360EngineAccountType SA360-Engine-Kontotyp

  • sa360KeywordText SA360-Keyword-Text

  • sa360ManagerAccountId SA360-Verwaltungskonto-ID

  • sa360ManagerAccountName Name des SA360-Verwaltungskontos

  • sa360Medium SA360-Medium

  • sa360Query SA360-Suchanfrage

  • sa360Source SA360-Quelle

  • sa360SourceMedium – SA360-Quelle/‑Medium

  • sessionSa360AdGroupId Sitzung – SA360-Anzeigengruppen-ID

  • sessionSa360CampaignId Sitzung – SA360-Kampagnen-ID

  • sessionSa360ManagerAccountId Sitzung – SA360-Verwaltungskonto-ID

  • sessionSa360ManagerAccountName Sitzung – SA360-Verwaltungskontoname

  • sessionSa360SourceMedium Sitzung – SA360-Quelle/‑Medium

06.03.2024: Unterstützung für Zielgruppen mit inaktiven Nutzern in Zielgruppenexporten.

Die Funktion „Zielgruppenexport“ unterstützt den Export von Zielgruppen mit inaktiven Nutzern besser. Nutzer werden ohne qualifizierendes Ereignis in diese Zielgruppen aufgenommen. Beispielsweise kann ein Nutzer in die Zielgruppe aufgenommen werden, wenn er Ihre Website sieben Tage lang nicht besucht. Beispiele für Zielgruppen mit inaktiven Nutzern sind „Inaktive Käufer in den letzten 7 Tagen“, „Inaktive Nutzer in den letzten 7 Tagen“ und „Nutzer, die 7 Tage lang nicht benachrichtigt wurden“. Weitere Informationen zu diesen vorgeschlagenen Zielgruppen finden Sie unter Vorgeschlagene Zielgruppen.

28.02.2024: Bei Zielgruppenexporten wird die im Tagging angegebene Nutzer-ID zurückgegeben.

Bei Zielgruppenexporten wird jetzt die im Tagging angegebene User-ID zurückgegeben, auch wenn die von Nutzern bereitgestellten Daten für Ihre Property aktiviert sind. Wenn die Erhebung von Nutzern bereitgestellter Daten aktiviert ist, können diese Daten zusammen mit der User-ID über das Tagging an Google Analytics gesendet werden, um die Analyse zu verbessern. Weitere Informationen finden Sie unter Erhebung der von Nutzern bereitgestellten Daten.

30.01.2024: Webhook-Benachrichtigungen für Zielgruppenlisten und wiederkehrende Zielgruppenlisten in der Data API v1 Alpha werden jetzt unterstützt.

Die Felder AudienceList.webhookNotification und RecurringAudienceList.webhookNotification können beim Erstellen einer Zielgruppenliste (mit properties.audienceLists.create) oder einer wiederkehrenden Zielgruppenliste (mit properties.recurringAudienceLists.create) angegeben werden.

Mit dieser Funktion können Sie asynchron Webhook-Benachrichtigungen erhalten, wenn eine Zielgruppenliste verfügbar wird.

18.01.2024: Die Kompatibilität für Dimensionen, die den Abfragestring oder die Minutenkomponente enthalten, wurde verbessert.

Dimensionen, die den Abfragestring enthalten, sind jetzt mit den meisten Feldern kompatibel. Dimensionen wie pagePathPlusQueryString, unifiedPageScreen, pageLocation und fullPageUrl sind jetzt mit vielen zusätzlichen Feldern kompatibel, darunter sessionSource, browser, city und landingPage.

Dimensionen, die die Minutenkomponente enthalten, sind jetzt mit den meisten Feldern kompatibel. Dimensionen wie minute, nthMinute und dateHourMinute sind jetzt mit einer ähnlichen Gruppe zusätzlicher Felder kompatibel.

Umfassende Informationen zur Kompatibilität finden Sie im GA4 Dimensions & Metrics Explorer.

13.12.2023: Benutzerdefinierte Parameter auf Artikelebene

Benutzerdefinierte Dimensionen auf Artikelebene können jetzt mit der folgenden Syntax in Analytics Data API-Abfragen einbezogen werden:

Generischer API-Name Beschreibung
customItem:parameter_name Benutzerdefinierte Dimension auf Artikelebene für parameter_name

Weitere Informationen finden Sie unter API-Dimensionen und -Messwerte.

05.12.2023: Zielgruppenlisten sind in der Data API v1 Beta als Zielgruppenexporte verfügbar.

Die Funktion „Zielgruppenlisten“ wurde in Zielgruppenexporte umbenannt und der Betaversion der Data API v1 hinzugefügt.

Die folgenden Methoden wurden der Data API v1 Beta hinzugefügt:

28.11.2023: samplingMetadatas wurde der Antwort auf die Meldung hinzugefügt.

samplingMetadatas wurde zu ResponseMetaData hinzugefügt. Diese Sammlung enthält für jeden Zeitraum in der Anfrage, für den die Ergebnisse stichprobenartig erhoben wurden, ein SampleMetadata. In Google Analytics werden Stichproben nur dann erhoben, wenn davon ausgegangen wird, dass die Datenqualität durch Kardinalitätsgrenzwerte beeinträchtigt wird.

28.11.2023: In der Data API v1 Alpha wurde die Funktion zum wiederkehrenden Export von Zielgruppenlisten hinzugefügt.

Die Methoden properties.recurringAudienceLists.create, properties.recurringAudienceLists.create und properties.recurringAudienceLists.list wurden der Data API v1 Alpha hinzugefügt.

Mit dieser Funktion können Sie täglich Zielgruppenlisten erstellen, wenn sich die Zielgruppenmitgliedschaften ändern. Mit wiederkehrenden Zielgruppenlisten arbeiten Sie mit den neuesten Ergebnissen zur Zielgruppenzugehörigkeit.

13.10.2023: Unterstützung für Zielgruppen mit einer Gültigkeitsdauer von einem Tag hinzugefügt

Zielgruppen mit einer Gültigkeitsdauer von einem Tag werden jetzt von der Exportfunktion für Zielgruppenlisten unterstützt.

12.09.2023: Standardregeln für die Sortierung von AudienceList

Standardmäßig werden Berichte, die mit der Exportfunktion für Zielgruppenlisten erstellt wurden, nach denselben Regeln sortiert wie die anderen Berichterstellungsmethoden der Data API: Die Sortierung erfolgt absteigend nach der ersten Spalte, dann absteigend nach der zweiten Spalte usw.

Vor dieser Änderung haben Sie möglicherweise den folgenden Bericht erhalten:

deviceId isAdsPersonalizationAllowed
ABC wahr
DAC falsch
ABC falsch
AAA wahr

Nach dieser Änderung erhalten Sie den folgenden Bericht:

deviceId isAdsPersonalizationAllowed
AAA wahr
ABC falsch
ABC wahr
DAC falsch

15.08.2023: Die Dimension isLimitedAdTracking wurde dem Exportschema für Zielgruppenlisten hinzugefügt.

  • isLimitedAdTracking Geräteeinstellung zum Beschränken von Anzeigen-Tracking. Mögliche Werte sind true, false und (not set).

    Weitere Informationen finden Sie unter Dimensionen für Zielgruppenlisten.

15.08.2023: Dimension currencyCode und Messwert itemDiscountAmount hinzugefügt

  • currencyCode Der Währungscode der Landeswährung (gemäß ISO 4217) für das E-Commerce-Ereignis. Beispiel: „USD“ oder „GBP“.

  • itemDiscountAmount Der Geldwert von Artikelrabatten in E-Commerce-Ereignissen. Dieser Messwert wird beim Tagging über den Artikelparameter „discount“ erfasst.

Weitere Informationen finden Sie unter Data API reporting schema.

10.08.2023: Die Dimension isAdsPersonalizationAllowed wurde dem Exportschema für Zielgruppenlisten hinzugefügt.

  • isAdsPersonalizationAllowed: Personalisierte Werbung ist zulässig. Wenn ein Nutzer die Voraussetzungen für personalisierte Werbung erfüllt, gibt isAdsPersonalizationAllowed den Wert true zurück. Wenn ein Nutzer nicht für personalisierte Werbung infrage kommt, gibt isAdsPersonalizationAllowed den Wert false zurück.

    Weitere Informationen finden Sie unter Dimensionen für Zielgruppenlisten.

10.07.2023: Zielgruppenlisten

Unterstützung für Zielgruppenlisten zur Data API v1 Alpha hinzugefügt. Zielgruppenlisten enthalten einen Snapshot der Nutzer in der Zielgruppe zum Zeitpunkt der Erstellung der Zielgruppenliste.

Die folgenden Methoden wurden der Data API v1 Alpha hinzugefügt:

19.05.2023: Benutzerdefinierte Channelgruppen

Die Data API unterstützt jetzt benutzerdefinierte Channelgruppen.

11.05.2023: Änderungen am Tokenkontingent.

Das Kontingentsystem der Data API wurde aktualisiert, um genauere Gebühren zu ermöglichen.

Die Anzahl der Tokens, die für jede Anfrage berechnet werden, wurde entsprechend der Kontingentänderung aktualisiert und so angepasst, dass eine größere Anzahl einfacher Berichtsanfragen möglich ist, während für Berichte mit großen Datumsbereichen deutlich mehr Kontingenttokens berechnet werden.

Nach dieser Änderung bleiben die Kosten für einige Anfragen gleich, aber die Kosten für komplexere Abfragen steigen spürbar. Für Anfragen nach Daten für mehr als 6 Monate können beispielsweise 1.000 oder mehr Kontingent-Tokens berechnet werden.

Standardeigenschaften

Kontingentname Altes Limit Neues Limit
Core-Tokens pro Property und Tag 25.000 200.000
Core-Tokens pro Property und Stunde 5.000 40.000
Core-Tokens pro Projekt, Property und Stunde 1750 14.000
Echtzeit-Tokens pro Property und Tag 25.000 200.000
Echtzeit-Tokens pro Property und Stunde 5.000 40.000
Echtzeit-Tokens pro Projekt, Property und Stunde 1750 14.000
Trichter-Tokens pro Property und Tag 25.000 200.000
Trichter-Tokens pro Property und Stunde 5.000 40.000
Trichter-Tokens pro Projekt, Property und Stunde 1750 14.000

Analytics 360-Properties

Kontingentname Altes Limit Neues Limit
Core-Tokens pro Property und Tag 250.000 2.000.000
Core-Tokens pro Property und Stunde 50.000 400.000
Core-Tokens pro Projekt, Property und Stunde 17.500 140.000
Echtzeit-Tokens pro Property und Tag 250.000 2.000.000
Echtzeit-Tokens pro Property und Stunde 50.000 400.000
Echtzeit-Tokens pro Projekt, Property und Stunde 17.500 140.000
Trichter-Tokens pro Property und Tag 250.000 2.000.000
Trichter-Tokens pro Property und Stunde 50.000 400.000
Trichter-Tokens pro Projekt, Property und Stunde 17.500 140.000

02.03.2023: Datumsdimensionen hinzugefügt.

  • dayOfWeekName Name des Wochentags. Der Wochentag auf Englisch. Diese Dimension hat die Werte Sunday, Monday usw.

  • isoWeek ISO-Woche des Jahres. ISO-Wochennummer, wobei jede Woche am Montag beginnt. Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/ISO_week_date. Beispielwerte sind 01, 02 und 53.

  • isoYear ISO-Jahr. Das ISO-Jahr des Ereignisses. Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/ISO_week_date. Beispielwerte sind 2022 und 2023.

  • isoYearIsoWeek ISO-Woche des ISO-Jahres. Die kombinierten Werte von isoWeek und isoYear. Beispielwerte sind 201652 und 201701.

  • yearMonth Jahr, Monat. Die kombinierten Werte von year und month. Beispielwerte sind 202212 oder 202301.

  • yearWeek Kalenderwoche. Die kombinierten Werte von year und week. Beispielwerte sind 202253 oder 202301.

27.02.2023: E-Commerce-Dimensionen hinzugefügt.

  • itemListPosition Artikellistenposition. Die Position eines Artikels (z. B. eines von Ihnen verkauften Produkts) in einer Liste. Diese Dimension wird beim Tagging über den Parameter „index“ im Array „items“ erfasst.

  • itemLocationID: Zielgebiets-ID des Artikels. Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden. Dieses Feld wird beim Tagging durch den Parameter „location_id“ im Array „items“ ausgefüllt.

  • itemPromotionCreativeSlot Creative-Fläche für Artikelwerbung. Der Name der Creative-Fläche, die mit dem Artikel verknüpft ist. Diese Dimension kann beim Tagging über den Parameter creative_slot auf Ereignis- oder Artikelebene angegeben werden. Wenn der Parameter sowohl auf Ereignis- als auch auf Artikelebene angegeben ist, wird der Parameter auf Artikelebene verwendet.

21.02.2023: Die Dimension „Landingpage + Abfragestring“ wurde hinzugefügt.

  • landingPagePlusQueryString Landingpage + Abfragestring Der Seitenpfad und Abfragestring, die dem ersten Seitenaufruf einer Sitzung zugeordnet sind.

Dieses Feld ersetzt die Dimension landingPage, die eingestellt wurde und ab dem 14. Mai 2023 keinen Abfragestring mehr zurückgibt.

28.01.2023: Die Messwerte „Aufrufe pro Nutzer“ und „Nutzer, die gescrollt haben“ wurden hinzugefügt.

  • screenPageViewsPerUser Aufrufe pro Nutzer. Die Anzahl der App-Bildschirme oder Webseiten, die Ihre Nutzer pro aktivem Nutzer aufgerufen haben. Wiederholte Aufrufe werden auch gezählt. (screen_view + page_view events) / active users.

  • scrolledUsers Nutzer, die weit genug nach unten gescrollt haben. Die Anzahl der einzelnen Nutzer, die mindestens 90 % der Seite heruntergescrollt haben.

23.01.2023: Die Dimensionen „Kontinent“ und „Kontinent-ID“ wurden hinzugefügt.

  • continent Kontinent. Der Kontinent, von dem die Nutzeraktivität ausgeht. Beispiel: Americasoder Asia

  • continentId Kontinent-ID. Die geografische ID des Kontinents, von dem die Nutzeraktivität ausgeht, abgeleitet von der IP-Adresse des Nutzers.

23.01.2023: Dimension „Testdatenfilter-ID“ hinzugefügt.

  • testDataFilterId: ID des Testdatenfilters. Die numerische Kennung eines Datenfilters im Teststatus. Mit Datenfiltern können Sie Ereignisdaten aus Ihren Berichten anhand von Ereignisparameterwerten ein- oder ausschließen. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/10108813.

18.10.2022: Google Ads-Messwerte hinzugefügt.

  • advertiserAdClicks Anzeigenklicks. Gibt an, wie oft Nutzer insgesamt auf eine Anzeige geklickt haben, um zur Property zu gelangen.
  • advertiserAdCost Werbekosten. Der Gesamtbetrag, den Sie für Ihre Anzeigen bezahlt haben
  • advertiserAdCostPerClick Cost-per-Click für Anzeigen. Der Cost-per-Click für Anzeigen entspricht den Anzeigenkosten geteilt durch die Anzeigenklicks und wird oft als CPC abgekürzt.
  • advertiserAdCostPerConversion Cost-per-Conversion Der Cost-per-Conversion ergibt sich aus den Anzeigenkosten geteilt durch die Anzahl der Conversions.
  • advertiserAdImpressions Anzeigenimpressionen. Die Gesamtzahl der Impressionen.
  • returnOnAdSpend ROAS (Return on Advertising Spend) Der Return on Advertising Spend (ROAS) ist der Gesamtumsatz geteilt durch die Werbekosten des Werbetreibenden.

17.10.2022: Messwerte auf Artikelebene hinzugefügt.

  • itemsAddedToCart Artikel wurden dem Einkaufswagen hinzugefügt. Die Anzahl der Einheiten eines einzelnen Artikels, die in den Einkaufswagen gelegt wurden.
  • itemsCheckedOut Artikel bezahlt. Die Anzahl der bezahlten Einheiten für einen einzelnen Artikel.
  • itemsClickedInList In Liste angeklickte Artikel. Die Anzahl der Einheiten, die in einer Liste für einen einzelnen Artikel angeklickt wurden.
  • itemsClickedInPromotion In Werbeaktion angeklickte Artikel. Die Anzahl der Einheiten, die in einer Werbeaktion für einen einzelnen Artikel angeklickt wurden.
  • itemsViewed Artikel angesehen. Die Anzahl der aufgerufenen Einheiten für einen einzelnen Artikel.
  • itemsViewedInList In Liste angesehene Artikel. Die Anzahl der Einheiten, die für einen einzelnen Artikel in der Liste aufgerufen wurden.
  • itemsViewedInPromotion In Werbeaktion angesehene Artikel. Die Anzahl der Einheiten, die in der Werbung für einen einzelnen Artikel angesehen wurden.

13.09.2022: Ankündigung von Änderungen an der Schemakompatibilität.

Am 1. Dezember 2022 treten die folgenden funktionsgefährdenden Änderungen in Kraft:

  1. Artikelbezogene Dimensionen wie itemName sind nicht mehr mit ereignisbezogenen Messwerten wie eventCount kompatibel. Artikelbezogene Dimensionen sind weiterhin mit artikelbezogenen Messwerten wie itemRevenue, nutzerbezogenen Messwerten wie activeUsers und sitzungsbezogenen Messwerten wie sessions kompatibel.

  2. Attributionsdimensionen wie source sind mit einigen ereignisbezogenen Messwerten wie eventCount nicht mehr kompatibel. Attributionsdimensionen sind weiterhin mit Attributionsmesswerten wie conversions, nutzerbasierten Messwerten wie activeUsers und sitzungsbasierten Messwerten wie sessions kompatibel.

  3. Dimensionen, die den Abfragestring enthalten, z. B. pagePathPlusQueryString, sind nur mit einer begrenzten Anzahl von Dimensionen und Messwerten kompatibel.

01.09.2022: Kontingentänderungen.

  • Die Kontingente Requests per day, Requests Per Minute und Requests Per Minute Per User werden aus der Data API entfernt.

  • Das Kontingent für Tokens Per Project Per Property Per Hour wurde der API hinzugefügt.

  • Jede Anfrage verbraucht Kontingent sowohl für Tokens Per Property Per Hour als auch für Tokens Per Project Per Property Per Hour.

    Ausführliche Informationen zu neuen Kontingenten finden Sie in der Dokumentation zu Kontingenten.

03.08.2022: SA360-Dimensionen auf Sitzungsebene hinzugefügt.

  • sessionSa360AdGroupName Sitzung – SA360-Anzeigengruppenname. Der Name der Anzeigengruppe aus Search Ads 360, die zu dieser Sitzung geführt hat.

  • sessionSa360CampaignName Sitzung – SA360-Kampagne. Der Name der Kampagne aus Search Ads 360, die zu dieser Sitzung geführt hat.

  • sessionSa360CreativeFormat Sitzung – SA360-Creative-Format. Der Typ des Creatives in Search Ads 360, über das die Sitzung initiiert wurde. Beispiele: „Responsive Suchanzeige“ oder „Erweiterte Textanzeige“.

  • sessionSa360EngineAccountId – Sitzung – SA360-Engine-Konto-ID Die ID des Engine-Kontos in SA360, das zu dieser Sitzung geführt hat.

  • sessionSa360EngineAccountName Sitzung – SA360-Engine-Kontoname. Der Name des Engine-Kontos in SA360, das zu dieser Sitzung geführt hat.

  • sessionSa360EngineAccountType Sitzung – SA360-Engine-Kontotyp Der Typ des Engine-Kontos in Search Ads 360, über das die Nutzersitzung initiiert wurde. Beispiele: „google ads“, „bing“ oder „baidu“.

  • sessionSa360Keyword Sitzung – SA360-Keyword-Text Das Suchmaschinen-Keyword aus Search Ads 360, das zu dieser Sitzung geführt hat.

  • sessionSa360Medium Sitzung – SA360-Medium. Das Suchmaschinen-Keyword aus Search Ads 360, das zu dieser Sitzung geführt hat. Beispiel: „cpc“.

  • sessionSa360Query Sitzung – SA360-Suchanfrage Die Suchanfrage aus Search Ads 360, die zu dieser Sitzung geführt hat.

  • sessionSa360Source – Sitzung – SA360-Quelle Die Quelle des Traffics aus Search Ads 360, der zu dieser Sitzung geführt hat. Beispiel: „beispiel.de“ oder „google“.

  • Die Dimensionen sessionCampaignId und sessionCampaignName unterstützen jetzt Search Ads 360-Kampagnen.

11.07.2022: Messwerte für die Conversion-Rate hinzugefügt.

Conversion-Rate

  • sessionConversionRate Der Prozentsatz der Sitzungen, in denen ein beliebiges Conversion-Ereignis ausgelöst wurde.

  • userConversionRate Der Prozentsatz der Nutzer, die ein beliebiges Conversion-Ereignis ausgelöst haben.

Conversion-Rate-Messwerte für eine Conversion

  • sessionConversionRate:event_name Der Prozentsatz der Sitzungen, in denen ein bestimmtes Conversion-Ereignis ausgelöst wurde.

  • userConversionRate:event_name Der Prozentsatz der Nutzer, die ein bestimmtes Conversion-Ereignis ausgelöst haben.

05.05.2022: Dem Alpha-Kanal wurde die Funktion für Trichterberichte hinzugefügt.

  • Die Methode runFunnelReport wurde der Version v1alpha der API hinzugefügt. Sie gibt einen benutzerdefinierten Trichterbericht Ihrer Google Analytics-Ereignisdaten zurück.

  • Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Bitte geben Sie über dieses Formular Feedback zur Google Analytics Data API.

16.02.2022: Neue Dimensionen hinzugefügt.

Manuelle Begriffe und Inhalte

  • firstUserManualAdContent Erste Nutzerinteraktion – manueller Anzeigeninhalt. Der Anzeigeninhalt, über den der Nutzer akquiriert wurde. Wird im Parameter utm_content übergeben.

  • firstUserManualTerm Erste Nutzerinteraktion – manueller Begriff. Der Begriff, über den der Nutzer akquiriert wurde. Wird im Parameter utm_term übergeben.

  • manualAdContent Manueller Anzeigeninhalt. Der Anzeigeninhalt, der dem Conversion-Ereignis zugeordnet ist. Wird im Parameter utm_content übergeben.

  • manualTerm Manueller Begriff. Der Begriff, der dem Conversion-Ereignis zugeordnet ist. Wird im Parameter utm_term übergeben.

  • sessionManualAdContent Sitzung – manueller Anzeigeninhalt. Die Anzeigeninhalte, die zu einer Sitzung geführt haben. Wird im Parameter utm_content übergeben.

  • sessionManualTerm Sitzung – manueller Begriff. Der Begriff, der zu einer Sitzung geführt hat. Wird im Parameter utm_term übergeben.

Absturzanalyse

  • crashAffectedUsers von Abstürzen betroffene Nutzer. Die Anzahl der Nutzer, bei denen ein Absturz in dieser Zeile des Berichts protokolliert wurde.

  • crashFreeUsersRate Anteil der nicht von einem Absturz betroffenen Nutzer.

App/Web

  • averageSessionDuration Die durchschnittliche Dauer der Nutzersitzungen in Sekunden.

  • newVsReturning Neue/wiederkehrende Nutzer.

  • screenPageViewsPerSession Aufrufe pro Sitzung.

  • landingPage Landing page. Der Seitenpfad und Abfragestring, die dem ersten Seitenaufruf einer Sitzung zugeordnet sind.

  • platformDeviceCategory Die Plattform und der Gerätetyp, auf denen Ihre Website oder App verwendet wurde.

Mobile App

  • averagePurchaseRevenuePerUser Durchschnittlicher Umsatz aus Käufen pro Nutzer.

  • firstTimePurchaserConversionRate Der Prozentsatz der aktiven Nutzer, die zum ersten Mal etwas gekauft haben.

  • firstTimePurchasersPerNewUser Die durchschnittliche Anzahl der Erstkäufer pro neuer Nutzer.

  • dauPerMau Aktive Nutzer pro Tag / monatlich aktive Nutzer. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 30 Tage sowie am letzten Tag des ausgewählten Zeitraums aktiv waren.

  • dauPerWau Aktive Nutzer pro Tag / Aktive Nutzer pro Woche. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 7 Tage sowie am letzten Tag des ausgewählten Zeitraums aktiv waren.

  • wauPerMau WAU / monatlich aktive Nutzer. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 30 Tage sowie innerhalb von 7 Tagen aktiv waren.

  • purchaserConversionRate Der Prozentsatz der aktiven Nutzer, die mindestens 1 Kauftransaktion durchgeführt haben.

  • transactionsPerPurchaser Transaktionen pro Käufer.

Google Ads-Kampagne

  • firstUserGoogleAdsCampaignType Der Kampagnentyp der Google Ads-Kampagne, über die der Nutzer akquiriert wurde.

  • googleAdsCampaignType: Der Kampagnentyp für die Google Ads-Kampagne, die dem Conversion-Ereignis zugeordnet ist.

  • sessionGoogleAdsCampaignType Der Kampagnentyp der Google Ads-Kampagne, die zu dieser Sitzung geführt hat.

07.09.2021: Neue Dimensionen für Datum/Uhrzeit hinzugefügt.

  • dateHourMinute Die kombinierten Werte für Datum, Stunde und Minute im Format JJJJMMTThhmm.

  • minute Die zweistellige Minute der Stunde, in der das Ereignis protokolliert wurde.

  • nthMinute Die Anzahl der Minuten seit Beginn des Zeitraums.

07.09.2021: Neue Dimensionen hinzugefügt, die durch Ereignisparameter ausgefüllt werden.

  • achievementId Die Erfolgs-ID in einem Spiel für ein Ereignis.

  • character Die Spielfigur in einem Spiel für ein Ereignis.

  • fileExtension: Die Erweiterung der heruntergeladenen Datei.

  • fileName Der Seitenpfad der heruntergeladenen Datei.

  • groupId Die Spieler-Gruppen-ID in einem Spiel für ein Ereignis.

  • linkClasses Das HTML-Attribut „class“ für einen externen Link.

  • linkDomain: Die Zieldomain des externen Links.

  • linkId Das HTML-Attribut „id“ für einen externen Link oder Dateidownload.

  • linkText Der Linktext des Dateidownloads.

  • linkUrl Die vollständige URL für einen externen Link oder Dateidownload.

  • method Gibt an, wie ein Ereignis ausgelöst wurde.

  • outbound Gibt „true“ zurück, wenn der Link zu einer Website führt, die nicht zur Domain der Property gehört.

  • pageLocation Das Protokoll, der Hostname, der Seitenpfad und der Abfragestring für besuchte Webseiten.

  • pageReferrer Die vollständige Verweis-URL, einschließlich Hostname und Pfad.

  • percentScrolled Der Prozentsatz der Seite, den der Nutzer heruntergescrollt ist (z. B. „90“).

  • searchTerm Der vom Nutzer gesuchte Begriff.

  • videoProvider Die Quelle des Videos, z. B. „youtube“.

  • videoTitle Der Titel des Videos.

  • videoUrl Die URL des Videos.

  • visible Gibt „true“ zurück, wenn der Inhalt sichtbar ist.

  • unifiedPagePathScreen Der Seitenpfad (Web) oder die Bildschirmklasse (App), auf dem bzw. der das Ereignis protokolliert wurde.

07.09.2021: Änderungen am API-Schema.

Änderungen an vorhandenen Dimensionen:

  • unifiedPageScreen Bei im Web generierten Ereignissen gibt diese Dimension jetzt den Seitenpfad und den Abfragestring zurück, für den das Ereignis protokolliert wurde.

Ankündigung anstehender Änderungen:

  • firstUserTrafficOrigin: Die Besucherquelle, über die der Nutzer akquiriert wurde. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, „Manuell“ zurückgibt. Im Rahmen einer bevorstehenden Funktionseinführung wird dieses Feld von „Manuell“ auf „(not set)“ aktualisiert.

  • sessionTrafficOrigin Gibt an, woher die Zugriffe der Kampagne stammen, die zur Sitzung geführt hat. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, „Manuell“ zurückgibt. Im Rahmen einer bevorstehenden Funktionseinführung wird dieses Feld von „Manuell“ auf „(not set)“ aktualisiert.

  • trafficOrigin Gibt an, woher die Zugriffe der Kampagne stammen, die zum Conversion-Ereignis geführt hat. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, „Manual“ zurückgibt. Im Rahmen einer bevorstehenden Funktionseinführung wird dieses Feld von „Manual“ auf „(not set)“ aktualisiert.

07.09.2021: Die Methode checkCompatibility wurde der API hinzugefügt.

Die Methode checkCompatibility listet Dimensionen und Messwerte auf, die einer Berichtsanfrage hinzugefügt werden können und die Kompatibilität aufrechterhalten.

21.07.2021: Änderungen bei Echtzeitberichten.

Sie können jetzt die Minutenbereiche der Ereignisdaten angeben, die gelesen werden sollen. Verwenden Sie dazu den Parameter minuteRanges der Methode runRealtimeReport.

21.07.2021: Neue Dimensionen für Channelgruppierungen.

Dem Berichtsschema der Data API wurden neue Dimensionen für die Channelgruppierung hinzugefügt:

  • firstUserDefaultChannelGrouping Erste Nutzerinteraktion – Standard-Channelgruppierung.

  • defaultChannelGrouping Standard-Channelgruppierung

10.06.2021: Änderungen am API-Schema.

  • Die Dimension minutesAgo wurde dem Echtzeitschema der Data API hinzugefügt und kann in Abfragen an die Methode runRealtimeReport verwendet werden. Diese Dimension enthält die Anzahl der Minuten, die seit der Erfassung eines Ereignisses vergangen sind. 00 ist die aktuelle Minute und 01 die vorherige Minute.

  • Die Dimension googleAdsCreativeId wurde dem Data API-Schema hinzugefügt. Diese Dimension enthält die ID des Google Ads-Anzeigen-Creatives, das dem Conversion-Ereignis zugeordnet ist.

  • Die Dimension sessionGoogleAdsCreativeId wurde dem Data API-Schema hinzugefügt. Diese Dimension enthält die ID des Google Ads-Anzeigen-Creatives, das zu einer Sitzung auf Ihrer Website oder in Ihrer App geführt hat.

  • Die Dimension firstUserCreativeId wurde im Data API-Schema in firstUserGoogleAdsCreativeId umbenannt. Diese Dimension enthält die ID des Google Ads-Creatives, über das der Nutzer akquiriert wurde.

09.04.2021: Die Google Analytics Data API v1 (Beta) wurde veröffentlicht.

  • Der API-Endpunkt wurde auf https://analyticsdata.googleapis.com/v1beta aktualisiert.

  • Die Methoden runReport, runPivotReport, batchRunReports und batchRunPivotReports akzeptieren jetzt die ID einer Google Analytics 4-Property im Parameter property des URL-Pfads anstelle des Felds entity eines Anfragetexts:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • API-Clientbibliotheken wurden aktualisiert, um den neuen API-Endpunkt zu verwenden.

19.02.2021: Änderungen an der Paginierung.

  • Die Standardgröße für Berichtsantworten wurde von 10 auf 10.000 Zeilen mit Ereignisdaten erhöht.

  • Der Wert "limit" : -1, der verwendet wurde, um einen Versuch zum Abrufen aller Zeilen anzugeben, wird in RunReportRequest nicht mehr unterstützt.

  • Der Höchstwert des Felds limit ist auf 100000 festgelegt. Verwenden Sie die Paginierung, um Berichte mit mehr als 100.000 Zeilen abzurufen.

08.02.2021: Neue E-Commerce-Dimensionen und -Messwerte.

Dem API-Schema wurden neue E-Commerce-Dimensionen und ‑Messwerte hinzugefügt:

Dimensionen: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Messwerte: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08.02.2021: Neue Kampagnendimensionen hinzugefügt.

Dem API-Schema wurden neue Kampagnendimensionen hinzugefügt: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

08.02.2021: Änderungen an den Dimensionen dayOfWeek und week.

  • Der Wert der Dimension dayOfWeek beginnt jetzt mit 0 statt mit 1.

  • Der Wert der Dimension week beginnt jetzt mit 01 und gibt eine zweistellige Zahl zwischen 01 und 53 zurück. Jede Woche beginnt am Sonntag. Der 1. Januar ist immer in Woche 01.

28.01.2021: Aggregationsvarianten für benutzerdefinierte Messwerte hinzugefügt.

Für jeden benutzerdefinierten Messwert, der für eine Property registriert wird, werden drei API-Messwertvarianten erstellt: eine Summe, ein Durchschnitt und eine Anzahl.

28.01.2021: Neue Dimensionen für Datum/Uhrzeit hinzugefügt.

Dem API-Schema wurden die folgenden neuen Dimensionen hinzugefügt: hour, nthHour, nthYear, dateHour.

28.01.2021: Die Anzahl der Kontingent-Tokens, die pro Abfrage berechnet werden, wurde in der Data API reduziert.

Die Anzahl der Kontingent-Tokens, die pro Abfrage berechnet werden, wurde in der Data API reduziert. Die Kontingentlimits für Property-Kontingent-Tokens pro Stunde und pro Tag wurden nicht geändert.

09.11.2020: Die Methode getUniversalMetadata wurde gelöscht.

Die Methode getUniversalMetadata wurde gelöscht. Verwenden Sie getMetadata. Der maximale Zeitraum von einem Jahr pro API-Anfrage wurde entfernt.

02.11.2020: Eine Echtzeit-Berichtsmethode wurde hinzugefügt.

Beispiele finden Sie unter Echtzeitbericht erstellen und die REST-Referenzdokumentation unter runRealtimeReport.

19.10.2020: Clientbibliotheksartefakte aktualisiert.

Clientbibliotheksartefakte wurden zusammen mit Nutzungsanleitungen und Codebeispielen aktualisiert.

13.10.2020: App + Web-Properties wurden in Google Analytics 4 (GA4) umbenannt.

08.10.2020: Die Methode getMetadata wurde der API hinzugefügt.

Die Methode getMetadata gibt benutzerdefinierte Dimensionen und Messwerte zurück, die für die angegebene GA4-Property-ID verfügbar sind, sowie universelle Metadaten.

08.10.2020: Benutzerdefinierte Dimensionen und Messwerte sind in Berichten verfügbar.

In der API-Schemadokumentation finden Sie Informationen zu benutzerdefinierten Dimensionen und Messwerten. Dieses Update umfasst benutzerdefinierte Dimensionen und Messwerte auf Ereignisebene sowie benutzerdefinierte Dimensionen auf Nutzerebene.