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.

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.