Google Analytics – Alle Änderungsprotokolle der Konfigurations-API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite werden alle Änderungen an den Google Analytics Configuration APIs dokumentiert. Sie enthält Änderungsprotokolle für die Provisioning API und die Management API. Wir empfehlen API-Entwicklern, diese Liste regelmäßig auf neue Ankündigungen zu prüfen. Änderungen können Sie auch über die unten im Abschnitt Abonnieren aufgeführten Feeds abschließen.

Zugehörige Änderungsprotokolle abonnieren

Alle Änderungslogs in der Google Analytics API
–
Abonnieren rss

Umfasst alle APIs für die Erfassung, Konfiguration und Berichterstellung.

Alle Änderungslogs der Konfigurations-API
–
Abonnieren rss

Umfasst die Management API und die Provisioning API.

Einstellungen für die Aufbewahrung von Nutzerdaten in der Management API

Es ist jetzt möglich, die Einstellungen für die Aufbewahrung von Nutzerdaten mithilfe der neuen Felder „dataRetentionTtl“ und „dataRetentionResetOnNewActivity“ programmatisch zu konfigurieren, die der Ressource „WebProperty“ hinzugefügt wurden.

Dies ist die erste Version der User Deletion API:

  • Mit der User Deletion API können Google Analytics-Kunden Daten eines bestimmten Endnutzers aus einem Projekt oder einer Web-Property löschen. Anfragen zum Löschen von Nutzern können über Firebase-Projekte oder Google Analytics-Properties gestellt werden. Weitere Informationen finden Sie unter User Deletion API.

Schreibvorgänge in der Management API

Für Schreibvorgänge in der Management API (z.B. Erstellen, Aktualisieren, Löschen, Patchen) für Web-Property-, Datenansichts- (Profil-) und Zielressourcen ist keine Zulassungsliste mehr erforderlich. Das tägliche Tageslimit für alle Schreibvorgänge in der Management API beträgt 50 Schreibvorgänge pro Tag. Weitere Informationen finden Sie auf der Seite Limits und Kontingente.

Benutzerdefinierte Messwerte

Dies ist eine Version zur Fehlerkorrektur. Das Problem, das beim Erstellen eines benutzerdefinierten Messwerts vom Typ TIME aufgetreten ist, als min_value nicht festgelegt wurde, wurde behoben. Für Anfragen ohne min_value wird jetzt ein benutzerdefinierter Messwert mit dem Standardwert min_value (0) erstellt.

Währungen

Dies ist ein Release, durch das ein Teil der Währungen in der Analytics-Weboberfläche, aber nicht in der API unterstützt wurde. In dieser Version werden die folgenden Währungen unterstützt:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Weitere Informationen finden Sie in der Referenz zu Aufrufen (Profilen). – Hilfeartikel Währungen

Gesamtdatenberichte

Die Gesamtdatenberichts-API hat jetzt kein Limit von 100 Berichten pro Tag mehr. Die API verwendet dasselbe Tokensystem pro Property und pro Tag wie beim Erstellen eines Gesamtdatenberichts über die Weboberfläche.

Gesamtdatenberichte

Für Gesamtdatenberichte, auf die der aktuelle Nutzer keinen Zugriff hat, gibt es in der Management API-Antwortnachricht keinen Downloadlink mehr. Dieses Verhalten entspricht nun der UI-Dashboard-Funktion, bei der nur Berichtsinhaber den Downloadlink für das erstellte Dokument sehen können.

Datenansichten (Profile)

In diesem Release wird die botFilteringEnabled-Property der Ansichtsressource (Profil) hinzugefügt. Diese Property gibt an, ob die Bot-Filterung für eine Datenansicht (Profil) aktiviert ist. Weitere Informationen finden Sie in der Referenzdokumentation zu (Profile).

Gesamtdatenberichte

In dieser Version wird die Methode delete zu Gesamtdatenberichten hinzugefügt. Weitere Informationen finden Sie in der Dokumentation zum Löschen von Gesamtdatenberichten.

Segmente

Dies ist ein Release zur Fehlerkorrektur. In dieser Version wurde ein Problem behoben, durch das Segmente mit Währungswerten in der Definition beim Aufrufen der Methode „Segmentliste“ falsch angezeigt wurden.

Segmente

Dies ist ein Release zur Fehlerkorrektur. In dieser Version wurde ein Problem behoben, bei dem Nutzer mit privaten Segmenten, die an mehrere Datenansichten (Profile) angepinnt waren, beim Aufrufen der Methode der Segmentliste die Fehlermeldung 500 erhalten.

In diesem Release wird der TOS API-URL der Nutzerverwaltung API ein zusätzlicher Parameter hinzugefügt:

  • Mit dem URL-Parameter provisioningSignup=false wird ein Problem behoben, das beim Bereitstellen eines Google Analytics-Kontos für einen Nutzer ohne Google Analytics-Konten auftritt. Entwickler sollten ihren Code aktualisieren, um diesen Parameter der TOS-URL hinzuzufügen.

Batching

In dieser Version haben wir zusätzlich zur allgemeinen Batch-Unterstützung spezielle Unterstützung für die User permissions API hinzugefügt. Bei Anfragen im Batch mit Nutzerberechtigungen kommt es zu erheblichen Leistungssteigerungen und einer geringeren Kontingentnutzung.

Datenansichten (Profile)

Ab dieser Version wird die Property currency der Datenansicht (Profil) standardmäßig auf USD gesetzt, sofern sie nicht während eines insert-Vorgangs festgelegt wird. Für get- und list-Vorgänge wird außerdem USD für Aufrufe (Profile) zurückgegeben, die zuvor ohne currency-Property erstellt wurden.

Filter

In diesem Release werden die veralteten Filterfelder IS_MOBILE und IS_TABLET endgültig entfernt, die durch DEVICE_CATEGORY=mobile und DEVICE_CATEGORY=tablet ersetzt werden sollten. Bei Einfügen-, Aktualisierungs- und Patchanfragen, bei denen die Filterfelder auf IS_MOBILE und IS_TABLET festgelegt sind, wird ein Fehler zurückgegeben.

Filter

In dieser Version wird die Verwendung einer benutzerdefinierten Dimension für ein Filterfeld unterstützt. Dabei wird allen Abschnitten mit Filterdetails die Property fieldIndex hinzugefügt. Es ist jetzt beispielsweise möglich, den Filterausdruck mit einem "field": "CUSTOM_DIMENSION" und einem "fieldIndex": "1" festzulegen, damit der Filter bei der ersten benutzerdefinierten Dimension funktioniert.

Zielvorhaben

In diesem Release wurde auch ein Problem behoben, bei dem beim Erstellen eines Zielvorhabens mit "comparisonValue": "0" ein Fehler aufgetreten war.

In dieser Version werden die Ressource dailyUpload endgültig eingestellt und entfernt. Die Ressource dailyUpload wurde am 20. Juni 2014 offiziell eingestellt. Der Import aller Kostendaten sollte nun mithilfe der Upload-Ressource erfolgen.

In diesem Release werden der Management API zwei neue Sammlungen hinzugefügt: benutzerdefinierte Dimensionen und Messwerte.

Benutzerdefinierte Dimensionen und Messwerte

Mit der Management API können jetzt benutzerdefinierte Dimensionen und Messwerte erstellt, aufgelistet, abgerufen, gepatcht und aktualisiert werden.

Die Antwort der Methode list für alle Sammlungen enthält jetzt eine leere Liste für die Property items, wenn die Sammlung keine Ressourcen enthält. Bisher wurde die Property items in der Antwort weggelassen. Ausführliche Informationen zu Abfragen und Antworten für Google Analytics-Konfigurationsdaten finden Sie in der API-Referenz.

Fehlerkorrekturen

In diesem Release wird ein neuer Bereich für die Google Analytics Management API eingeführt. - analytics.manage.users.readonly – Nutzerberechtigungen für Google Analytics aufrufen

Das neue Feld DEVICE_CATEGORY filter wurde hinzugefügt und IS_MOBILE und IS_TABLET wurden verworfen. Verwende DEVICE_CATEGORY=mobile und DEVICE_CATEGORY=tablet.

Die Ressource Datenansicht (Profil) enthält jetzt die Property enhancedECommerceTracking, die angibt, ob erweiterte E-Commerce-Berichte aktiviert (true) oder deaktiviert (false) sind.

In diesem Release sind neue Datenimporttypen und die Einstellung der Ressource dailyUpload enthalten.

Datenimport

Im Entwicklerleitfaden zum Datenimport erfahren Sie, wie Sie mit der Management API Daten in Ihr Google Analytics-Konto importieren können.

Uploads

  • Die Ressource upload unterstützt jetzt die folgenden Uploadtypen:
    • Kampagnendaten
    • Inhaltsdaten
    • Kostendaten
    • Produktdaten
    • Daten zu Erstattungen
    • Nutzerdaten
  • Die Ressource upload hat eine neue migrateDataImport-Methode, um vorhandene Kostendaten customDataSources zu migrieren.

Einstellung der täglichen Uploads

  • Die Ressource dailyUpload wurde verworfen. Weitere Informationen zur Migration und Nutzung des Datenimports finden Sie im Migrationsleitfaden.
  • Die Ressource dailyUpload ist noch sechs Monate lang verfügbar. Danach werden alle verbleibenden customDataSources mit uploadType-Attribut, die auf analytics#dailyUploads festgelegt ist, automatisch migriert und funktionieren nur mit der Ressource upload.
  • Aktuelle Nutzer der Ressource dailyUpload sollten ihren Code aktualisieren und so bald wie möglich migrieren, um die Upload-Ressource zu verwenden.

Dies ist der erste Release der Nutzerverwaltungs-API:

  • Mit der Provisioning API können programmatisch neue Google Analytics-Konten erstellt werden. Diese API ist nur auf Einladung verfügbar und für qualifizierte Dienstleister und große Partner bestimmt. Weitere Informationen finden Sie in der Übersicht über die Provisioning API.

In diesem Release werden zwei neue Konfigurations-APIs hinzugefügt.

  • Mit AdWords-Verknüpfungen in der Management API können Sie Verknüpfungen zwischen Google AdWords-Konten und Google Analytics-Properties erstellen, auflisten, abrufen, aktualisieren, korrigieren und löschen sowie festlegen, welche Datenansichten (Profile) mit AdWords-Daten verknüpft werden.

Filter

Gesamtdatenberichte: Management API

Der Management API wird eine neue Ressource mit dem Namen Gesamtdatenberichte hinzugefügt. Gesamtdatenberichte sind Google Analytics-Berichte, die mit Gesamtdaten erstellt wurden.Gesamtdatenberichte sind derzeit nur für GA Premium-Nutzer verfügbar. 

Segmente: Management API Version 2.4 &v3.0

An der Segmenterfassung wurden folgende Änderungen vorgenommen:

  • Nutzer- und Sequenzsegmente werden jetzt in der API unterstützt.
  • In der Segmentsammlung werden jetzt alle integrierten und benutzerdefinierten Segmente auf Sitzungsebene und Nutzerebene zurückgegeben.
  • Für die definition-Property für Segmente wird jetzt die neue Segmentsyntax verwendet. Dazu gehören auch Definitionen für bestehende Segmente auf Sitzungsebene, die von „definition: ""“ in „definition: "sessions::condition::"“ geändert werden.
  • Eine neue type-Property wurde der Ressource Segment hinzugefügt, um anzugeben, ob ein Segment CUSTOM ist (d.h. von einem Nutzer in der Weboberfläche erstellt wurde) oder BUILT_IN (d.h. von Google Analytics bereitgestellt).

Tests

Die folgenden AdSense-Messwerte können jetzt als Optimierungsziele verwendet werden:

  • ga:adsenseAdsClicks: Gibt an, wie oft AdSense-Anzeigen auf Ihrer Website angeklickt wurden.
  • ga:adsenseAdsViewed: Die Anzahl der aufgerufenen AdSense-Anzeigen. In einem Anzeigenblock können mehrere Anzeigen ausgeliefert werden.
  • ga:adsenseRevenue: Der Gesamtumsatz aus AdSense-Anzeigen.

Sammlung neuer Kontozusammenfassungen

  • Die Sammlung AccountSummaries wurde der Management API hinzugefügt. Er enthält eine Zusammenfassung der Informationen zu jedem Konto, jeder Property und jeder Datenansicht (Profil), auf das ein autorisierter Nutzer mit einer einzigen und schnellen Anfrage Zugriff hat. Weitere Informationen finden Sie im Entwicklerleitfaden zu Konten.

Aufgrund der Einstellung der Dimensionen ga:isMobile und ga:isTablet wurden an den Standardsegmenten die folgenden Änderungen vorgenommen:

  • Das Segment "gaid::-11" wurde von Mobile Zugriffe in Mobile Zugriffe und Tablets umbenannt. Die Definition für dieses Segment wurde von „ga:isMobile==Yes“ in „ga:deviceCategory==mobile,ga:deviceCategory==tablet“ geändert. Beachte, dass ga:isMobile Tablet-Traffic umfasst hat, was sich in der neuen Definition widerspiegelt. Wenn Sie nur Zugriffe über Mobilgeräte erfassen möchten, wechseln Sie zum neuen Segment Zugriffe über Mobilgeräte (gaid::-14).
  • Die Definition des Segments gaid::-13 wurde von ga:isTablet==Yes zu ga:deviceCategory==tablet geändert. Dies entspricht weiterhin Tablet-Traffic.
  • Segment gaid::-14 wurde hinzugefügt. Der Name des Segments lautet Mobile Zugriffe und die Definition lautet ga:deviceCategory==mobile.

Fehlerkorrekturen:

  • Die Zeitzoneninformationen für Datenansichten (Profile) wurden korrigiert. Details: Vor dieser Korrektur wurden in bestimmten Fällen bei der Listenansicht (Profile) in der Management API falsche Zeitzoneninformationen für eine Ansicht (Profil) zurückgegeben. Die Zeitzoneninformationen für Datenansichten (Profile) stimmen jetzt mit den Einstellungen in der Google Analytics-Benutzeroberfläche für Administratoren überein.

In diesem Release werden Schreibvorgänge für Web-Property-, Datenansichts- (Profil) und Zielressourcen sowie eine Gruppe von drei neuen Ressourcen eingeführt, die die Verwaltung von Nutzerberechtigungen ermöglichen.

APIs zur Kontoeinrichtung und Konfiguration

Nutzerberechtigungen in der Management API

Im Rahmen der Einführung neuer Segmente führen wir die folgenden Änderungen an der Sammlung von Segmenten ein:

  • Alle Segment-IDs werden von positiven Ganzzahlen zu alphanumerischen Strings geändert. Falls Sie die Segment-IDs der Nutzer gespeichert haben, sollten Sie sie aktualisieren, um die neuen IDs zu verwenden.
  • Bei der Segmenterfassung werden nur die vorhandenen Segmente auf Besuchsebene zurückgegeben. Die neuen Besucher-, Kohorten- und Sequenzsegmente werden in der API derzeit nicht unterstützt.
  • In den Segmenten werden weiterhin die vorhandenen Standardsegmente mit denselben negativen numerischen IDs zurückgegeben. Die neuen Standardsegmente werden derzeit jedoch nicht unterstützt.

In dieser Version werden der Web-Property zwei neue Properties hinzugefügt:

  • profileCount: Gibt die Profilzahl für eine Property zurück. So können Sie Attribute ohne Profile filtern (d.h. profileCount = 0).
  • industryVertical: Gibt die Branche/Kategorie zurück, die für eine Property ausgewählt ist.

Fehlerkorrekturen:

  • Die eCommerceTracking-Property der Profilressource entspricht jetzt den E-Commerce-Einstellungen im Bereich „Admin“ der Weboberfläche. Gibt true zurück, wenn E-Commerce-Tracking aktiviert ist. Andernfalls wird false zurückgegeben.
  • Die Web-Property-Ressource enthält jetzt eine level-Property, die angibt, ob die Web-Property PREMIUM oder STANDARD ist.
  • Der Management API Version 3 wurde ein neuer Endpunkt hinzugefügt, über den Sie auf Testressourcen zugreifen und diese ändern können.
  • Die Profilressource enthält jetzt die Property type, mit der angegeben wird, ob ein Profil für eine Website oder App konfiguriert ist. Folgende Werte sind möglich: WEB oder APP.

In dieser Version werden der Management API hilfreiche Fehlerantworten hinzugefügt.

  • Im Text der API-Fehlerantworten wurden neue Fehlercodes, Ursachen und Beschreibungen hinzugefügt. Alle Codes für die beiden Versionen Version 2.4 und Version 3.0 der Management API sind dokumentiert.

In dieser Version werden Daten hinzugefügt, vorhandene Funktionen geändert und ein Fehler behoben.

Neue Daten

Änderungen

  • Der Datentyp für max-results wurde zu integer geändert.

  • Der Standardwert und der Maximalwert für max-results wurden in 1.000 geändert.

Fehlerkorrekturen

  • Konten, Web-Properties und Profile für Tests mit dem Google Website-Optimierungstool sind nicht mehr in den entsprechenden Sammlungen enthalten.

In diesem Release werden zwei neue Versionen der API mit vielen neuen Funktionen hinzugefügt. Die alte Version wird eingestellt. Die Änderungen wirken sich darauf aus, wie Sie Daten von der API anfordern und verarbeiten.

Version 3.0

  • Dies ist die aktuelle Hauptversion unserer API. Sie ist nicht abwärtskompatibel. Die zukünftige Entwicklung der API erfolgt mit dieser Version.

  • Neue Daten

    • Vollständige Darstellung der Zielvorhaben vom Typ „Ereignis“
    • Eine interne Web-Property-ID, die für Deeplinks zur Google Analytics-Benutzeroberfläche verwendet werden kann
    • Profilkonfigurationen für die standardmäßigen Suchparameter der Seite und der Website

  • Änderungen

Version 2.4

  • Dies ist eine Nebenversionsaktualisierung, die zum Großteil abwärtskompatibel mit der bestehenden Version 2.3 ist.

  • Änderungen

    • Neue Kontingentrichtlinie
    • Einbindung in die Google APIs-Konsole, um den API-Zugriff zu verwalten und ein höheres Kontingent anzufordern
    • Kontinuierliche Unterstützung für vorhandene Autorisierungsmechanismen und OAuth 2.0
    • Neue URL für Anfragen: https://www.googleapis.com/analytics/v2.4/management/…
    • Antworten nur in XML
    • Keine Unterstützung für die Google Data JavaScript-Clientbibliothek
    • XML-Ausgabe in Übereinstimmung mit Version 2.3, sodass die anderen vorhandenen Google Data-Clientbibliotheken weiterhin funktionieren

Einstellung

  • Wir kündigen die Einstellung der alten Version 2.3 der Management API an. Sie funktionieren noch zwei Monate lang. Danach wird bei allen Anfragen aus Version 2.3 eine Antwort von Version 2.4 zurückgegeben.

Dies ist die Betaversion der Google Analytics Management API.

Neue Feeds

Aktualisierte Clientbibliotheken

  • Die Management API wird in derselben Bibliothek wie die Google Analytics-API für den Datenexport veröffentlicht. Sowohl die Java- als auch die JavaScript-Bibliotheken von Google Data wurden aktualisiert. Auf jeden Feed kann durch Angabe des entsprechenden Feed-URI für die Methode getManagementFeed() der Bibliotheken zugegriffen werden.

Neue Dokumentation

  • In einem neuen Abschnitt der Google Analytics-Entwicklerdokumentation wurde die Funktionsweise der neuen Management API beschrieben.