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 opisujemy typowe przypadki użycia Measurement Protocol 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. W przypadku zdarzeń i właściwości użytkownika wartość timestamp_micros jest domyślnie ustawiana na 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 dotyczące 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 <= ostatni dzień sesji + 63 dni >= czas żądania minus 72 godziny oraz <= czas żądania
Wysyłanie zdarzeń lub właściwości użytkownika na potrzeby tworzenia list odbiorców Niewymagane Sieć: <= czas ostatniego zdarzenia online + 30 dni
Aplikacja: <= czas ostatniego zdarzenia online + 42 dni
>= czas żądania minus 72 godziny oraz <= czas żądania

Przypisywanie identyfikatorów User-ID do zdarzeń

Użyj Measurement Protocol, aby przypisać identyfikator a User-ID do zdarzeń online lub offline.

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

  1. Pomiar online nie zawiera 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, aby przypisać identyfikator User-ID do zdarzeń online.

  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 przypisać identyfikator User-ID do zdarzeń Measurement Protocol.

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ępujesz timestamp_micros, ustaw go na sygnaturę czasową między czasem rozpoczęcia a zakończenia sesji online.
  • Jeśli chcesz przypisać identyfikator User-ID do zdarzeń online, ustaw user_id w żądaniu.
  • Jeśli chcesz, aby każde zdarzenie Measurement Protocol miało identyfikator User-ID z odpowiadającej mu sesji online, nie musisz ustawiać user_id.

Atrybucja sesji

Zdarzenia Measurement Protocol, które spełniają określone wymagania, są wyświetlane w raportach z tymi samymi atrybutami sesji (takimi jak 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 żądanie nie później niż 24 godziny po rozpoczęciu sesji online.

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

  • Jeśli zastępujesz 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 jest przydatna:

  • 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 nadal chcesz uwzględniać te zdarzenia 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ż dotrzeć w oknie atrybucji kluczowego zdarzenia. Dowiedz się, jak skonfigurować ustawienia okna atrybucji.

    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 nie później niż 3 maja.

  • Jeśli zastępujesz 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:

  • Wyślij żądanie do strumienia danych z sieci nie później niż 30 dni po ostatnim zdarzeniu online dla tego samego client_id.

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

  • Wyślij żądanie do strumienia danych z 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 dla app_instance_id miało miejsce 1 marca, wyślij zdarzenie Measurement Protocol nie później niż 12 kwietnia.

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