Änderungslog

Offizielle Ankündigungen zur Google Analytics API erhalten Sie, wenn Sie der Google Analytics API-Benachrichtigungsgruppe beitreten.

2024-10-20 Der Dimensionsfiltertyp EmptyFilter wurde hinzugefügt.

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

2024-10-15 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 haben Google Analytics 360-Properties Zugriff auf höhere Stichprobenlimits von 1 Milliarde Ereignissen. Außerdem können die Stichprobenlimits auf UNSAMPLED gesetzt werden, um für eine große Anzahl von Ereignissen nicht gestempelte Ergebnisse zu erhalten.

18.09.2024: Die Funktion „Snapshot für Property-Kontingente“ wurde hinzugefügt.

Mit der Methode properties.getPropertyQuotasSnapshot können Sie einen aktuellen Snapshot aller Unterkunftsquoten für eine bestimmte Unterkunft abrufen, die nach Quotenkategorie sortiert sind.

28.06.2024 Das Kontingent „Clientfehler pro Projekt und Property“ wurde hinzugefügt.

Pro Projekt und Property sind jetzt maximal 10.000 API-Serverfehler innerhalb eines 15-minütigen Zeitraums 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-minütige Zeitfenster abgelaufen ist.

14.05.2024 Die Funktion „Vergleiche“ wurde 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. Wenn dieses Feld 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 in eine Anfrage einfügen, oder einen gespeicherten Vergleich verwenden, indem Sie den Ressourcennamen des Vergleichs im Feld comparison angeben.

Die Methode getMetadata wurde aktualisiert, sodass im Antwortfeld comparisons alle gespeicherten Vergleiche aufgeführt werden, die für eine Property verfügbar sind.

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

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

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

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

Der Data API v1alpha wurden die folgenden Methoden zur Manipulation von Berichtsaufgaben hinzugefügt:

06.05.2024: Neue Dimensionen für Schlüsselereignisse

Dimensionen und Messwerte für wichtige Ereignisse sind jetzt verfügbar.

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

Ersetzen Sie in allen Berichtsanfragen, in denen ein eingestellter Messwert aus der folgenden Tabelle verwendet wird, diesen durch den Messwert „Schlüsselereignisse“.

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

Nehmen Sie ähnliche Änderungen an der Verwendung 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 Dimensionen und Messwerten für Schlüsselereignisse in DimensionMetadata- und MetricMetadata-Objekten wider:

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

25.03.2024: Die primäre Channelgruppe sowie Dimensionen für manuelle Besucherquellen und Integrationen wurden hinzugefügt.

Dem Schema der Data API wurden Dimensionen für die primäre Channelgruppe, die manuelle Besucherquelle sowie CM360-, DV360- und SA360-Integrationen hinzugefügt.

Zielgruppendimensionen:

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

Dimensionen für primäre Channelgruppe

  • firstUserPrimaryChannelGroup Erste Nutzerinteraktion – primäre Channelgruppe

  • primaryChannelGroup Primäre Channelgruppe

  • sessionPrimaryChannelGroup Primäre Channelgruppe der Sitzung

Manuelle Dimensionen für 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 Manuelle Quelle / Medium

  • manualSourcePlatform Manuelle Quellplattform

  • firstUserManualCampaignId Kampagnen-ID (manuell) für die erste Nutzerinteraktion

  • firstUserManualCampaignName Kampagnenname (manuell) für die erste Nutzerinteraktion

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

  • 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 CM360-Konto-ID des ersten Nutzers

  • firstUserCm360AccountName Name des CM360-Kontos des ersten Nutzers

  • 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 CM360-Creative-ID des ersten Nutzers

  • firstUserCm360CreativeName Erste Nutzerinteraktion – CM360-Creative-Name

  • firstUserCm360CreativeType Erste Nutzerinteraktion – CM360-Creative-Typ

  • firstUserCm360CreativeTypeId CM360-Creative-Typ-ID der ersten Nutzerinteraktion

  • 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 Name des DV360-Partners für die erste Nutzerinteraktion

  • 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-Verknüpfung (SA360):

  • firstUserSa360AdGroupId Erste Nutzerinteraktion – SA360-Anzeigengruppen-ID

  • firstUserSa360AdGroupName Name der SA360-Anzeigengruppe für die erste Nutzerinteraktion

  • firstUserSa360CampaignId Erste Nutzerinteraktion – SA360-Kampagnen-ID

  • firstUserSa360CampaignName Erster Nutzer – SA360-Kampagne

  • firstUserSa360CreativeFormat Erster Nutzer – SA360-Creative-Format

  • firstUserSa360EngineAccountId SA360-Engine-Konto-ID des ersten Nutzers

  • firstUserSa360EngineAccountName Name des SA360-Engine-Kontos des ersten Nutzers

  • firstUserSa360EngineAccountType Erster Nutzer – SA360-Engine-Kontotyp

  • firstUserSa360KeywordText Keyword-Text für erste Nutzerinteraktion – SA360

  • firstUserSa360ManagerAccountId SA360-Verwaltungskonto-ID des ersten Nutzers

  • firstUserSa360ManagerAccountName Name des SA360-Verwaltungskontos des ersten Nutzers

  • firstUserSa360Medium Erster Nutzer – SA360-Medium

  • firstUserSa360Query Erster Nutzer – 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.

Mit der Funktion „Zielgruppenexport“ können Zielgruppen mit inaktiven Nutzern besser exportiert werden. Nutzer werden diesen Zielgruppen ohne ein auslösendes Ereignis zugewiesen. So kann ein Nutzer beispielsweise 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.

2024-02-28: Zielgruppenauszüge geben die im Tagging angegebene Nutzer-ID zurück.

In Zielgruppenexporten wird jetzt die im Tagging angegebene Nutzer-ID zurückgegeben, auch wenn die Erhebung der von Nutzern bereitgestellten Daten für Ihre Property aktiviert ist. Wenn die Erhebung der von Nutzern bereitgestellten Daten aktiviert ist, können diese 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. Januar 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 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 weiteren Feldern kompatibel, darunter sessionSource, browser, city und landingPage.

Dimensionen mit der Minutenkomponente sind jetzt mit den meisten Feldern kompatibel. Dimensionen wie minute, nthMinute und dateHourMinute sind jetzt mit einer ähnlichen Reihe von zusätzlichen Feldern kompatibel.

Im GA4 Dimensions & Metrics Explorer finden Sie umfassende Informationen zur Kompatibilität.

2023-12-13 Benutzerdefinierte Parameter auf Artikelebene

Benutzerdefinierte Dimensionen auf Artikelebene können jetzt mit der folgenden Syntax in Analytics Data API-Abfragen eingeschlossen 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 Data API v1 Beta hinzugefügt.

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

2023-11-28 samplingMetadatas wurde der Antwort hinzugefügt.

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

28.11.2023: Die Data API v1 Alpha unterstützt jetzt den Export wiederkehrender Zielgruppenlisten.

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 Zielgruppenzusammensetzung ändert. Mit wiederkehrenden Zielgruppenlisten können Sie immer auf die neuesten Ergebnisse zur Zielgruppenzugehörigkeit zugreifen.

2023-11-08 Die Data API v1 Alpha unterstützt jetzt den Export von Zielgruppenlisten in Google Tabellen.

Die Data API v1 Alpha bietet jetzt die Methode properties.audienceLists.exportSheet, mit der Sie eine Zielgruppenliste in Google Tabellen exportieren können.

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

Zielgruppen mit einer Zugehörigkeitsdauer von einem Tag werden jetzt von der Exportfunktion für Zielgruppenlisten unterstützt.

2023-09-12 Standardsortierungsregeln für Zielgruppenlisten

Für Berichte, die mit der Exportfunktion für Zielgruppenlisten erstellt wurden, gelten standardmäßig dieselben Sortierreihenfolgen wie für die anderen Berichtsmethoden der Data API: Die Sortierung erfolgt absteigend nach der ersten Spalte, dann 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 Die 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: Die Dimension currencyCode und der Messwert itemDiscountAmount wurden hinzugefügt.

  • currencyCode Der Code der Landeswährung (gemäß ISO 4217) des E-Commerce-Ereignisses. 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 im Berichtsschema der Data API.

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

  • isAdsPersonalizationAllowed Ist personalisierte Werbung 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.

2023-07-10 Zielgruppenlisten

Die Data API v1alpha unterstützt jetzt Zielgruppenlisten. Zielgruppenlisten enthalten einen Snapshot der Nutzer in der Zielgruppe zum Zeitpunkt der Erstellung der Zielgruppenliste.

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

2023-05-19 Benutzerdefinierte Channelgruppen

Die Data API unterstützt jetzt benutzerdefinierte Channelgruppen.

11. Mai 2023: Änderungen am Tokenkontingent.

Das Kontingentsystem der Data API wurde aktualisiert, um genauere Abrechnungen zu ermöglichen.

Die Anzahl der für jede Anfrage in Rechnung gestellten Tokens wurde entsprechend der Kontingentänderung aktualisiert und so neu verteilt, dass eine größere Anzahl einfacher Berichtsanfragen möglich ist. Für große Datenberichte werden jedoch deutlich mehr Kontingenttokens in Rechnung gestellt.

Nach dieser Änderung bleiben die Kosten für einige Anfragen gleich, für komplexere Abfragen steigen sie jedoch deutlich an. Anfragen für Daten aus mehr als 6 Monaten können beispielsweise 1.000 oder mehr Kontingent-Tokens kosten.

Standardeigenschaften

Kontingentname Altes Limit Neues Limit
Haupt-Tokens pro Property und Tag 25.000 200.000
Kern-Tokens pro Property und Stunde 5.000 40.000
Core-Tokens pro Projekt und Property und Stunde 1750 14.000
Realtime Tokens Per Property Per Day 25.000 200.000
Echtzeit-Tokens pro Property und Stunde 5.000 40.000
Echtzeit-Tokens pro Projekt und Property pro 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 und Property pro Stunde 1750 14.000

Analytics 360-Properties

Kontingentname Altes Limit Neues Limit
Haupt-Tokens pro Property und Tag 250.000 2.000.000
Kern-Tokens pro Property und Stunde 50.000 400.000
Core-Tokens pro Projekt und Property und Stunde 17.500 140.000
Realtime Tokens Per Property Per Day 250.000 2.000.000
Echtzeit-Tokens pro Property und Stunde 50.000 400.000
Echtzeit-Tokens pro Projekt und Property pro 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 und Property pro Stunde 17.500 140.000

2. März 2023: Datumsdimensionen wurden 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. Beispiele für Werte 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. Beispiele für Werte: 2022 und 2023.

  • isoYearIsoWeek ISO-Woche des ISO-Jahres. Die kombinierten Werte von isoWeek und isoYear. Beispiele für Werte: 201652 und 201701.

  • yearMonth Jahr Monat. Die kombinierten Werte von year und month. Beispiele für Werte sind 202212 und 202301.

  • yearWeek Jahr Woche. Die kombinierten Werte von year und week. Beispiele für Werte sind 202253 und 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 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. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Dieses Feld wird beim Tagging mit dem Parameter „location_id“ im „items“-Array ausgefüllt.

  • itemPromotionCreativeSlot Creative-Fläche für Artikelwerbung. Der Name der Creative-Fläche für die Werbung, die mit dem Artikel verknüpft ist. Diese Dimension kann beim 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 und Abfragestring Der Seitenpfad + Abfragestring, die dem ersten Seitenaufruf einer Sitzung zugeordnet sind.

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

28. Januar 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.

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. Oktober 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 ist der Betrag, der für Anzeigen anfällt, geteilt durch die Anzahl der Anzeigenklicks. Er wird oft mit CPC abgekürzt.
  • advertiserAdCostPerConversion Cost-per-Conversion. Der Cost-per-Conversion ergibt sich, wenn die Anzeigenkosten durch die Conversions geteilt werden.
  • advertiserAdImpressions Anzeigenimpressionen. Die Gesamtzahl der Impressionen.
  • returnOnAdSpend ROAS (Return on Advertising Spend) Der ROAS (Return on Advertising Spend) ist der 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 Artikel, die dem Einkaufswagen für einen einzelnen Artikel hinzugefügt wurden.
  • itemsCheckedOut Ausgeliehene Artikel Die Anzahl der Artikel, die für einen einzelnen Artikel bezahlt wurden.
  • itemsClickedInList In Liste angeklickte Artikel. Die Anzahl der Artikel, auf die in einer Liste für einen einzelnen Artikel geklickt wurde.
  • itemsClickedInPromotion In Angebot angeklickte Artikel. Die Anzahl der Artikel, auf die in einer Werbeaktion für einen einzelnen Artikel geklickt wurde.
  • itemsViewed Angesehene Artikel Die Anzahl der angesehenen Artikel.
  • itemsViewedInList In Liste angesehene Artikel. Die Anzahl der Artikel, die sich ein Nutzer in der Liste für einen einzelnen Artikel angesehen hat.
  • itemsViewedInPromotion In Werbeaktion angesehene Artikel. Die Anzahl der Artikel, die sich ein Nutzer in einer Werbeaktion für einen einzelnen Artikel angesehen hat.

13. September 2022: Ankündigung von Änderungen an der Schemakompatibilität.

Am 1. Dezember 2022 treten die folgenden Ä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, nutzerbasierten Messwerten wie activeUsers und sitzungsbasierten Messwerten wie sessions kompatibel.

  2. Attributionsdimensionen wie source sind nicht mehr mit einigen Messwerten auf Ereignisebene wie eventCount kompatibel. Attributionsdimensionen sind weiterhin mit atribierbaren 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.

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

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 ein Kontingent von Tokens Per Project Per Property Per Hour hinzugefügt.

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

    Ausführliche Informationen zu den 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 in Search Ads 360, über die diese Sitzung aufgerufen wurde.

  • 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 SA360-Engine-Konto-ID der Sitzung. Die ID des Engine-Kontos in SA360, das zu dieser Sitzung geführt hat.

  • sessionSa360EngineAccountName Name des SA360-Engine-Kontos der Sitzung. 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 diese Sitzung aufgerufen wurde. 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 aus Search Ads 360, die zu dieser Sitzung geführt hat.

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

  • Die Dimensionen sessionCampaignId und sessionCampaignName werden jetzt für Search Ads 360-Kampagnen unterstützt.

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

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

  • 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: Es wurden neue Dimensionen hinzugefügt.

Manueller Begriff und Inhalt

  • firstUserManualAdContent Erste Nutzerinteraktion – manueller Anzeigeninhalt. Die Anzeigeninhalte, über die der Nutzer gewonnen wurde. Wird vom Parameter utm_content übergeben.

  • firstUserManualTerm Manueller Begriff für die erste Nutzerinteraktion. Der Begriff, über den der Nutzer akquiriert wurde. Wird vom Parameter utm_term übergeben.

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

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

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

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

Absturzanalyse

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

  • 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 Landingpage. 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 DAU / MAU. Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 30 Tage sowie am letzten Tag des ausgewählten Zeitraums aktiv waren.

  • dauPerWau Täglich aktive / wöchentlich aktive Nutzer Der gleitende Prozentsatz der Nutzer, die innerhalb der letzten 7 Tage sowie am letzten Tag des ausgewählten Zeitraums aktiv waren.

  • wauPerMau Wöchentlich aktive / monatlich aktive Nutzer 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 der Google Ads-Kampagne, die zu dieser Sitzung geführt hat.

07.09.2021: Es wurden neue Datum/Uhrzeit-Dimensionen 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 aus Ereignisparametern stammen.

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

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

  • fileExtension Die Endung 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 „wahr“ 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 verweisende URL, einschließlich Hostnamen und Pfad.

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

  • searchTerm Der vom Nutzer eingegebene Suchbegriff.

  • 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), auf dem bzw. der das Ereignis erfasst wurde.

2021-09-07 API-Schemaänderungen

Änderungen an vorhandenen Dimensionen:

  • unifiedPageScreen Bei webgenerierten Ereignissen gibt diese Dimension jetzt den Seitenpfad und den Abfragestring zurück, unter dem das Ereignis protokolliert wurde.

Ankündigung bevorstehender Änderungen:

  • firstUserTrafficOrigin Die Besucherquelle, über die der Nutzer akquiriert wurde. Bei Zugriffen mit UTMs wird dieses Feld nicht mehr als „Manuell“ zurückgegeben. Bei einer bevorstehenden Funktionseinführung wird es stattdessen den Wert „(nicht festgelegt)“ zurückgeben.

  • sessionTrafficOrigin Herkunft der Zugriffe der Kampagne, zu der die Sitzung gehört. Bei Zugriffen mit UTMs wird dieses Feld nicht mehr als „Manuell“ zurückgegeben. Bei einer bevorstehenden Funktionseinführung wird es stattdessen den Wert „(nicht festgelegt)“ zurückgeben.

  • trafficOrigin Herkunft der Zugriffe der Kampagne, die zum Conversion-Ereignis geführt hat. Bei Zugriffen mit UTMs wird dieses Feld nicht mehr als „Manuell“ zurückgegeben. Bei einer bevorstehenden Funktionseinführung wird es stattdessen den Wert „(nicht festgelegt)“ zurückgeben.

2021-09-07 Die checkCompatibility-Methode wurde der API hinzugefügt.

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

21. Juli 2021: Änderungen bei Echtzeitberichten.

Mit dem Parameter minuteRanges der Methode runRealtimeReport können Sie jetzt die Minutenbereiche der Ereignisdaten angeben, die gelesen werden sollen.

21. Juli 2021: Neue Dimensionen für Channelgruppierungen.

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

  • firstUserDefaultChannelGrouping Standard-Channelgruppierung für die erste Nutzerinteraktion.

  • defaultChannelGrouping Standard-Channelgruppierung.

10. Juni 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 vergangen sind, seit ein Ereignis erfasst wurde. „00“ steht für die aktuelle Minute und „01“ für 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 gewonnen wurde.

09.04.2021: Die Betaversion der Google Analytics Data API v1 wurde veröffentlicht.

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

  • Bei den Methoden runReport, runPivotReport, batchRunReports und batchRunPivotReports wird die ID einer Google Analytics 4-Property jetzt im Parameter property des URL-Pfads statt im Feld entity eines Anfrage-Bodys akzeptiert:

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

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

19. Februar 2021: Änderungen an der Paginierung.

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

  • Der Wert „"limit" : -1“, der einen Versuch zum Abrufen aller Zeilen angab, 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: Es wurden neue Kampagnendimensionen hinzugefügt.

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

2021-02-08 Änderungen an den Dimensionen dayOfWeek und 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. Januar 2021: Es wurden Aggregationsvarianten für benutzerdefinierte Messwerte hinzugefügt.

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

28. Januar 2021: Es wurden neue Datum/Uhrzeit-Dimensionen hinzugefügt.

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

28. Januar 2021: Die Anzahl der pro Abfrage in Rechnung gestellten Kontingent-Tokens wurde für die Data API reduziert.

Die Anzahl der pro Abfrage in Rechnung gestellten Kontingent-Tokens wurde in der Data API reduziert. Die Kontingentlimits für Kontingenttokens pro Stunde und pro Tag wurden nicht geändert.

2020-11-09 Die Methode getUniversalMetadata wurde gelöscht.

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

2. November 2020: Es wurde eine Methode für Echtzeitberichte hinzugefügt.

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

19.10.2020 Clientbibliotheks-Artefakte wurden aktualisiert.

Clientbibliotheksartefakte wurden zusammen mit einer Anleitung zur Verwendung und Codebeispielen aktualisiert.

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

2020-10-08 getMetadata-Methode zur API hinzugefügt.

Die Methode getMetadata gibt die für die angegebene GA4-Property-ID verfügbaren benutzerdefinierten Dimensionen und Messwerte sowie universelle Metadaten zurück.

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

Informationen zu benutzerdefinierten Dimensionen und Messwerten finden Sie in der API-Schemadokumentation. Diese Aktualisierung umfasst benutzerdefinierte Dimensionen und Messwerte auf Ereignisebene sowie benutzerdefinierte Dimensionen auf Nutzerebene.