Przypadki użycia platformy Measurement Protocol

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

W tym przewodniku opisano typowe przypadki użycia platformy 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 do dostarczania zdarzeń online lub offline z identyfikatorem User-ID.

Oto kilka przykładowych przypadków użycia dodawania identyfikatora User-ID do zdarzenia:

1. W pomiarach online brakuje informacji potrzebnych do wyszukania identyfikatora User-ID dla zdarzeń online, ale masz potok przetwarzania zdarzeń, który może powiązać sesję online z identyfikatorem User-ID.

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

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

   W tym scenariuszu używasz zdarzeń online, aby dostarczać zdarzenia Measurement Protocol z identyfikatorem User-ID.

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

• Uwzględnij parametr session_id na liście parametrów zdarzenia.
• Wysyłaj zdarzenia Measurement Protocol w tym samym dniu roboczym, w którym miała miejsce 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 Twoim celem jest podanie identyfikatora 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. informacjami geograficznymi, źródłem, medium i kampanią) co zdarzenia online z tej samej sesji.

Oto wymagania dotyczące atrybutów sesji:

• Uwzględnij parametr session_id na liście 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ę w poniedziałek o 11:15 według strefy 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 sytuacji, w których jest to przydatne:

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

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

• Wyślij żądanie 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ż zostać zarejestrowane w oknie atrybucji kluczowego zdarzenia. Dowiedz się, jak skonfigurować ustawienia okna atrybucji.

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

• Jeśli zastąpisz 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 dotyczących list 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:

• Wyślij prośbę do strumienia danych z sieci nie później niż 30 dni po ostatnim zdarzeniu online dotyczącym tego samego parametru client_id.

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

• Wyślij żądanie do strumieniowego przesyłania aplikacji nie później niż 42 dni po najnowszym zdarzeniu online dla tego samego parametru app_instance_id.

  Jeśli np. ostatnie zdarzenie online dla identyfikatora app_instance_id miało miejsce 1 marca, zdarzenie Measurement Protocol należy wysłać najpóźniej 12 kwietnia.

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