Google Analytics Management API-Änderungsprotokoll

Wir aktualisieren die Google Analytics Management API regelmäßig, um neue Funktionen bereitzustellen und Fehler zu beheben, die in früheren Versionen festgestellt wurden. In den meisten Fällen sind diese Änderungen für API-Entwickler transparent. Gelegentlich müssen wir jedoch Änderungen vornehmen, sodass Entwickler ihre vorhandenen Anwendungen anpassen müssen.

Auf dieser Seite werden alle an der Google Analytics Management API vorgenommenen Änderungen dokumentiert, die sich auf Ihre Anwendung auswirken könnten. Wir empfehlen API-Entwicklern, diese Liste regelmäßig auf neue Ankündigungen zu prüfen. Sie können Änderungen auch über die unten im Abschnitt Abonnieren aufgeführten Feeds abonnieren.

Zugehörige Änderungsprotokolle abonnieren

Alle Google Analytics API-Änderungsprotokolle
–
Abo rss

Umfasst alle Collection-, Konfigurations- und Reporting APIs.

Alle Configuration API-Änderungslogs
–
Abo rss

Umfasst Management API und Provisioning API.

Änderungslog der Management API
–
Abo rss

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

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

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 müssen nicht mehr auf die Zulassungsliste gesetzt werden. Das standardmäßige 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, durch die das Problem behoben wurde, bei dem ein benutzerdefinierter Messwert vom Typ TIME nicht erstellt werden konnte, wenn min_value nicht festgelegt war. Bei Anfragen ohne min_value wird jetzt ein benutzerdefinierter Messwert mit dem Standard-min_value von 0 erstellt.

Währungen

Dies ist eine Version zur Fehlerkorrektur, durch die ein Problem behoben wurde, bei dem einige Währungen in der Analytics-Weboberfläche, aber nicht API unterstützt wurden. In dieser Version werden folgende 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 Ansichten (Profilen). – Währungsreferenz in der Hilfe

Gesamtdatenberichte

Die Gesamtdatenberichte API haben kein Limit von 100 Berichten pro Tag mehr. Die API verwendet dasselbe Tokensystem pro Property und Tag wie bei der Erstellung eines Gesamtdatenberichts über die Weboberfläche.

Gesamtdatenberichte

Auf Gesamtdatenberichte, auf die der aktuelle Nutzer nicht zugreifen kann, wird in der Management API-Antwortnachricht kein Downloadlink mehr angezeigt. Dieses Verhalten entspricht jetzt der Funktionalität des UI-Dashboards, bei der nur Inhaber von Berichten den Downloadlink für das generierte Dokument sehen können.

Aufrufe (Profile)

In diesem Release wird die botFilteringEnabled-Eigenschaft der Ressource vom Typ „Datenansicht“ (Profil) hinzugefügt. Diese Property gibt an, ob die Botfilterung für eine Datenansicht (Profil) aktiviert ist. Weitere Informationen finden Sie in der Referenzdokumentation zu Ansichten (Profile).

Gesamtdatenberichte

In diesem Release wird die Methode delete zu Gesamtdatenberichten hinzugefügt. Weitere Informationen finden Sie in der Referenzdokumentation zum Löschen von Gesamtdatenberichten.

Segmente

Dies ist eine Version zur Fehlerkorrektur. In dieser Version wurde ein Problem behoben, durch das Segmente mit Währungswerten in der Definition falsch dargestellt wurden, wenn die Methode für die Segmentliste aufgerufen wurde.

Segmente

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

Batching

In dieser Version wurde neben der allgemeinen Batch-Unterstützung auch die User Berechtigungen API unterstützt. Durch Batchanfragen für Nutzerberechtigungen wird die Leistung erheblich gesteigert und das Kontingent reduziert.

Aufrufe (Profile)

Ab dieser Version wird die currency-Eigenschaft der Ansicht (Profil) standardmäßig auf USD gesetzt, wenn sie beim Einfügen nicht festgelegt wird. Außerdem geben get- und list-Vorgänge USD für Datenansichten (Profile) zurück, die zuvor ohne currency-Property erstellt wurden.

Filter

In diesem Release wurden die verworfenen Filterfelder IS_MOBILE und IS_TABLET endgültig entfernt, die durch DEVICE_CATEGORY=mobile und DEVICE_CATEGORY=tablet ersetzt werden sollten. Bei Eingabe-, Aktualisierungs- und Patchanfragen, die die Filterfelder auf die Verwendung von IS_MOBILE und IS_TABLET festlegen, wird ein Fehler zurückgegeben.

Filter

In diesem Release wird die Verwendung einer benutzerdefinierten Dimension für ein Filterfeld unterstützt. Dazu wird allen Abschnitten mit Filterdetails eine fieldIndex-Eigenschaft hinzugefügt. Beispielsweise ist es jetzt möglich, den Filterausdruck mit einem "field": "CUSTOM_DIMENSION" und einem "fieldIndex": "1" festzulegen, damit der Filter auf die erste benutzerdefinierte Dimension angewendet wird.

Ziele

In dieser Version wurde außerdem ein Problem behoben, bei dem das Erstellen eines Ziels mit "comparisonValue": "0" fehlschlägt.

Mit diesem Release wird die dailyUpload-Ressource endgültig eingestellt und entfernt. Die Ressource dailyUpload wurde offiziell am 20. Juni 2014 eingestellt. Der gesamte Kostendatenimport sollte jetzt über die Upload-Ressource erfolgen.

In dieser Version werden der Management API zwei neue Sammlungen hinzugefügt: „Benutzerdefinierte Dimensionen“ und „Benutzerdefinierte Messwerte“.

Benutzerdefinierte Dimensionen und Messwerte

Es ist jetzt möglich, benutzerdefinierte Dimensionen und Messwerte mit der Management API zu erstellen, aufzulisten, abzurufen, zu patchen und zu aktualisieren.

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

Fehlerkorrekturen

Mit dieser Version wird ein neuer Bereich für die Google Analytics Management API eingeführt. - analytics.manage.users.readonly - Google Analytics-Nutzerberechtigungen abrufen.

Das neue Feld DEVICE_CATEGORY filters 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 eine enhancedECommerceTracking-Property, die angibt, ob erweiterte E-Commerce-Berichte aktiviert (true) oder deaktiviert (false) sind.

Dieser Release umfasst neue Datenimporttypen und die Einstellung der Ressource dailyUpload.

Datenimport

Im Entwicklerleitfaden für den Datenimport erfahren Sie, wie Sie mit der Management API Daten in Ihr Google Analytics-Konto importieren.

Uploads

  • Die Ressource upload unterstützt jetzt die folgenden Uploadtypen:
    • Kampagnendaten
    • Inhaltsdaten
    • Kostendaten
    • Produktdaten
    • Daten zu Erstattungen
    • Nutzerdaten
  • Für die Ressource upload gibt es eine neue Methode migrateDataImport zum Migrieren vorhandener Kostendaten customDataSources.

Einstellung der täglichen Uploads

  • Die Ressource dailyUpload ist jetzt veraltet. Im Migrationsleitfaden finden Sie weitere Informationen zur Migration zur Verwendung der Funktion Datenimport.
  • Die Ressource „dailyUpload“ funktioniert noch sechs weitere Monate. Danach werden alle verbleibenden customDataSources, bei denen die Property „uploadType“ auf analytics#dailyUploads gesetzt ist, automatisch migriert und funktioniert nur noch mit der Ressource upload.
  • Aktuelle Nutzer der dailyUpload-Ressource sollten so schnell wie möglich ihren Code aktualisieren und zur Verwendung der Upload-Ressource migrieren.

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

  • Mit AdWords-Verknüpfungen in der Verwaltungs-API können Sie Verknüpfungen zwischen Google AdWords-Konten und Google Analytics-Properties erstellen, auflisten, abrufen, aktualisieren, patchen und löschen. Außerdem können Sie verwalten, welche Datenansichten (Profile) mit AdWords-Daten verknüpft werden.

Filter

Gesamtdatenberichte: Management API

Der Management API wird die neue Ressource Gesamtdatenberichte hinzugefügt. Gesamtdatenberichte sind Google Analytics-Berichte, die auf Basis von Gesamtdaten erstellt wurden.Gesamtdatenberichte sind derzeit nur für Nutzer von GA-Premium-Nutzern verfügbar. 

Segmente: Management API Version 2.4 und v3.0

An der Sammlung „Segmente“ wurden folgende Änderungen vorgenommen:

  • Nutzer- und Sequenzsegmente werden jetzt in der API unterstützt.
  • Die Segmentsammlung gibt jetzt alle integrierten und benutzerdefinierten Segmente auf Sitzungsebene und Nutzerebene zurück.
  • Für die definition-Property für Segmente wird jetzt die neue Syntax für Segmente verwendet. Dazu gehören auch Definitionen für vorhandene Segmente auf Sitzungsebene. Diese werden von „definition: ""“ zu „definition: "sessions::condition::"“ geändert.
  • Der Ressource Segment wurde eine neue type-Property hinzugefügt, die angibt, ob ein Segment CUSTOM (von einem Nutzer über die Weboberfläche erstellt) oder BUILT_IN (von Google Analytics bereitgestellt) ist.

Tests

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

  • ga:adsenseAdsClicks: gibt an, wie oft auf AdSense-Anzeigen auf Ihrer Website geklickt wurde.
  • ga:adsenseAdsViewed: Die Anzahl der AdSense-Anzeigen, die angesehen wurden. In einem Anzeigenblock können mehrere Anzeigen erscheinen.
  • ga:adsenseRevenue: Der Gesamtumsatz aus AdSense-Anzeigen.

Neue Sammlung „Kontozusammenfassungen“

  • Die Sammlung AccountSummaries wurde der Management API hinzugefügt. Sie enthält eine Zusammenfassung der Informationen zu allen Konten, Properties und Datenansichten, auf die ein autorisierter Nutzer in einer einzigen und schnellen Anfrage zugreifen kann. Weitere Informationen finden Sie im Entwicklerleitfaden mit Zusammenfassungen von Konten.

Aufgrund der Einstellung der Dimensionen ga:isMobile und ga:isTablet wurden folgende Änderungen an Standardsegmenten vorgenommen:

  • Segment gaid::-11 wurde von Zugriffe über Mobilgeräte in Zugriffe über Smartphones und Tablets umbenannt. Die Definition für dieses Segment wurde von „ga:isMobile==Yes“ zu „ga:deviceCategory==mobile,ga:deviceCategory==tablet“ geändert. Beachten Sie, dass ga:isMobile Zugriffe über Tablets enthalten hat. Dies wird in der neuen Definition widergespiegelt. Wenn Sie nur Zugriffe über Mobilgeräte und keine Tablets 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. Sie repräsentieren weiterhin Zugriffe über Tablets.
  • Segment gaid::-14 wurde hinzugefügt. Der Name des Segments lautet Zugriffe über Mobilgeräte und die Definition lautet ga:deviceCategory==mobile.

Fehlerkorrekturen:

  • Probleme mit Zeitzoneninformationen für Datenansichten (Profile) wurden behoben. Details: Vor dieser Korrektur wurden in bestimmten Fällen bei der Listenansicht (Profilen) in der Management API falsche Zeitzoneninformationen für eine Datenansicht (ein Profil) zurückgegeben. Die Zeitzoneninformationen für Datenansichten (Profile) entsprechen nun den Einstellungen auf der Verwaltungsoberfläche von Google Analytics.

Dieser Release enthält Schreibvorgänge für Web-Property-, Datenansichts- (Profil-) und Zielvorhabenressourcen sowie drei neue Ressourcen, die die Verwaltung von Nutzerberechtigungen ermöglichen.

APIs zur Kontoeinrichtung und -konfiguration

  • Ansichten (Profile) können jetzt erstellt, aktualisiert, gepatcht und gelöscht werden. Weitere Informationen zu den neuen Methoden finden Sie in der Referenz zu Datenansichten (Profile).
  • Web-Properties und Zielvorhaben können jetzt erstellt, aktualisiert und gepatcht werden. Weitere Informationen zu den neuen Methoden finden Sie in der Referenz zu Web-Properties und der Referenz zu Zielvorhaben.
  • Eine einzelne Web-Property, eine einzelne Datenansicht (Profil) oder ein Zielvorhaben kann jetzt mit der Methode get angefordert werden.
  • Diese Funktionen sind derzeit als Entwicklervorschau in einer eingeschränkten Betaversion verfügbar. Wenn Sie sich registrieren möchten, fordern Sie Zugriff auf die Betaversion an.

Nutzerberechtigungen in der Management API

  • Die neue Ressource accountUserLinks ermöglicht die Verwaltung von Kontoberechtigungen für Nutzer.
  • Die neue Ressource webpropertyUserLinks ermöglicht die Verwaltung von Property-Berechtigungen für Nutzer.
  • Die neue profileUserLinks-Ressource ermöglicht die Verwaltung von Anzeige- bzw. Profilberechtigungen für Nutzer.
  • Berechtigungen für autorisierte Nutzer sind jetzt in den Ressourcen Konto, Web-Property und Datenansicht (Profil) verfügbar.
  • Es wurde ein neuer Bereich eingeführt, der für die Verwaltung von Nutzerberechtigungen erforderlich ist. https://www.googleapis.com/auth/analytics.manage.users.
  • Weitere Informationen finden Sie im Entwicklerleitfaden für Nutzerberechtigungen.

Im Rahmen der Einführung der neuen Segmente führen wir folgende Änderungen an der Sammlung „Segmente“ ein:

  • Alle Segment-IDs werden von positiven Ganzzahlen in alphanumerische Strings geändert. Wenn Sie Segment-IDs von Nutzern gespeichert haben, sollten Sie diese auf die neuen IDs aktualisieren.
  • In der Segmentsammlung werden nur die vorhandenen Segmente auf Besuchsebene zurückgegeben. Die neuen Besucher-, Kohorten- und Sequenzsegmente werden derzeit in der API nicht unterstützt.
  • Die Segmentsammlung gibt weiterhin die vorhandenen Standardsegmente mit denselben negativen numerischen IDs zurück. Die neuen Standardsegmente werden jedoch derzeit nicht unterstützt.

In diesem Release werden der Web-Property-Ressource zwei neue Properties hinzugefügt:

  • profileCount: gibt die Profilanzahl für eine Property zurück. Auf diese Weise können Sie Eigenschaften filtern, die kein Profil haben (d.h. profileCount = 0).
  • industryVertical: gibt die Branche/Kategorie zurück, die für eine Property ausgewählt wurde.

Fehlerkorrekturen:

  • Die Eigenschaft eCommerceTracking der Profilressource stimmt jetzt mit den E-Commerce-Einstellungen im Verwaltungsbereich der Weboberfläche überein. Gibt true zurück, wenn E-Commerce-Tracking aktiviert ist, andernfalls false.
  • 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, um auf Testressourcen zuzugreifen und diese zu ändern.
  • Die Profilressource enthält jetzt eine type-Property, mit der angegeben wird, ob ein Profil für eine Website oder App konfiguriert ist. Die beiden möglichen Werte sind WEB und APP.

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

  • Dem Text der API-Fehlerantworten wurden neue Fehlercodes, Gründe und Beschreibungen hinzugefügt. Alle Codes sind sowohl für Version 2.4 als auch für Version 3.0 der Management API dokumentiert.

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

Neue Daten

  • Die Sammlung „Erweitertes Segment“ enthält jetzt das Feld segmentId, das mit dem Parameter segment der API für den Datenexport verwendet werden kann.

Änderungen

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

  • Der Standard- und Höchstwert für max-results wurde 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.

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

Version 3.0

  • Dies ist die neueste Hauptversion unserer API und nicht abwärtskompatibel. Die gesamte künftige Entwicklung der API erfolgt auf dieser Version.

  • Neue Daten

    • Vollständige Darstellung von Ereigniszielen
    • Interne Web-Property-ID, mit der ein Deeplink zur Google Analytics-Benutzeroberfläche erstellt werden kann
    • Profilkonfigurationen für die Suchparameter der Standardseite und der Websitesuche

  • Änderungen

Version 2.4

  • Dies ist ein Upgrade der Nebenversion, das mit der bestehenden Version 2.3 weitgehend abwärtskompatibel ist.

  • Änderungen

    • Eine neue Kontingentrichtlinie
    • Einbindung in die Google APIs-Konsole, um den API-Zugriff zu verwalten und ein höheres Kontingent anzufordern
    • Vorhandene Autorisierungsmechanismen und OAuth 2.0 werden weiterhin unterstützt.
    • 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 entspricht Version 2.3, sodass die anderen vorhandenen Google Data-Clientbibliotheken weiterhin funktionieren.

Einstellung

  • Die alte Version 2.3 der Management API wird eingestellt. Es funktioniert noch zwei Monate lang. Danach wird auf alle Anfragen von Version 2.3 eine Antwort der 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 veröffentlicht wie die Google Analytics-API für den Datenexport. Sowohl die Google Data-Java- als auch die JavaScript-Bibliotheken wurden aktualisiert. Um auf jeden Feed zuzugreifen, geben Sie den entsprechenden Feed-URI für die getManagementFeed()-Methode der Bibliotheken an.

Neue Dokumentation

  • Ein neuer Abschnitt der Google Analytics-Entwicklerdokumentation wurde erstellt, um die Funktionsweise der neuen Management API zu beschreiben.