Co to jest wielokanałowy interfejs API do raportowania? Omówienie

Ten dokument zawiera ogólny przegląd interfejsu API do raportowania ścieżek wielokanałowych. Szczegółowe informacje o interfejsie API znajdziesz w przewodniku.

Wprowadzenie

Interfejs API do raportowania ścieżek wielokanałowych umożliwia przesyłanie żądań danych o ścieżkach wielokanałowych uwierzytelnionych użytkowników. Dane pochodzą z danych ścieżki konwersji, które wskazują interakcje użytkowników z różnymi źródłami wizyt w wielu sesjach przed konwersją. Dzięki temu możesz analizować wpływ wielu kanałów marketingowych na konwersje na przestrzeni czasu. Więcej informacji o dostępnych danych znajdziesz w artykułach na temat ścieżek wielokanałowych oraz danych o ścieżkach wielokanałowych.

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

  • Twórz raporty niestandardowe, korzystając z danych o ścieżkach wielokanałowych. Możesz np. użyć danych Najważniejsze ścieżki konwersji, aby raportować takie atrybuty jak względna pozycja interakcji na ścieżce konwersji.
  • Integracja danych ścieżek wielokanałowych z firmowymi bazami danych. Możesz na przykład powiązać dane o konwersjach online z danymi o sprzedaży offline i danymi o kosztach mediów, aby uzyskać pełniejszy obraz zwrotu z inwestycji w marketing.
  • Wyświetl ścieżki wielokanałowe w nowych środowiskach. Możesz na przykład utworzyć wizualizacje i inne prezentacje danych, które informują o wartości różnych kanałów marketingowych w generowaniu konwersji.

Koncepcyjne omówienie

Podstawowe zagadnienia, które dotyczą interfejsu API do raportowania ścieżek wielokanałowych, to:

  • W jaki sposób raporty odnoszą się do użytkowników i wyświetleń (profili).
  • Struktura raportu i sposób tworzenia zapytań
  • Dane ścieżki konwersji i koncepcje atrybucji
  • Praca z odpowiedzią interfejsu API.

Raporty, Użytkownicy i Wyświetlenia (Profile)

Aby można było wysłać prośbę o dane do użytkownika, aplikacja musi go zidentyfikować i określić widok (profil), który umożliwi pobranie danych. Użytkownik jest identyfikowany przez uzyskanie danych logowania i przekazanie ich w każdym żądaniu do interfejsu API. Widok (profil) jest identyfikowany przez identyfikator widoku (profil). Widoki (profile) należą do hierarchii konfiguracji Google Analytics. Twoja aplikacja może używać interfejsu Management API do poruszania się po hierarchii i uzyskiwania identyfikatora widoku danych.

Wysyłanie zapytań o wymiary i dane

Wysyłasz zapytania dotyczące danych raportu w interfejsie API Google Analytics, które składają się z wymiarów i danych. Dane to indywidualne pomiary aktywności użytkownika, np. liczba konwersji i wartości. 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 całych ścieżkach konwersji.

Skorzystaj z Przewodnika po wymiarach i danych, aby poznać wszystkie wymiary i dane widoczne w interfejsie API. Przeczytaj także Przewodnik dotyczący interfejsu API raportowania ścieżek wielokanałowych, aby dowiedzieć się, jak określić wymiary i dane w zapytaniu interfejsu API.

Dane ścieżki konwersji i koncepcje atrybucji

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

Zapytania w raporcie Ścieżki wielokanałowe zwracają dane na podstawie przykładowego zbioru 1 miliona ścieżek konwersji. Jeśli zakres dat zawiera łączną liczbę konwersji nieprzekraczającą 1 mln, raport nie będzie próbkowany. W przeciwnym razie do wygenerowania wyników zostanie użyty przykładowy zbiór zawierający 1 milion. Jest to sprzeczne z funkcją podstawowego raportowania, która próbka jest oparta na sesjach. Więcej informacji o danych i powiązanych pojęciach znajdziesz w artykule Dane ścieżek wielokanałowych. Warto zapoznać się też z artykułem Analizowanie udziału kanału, w którym definiujemy podstawowe pojęcia, takie jak konwersje wspomagane.

Praca z raportami

Dane zwracane 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 każdej kolumny. 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ść komórki zawiera wartość podstawową typu ciągu znaków lub wartość ścieżki konwersji. Ta wartość ścieżki konwersji to tablica obiektów reprezentujących wszystkie węzły tej ścieżki. Na podstawie informacji o typie w nagłówkach kolumn możemy przeanalizować wartości poszczególnych komórek. Więcej dowiesz się tutaj.

Zasady dotyczące limitów

Zapytanie o dane ścieżek wielokanałowych obsługuje miliony operacji. Aby chronić system przed odbieraniem większej liczby operacji, niż może obsłużyć, a także aby zapewnić sprawiedliwy rozkład zasobów systemowych, musisz zastosować system limitów. Więcej informacji znajdziesz w przewodniku Limity i limit.

Następne kroki

Wiesz już, jak działa interfejs API, dlatego udostępniamy przeznaczone dla Ciebie zasoby.