Przypadki użycia platformy Measurement Protocol

Protokół pomiarowy 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 platformy Measurement Protocol, aby przekazywać zdarzenia online lub offline z identyfikatorem User-ID.

Oto kilka przykładowych przypadków 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 platformy Measurement Protocol do przekazywania zdarzeń online z identyfikatorem użytkownika.

2. Nie masz identyfikatora User-ID w przypadku zdarzeń wysyłanych za pomocą protokołu pomiarowego, 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 podawać identyfikator User-ID w przypadku zdarzeń online, ustaw w żądaniu parametr user_id.
• Jeśli chcesz, aby każde zdarzenie protokołu 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 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.
• W systemie, który nie jest dostępny dla tagowania ani pakietu SDK Firebase, masz dodatkowe zdarzenia, ale nadal chcesz uwzględniać je w połączonych usługach.

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

• Wyślij prośbę nie później niż do końca dnia roboczego 63 dni po ostatnim zdarzeniu online, nawet jeśli okres atrybucji kluczowego zdarzenia jest dłuższy niż 63 dni.

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

• Jeśli zastępujesz wartość timestamp_micros, ustaw ją na sygnaturę czasową z ostatnich 3 dni roboczych.

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ż do końca dnia roboczego 30 dni po ostatnim zdarzeniu online dotyczącym tego samego client_id.

  Jeśli np. ostatnie zdarzenie online dotyczące client_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej do końca dnia roboczego 31 marca.

• Prześlij żądanie do strumienia danych z aplikacji nie później niż do końca dnia roboczego 42 dni po najnowszym zdarzeniu online dotyczącym tego samego app_instance_id.

  Jeśli np. ostatnie zdarzenie online dla app_instance_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej do końca dnia roboczego 12 kwietnia.

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