Measurement Protocol umożliwia wysyłanie danych offline do strumienia danych z sieci lub aplikacji w oprócz danych, które zbierasz już za pomocą tagowania lub pakietu SDK Firebase.
W tym przewodniku opisano typowe przypadki użycia Google Analytics Measurement Protocol i związane z nimi wymagania.
Podsumowanie wymagań
W tej tabeli podano krótkie omówienie wymagań związanych z każdym zastosowaniem tych kwestii. Pamiętaj o tych sprawdzonych metodach:
Elementem
timestamp_micros
zdarzeń i właściwości użytkownika jest domyślnie żądanie obecnie się znajdujesz. Podczas wysyłania zdarzenia lub zmiany właściwości użytkownika, która nastąpiła w zastąp sygnaturę czasową zgodnie z opisem w przewodniku po wysyłaniu zdarzeń. zapoznaj się z przewodnikiem po właściwościach użytkownika.Aby uzyskać dokładne raporty Czas rzeczywisty i wskaźniki zaangażowania, uwzględnij Parametr zdarzenia
engagement_time_msec
został ustawiony na milisekundy, które upłynęły od poprzednim zdarzeniem.
Przypadek użycia | Identyfikator sesji | Wymagany czas przesyłania prośby | Wymagania: timestamp_micros |
---|---|---|---|
Przypisywanie funkcji User-ID do zdarzeń | Wymagane | <= koniec dnia roboczego sesji | >= początek sesji i <= koniec sesji |
Atrybucja sesji | Wymagane | <= początek sesji + 24 godziny | >= początek sesji i <= koniec sesji |
Eksportowanie zdarzeń na platformy reklamowe | Niewymagane | <= ostatnia sesja – dzień roboczy + 63 dni | <= czas żądania |
Wysyłanie zdarzeń lub właściwości użytkownika na potrzeby listy odbiorców tworzenie | Niewymagane | Internet: <= ostatnie wydarzenie online + 30 dni Aplikacja: <= najnowsze wydarzenie online + 42 dni |
<= czas żądania |
Przypisywanie funkcji User-ID do zdarzeń
Korzystając z platformy Measurement Protocol, możesz udostępniać zdarzenia online lub offline za pomocą User-ID.
Oto kilka przykładów użycia funkcji User-ID do zdarzenia:
W pomiarach online brakuje informacji potrzebnych do wyszukiwania User-ID dla zdarzeń online, ale masz potok przetwarzania zdarzeń, potrafi utworzyć powiązanie między sesją online a identyfikatorem User-ID.
W tym scenariuszu używasz platformy Measurement Protocol online z identyfikatorem User-ID.
Nie masz identyfikatora User-ID dla zdarzeń wysyłanych za pomocą Measurement Protocol, ale chcesz, aby te zdarzenia były powiązane ze stroną User-ID, jeśli użytkownik zalogował się online w trakcie sesji.
W tym scenariuszu korzystasz z wydarzeń online, aby zapewnić Zdarzenia Measurement Protocol z identyfikatorem User-ID.
Oto wymagania, które musisz spełnić, aby dodać do zdarzenia identyfikator User-ID:
- Dodaj
session_id
do listy parametrów zdarzenia. - Wysyłaj zdarzenia Measurement Protocol w tym samym dniu roboczym co podczas sesji online.
- Jeśli zastępujesz
timestamp_micros
, ustaw go na sygnaturę czasową między tagami rozpoczęcia i zakończenia sesji online. - Jeśli Twoim celem jest udostępnianie funkcji User-ID w przypadku zdarzeń online, ustaw
user_id
w do ich przesłania. - Jeśli celem jest użycie identyfikatora User-ID dla każdego zdarzenia Measurement Protocol
z odpowiedniej sesji online, nie musisz ustawiać elementu
user_id
.
Atrybucja sesji
W raportach pojawiają się zdarzenia Measurement Protocol, które spełniają określone wymagania o tych samych atrybutach sesji (takich jak informacje geograficzne, źródło, medium i kampania) jako zdarzenia online z tej samej sesji.
Oto wymagania dotyczące atrybucji sesji:
- Dodaj
session_id
do listy parametrów zdarzenia. Prośbę należy wysłać nie później niż 24 godziny od rozpoczęcia procesu online. .
Jeśli na przykład sesja rozpoczęła się o 11:15 w poniedziałek na stronie strefę czasową, wyślij żądanie przed 11:15 we wtorek.
Jeśli zastępujesz
timestamp_micros
, ustaw go na sygnaturę czasową między tagami rozpoczęcia i 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, np. Google Ads lub Campaign Managera. 360.
Oto kilka typowych scenariuszy, w których jest to przydatne:
- Twoja firma ma wydarzenia offline, które chcesz uwzględnić w reklamach atrybucjami i raportowaniem.
- Masz w systemie dodatkowe zdarzenia, których nie można tagować, lub pakietu SDK Firebase, ale chcesz uwzględnić te zdarzenia w sekcji połączonych kont usług.
Oto wymagania dotyczące eksportowania zdarzeń na platformy reklamowe:
Prośbę należy wysłać nie później niż do końca dnia roboczego 63 dni po najnowszego zdarzenia online, nawet jeśli okno atrybucji kluczowego zdarzenia jest dłuższe, niż 63 dni.
Jeśli na przykład ostatnie wydarzenie online z
client_id
lubapp_instance_id
wystąpiło 1 marca. Wyślij Measurement Protocol nie później niż pod koniec dnia roboczego 3 maja.Jeśli zastępujesz
timestamp_micros
, ustaw sygnaturę czasową mniejszą lub równą do czasu żądania.
Wysyłanie zdarzeń lub właściwości użytkownika na potrzeby utworzenia listy odbiorców
Zdarzenia i właściwości użytkownika wysyłane za pomocą platformy Measurement Protocol są uwzględniane w raportach ocenę warunków odbiorców, jeśli spełniasz kilka wymagań.
Oto wymagania dotyczące wysyłania zdarzeń lub właściwości użytkownika w przypadku list odbiorców stworzenie:
Wyślij żądanie do strumienia danych z sieci nie później niż do końca dnia roboczego 30 dni po ostatnim wydarzeniu online dla tego samego zdarzenia (
client_id
).Jeśli na przykład ostatnie zdarzenie online w domenie
client_id
miało miejsce 1 marca należy wysłać zdarzenie Measurement Protocol nie później niż pod koniec dniu roboczym w dniu 31 marca.Wyślij żądanie do strumienia danych z aplikacji nie później niż do końca dnia roboczego 42 dni po ostatnim wydarzeniu online z tego samego zdarzenia (
app_instance_id
).Jeśli na przykład wystąpiło ostatnie zdarzenie online w domenie
app_instance_id
1 marca wyślij zdarzenie Measurement Protocol nie później niż do końca w dniu roboczym 12 kwietnia.Jeśli zastępujesz właściwość
timestamp_micros
, ustaw ją na sygnaturę czasową mniejszą lub równą do czasu żądania.