Änderungsprotokoll

Offizielle Ankündigungen zur Google Analytics API erhalten Sie in der Google Analytics API Notify Group.

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

Jetzt gilt ein Limit von 10.000 API-Serverfehlern pro Projekt und Attribut innerhalb eines Zeitfensters von 15 Minuten. Dies schließt alle Anfragen ein, 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 aus Dimensionen und Messwerten oder Authentifizierungsfehler.

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

14.05.2024 Funktion für Vergleiche hinzugefügt

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

Die wichtigsten Berichtsmethoden der Data API v1beta wurden aktualisiert, um das Feld comparisons zu unterstützen. Dieses Feld gibt, sofern vorhanden, die Konfiguration der angeforderten Vergleiche an.

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

Die Methode getMetadata wird aktualisiert, um alle gespeicherten Vergleiche, die für ein Attribut verfügbar sind, im Antwortfeld comparisons aufzulisten.

Wenn in einer Anfrage mindestens ein Vergleich angegeben ist, enthält die Antwort die Spalte comparison, die jeden Vergleich identifiziert.

Gespeicherte Vergleiche können derzeit nur mit der Google Analytics-Benutzeroberfläche erstellt werden.

08.05.2024 Der Data API v1alpha wurden Berichtsaufgaben hinzugefügt, eine asynchrone Berichtsfunktion.

Mithilfe von Berichtsaufgaben können Sie eine lange laufende asynchrone Anfrage initiieren, um einen benutzerdefinierten Bericht Ihrer Google Analytics-Ereignisdaten zu erstellen.

Die folgenden Methoden zur Bearbeitung von Aufgaben in Berichten wurden der Data API v1alpha hinzugefügt:

06.05.2024 Neue Dimensionen für Schlüsselereignisse

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

Ändern Sie Ihre Berichtsanfragen mit der Dimension isConversionEvent so, dass stattdessen die Dimension isKeyEvent verwendet wird.

Ändern Sie alle Berichtsanfragen mit einem eingestellten Messwert in der folgenden Tabelle so, dass stattdessen der Schlüsselereignis-Messwert verwendet wird.

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

Nehmen Sie ähnliche Änderungen an der Verwendung von Schlüsselereignismesswerten für ein Schlüsselereignis in Ihren Berichtsanfragen vor.

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

  • apiName, uiName und description enthalten den API-Namen für das Schlüsselereignis, den Namen der Benutzeroberfläche und die Beschreibung.
  • Das wiederkehrende Feld deprecatedApiNames enthält einen Eintrag mit dem eingestellten Namen der Conversion API.

25.03.2024: Primäre Channelgruppe, manuelle Zugriffsquelle und integrationspezifische Dimensionen wurden hinzugefügt.

Primäre Channelgruppe, manuelle Besucherquelle und spezifische Dimensionen für die Verknüpfung von CM360, DV360 und SA360, die dem Schema der Data API hinzugefügt wurden.

Zielgruppendimensionen:

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

Primäre Channelgruppendimensionen:

  • firstUserPrimaryChannelGroup Erste Nutzerinteraktion – primäre Channelgruppe

  • primaryChannelGroup Primäre Channelgruppe

  • sessionPrimaryChannelGroup Sitzung – primäre Channelgruppe

Dimensionen für manuelle Besucherquellen:

  • manualCampaignId – Kampagnen-ID (manuell)

  • manualCampaignName Kampagnenname (manuell)

  • manualCreativeFormat Manuelles Creative-Format

  • manualMarketingTactic Manuelle Marketingtaktik

  • manualMedium – Medium (manuell)

  • manualSource – manuelle Quelle

  • manualSourceMedium Manuelle Quelle / Medium

  • manualSourcePlatform Manuelle Quellplattform

  • firstUserManualCampaignId Erste Nutzerinteraktion – Kampagnen-ID (manuell)

  • firstUserManualCampaignName Erste Nutzerinteraktion – Kampagnenname (manuell)

  • firstUserManualCreativeFormat Erste Nutzerinteraktion – manuelles Creative-Format

  • firstUserManualMarketingTactic Erste Nutzerinteraktion – manuelle Marketingtaktik

  • firstUserManualMedium Erste Nutzerinteraktion – Medium (manuell)

  • firstUserManualSource Erste Nutzerinteraktion – manuelle Quelle

  • firstUserManualSourceMedium Erste Nutzerinteraktion – manuelle Quelle / Medium

  • firstUserManualSourcePlatform Erste Nutzerinteraktion – manuelle Quellplattform

  • sessionManualCampaignId Sitzung – Kampagnen-ID (manuell)

  • sessionManualCampaignName Sitzung – Kampagnenname (manuell)

  • sessionManualCreativeFormat Sitzung – manuelles Creative-Format

  • sessionManualMarketingTactic Sitzung – manuelle Marketingtaktik

  • sessionManualMedium Sitzung – Medium (manuell)

  • sessionManualSource Sitzung – manuelle Quelle

  • sessionManualSourceMedium Sitzung – manuelle Quelle / Medium

  • sessionManualSourcePlatform Sitzung – manuelle Quellplattform

Integrationsdimensionen für Campaign Manager 360 (CM360):

  • cm360AccountId CM360-Konto-ID

  • cm360AccountName CM360-Kontoname

  • cm360AdvertiserId CM360-Werbetreibenden-ID

  • cm360AdvertiserName Name des CM360-Werbetreibenden

  • 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

Integrationsdimensionen für 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 ID der DV360-Anzeigenplattform

  • dv360ExchangeName DV360-Anzeigenplattformname

  • dv360InsertionOrderId DV360-Anzeigenauftrags-ID

  • dv360InsertionOrderName DV360-Anzeigenauftragsname

  • dv360LineItemId DV360-Werbebuchungs-ID

  • dv360LineItemName DV360-Werbebuchungsname

  • dv360Medium DV360-Medium

  • dv360PartnerId ID des DV360-Partners

  • 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

Google Search Ads 360-Integrationsdimensionen (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 SA360-Verwaltungskontoname

  • 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 inaktiver Nutzerzielgruppen in Zielgruppenexporten.

Mit der Funktion „Zielgruppenexport“ lassen sich inaktive Nutzerzielgruppen besser exportieren. Nutzer können diese Zielgruppen ohne entsprechendes Ereignis eingeben, z. B. wenn sie Ihre Website sieben Tage lang nicht besuchen. Beispiele für inaktive Nutzerzielgruppen sind „Nutzer, die in den letzten 7 Tagen inaktiv sind“, „Nutzer, die 7 Tage inaktiv waren“ und „Nutzer, die innerhalb der letzten 7 Tage nicht benachrichtigt wurden“. Weitere Informationen zu diesen vorgeschlagenen Zielgruppen finden Sie unter Vorgeschlagene Zielgruppen.

28.02.2024 Zielgruppenexporte geben die beim Tagging angegebene User-ID zurück.

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

30.01.2024 Unterstützung von Webhook-Benachrichtigungen für Zielgruppenlisten und wiederkehrende Zielgruppenlisten in der Alphaversion der Data API Version 1.

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

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

18.01.2024 Verbesserte Kompatibilität für Dimensionen, die den Abfragestring oder die Minutenkomponente enthalten.

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 ähnlichen zusätzlichen Feldern kompatibel.

Ausführliche 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 eingebunden werden:

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

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

05.12.2023 Zielgruppenlisten sind in der Betaversion 1 der Data API als Zielgruppenexporte verfügbar.

Die Funktion "Zielgruppenlisten" wurde in Zielgruppenexporte umbenannt und der Data API Version 1 (Beta) hinzugefügt.

Die folgenden Methoden wurden zur Betaversion 1 der Data API hinzugefügt:

28.11.2023: samplingMetadatas zum Melden der Antwort hinzugefügt

samplingMetadatas wurde ResponseMetaData hinzugefügt. Diese Sammlung enthält eine SampleMetadata für jeden Zeitraum in der Anfrage, für die Stichproben der Ergebnisse herangezogen wurden. In Google Analytics werden Stichproben nur dann erhoben, wenn davon auszugehen ist, dass Kardinalitätslimits die Datenqualität verringern.

28.11.2023: Funktion für den wiederkehrenden Export von Zielgruppenlisten zur Data API Version 1 (Alpha) hinzugefügt

Der Alphaversion der Data API Version 1 wurden die Methoden properties.recurringAudienceLists.create, properties.recurringAudienceLists.create und properties.recurringAudienceLists.list hinzugefügt.

Mit dieser Funktion können Sie täglich Zielgruppenlisten erstellen, wenn sich die Zugehörigkeit zu Zielgruppen ändert. Mit wiederkehrenden Zielgruppenlisten erhalten Sie immer aktuelle Ergebnisse.

08.11.2023: Funktion zum Exportieren von Zielgruppenlisten in Google Tabellen zur Data API Version 1 (Alpha) hinzugefügt

Der Alphaversion der Data API Version 1 wurde die Methode properties.audienceLists.exportSheet hinzugefügt, mit der Zielgruppenlisten nach Google Tabellen exportiert werden können.

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

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

12.09.2023: Standardmäßige Sortierungsregeln für Zielgruppenlisten

Standardmäßig gelten für Berichte, die mit der Exportfunktion für Zielgruppenlisten erstellt wurden, dieselben Sortierregeln wie für die anderen Berichtsmethoden der Data API: Die Sortierung erfolgt absteigend nach der ersten Spalte, dann nach absteigender Spalte usw.

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

Nach dieser Änderung erhalten Sie den folgenden Bericht:

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

15.08.2023 Dem Exportschema für Zielgruppenlisten wurde die Dimension isLimitedAdTracking 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 Zielgruppenlistendimensionen.

15.08.2023: Dimension „currencyCode“, Messwert „itemDiscountAmount“ hinzugefügt

  • currencyCode Der lokale Währungscode (gemäß ISO 4217-Standard) des E-Commerce-Ereignisses. Beispiel: „USD“ oder „GBP“.

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

Weitere Informationen finden Sie unter Berichtsschema für die Data API.

10.08.2023: Dimension „isAdsPersonalizationAllowed“ dem Exportschema für Zielgruppenlisten hinzugefügt

  • isAdsPersonalizationAllowed: Personalisierte Anzeigen sind zulässig. Wenn ein Nutzer für personalisierte Anzeigen infrage kommt, gibt isAdsPersonalizationAllowed den Wert true zurück. Wenn ein Nutzer nicht für personalisierte Anzeigen infrage kommt, gibt isAdsPersonalizationAllowed den Wert false zurück.

    Weitere Informationen finden Sie unter Zielgruppenlistendimensionen.

10.07.2023 Zielgruppenlisten

Unterstützung von Zielgruppenlisten für die Data API Version 1 (Alpha). Zielgruppenlisten enthalten eine Übersicht der Nutzer in der Zielgruppe zum Zeitpunkt der Erstellung.

Die folgenden Methoden wurden zu Version 1 der Data API (Alpha) hinzugefügt:

19.05.2023 Benutzerdefinierte Channelgruppen

Unterstützung für benutzerdefinierte Channelgruppen wurde der Data API hinzugefügt.

11.05.2023 Änderungen am Tokenkontingent

Das Kontingentsystem der Data API wurde aktualisiert, um präzisere Gebühren berechnen zu können.

Die Anzahl der Tokens, die für jede Anfrage in Rechnung gestellt werden, wurde entsprechend der Kontingentänderung aktualisiert und so neu ausbalanciert, dass eine größere Anzahl einfacher Berichtsabfragen möglich ist, während für Berichte mit umfangreichen Daten erheblich mehr Kontingenttokens in Rechnung gestellt werden.

Auch wenn die Kosten für einige Anfragen nach dieser Änderung unverändert bleiben, werden sie für kompliziertere Abfragen spürbar steigen. Bei Anfragen für Daten von mehr als 6 Monaten können beispielsweise 1.000 oder mehr Kontingenttokens in Rechnung gestellt werden.

Standard-Properties

Kontingentname Altes Limit Neues Limit
Kerntokens pro Property und Tag 25.000 200.000
Kerntokens pro Property und Stunde 5.000 40.000
Kerntokens pro Projekt, Property und Stunde 1750 14.000
Realtime Tokens pro Property und Tag 25.000 200.000
Echtzeittokens pro Property und Stunde 5.000 40.000
Realtime-Tokens pro Projekt, Property und Stunde 1750 14.000
Trichtertokens pro Property und Tag 25.000 200.000
Trichtertokens pro Property und Stunde 5.000 40.000
Trichtertokens pro Projekt, Property und Stunde 1750 14.000

Analytics 360-Properties

Kontingentname Altes Limit Neues Limit
Kerntokens pro Property und Tag 250.000 2.000.000
Kerntokens pro Property und Stunde 50.000 400.000
Kerntokens pro Projekt, Property und Stunde 17.500 140.000
Realtime Tokens pro Property und Tag 250.000 2.000.000
Echtzeittokens pro Property und Stunde 50.000 400.000
Realtime-Tokens pro Projekt, Property und Stunde 17.500 140.000
Trichtertokens pro Property und Tag 250.000 2.000.000
Trichtertokens pro Property und Stunde 50.000 400.000
Trichtertokens pro Projekt, Property und Stunde 17.500 140.000

2023-03-02 Datumsdimensionen wurden hinzugefügt.

  • dayOfWeekName Name des Wochentags. Der Wochentag in englischer Sprache. Diese Dimension hat Werte wie Sunday und Monday.

  • isoWeek ISO-Woche des Jahres. ISO-Wochennummer, wobei jede Woche mit dem Montag beginnt. Weitere Informationen hierzu 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 hierzu 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 Jahr Woche. Die kombinierten Werte von year und week. Beispielwerte sind 202253 oder 202301.

27.02.2023: E-Commerce-Dimensionen wurden 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 „items“-Array erfasst.

  • itemLocationID Standort-ID des Artikels. Der physische Standort des Artikels (z.B. der Standort des Geschäfts). Wir empfehlen die Verwendung der Google Place ID, die dem verknüpften Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden. Dieses Feld wird beim Tagging über den Parameter „location_id“ im „items“-Array 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 wird, wird der Parameter auf Artikelebene verwendet.

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

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

Dieses Feld ersetzt die Dimension landingPage, die eingestellt wurde und am 14. Mai 2023 so aktualisiert wird, dass kein Abfragestring zurückgegeben wird.

28.01.2023: Messwerte „Aufrufe pro Nutzer“ und „Scrollende Nutzer“ 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 mit Scrollen. Die Anzahl der einzelnen Nutzer, die auf der Seite mindestens 90% nach unten gescrollt 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 ihrer IP-Adresse.

23.01.2023 Die Dimension „ID des Testdatenfilters“ wurde hinzugefügt.

  • testDataFilterId Testdatenfilter-ID. Die numerische Kennzeichnung 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: Messwerte für Anzeigen wurden 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. Anzeigen-Cost-per-Click sind die Werbekosten geteilt durch die Anzeigenklicks und wird oft als CPC bezeichnet.
  • advertiserAdCostPerConversion Cost-per-Conversion. Der Cost-per-Conversion ergibt sich aus den Werbekosten geteilt durch die Anzahl der Conversions.
  • advertiserAdImpressions Anzeigenimpressionen. Die Gesamtzahl der Impressionen.
  • returnOnAdSpend Return on Advertising Spend. Der ROAS (Return on Advertising Spend) ergibt sich aus dem Gesamtumsatz geteilt durch die Werbekosten des Werbetreibenden.

17.10.2022: Messwerte auf Artikelebene wurden hinzugefügt.

  • itemsAddedToCart Artikel wurden dem Einkaufswagen hinzugefügt. Die Anzahl der Einheiten, die für einen einzelnen Artikel in den Einkaufswagen gelegt wurden.
  • itemsCheckedOut Artikel geprüft. Die Anzahl der Einheiten, die für einen einzelnen Artikel bezahlt wurden.
  • itemsClickedInList Artikel in der Liste angeklickt. Die Anzahl der Einheiten, die in der Liste für einen einzelnen Artikel angeklickt wurden.
  • itemsClickedInPromotion Artikel in Werbeaktion angeklickt. Die Anzahl der angeklickten Einheiten bei der Werbeaktion für einen einzelnen Artikel.
  • itemsViewed Artikel wurden angesehen. Die Anzahl der Einheiten, die für einen einzelnen Artikel angesehen wurden.
  • itemsViewedInList Artikel in der Liste angesehen. Die Anzahl der Einheiten, die in der Liste für einen einzelnen Artikel angesehen wurden.
  • itemsViewedInPromotion Artikel in Werbeaktion angesehen. Die Anzahl der Einheiten, die in der Werbeaktion für einen einzelnen Artikel angesehen wurden.

13.09.2022 Bekanntgabe von Änderungen an der Schemakompatibilität

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

  1. Dimensionen auf Artikelebene wie itemName sind nicht mehr mit ereignisbezogenen Messwerten wie eventCount kompatibel. Dimensionen auf Artikelebene sind weiterhin mit Messwerten auf Artikelebene wie itemRevenue, nutzerbasierten Messwerten wie activeUsers und sitzungsbasierten Messwerten wie sessions kompatibel.

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

  3. Dimensionen, die einen Abfragestring wie pagePathPlusQueryString enthalten, sind nur mit einer begrenzten Anzahl von Dimensionen und Messwerten kompatibel.

Weitere Informationen finden Sie in der detaillierten Erklärung der Kompatibilitätsänderungen.

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 von Tokens Per Project Per Property Per Hour wurde der API hinzugefügt.

  • Jede Anfrage verbraucht sowohl das Kontingent 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: Sitzungsbezogene SA360-Dimensionen wurden hinzugefügt.

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

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

  • sessionSa360CreativeFormat Sitzung – SA360-Creative-Format. Der Creative-Typ in Search Ads 360, der zu dieser Sitzung geführt hat. Beispiel: „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, das zu dieser Sitzung geführt hat. Beispiel: „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 von 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 zur Conversion-Rate wurden 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.

Messwerte zur Conversion-Rate 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 Alphakanal wurden Trichterberichte hinzugefügt.

  • Die Methode runFunnelReport wurde der v1alpha-Version der API hinzugefügt, mit der ein benutzerdefinierter Trichterbericht Ihrer Google Analytics-Ereignisdaten zurückgegeben wird.

  • Diese Methode wird in der Alpha-Stabilität eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Bitte geben Sie Feedback zu dieser API über Trichterberichte zur Google Analytics Data API.

16.02.2022 Neue Dimensionen hinzugefügt.

Manueller Begriff und Inhalt

  • firstUserManualAdContent Erste Nutzerinteraktion – manueller Anzeigeninhalt. Der Anzeigeninhalt, mit dem der Nutzer akquiriert wurde. Sie wird vom Parameter utm_content übergeben.

  • firstUserManualTerm Erste Nutzerinteraktion – manueller Begriff. Der Begriff, über den die Nutzerin akquiriert wurde. Sie wird vom Parameter utm_term übergeben.

  • manualAdContent Manueller Anzeigeninhalt. Der Anzeigeninhalt, der dem Conversion-Ereignis zugeordnet ist. Sie wird vom Parameter utm_content übergeben.

  • manualTerm Manueller Begriff. Der Begriff, der dem Conversion-Ereignis zugeordnet ist. Sie wird vom Parameter utm_term übergeben.

  • sessionManualAdContent Sitzung – manueller Anzeigeninhalt. Der Anzeigeninhalt, der zu einer Sitzung geführt hat. Sie wird vom Parameter utm_content übergeben.

  • sessionManualTerm Sitzung – manueller Begriff. Der Begriff, der zu einer Sitzung geführt hat. Sie wird vom Parameter utm_term übergeben.

Absturzanalyse

  • crashAffectedUsers von Abstürzen betroffene Nutzer. Die Anzahl der Nutzer, die einen Absturz in dieser Zeile des Berichts protokolliert haben.

  • crashFreeUsersRate Prozentsatz der Nutzer ohne Abstürze.

App/Web

  • averageSessionDuration Die durchschnittliche Dauer der Nutzersitzungen in Sekunden.

  • newVsReturning Neue / wiederkehrende Nutzer.

  • screenPageViewsPerSession Aufrufe pro Sitzung.

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

  • platformDeviceCategory Die Plattform und der Gerätetyp, auf dem Ihre Website oder App ausgeführt 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 und monatlich aktive Nutzer. Der gleitende Prozentsatz der in den letzten 30 Tagen aktiven Nutzer, die auch an einem Tag aktiv waren.

  • dauPerWau aktive Nutzer pro Tag / Woche Der gleitende Prozentsatz der in den letzten 7 Tagen aktiven Nutzer, die auch an einem Tag aktiv waren.

  • wauPerMau WAU / MAN. Der gleitende Prozentsatz der in den letzten 30 Tagen aktiven Nutzer, die auch in den letzten 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 der 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 vom Typ „Datum/Uhrzeit“ wurden 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: Es wurden neue Dimensionen hinzugefügt, die durch Ereignisparameter ausgefüllt werden.

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

  • character Die Figur des Spielers in einem Spiel für ein Ereignis.

  • fileExtension Die Erweiterung der heruntergeladenen Datei.

  • fileName Der Seitenpfad der heruntergeladenen Datei.

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

  • linkClasses Das HTML-Klassenattribut für einen externen Link.

  • linkDomain Die Zieldomain des externen Links.

  • linkId Das HTML-ID-Attribut 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 Die Methode, mit der 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: Protokoll, Hostname, Seitenpfad und Abfragestring für besuchte Webseiten.

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

  • percentScrolled Der Prozentsatz auf der Seite, den der Nutzer nach unten gescrollt hat (z. B. „90“).

  • searchTerm Der Begriff, nach dem der Nutzer gesucht hat.

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

  • videoTitle Der Titel des Videos.

  • videoUrl Die URL des Videos.

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

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

07.09.2021 Änderungen am API-Schema

Änderungen an vorhandenen Dimensionen:

  • unifiedPageScreen Bei webgenerierten Ereignissen gibt diese Dimension jetzt den Seitenpfad und den Abfragestring zurück, in denen das Ereignis erfasst wurde.

Ankündigung zu anstehenden Änderungen:

  • firstUserTrafficOrigin Die Zugriffsquelle, über die der Nutzer akquiriert wurde. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, den Wert „Manuell“ zurückgibt. Bei einer bevorstehenden Funktionseinführung wird dieses Feld von „Manuell“ zu „(nicht festgelegt)“ geändert.

  • sessionTrafficOrigin Der Ursprung der Zugriffe für die Kampagne der Sitzung. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, den Wert „Manuell“ zurückgibt. Bei einer bevorstehenden Funktionseinführung wird dieses Feld von „Manuell“ zu „(nicht festgelegt)“ geändert.

  • trafficOrigin Die Herkunft der Zugriffe für die Kampagne des Conversion-Ereignisses. Verlassen Sie sich nicht darauf, dass dieses Feld für Traffic, der UTMs verwendet, den Wert „Manuell“ zurückgibt. Bei einer bevorstehenden Funktionseinführung wird dieses Feld von „Manuell“ zu „(nicht festgelegt)“ geändert.

07.09.2021 checkCompatibility wurde der API hinzugefügt.

checkCompatibility werden Dimensionen und Messwerte aufgelistet, die einer Berichtsanfrage hinzugefügt werden können, um die Kompatibilität zu gewährleisten.

21.07.2021 Änderungen bei Echtzeitberichten.

Es ist jetzt möglich, mit dem Parameter minuteRanges der Methode runRealtimeReport die Minutenbereiche der zu lesenden Ereignisdaten anzugeben.

21.07.2021: Neue Dimensionen für Channelgruppierungen.

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

  • firstUserDefaultChannelGrouping Erste Nutzerinteraktion – Standard-Channelgruppierung.

  • defaultChannelGrouping Standard-Channelgruppierung.

10.06.2021 Änderungen am API-Schema

  • Die Dimension minutesAgo wurde dem Realtime-Schema der Data API hinzugefügt und kann in Abfragen an die Methode runRealtimeReport verwendet werden. Diese Dimension enthält die Anzahl der Minuten, vor denen ein Ereignis erfasst wurde. 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-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-Creatives, das zu einer Sitzung auf Ihrer Website oder in Ihrer App geführt hat.

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

09.04.2021: Die Betaversion der Google Analytics Data API Version 1 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

  • Die API-Clientbibliotheken wurden aktualisiert und verwenden jetzt den neuen API-Endpunkt.

19.02.2021: Änderungen bei der Paginierung

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

  • Der "limit" : -1-Wert, der verwendet wurde, um anzugeben, dass alle Zeilen abgerufen werden sollten, wird in RunReportRequest nicht mehr unterstützt.

  • Der Maximalwert 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 wurden hinzugefügt.

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

08.02.2021 dayOfWeek, week Dimensionsänderungen.

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

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

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

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

28.01.2021: Neue Dimensionen vom Typ „Datum/Uhrzeit“ wurden hinzugefügt.

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

28.01.2021: Durch die Data API wurden die pro Abfrage berechneten Kontingenttokens gesenkt.

Die Data API reduzierte die pro Abfrage berechneten Kontingenttokens. Die Kontingentlimits für Property-Kontingenttokens 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 dazu getMetadata. Der maximale Zeitraum von einem Jahr pro API-Anfrage wurde entfernt.

02.11.2020: Eine Methode für Echtzeitberichte wurde hinzugefügt.

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

19.10.2020 Artefakte der Clientbibliothek aktualisiert

Außerdem wurden die Artefakte der Clientbibliothek zusammen mit einer Anleitung 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.

getMetadata gibt die benutzerdefinierten 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.

Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten finden Sie in der Dokumentation zum API-Schema. Dieses Update umfasst benutzerdefinierte Dimensionen und Messwerte auf Ereignisebene sowie benutzerdefinierte Dimensionen auf Nutzerebene.