Przewodnik dla programistów ds. importu danych

Interfejs Google Analytics Management API zapewnia automatyczny dostęp do funkcji Import danych Google Analytics.

Wstęp

Interfejs API zarządzania umożliwia przesyłanie, wyświetlanie, usuwanie i pobieranie przesłanych plików oraz tworzenie list zbiorów danych. Ogólne omówienie zalet funkcji Import danych znajdziesz w artykule Informacje o imporcie danych w Centrum pomocy.

Dwa zasoby interfejsu API zarządzania, które umożliwiają import danych:

  • Zasób niestandardowe źródło danych nazywany w interfejsie internetowym zestawem danych, który działa jako kontener na przesłane pliki. Zbiór niestandardowych źródeł danych obejmuje wszystkie zbiory danych powiązane z usługą w Google Analytics.
  • Zasób Upload, który reprezentuje przesłany plik. Zbiór zasobów przesyłania reprezentuje wszystkie pliki przesłane przez Ciebie do zbioru danych.

Przykłady zastosowania

Funkcja importu danych ma 3 najwyższe kategorie, z których każda ma własne przypadki użycia. Organizacja jest taka:

Import danych działań

Dane o zwrocie środków

Transakcje e-commerce, które zostały całkowicie lub częściowo zwrócone, można przesyłać do Google Analytics. Ułatwia to automatyczne uzgadnianie danych w raportach e-commerce Google Analytics z przetwarzanymi zwrotami środków.

Więcej informacji o importowaniu do Google Analytics danych o zwrocie środków znajdziesz w artykule Przykład importu danych o zwrocie środków.

Rozszerzony import danych

Dane użytkownika

Możesz przesyłać z zewnętrznych narzędzi do zarządzania relacjami z klientami dane użytkowników, które nie umożliwiają identyfikacji konkretnej osoby, oraz tworzyć listy odbiorców remarketingu w Google Ads na potrzeby segmentów najbardziej wartościowych użytkowników.

Więcej informacji o importowaniu danych o użytkownikach do Google Analytics na potrzeby tworzenia list odbiorców remarketingu w Google Ads znajdziesz w tych artykułach:

Dane kampanii

Możesz importować dane kampanii do Google Analytics, aby dostosować analizę skuteczności kampanii do potrzeb swojej firmy.

Więcej informacji o importowaniu danych kampanii do Google Analytics znajdziesz w artykule Importowanie danych kampanii za pomocą interfejsu API zarządzania Google Analytics.

Dane geograficzne

Możesz importować mapowania identyfikatorów geograficznych na regiony, co umożliwia generowanie raportów na podstawie danych Google Analytics według regionu niestandardowego. Na przykład w Stanach Zjednoczonych możesz działać we wschodnich, środkowych i zachodnich grupach stanów, a w Europie – w grupach krajów północnych, centralnych i południowych. Podczas importowania danych możesz użyć kluczy ga:regionId, ga:cityId, ga:countryIsoCode lub ga:subContinentCode. Identyfikatory miast i krajów znajdziesz w tabeli Kierowanie geograficzne. Kody ISO kraju i kod subkontynentu znajdziesz odpowiednio w tabelach ISO-3166-1 alfa-2 i UN M.49.

Więcej informacji o importowaniu danych geograficznych znajdziesz w artykule Przykład importu danych geograficznych.

Dane o treści

Możesz przesłać metadane związane z treścią, np. autora lub temat, by przeprowadzić szczegółową analizę artykułów publikowanych w witrynie za pomocą Google Analytics.

Więcej informacji o importowaniu danych o treści do Google Analytics znajdziesz w artykule Przykład importu danych o treści.

Dane produktu

Importowanie danych produktów do Google Analytics upraszcza i zmniejsza ilość danych e-commerce, które trzeba wysyłać razem z działaniami, takimi jak wyświetlenia strony i zdarzenia. Pojedynczy identyfikator produktu lub kod SKU można połączyć z zaimportowanymi danymi produktów, aby wypełnić wymiary i dane produktów w raportach.

Aby dowiedzieć się, jak importować dane produktów do Google Analytics, przeczytaj artykuł Importowanie danych produktów za pomocą interfejsu API zarządzania Google Analytics.

Skrócony import danych

Dane o kosztach

Możesz przesyłać dane o kosztach płatnych kampanii niezwiązanych z usługami Google oraz korzystać z platformy Google Analytics do przeprowadzania analiz ROI i porównywania skuteczności kampanii dla wszystkich inwestycji reklamowych i marketingowych online.

Więcej informacji o importowaniu danych o kosztach do Google Analytics znajdziesz w artykule Importowanie danych o kosztach przy użyciu interfejsu API zarządzania Google Analytics.

Pojęcia

Stan przetwarzania

Gdy prześlesz plik, jego stan będzie wynosić PENDING, dopóki nie sprawdzimy i nie przetworzymy danych. Jeśli przetwarzanie się uda, stan zmieni się na COMPLETED.

Jeśli podczas przetwarzania wystąpił błąd, a nie udało się przesłać pliku, stan przesyłania to FAILED. Dostępna jest lista błędów, która pomoże Ci zidentyfikować problemy z plikiem. Oto przykładowa odpowiedź dotycząca przesyłania, które nie przeszło weryfikacji:

{
  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."
  ]
}

Sumowanie i zastępowanie danych o kosztach

Przy tworzeniu niestandardowego źródła danych / zbioru danych dla danych o kosztach masz możliwość określenia sposobu postępowania w przypadku, gdy przesłany plik zawiera wiersz danych z kluczem (tj. datą, źródłem, medium) zgodnym z istniejącym wierszem. Dostępne są te opcje:

  • summation (domyślna) – nowe dane zostaną dodane do wszystkich poprzednich pasujących danych i zsumowane.
  • overwrite (zastąpienie) – nowe dane zastąpią wszelkie wcześniejsze pasujące dane.

Aby dowiedzieć się, jaki typ został ustawiony dla zbioru danych, użyj metody listy niestandardowych źródeł danych, by sprawdzić, czy właściwość importBehavior ma wartość OVERWRITE lub SUMMATION.

Suma danych o kosztach a zastąpienie

Możesz też zastąpić działanie zbioru danych w przypadku każdego przesyłanego pliku, dodając do nagłówka kolumnę ga:importBehavior. Na poziomie wiersza możesz ustawić wartość ga:importBehavior na SUMMATION lub OVERWRITE.

Na przykład ten plik zastąpi wszelkie wcześniejsze dane o kosztach z raportów Facebook/cpc i Yahoo/cpc, ale wiersz Bing/cpc zostanie dodany do wszystkich istniejących danych o kosztach z tego konkretnego dnia i kombinacji źródło/medium.

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 i ograniczenia

Aby dane zostały przesłane do Google Analytics, muszą one mieć poprawnie sformatowany plik CSV. W tej sekcji opisano ograniczenia, które musi spełnić, aby można było za jej pomocą przesłać dane za pomocą wszystkich typów importu danych.

Jeśli któreś z tych ograniczeń zostanie naruszone lub wystąpi błąd analizy, żądanie przesyłania zakończy się niepowodzeniem i wyświetli komunikaty o błędzie. Interfejs API zgłasza do 10 błędów w jednej odpowiedzi, aby pomóc użytkownikom zmniejszyć liczbę nieprawidłowych operacji przesyłania.

Ograniczenia dotyczące plików

  • Kodowanie: UTF-8
  • Limit rozmiaru pliku: 1 GB

Ograniczenia nagłówka

  • Pierwszy wiersz jest traktowany jako nagłówek kolumny i jest wymagany. Musi też określać wymiary i dane zawarte w konkretnej kolumnie.

Ograniczenia wierszy

  • Maksymalny limit wierszy to 1 MB.

Formatowanie komórek

  • Komórki mogą mieć maksymalnie 2048 znaków.
  • Spacje na początku i na końcu komórki zostaną usunięte.
  • Aby można było podać przecinek w komórce, wartość ta musi być ujęta w cudzysłów podwójny. Np. source1,"medium,ether",group1,100 – wartość w drugiej komórce to „medium”, czyli eter.
  • Aby określić podwójny cudzysłów w komórce, oprócz początkowego i końcowego cudzysłowu, użyj innego cudzysłowu prostego. Np. source1,"medium""ether",group1,100 – wartość w drugiej komórce to medium"ether.