Co to jest interfejs API do raportowania ścieżek wielokanałowych – omówienie

Ten dokument zawiera ogólny opis interfejsu API do raportowania ścieżek wielokanałowych w Google Analytics. Szczegółowe informacje o interfejsie API znajdziesz w Przewodniku.

Wstęp

Interfejs API do raportowania ścieżek wielokanałowych umożliwia wysyłanie żądań danych dotyczących ścieżek wielokanałowych do uwierzytelnionego użytkownika. Dane pochodzą z danych ścieżki konwersji, które wskazują interakcje użytkowników z różnymi źródłami wizyt w ciągu wielu sesji przed konwersją. Pozwala to analizować wpływ wielu kanałów marketingowych na konwersje na przestrzeni czasu. Więcej informacji o dostępnych danych znajdziesz w artykułach Ścieżki wielokanałowe – informacje i Dane ścieżek wielokanałowych – informacje.

Dzięki interfejsowi API do raportowania ścieżek wielokanałowych możesz:

  • Tworzenie raportów niestandardowych na podstawie danych ścieżek wielokanałowych. Możesz np. wykorzystać dane o Najważniejsze ścieżki konwersji do raportowania atrybutów takich jak względne położenie interakcji na ścieżce konwersji.
  • Integracja danych ścieżek wielokanałowych z firmowymi bazami danych Możesz na przykład skorelować dane o konwersjach online z danymi o sprzedaży offline i kosztach mediów, aby uzyskać pełniejszy obraz zwrotu z inwestycji w działania marketingowe.
  • Wyświetlaj ścieżki wielokanałowe w nowych środowiskach. Możesz na przykład tworzyć wizualizacje i inne prezentacje danych, które przedstawiają wartość różnych kanałów marketingowych w zwiększaniu liczby konwersji.

Omówienie koncepcji

Podstawowe koncepcje leżące u podstaw interfejsu API do raportowania ścieżek wielokanałowych to:

  • Jaki jest związek raportów z użytkownikami i wyświetleniami (profilami).
  • Struktura raportu i sposób tworzenia zapytań.
  • Dane ścieżki konwersji i koncepcje atrybucji.
  • Praca z odpowiedzią interfejsu API.

Raporty, użytkownicy i widoki danych (profile)

Aby zażądać danych z raportu dotyczących użytkownika, aplikacja musi zidentyfikować tego użytkownika i określić widok (profil), z którego mają być pobierane dane. Użytkownik jest identyfikowany przez uzyskanie danych uwierzytelniających i przekazywanie ich w każdym żądaniu do interfejsu API. Widok (profil) jest identyfikowany przez identyfikator widoku danych (profilu). Widoki danych (profile) oraz inne elementy wchodzą w skład hierarchii konfiguracji Google Analytics. Aby przemierzyć tę hierarchię i uzyskać identyfikator widoku (profilu), Twoja aplikacja może użyć interfejsu Manage Management API.

Wysyłanie zapytań o wymiary i dane

Wysyłasz zapytanie do interfejsu API, aby uzyskać dane do raportu Google Analytics, na które składają się wymiary i dane. Dane to indywidualne pomiary aktywności użytkowników, np. liczba i wartości konwersji. Wymiary dzielą dane według niektórych wspólnych kryteriów i mogą być wartościami podstawowymi reprezentującymi poszczególne zdarzenia interakcji na ścieżkach konwersji lub sekwencjami reprezentującymi serię zdarzeń interakcji na wszystkich ścieżkach konwersji.

W Przewodniku po wymiarach i danych znajdziesz wszystkie wymiary i dane udostępniane przez interfejs API. Przeczytaj też Przewodnik po interfejsie API raportowania ścieżek wielokanałowych, aby dowiedzieć się, jak określić wymiary i dane w zapytaniu do interfejsu API.

Dane ścieżki konwersji i koncepcje atrybucji

Raporty te są generowane na podstawie ścieżek konwersji, czyli sekwencji interakcji (np. kliknięć/odesłań z kanałów), które doprowadziły do poszczególnych konwersji i transakcji. Ścieżki konwersji są zbierane za pomocą pliku cookie Google Analytics, który rejestruje interakcje tej samej przeglądarki i tej samej maszyny. Dane ścieżek wielokanałowych łączą dane o konwersjach Google Analytics z sekwencją interakcji zarejestrowanych w pliku cookie.

Zapytania dotyczące raportów Ścieżki wielokanałowe zwracają dane na podstawie przykładowego zbioru obejmującego milion ścieżek konwersji. Jeśli zakres dat obejmuje łączną liczbę konwersji nieprzekraczającą 1 miliona, raport będzie niespróbkowany. W przeciwnym razie do wygenerowania wyników zostanie użyty zbiór próbkowy 1 mln. Inaczej niż w przypadku podstawowego raportowania, którego próbkowanie odbywa się na podstawie sesji. Więcej informacji na temat danych i powiązanych pojęć znajdziesz w artykule Dane ścieżek wielokanałowych – informacje. Może Ci się też przydać artykuł Analiza udziału kanału, w którym znajdziesz podstawowe pojęcia takie jak konwersje wspomagane.

Praca z raportami

Dane zwrócone przez interfejs API można traktować jako tabelę z nagłówkiem i listą wierszy. Każda odpowiedź interfejsu API składa się z nagłówka opisującego nazwę i typ danych poszczególnych kolumn. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz to lista komórek z danymi w tej samej kolejności co nagłówki. Więcej informacji o odpowiedzi interfejsu API znajdziesz w Przewodniku po interfejsie API do raportowania ścieżek wielokanałowych.

Każda wartość w komórce zawiera wartość prostą typu ciąg znaków lub wartość ścieżki konwersji. Wartość tej ścieżki konwersji to tablica obiektów reprezentujących wszystkie węzły tej ścieżki. Na podstawie informacji o typie z nagłówków kolumn możemy przeanalizować wartości poszczególnych komórek według odpowiedniego typu. Więcej na ten temat znajdziesz tutaj.

Zasady dotyczące limitów

Zapytanie o dane dotyczące ścieżek wielokanałowych obejmuje miliony operacji. Aby zabezpieczyć system przed otrzymywaniem większej liczby operacji, niż jest w stanie obsłużyć, oraz zagwarantować sprawiedliwy rozkład zasobów systemu, warto zastosować system limitów. Więcej informacji znajdziesz w przewodniku dotyczącym limitów i limitów.

Dalsze kroki

Skoro wiesz już, jak działa interfejs API, udostępniamy Ci materiały, które pomogą Ci rozpocząć pracę: