Importowanie danych o kosztach przy użyciu interfejsu API zarządzania

Z tego przewodnika dowiesz się, jak importować dane o kosztach za pomocą interfejsu Management API.

Wstęp

Importowanie danych o kosztach i kliknięciach w przypadku płatnych kampanii niezwiązanych z Google umożliwia korzystanie z platformy Google Analytics do przeprowadzania analiz ROI i porównywania skuteczności kampanii we wszystkich Twoich inwestycjach reklamowych i marketingowych.

Zanim zaczniesz

Przed rozpoczęciem tego przewodnika deweloperzy powinni wykonać te czynności:

Przegląd

Importowanie danych o kosztach do Google Analytics za pomocą interfejsu API zarządzania wymaga wykonania następujących czynności:

  1. Dodaj tagi do adresów URL kampanii.
  2. Tworzenie zbioru danych
  3. Przygotuj do przesłania plik CSV z danymi o kosztach.
  4. Prześlij dane o kosztach za pomocą interfejsu API zarządzania Google Analytics.

Dodaj tagi do adresów URL kampanii

Aby przeprowadzić analizę zwrotu z inwestycji w płatne kampanie, można połączyć dane o kosztach ze źródeł zewnętrznych z danymi sesji w Google Analytics, dodając parametry śledzenia kampanii do wszystkich docelowych adresów URL w używanym przez Ciebie systemie reklamowym niezwiązanym z Google.

Przykład

W poniższej przykładowej reklamie docelowy adres URL jest otagowany parametrami śledzenia kampanii (utm_campaign, utm_source, utm_medium, utm_term). Dzięki temu wizyty w witrynie po kliknięciu reklamy są powiązane z kampanią letniej wyprzedaży w Google Analytics.

Rysunek 1.Przykład reklamy

Sklep zoologiczny użył tej reklamy w następujący sposób:

http://www.examplepetstore.com?utm_campaign=Summer%2BSale&utm_source=ad%2Bnetwork&utm_medium=cpc&utm_term=dogbone

Gdy użytkownik kliknie reklamę, zostanie przekierowany do witryny sklepu zoologicznego. W Google Analytics dla tej sesji zostaną ustawione te wartości:

Nazwa wymiaru w interfejsie internetowym Google Analytics Parametr śledzenia kampanii Wartość ustawiona w Google Analytics
Nazwa kampanii utm_campaign Letnia wyprzedaż
Źródło utm_source sieć reklamowa
Średnia utm_medium cpc
Słowo kluczowe utm_term dogbone

Dzięki temu Google Analytics ma parametry śledzenia kampanii powiązane z sesją oraz istnieje sposób na powiązanie danych Google Analytics z zewnętrznymi źródłami danych o kosztach.

Tworzenie zbioru danych

Aby zaimportować dane o kosztach, musisz utworzyć zbiór danych. Zbiór danych reprezentuje co najmniej jedno zewnętrzne źródło danych w Google Analytics. Zbiór danych można utworzyć tylko za pomocą interfejsu internetowego.

Na karcie usługi na stronie Administracja wykonaj te czynności:

  1. Kliknij kartę Import danych.
  2. Kliknij przycisk Nowy zbiór danych.
  3. Wybierz typ Dane o kosztach i kliknij Następny krok.
  4. Nadaj zbiorowi danych nazwę i wybierz co najmniej 1 widok danych (profil), by włączyć w raportach Analiza kosztów, a następnie kliknij Następny krok.
  5. Wybierz Wymiary i dane, które chcesz przesłać.
  6. Wybierz Sposób importowania.
    • To ustawienie określa, czy w przypadku znalezienia zduplikowanego klucza mają być zastępowane, czy sumowane dane o kosztach. Więcej informacji o sposobie importowania danych znajdziesz w sekcji Sumowanie danych o kosztach a zastępowanie danych w przewodniku dla programistów dotyczącym importu danych.
  7. Kliknij Zapisz.
Rys. 2. Tworzenie zbioru danych o kosztach

Przygotowanie do przesłania pliku CSV z danymi o kosztach

Google Analytics wymaga przesyłania danych o kosztach w określonym formacie z określonymi wartościami. Przed przesłaniem sprawdź, czy dane o kosztach wyeksportowane ze źródła zewnętrznego spełniają te wymagania.

Najważniejsze modyfikacje i weryfikacje, które musisz wykonać w pliku CSV:

  • Zmień nazwy nagłówków kolumn, aby były zgodne z tymi rozpoznawanymi przez Google Analytics. Nagłówek możesz pobrać ze strony szczegółów zbioru danych w interfejsie internetowym.
  • Dodaj brakujące wymagane wartości.
  • W odpowiednich przypadkach wartości w pliku CSV powinny odpowiadać wartościom parametrów śledzenia kampanii.

Przykład

W przypadku sklepu zoologicznego dane są eksportowane zbiorczo i zapisywane w pliku CSV:

Rysunek 3. Wyeksportowany plik CSV z danymi o kosztach.

Następnie plik CSV jest modyfikowany do formatu wymaganego przez Google Analytics:

Rys. 4. Sformatowany plik CSV z danymi o kosztach

Po przygotowaniu pliku CSV jego format powinien wyglądać podobnie do tego przykładu:

ga:date,ga:source,ga:medium,ga:campaign,ga:keyword,ga:impressions,ga:adClicks,ga:adCost
20140615,ad network,cpc,Summer Sale,dogbone,9387,288,100.3
20140615,ad network,cpc,Summer Sale,dog treat,1684,52,19.35
20140615,ad network,cpc,Summer Sale,pet store,3187,143,76.23
20140616,ad network,cpc,Summer Sale,dogbone,8754,188,86.21

Ogólne ograniczenia formatu plików znajdziesz w Przewodniku dla programistów ds. importowania danych.

Przesyłanie danych o kosztach za pomocą interfejsu API zarządzania

Po utworzeniu zbioru danych i przygotowaniu danych o kosztach do przesłania w pliku CSV możesz przesłać dane o kosztach za pomocą interfejsu API zarządzania lub interfejsu internetowego.

Raporty

Przesłane dane o kosztach będą dostępne w raportach Analiza kosztów w sekcji Pozyskiwanie w Google Analytics, a także w interfejsie API podstawowego raportowania.