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 uwierzytelnionych użytkowników. Dane pochodzą z danych o ścieżce konwersji, które wskazują interakcje użytkowników z różnymi źródłami wizyt na przestrzeni wielu sesji przed konwersją. Pozwala to analizować, jak różne kanały marketingowe wpływają na konwersje na przestrzeni czasu. Aby dowiedzieć się więcej o dostępnych danych, przeczytaj artykuły Informacje o ścieżkach wielokanałowych i Dane ścieżek wielokanałowych – informacje.

Za pomocą interfejsu API do raportowania ścieżek wielokanałowych możesz:

  • Tworzenie raportów niestandardowych przy użyciu danych ścieżek wielokanałowych. Możesz np. użyć danych Najważniejsze ścieżki konwersji, aby tworzyć raporty o atrybutach 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świetlanie ścieżek wielokanałowych 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

Podstawowe pojęcia związane z interfejsem API do raportowania ścieżek wielokanałowych to:

  • Jaki jest związek raportów z użytkownikami i widokami (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 do raportu dotyczących użytkownika, aplikacja musi zidentyfikować tego użytkownika i określić widok (profil), dla którego mają być pobierane dane. Użytkownik jest identyfikowany przez uzyskanie danych uwierzytelniających i przekazanie ich w każdym żądaniu do interfejsu API. Widok (profil) jest identyfikowany przez identyfikator widoku (profilu). Widoki danych (profile) są m.in. częścią hierarchii konfiguracji Google Analytics. Aby przemierzyć tę hierarchię i uzyskać identyfikator widoku (profilu), aplikacja może użyć interfejsu Manage Management API.

Zapytania dotyczące wymiarów i danych

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

Wszystkie wymiary i dane udostępniane przez interfejs API znajdziesz w Przewodniku po wymiarach i danych. Przeczytaj też Przewodnik po interfejsie API raportowania ścieżek wielokanałowych, z którego dowiesz się, jak określić wymiary i dane w zapytaniu do interfejsu API.

Dane ścieżek 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. Dane o ścieżkach konwersji są zbierane za pomocą pliku cookie Google Analytics, który rejestruje interakcje tej samej przeglądarki i maszyny. Dane ścieżek wielokanałowych łączą dane o konwersjach z 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 zawierającego milion ścieżek konwersji. Jeśli w zakresie dat łączna liczba konwersji nie przekracza 1 miliona, raport będzie niespróbkowany. W przeciwnym razie do wygenerowania wyników zostanie użyty zbiór próbkowy 1 mln. Inaczej jest to z funkcją podstawowego raportowania, która próbkuje dane na podstawie sesji. Więcej informacji o danych i powiązanych z nimi zagadnieniach znajdziesz w artykule Dane ścieżek wielokanałowych – informacje. Możesz także przeczytać artykuł Analiza udziału kanału, w którym zdefiniowano 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 w każdej kolumnie. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz jest listą 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ść komórki zawiera wartość prostą typu ciąg znaków lub wartość ścieżki konwersji. Wartość ścieżki konwersji to tablica obiektów reprezentujących wszystkie węzły tej ścieżki. Możemy użyć informacji o typie z nagłówków kolumn, aby przeanalizować wartość każdej komórki pod kątem odpowiedniego typu. Więcej na ten temat znajdziesz tutaj.

Zasady dotyczące limitów

Zapytanie o dane ścieżek wielokanałowych obejmuje miliony operacji. Wdrożenie systemu limitów pozwala chronić system przed otrzymywaniem większej liczby operacji, niż jest w stanie obsłużyć, a także zapewnia równomierny rozkład zasobów systemowych. Więcej informacji znajdziesz w przewodniku Limity i limity.

Dalsze kroki

Skoro wiesz już, jak działa interfejs API, skorzystaj z tych materiałów, aby rozpocząć: