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.

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 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 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 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.
  • 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:

  • Wysyłaj prośbę nie później niż 63 dni po ostatnim zdarzeniu online, nawet jeśli okres ważności kluczowego zdarzenia jest dłuższy niż 63 dni.

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

  • Jeśli zastępujesz wartość parametru timestamp_micros, ustaw ją 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:

  • Żądanie należy wysłać 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 wydarzenie online dla elementu client_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol najpóźniej 31 marca.

  • Wyślij żądanie do strumienia aplikacji nie później niż 42 dni po ostatnim zdarzeniu online dotyczącym 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 nie później niż 12 kwietnia.

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