Entwicklerleitfaden für den Datenimport

Die Google Analytics Management API ermöglicht den programmatischen Zugriff auf die Google Analytics-Funktion Datenimport.

Einleitung

Mit der Management API können Sie Dateien hochladen, auflisten, löschen und abrufen sowie Datensätze auflisten. Einen allgemeinen Überblick über die Vorteile der Datenimportfunktion finden Sie im Hilfeartikel Datenimport.

Die beiden Ressourcen in der Management API, die den Datenimport ermöglichen, sind:

  • Die Ressource der benutzerdefinierten Datenquelle. Sie wird in der Weboberfläche als Datensatz bezeichnet und dient als Container für Ihre hochgeladenen Dateien. Eine Sammlung benutzerdefinierter Datenquellen umfasst alle Datensätze, die mit einer Google Analytics-Property verknüpft sind.
  • Die Upload-Ressource, die für eine hochgeladene Datei steht. Eine Sammlung von Upload-Ressourcen stellt alle Dateien dar, die Sie in einen Datensatz hochgeladen haben.

Anwendungsbereiche

Die Datenimportfunktion hat drei Kategorien der obersten Ebene mit jeweils eigenen Anwendungsfällen. Die Organisation ist folgende:

Trefferdatenimport

Daten zu Erstattungen

E-Commerce-Transaktionen, die vollständig oder teilweise erstattet wurden, können in Google Analytics hochgeladen werden. So lassen sich die Daten in Ihren E-Commerce-Berichten in Google Analytics ganz einfach mit verarbeiteten Erstattungen abgleichen.

Informationen zum Importieren von Daten zu Rückerstattungen in Google Analytics finden Sie unter Beispiel für den Import von Rückerstattungsdaten.

Erweiterter Datenimport

Nutzerdaten

Sie können nicht personenidentifizierbare Nutzerdaten aus externen CRM-Tools hochladen und Google Ads-Remarketing-Zielgruppen für Ihre wichtigsten Nutzersegmente erstellen.

Informationen zum Importieren von Nutzerdaten in Google Analytics, um Remarketing-Zielgruppen in Google Ads zu erstellen, finden Sie unter:

Kampagnendaten

Sie können Kampagnendaten in Google Analytics importieren, um die Analyse der Kampagnenleistung an Ihr Unternehmen anzupassen.

Weitere Informationen zum Importieren von Kampagnendaten in Google Analytics

Geografische Daten

Sie können Zuordnungen geografischer IDs zu Regionen importieren, um Berichte zu Google Analytics-Daten nach benutzerdefinierten Region zu erstellen. In den USA können Sie beispielsweise in den Bundesstaaten „Ost“, „Mitte“ und „West“ tätig sein, in Europa dagegen in den Staaten „Nord“, „Mitte“ und „Süd“. Beim Datenimport können Sie ga:regionId, ga:cityId, ga:countryIsoCode oder ga:subContinentCode als Schlüssel verwenden. Die Orts- und Länder-IDs sind in der Tabelle für die geografische Ausrichtung aufgelistet. Der ISO-Ländercode und der Subkontinentcode sind in den Tabellen ISO-3166-1 alpha-2 bzw. UN M.49 aufgeführt.

Weitere Informationen zum Importieren geografischer Daten finden Sie unter Beispiel für den Import geografischer Daten.

Contentdaten

Sie können inhaltsbezogene Metadaten wie Autor und Thema hochladen und mithilfe von Google Analytics detaillierte Analysen von Artikeln durchführen, die auf einer Website veröffentlicht werden.

Informationen zum Importieren von Contentdaten in Google Analytics finden Sie unter Beispiel für den Import von Contentdaten.

Produktdaten

Durch den Import von Produktdaten in Google Analytics wird die Menge an E-Commerce-Daten, die mit Treffern wie Seitenaufrufen und Ereignissen gesendet werden müssen, vereinfacht und reduziert. Eine einzelne Produkt-ID oder SKU kann mit den importierten Produktdaten verknüpft werden, um Produktdimensionen und -messwerte in Ihren Berichten zu erfassen.

Informationen zum Importieren Ihrer Produktdaten in Google Analytics finden Sie unter Produktdaten mithilfe der Management API importieren.

Datenübersichtsimport

Kostendaten

Sie können Kostendaten für bezahlte Nicht-Google-Kampagnen hochladen und die Google Analytics-Plattform verwenden, um ROI-Analysen durchzuführen und die Kampagnenleistung für alle Investitionen in Onlinewerbung und Marketing zu vergleichen.

Informationen zum Importieren von Kostendaten in Google Analytics finden Sie unter Kostendaten mithilfe der Management API importieren.

Konzepte

Verarbeitungsstatus

Nachdem Sie eine Datei hochgeladen haben, lautet der Status des Uploads PENDING, bis er validiert und verarbeitet wurde. Wenn die Verarbeitung erfolgreich war, ändert sich der Status in COMPLETED.

Wenn während der Verarbeitung ein Fehler aufgetreten ist und der Upload nicht erfolgreich war, lautet der Status des Uploads FAILED. Eine Liste der Fehler wird bereitgestellt, um Ihnen bei der Identifizierung des Problems bzw. der Probleme mit der Datei zu helfen. Im Folgenden finden Sie eine Beispielantwort für einen Upload, bei dem die Validierung fehlgeschlagen ist:

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

Summierung der Kostendaten vs. Überschreiben

Wenn Sie eine benutzerdefinierte Datenquelle bzw. einen benutzerdefinierten Datensatz für Kostendaten erstellen, können Sie angeben, wie mit Fällen verfahren werden soll, in denen eine hochgeladene Datei eine Datenzeile mit einem Schlüssel (d. h. Datum, Quelle, Medium) enthält, der mit einer vorhandenen Zeile übereinstimmt. Folgende Optionen sind verfügbar:

  • Summierung (Standardeinstellung): Die neuen Daten werden zu allen vorherigen übereinstimmenden Daten addiert, und die Messwerte werden addiert.
  • overwrite: Die neuen Daten überschreiben alle vorherigen übereinstimmenden Daten.

Wenn Sie herausfinden möchten, welcher Typ für einen Datensatz festgelegt wurde, können Sie mit der Methode für die Liste benutzerdefinierter Datenquellen prüfen, ob die Property importBehavior auf OVERWRITE oder SUMMATION festgelegt ist.

Summenwerte im Vergleich zu Überschreibung auf Zeilenebene der Kostendaten

Sie können das Verhalten des Datensatzes für jede hochgeladene Datei überschreiben, indem Sie die Spalte ga:importBehavior in die Kopfzeile aufnehmen. Sie können den Wert von ga:importBehavior auf Zeile pro Zeile auf SUMMATION oder OVERWRITE setzen.

Beispiel: Die folgende Datei überschreibt alle vorherigen Kostendaten für Facebook/cpc und Yahoo/cpc. Die Zeile für Bing/cpc wird jedoch allen vorhandenen Kostendaten für diese Kombination aus Datum und Quelle/Medium hinzugefügt.

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

Format und Einschränkungen

Damit Daten in Google Analytics hochgeladen werden können, müssen sie in einer korrekt formatierten CSV-Datei vorliegen. In diesem Abschnitt werden die Einschränkungen beschrieben, die erfüllt sein müssen, bevor der Feed für den Upload in alle Datenimporttypen als gültig angesehen wird.

Wenn eine der unten aufgeführten Einschränkungen verletzt wird oder ein Parsing-Fehler auftritt, schlägt die Uploadanfrage mit Fehlermeldungen fehl. Die API meldet bis zu zehn Fehler in einer einzigen Antwort, damit Nutzer die Anzahl ungültiger Uploads reduzieren können.

Dateieinschränkungen

  • Codierung: UTF-8
  • Maximale Dateigröße: 1 GB

Headereinschränkungen

  • Die erste Zeile wird als Spaltenüberschrift betrachtet und ist erforderlich. Sie muss die Dimensionen und Messwerte definieren, die die jeweilige Spalte enthalten soll.

Zeileneinschränkungen

  • Das Zeilenlimit beträgt 1 MB.

Zellenformatierung

  • Die Zellen dürfen maximal 2.048 Zeichen lang sein.
  • Voran- und nachgestellte Leerzeichen für eine Zelle werden entfernt.
  • Um ein Komma in einer Zelle anzugeben, muss der Wert der Zelle in doppelte Anführungszeichen gesetzt werden. Beispiel: source1,"medium,ether",group1,100: Der Wert der zweiten Zelle ist mittel,ether.
  • Um doppelte Anführungszeichen innerhalb einer Zelle anzugeben, müssen Sie zusätzlich zu den doppelten Anführungszeichen am Anfang und Ende das doppelte Anführungszeichen mit einem weiteren doppelten Anführungszeichen maskieren. Beispiel: source1,"medium""ether",group1,100: Der Wert der zweiten Zelle ist medium"ether.