Przypadki użycia platformy Measurement Protocol

Measurement Protocol Google Analytics umożliwia przesyłanie danych offline do strumienia danych z witryny lub aplikacji, oprócz danych, które już zbierasz za pomocą tagowania lub pakietu SDK Firebase.

W tym przewodniku opisujemy typowe przypadki użycia Measurement Protocol w Google Analytics i ich wymagania.

Podsumowanie wymagań

W tabeli poniżej znajdziesz krótki przegląd wymagań poszczególnych przypadków użycia. Pamiętaj o tych sprawdzonych metodach:

  1. Parametr timestamp_micros w zdarzeniach i właściwościach użytkownika podaje domyślnie czas żądania. Przy wysyłaniu zmiany, która miała miejsce w przeszłości, a dotyczy zdarzenia lub właściwości użytkownika, zastąp sygnaturę czasową w sposób podany w przewodniku po wysyłaniu zdarzeń i po właściwościach użytkownika.

  2. Aby otrzymywać dokładne raporty Czas rzeczywisty i wskaźniki zaangażowania, przekazuj parametr zdarzenia engagement_time_msec podający liczbę milisekund, która upłynęła od poprzedniego zdarzenia.

Przypadek użycia Identyfikator sesji Wymaganie dotyczące czasu żądania Wymaganie timestamp_micros
Przypisywanie identyfikatorów User-ID do zdarzeń Wymagane <= koniec sesji, dzień roboczy początku sesji >= początek sesji oraz <= koniec sesji
Atrybucja sesji Wymagane <= początek sesji + 24 godziny >= początek sesji oraz <= koniec sesji
Eksportowanie zdarzeń na platformy reklamowe Niewymagane <= dzień ostatniej sesji + 63 dni >= czas żądania minus 72 godziny i <= czas żądania
Wysyłanie zdarzeń lub właściwości użytkownika na potrzeby tworzenia list odbiorców Niewymagane Internet: <= czas najnowszego zdarzenia online + 30 dni
Aplikacja: <= czas najnowszego zdarzenia online + 42 dni		 >= czas żądania minus 72 godziny i <= czas żądania

Przypisywanie identyfikatorów User-ID do zdarzeń

Używaj Measurement Protocol, aby przekazywać zdarzenia online lub offline z identyfikatorem User-ID.

Oto przykładowe przypadki użycia dodawania identyfikatora User-ID do zdarzenia:

  1. Twoje pomiary online nie zawierają informacji potrzebnych do wyszukania identyfikatora użytkownika w przypadku zdarzeń online, ale masz potok przetwarzania zdarzeń, który może powiązać sesję online z identyfikatorem użytkownika.

    W tym scenariuszu używasz Measurement Protocol do przekazywania zdarzeń online z identyfikatorem User-ID.

  2. Nie masz identyfikatora User-ID w przypadku zdarzeń wysyłanych za pomocą protokołu Measurement Protocol, ale chcesz, aby te zdarzenia były powiązane z identyfikatorem User-ID, jeśli użytkownik zaloguje się online w trakcie sesji.

    W tym scenariuszu używasz zdarzeń online, aby przekazywać zdarzenia Measurement Protocol z identyfikatorem użytkownika.

Oto wymagania dotyczące dodawania identyfikatora User-ID do zdarzenia:

  • Dodaj session_id do listy parametrów zdarzenia.
  • Wysyłaj zdarzenia Measurement Protocol w tym samym dniu roboczym co sesja online.
  • Jeśli zastąpisz parametr timestamp_micros, ustaw go na sygnaturę czasową między czasem rozpoczęcia a zakończenia sesji online.
  • Jeśli chcesz podać identyfikator User-ID dla zdarzeń online, ustaw w żądaniu parametr user_id.
  • Jeśli chcesz, aby każde zdarzenie Measurement Protocol miało identyfikator User-ID z odpowiedniej sesji online, nie musisz ustawiać parametru user_id.

Atrybucja sesji

Zdarzenia platformy Measurement Protocol, które spełniają określone wymagania, pojawiają się w raportach z tymi samymi atrybutami sesji (np. informacje geograficzne, źródło, medium i kampania) co zdarzenia online z tej samej sesji.

Oto wymagania dotyczące atrybucji sesji:

  • Dodaj session_id do listy parametrów zdarzenia.

  • Wyślij prośbę nie później niż 24 godziny po rozpoczęciu sesji online.

    Jeśli np. sesja rozpoczęła się o 11:15 w poniedziałek w strefie czasowej Twojej usługi, wyślij żądanie przed 11:15 we wtorek.

  • Jeśli zastąpisz parametr timestamp_micros, ustaw go na sygnaturę czasową między czasem rozpoczęcia a zakończenia sesji online.

Eksportowanie zdarzeń na platformy reklamowe

Google Analytics uwzględnia zdarzenia wysyłane za pomocą Measurement Protocol w eksportach do połączonych usług reklamowych, takich jak Google Ads czy Campaign Manager 360.

Oto kilka typowych scenariuszy, w których ta funkcja może być przydatna:

  • Twoja firma organizuje wydarzenia offline, które chcesz uwzględniać w atrybucji i raportowaniu reklam.
  • Masz dodatkowe zdarzenia w systemie, który nie jest dostępny dla tagowania ani pakietu SDK Firebase, ale nadal chcesz uwzględniać te zdarzenia w połączonych usługach.

Oto wymagania dotyczące eksportowania zdarzeń na platformy reklamowe:

  • Wyślij prośbę nie później niż 63 dni po ostatnim zdarzeniu online, nawet jeśli okno atrybucji kluczowego zdarzenia jest dłuższe niż 63 dni. Zdarzenie musi też nastąpić w okresie atrybucji kluczowego zdarzenia. Dowiedz się, jak skonfigurować ustawienia okna atrybucji.

    Jeśli na przykład ostatnie zdarzenie online dla elementu client_id lub app_instance_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej 3 maja.

  • Jeśli zastępujesz parametr timestamp_micros, ustaw go na sygnaturę czasową z ostatnich 72 godzin.

Wysyłanie zdarzeń lub właściwości użytkownika na potrzeby tworzenia list odbiorców

Zdarzenia i właściwości użytkownika wysyłane za pomocą Measurement Protocol są uwzględniane w ocenie warunków odbiorców, jeśli spełniasz kilka wymagań.

Oto wymagania dotyczące wysyłania zdarzeń lub właściwości użytkownika na potrzeby tworzenia list odbiorców:

  • Prześlij żądanie do strumienia danych z internetu nie później niż 30 dni po ostatnim zdarzeniu online dotyczącym tego samego client_id.

    Jeśli na przykład ostatnie zdarzenie online dla elementu client_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej 31 marca.

  • Wysyłaj żądanie do strumienia aplikacji nie później niż 42 dni po ostatnim zdarzeniu online dla tego samego app_instance_id.

    Jeśli na przykład ostatnie zdarzenie online dotyczące app_instance_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej 12 kwietnia.

  • Jeśli zastępujesz wartość parametru timestamp_micros, ustaw ją na sygnaturę czasową z ostatnich 72 godzin.