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:
W przypadku zdarzeń i właściwości użytkownika wartość
timestamp_microsjest 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.Aby otrzymywać dokładne raporty Czas rzeczywisty i wskaźniki zaangażowania, przekazuj parametr zdarzenia
engagement_time_msecpodają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:
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.
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_iddo 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_idw żą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_iddo 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_idlubapp_instance_idmiał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_idmiał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_idmiał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.