Änderungsprotokoll

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

20.10.2024: Der Größenfiltertyp EmptyFilter wurde hinzugefügt.

Mit dem Dimensionsfilter EmptyFilter können Sie Filterbedingungen erstellen, die mit einem leeren Wert verglichen werden.

15.10.2024: Der Methode reportTasks wurde die Funktion „Stichprobenebene“ hinzugefügt.

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

Mit dieser Funktion können für Google Analytics 360-Properties höhere Stichprobenlimits von 1 Milliarde Ereignissen festgelegt werden. Außerdem können Stichprobenlimits für Ergebnisse mit einer großen Anzahl von Ereignissen auf UNSAMPLED gesetzt werden.

18.09.2024: Snapshot-Funktion für Property-Kontingente hinzugefügt

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

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

Es gilt jetzt ein Limit von 10.000 API-Serverfehlern pro Projekt und Property innerhalb eines 15-Minuten-Zeitraums. 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-Zeitfenster endet.

14.05.2024: Vergleichsfunktion hinzugefügt

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

Die wichtigsten Berichtsmethoden 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 bereitstellen, oder einen gespeicherten Vergleich verwenden, indem Sie den Ressourcennamen des Vergleichs im Feld comparison angeben.

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

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

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

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

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

Der Data API v1alpha wurden die folgenden Methoden zum Bearbeiten von Berichtsaufgaben 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 Berichtsabfragen, in denen die Dimension isConversionEvent verwendet wird, so, dass stattdessen die Dimension isKeyEvent verwendet wird.

Ändern Sie alle Berichtsanfragen, in denen ein eingestellter Messwert aus der folgenden Tabelle verwendet wird, 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 Schlüsselereignis in Ihren Berichtsanfragen vor.

Die Antwort für die Methode properties/getMetadata spiegelt die Einführung von Schlüsselereignisdimensionen und ‑messwerten in den Objekten DimensionMetadata und MetricMetadata wider:

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

25.03.2024: Primäre Channelgruppe, manuelle Dimensionen für Besucherquellen und integrationsspezifische Dimensionen hinzugefügt.

Dem Schema der Data API wurden die Dimensionen „Primäre Channelgruppe“, „Manuelle Traffic-Quelle“ und „CM360-, DV360- und SA360-Verknüpfung“ 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 Primäre Channelgruppe – Sitzung

Dimensionen für manuelle Besucherquellen:

  • manualCampaignId ID der manuellen Kampagne

  • manualCampaignName Name der manuellen Kampagne

  • manualCreativeFormat Creative-Format (manuell)

  • manualMarketingTactic Manuelle Marketingtaktik

  • manualMedium Medium (manuell)

  • manualSource Manuelle Quelle

  • 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 – manuelles Medium

  • 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 – manuelle Quelle / Medium

  • 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 Google Display & Video 360-Verknüpfung (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 – DV360-Partner-ID

  • 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 – DV360-Partner-ID

  • sessionDv360PartnerName Sitzung – Name des DV360-Partners

  • sessionDv360Source Sitzung – DV360-Quelle

  • sessionDv360SourceMedium Sitzung – DV360-Quelle/‑Medium

Dimensionen für die Google Search Ads 360-Integration (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 Erster Nutzer – SA360-Engine-Konto-ID

  • firstUserSa360EngineAccountName Erster Nutzer – SA360-Engine-Kontoname

  • firstUserSa360EngineAccountType Erster Nutzer – SA360-Engine-Kontotyp

  • firstUserSa360KeywordText Erster Nutzer – 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 von Zielgruppen mit inaktiven Nutzern beim Zielgruppenexport.

Mit der Funktion „Zielgruppenexport“ lassen sich Zielgruppen mit inaktiven Nutzern besser exportieren. Nutzer werden ohne qualifizierendes Ereignis in diese Zielgruppen aufgenommen. Ein Beispiel: Ein Nutzer kann 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 vorgeschlagenen Zielgruppen

28.02.2024: Beim Export von Zielgruppen wird die in der Markierung angegebene Nutzer-ID zurückgegeben.

Beim Exportieren von Zielgruppen wird jetzt die in der Kennzeichnung angegebene User-ID zurückgegeben, auch wenn die von Nutzern bereitgestellten Daten für Ihre Property aktiviert sind. Wenn die Erhebung von Daten, die von Nutzern bereitgestellt werden, aktiviert ist, können diese Daten zusammen mit der User-ID im Tagging an Google Analytics gesendet werden, um die Analyse zu verbessern. Weitere Informationen

30.01.2024: Unterstützung von Webhook-Benachrichtigungen für Zielgruppenlisten und wiederkehrende Zielgruppenlisten in der Data API v1 alpha.

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: Verbesserte Kompatibilität für Dimensionen, die den Abfragestring oder die Minutenkomponente enthalten.

Dimensionen, die den Suchstring 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 verwendet werden:

Allgemeiner 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 Data API v1-Beta hinzugefügt.

Der Data API v1-Beta wurden die folgenden Methoden hinzugefügt:

28.11.2023: samplingMetadatas wurde der Antwort auf den Bericht hinzugefügt.

samplingMetadatas wurde zu ResponseMetaData hinzugefügt. Diese Sammlung enthält ein SampleMetadata für jeden Zeitraum in der Anfrage, für den die Ergebnisse hochgerechnet wurden. In Google Analytics werden Stichproben nur dann erhoben, wenn die Kardinalitätslimits voraussichtlich die Datenqualität beeinträchtigen.

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

Der Data API v1 alpha 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 Zielgruppenmitgliedschaften ändern. Mit wiederkehrenden Zielgruppenlisten haben Sie immer die aktuellsten Ergebnisse zur Zielgruppenmitgliedschaft.

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

Zielgruppen mit einer Mitgliedschaftsdauer 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 folgen Berichte, die mit der Exportfunktion für Zielgruppenlisten erstellt werden, denselben Sortierungsregeln wie die anderen Berichtsmethoden 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: Dimension isLimitedAdTracking dem Exportschema für Zielgruppenlisten hinzugefügt

15.08.2023: Dimension currencyCode und Messwert itemDiscountAmount hinzugefügt

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

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

Weitere Informationen finden Sie unter Data API reporting schema.

10.08.2023: Dimension isAdsPersonalizationAllowed zum Exportschema für Zielgruppenlisten hinzugefügt

  • isAdsPersonalizationAllowed Personalisierte Anzeigen sind 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 zu Dimensionen für Zielgruppenlisten

10.07.2023 Zielgruppenlisten

Unterstützung für Zielgruppenlisten in der Data API v1alpha hinzugefügt. Zielgruppenlisten enthalten eine Momentaufnahme der Nutzer in der Zielgruppe zum Zeitpunkt der Erstellung der Zielgruppenliste.

Der Data API v1-Alpha wurden die folgenden Methoden hinzugefügt:

19.05.2023 Benutzerdefinierte Channelgruppen

Benutzerdefinierte Channelgruppen werden jetzt von der Data API unterstützt.

11.05.2023: Änderungen am Tokenkontingent.

Das Kontingentsystem der Data API wurde aktualisiert, um genauere Abrechnungen 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 Berichtsabfragen möglich ist. Für Berichte mit großen Zeiträumen werden jedoch deutlich mehr Kontingenttokens berechnet.

Nach dieser Änderung bleibt die Gebühr für einige Anfragen zwar gleich, aber die Gebühren für komplexere Anfragen werden deutlich steigen. Anfragen für Daten, die älter als 6 Monate sind,können beispielsweise 1.000 oder mehr Kontingent-Tokens kosten.

Standard-Properties

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
Kern-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
Kern-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: 2022 und 2023.

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

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

  • yearWeek Jahr Woche Die kombinierten Werte von year und week. Beispielwerte sind 202253 und 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 „items“-Array erfasst.

  • itemLocationID Standort-ID des Artikels. Der physische Standort, der mit dem Artikel verknüpft ist, z.B. der Standort des Geschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Dieses Feld wird beim Tagging durch 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 im Tagging mit dem 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 + Abfragestring, die dem ersten Seitenaufruf einer Sitzung zugeordnet sind.

Dieses Feld ersetzt die Dimension landingPage, die veraltet ist 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 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 aus der IP-Adresse des Nutzers.

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

  • testDataFilterId Testdatenfilter-ID. 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: Anzeigenmesswerte 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 Anzahl der Anzeigenklicks und wird häufig als CPC abgekürzt.
  • advertiserAdCostPerConversion Cost-per-Conversion. Der Cost-per-Conversion entspricht den Werbekosten geteilt durch die 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 Anzeigenkosten des Werbetreibenden.

17.10.2022: Messwerte auf Artikelebene 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 bezahlt. Die Anzahl der Einheiten, die für einen einzelnen Artikel bezahlt wurden.
  • itemsClickedInList In Liste angeklickte Artikel. Die Anzahl der Einheiten, die in einer Liste für einen einzelnen Artikel angeklickt wurden.
  • itemsClickedInPromotion In Angebot angeklickte Artikel. Die Anzahl der Einheiten, die in einer Werbeaktion für einen einzelnen Artikel angeklickt wurden.
  • itemsViewed Elemente angesehen. Die Anzahl der Einheiten, die für einen einzelnen Artikel angesehen wurden.
  • itemsViewedInList In Liste angesehene Artikel. Die Anzahl der Einheiten, die in einer Liste für einen einzelnen Artikel angesehen wurden.
  • itemsViewedInPromotion In Werbeaktion angesehene Artikel. Die Anzahl der Einheiten, die in einer Werbeaktion für einen einzelnen Artikel angesehen wurden.

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

Am 1. Dezember 2022 treten die folgenden schwerwiegenden Änderungen in Kraft:

  1. Artikelbezogene Dimensionen 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 einigen 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 den Abfragestring enthalten, z. B. pagePathPlusQueryString, sind nur mit einer begrenzten Anzahl von Dimensionen und Messwerten kompatibel.

01.09.2022 Kontingentänderungen.

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

  • Der API wurde das Kontingent Tokens Per Project Per Property Per Hour hinzugefügt.

  • Für jede Anfrage wird Kontingent für Tokens Per Property Per Hour und Tokens Per Project Per Property Per Hour verbraucht.

    Weitere Informationen zu den neuen 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 Kampagnenname aus Search Ads 360, der zu dieser Sitzung geführt hat.

  • sessionSa360CreativeFormat Sitzung – SA360-Creative-Format. Der Typ des Creatives in Search Ads 360, das zu dieser Sitzung geführt hat. 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, das zu dieser Sitzung geführt hat. 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: Es wurden 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.

Messwerte für die 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 Alpha-Channel wurde die Funktion für Trichterberichte hinzugefügt.

  • Die Methode runFunnelReport wurde der v1alpha-Version 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. Die Anzeigeninhalte, über die der Nutzer gewonnen wurde. Sie wird vom Parameter utm_content übergeben.

  • firstUserManualTerm Begriff für die erste Nutzerinteraktion (manuell). Der Begriff, über den der Nutzer 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 Absturz betroffene Nutzer. Die Anzahl der Nutzer, bei denen in dieser Zeile des Berichts ein Absturz protokolliert wurde.

  • crashFreeUsersRate Anteil der nicht von Abstürzen betroffenen Nutzer.

App/Web

  • averageSessionDuration Die durchschnittliche Dauer der Nutzersitzungen in Sekunden.

  • newVsReturning Neue / wiederkehrende Nutzer.

  • screenPageViewsPerSession Aufrufe pro Sitzung

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

  • platformDeviceCategory Die Plattform und der Gerätetyp, auf denen 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 DAU / MAU. 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 / Woche. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 7 Tage sowie am letzten Tag des ausgewählten Zeitraums aktiv waren.

  • wauPerMau WAU / MAU. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 30 Tage aktiv waren und auch innerhalb der letzten 7 Tage aktiv waren.

  • purchaserConversionRate Der Prozentsatz der aktiven Nutzer, die mindestens eine 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 für die Google Ads-Kampagne, die zu dieser Sitzung geführt hat.

07.09.2021: Neue Datums-/Uhrzeitdimensionen hinzugefügt.

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

  • 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 mit Ereignisparametern gefü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 Dateiendung der heruntergeladenen Datei.

  • fileName Der Seitenpfad der heruntergeladenen Datei.

  • groupId Die ID einer Spielergruppe 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 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 Das Protokoll, der Hostname, der Seitenpfad und der Abfragestring für besuchte Webseiten.

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

  • percentScrolled Der Prozentsatz der Seite, den der Nutzer heruntergescrollt hat (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 die Inhalte sichtbar sind.

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

07.09.2021: Änderungen am API-Schema.

Änderungen an vorhandenen Dimensionen:

  • unifiedPageScreen Bei Web-Ereignissen wird mit dieser Dimension jetzt der Seitenpfad und Abfragestring zurückgegeben, für die das Ereignis protokolliert wurde.

Ankündigung bevorstehender Änderungen:

  • firstUserTrafficOrigin Die Herkunft der Zugriffe, über die der Nutzer akquiriert wurde. Verlassen Sie sich nicht darauf, dass in diesem Feld „Manuell“ für Traffic mit UTMs zurückgegeben wird. Dieses Feld wird im Rahmen der Einführung einer neuen Funktion aktualisiert und gibt dann „(not set)“ anstelle von „Manuell“ zurück.

  • sessionTrafficOrigin Gibt an, woher die Zugriffe der Kampagne stammen, die zur Sitzung geführt hat. Verlassen Sie sich nicht darauf, dass in diesem Feld „Manuell“ für Traffic mit UTMs zurückgegeben wird. Dieses Feld wird im Rahmen der Einführung einer neuen Funktion aktualisiert und gibt dann „(not set)“ anstelle von „Manuell“ zurück.

  • trafficOrigin Gibt an, woher die Zugriffe der Kampagne stammen, die zum Conversion-Ereignis geführt hat. Verlassen Sie sich nicht darauf, dass in diesem Feld „Manuell“ für Traffic mit UTMs zurückgegeben wird. Dieses Feld wird im Rahmen der Einführung einer neuen Funktion aktualisiert und gibt dann „(not set)“ anstelle von „Manuell“ zurück.

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

Mit der Methode checkCompatibility werden Dimensionen und Messwerte aufgelistet, die einer Berichtsanfrage hinzugefügt werden können, ohne die Kompatibilität zu beeinträchtigen.

21.07.2021 Änderungen bei der Echtzeitberichterstellung.

Mit dem Parameter minuteRanges der Methode runRealtimeReport können Sie jetzt die Minutenbereiche der zu lesenden Ereignisdaten angeben.

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 für 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-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.

  • 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 Betaversion der Google Analytics Data API v1 wurde veröffentlicht.

  • Der API-Endpunkt wurde zu 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, um den neuen API-Endpunkt zu verwenden.

19.02.2021: Änderungen an der Paginierung.

  • Die Standardgröße der Berichtsantwort 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 sollen, wird in RunReportRequest nicht mehr unterstützt.

  • Der Maximalwert des Felds limit wird 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 dayOfWeek, Änderungen an der Dimension week.

  • Der Wert der Dimension dayOfWeek beginnt jetzt mit 0 anstelle von 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 Datums-/Zeitdimensionen hinzugefügt.

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

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

Bei der Data API wird die Anzahl der Kontingent-Tokens, die pro Abfrage berechnet werden, 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. Die maximale Zeitspanne 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 die REST-Referenzdokumentation unter runRealtimeReport.

19.10.2020: Clientbibliotheksartefakte wurden 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 Universal-Metadaten.

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

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