Odniesienie do platformy Measurement Protocol

Na tej stronie opisujemy mechanizm transportu i parametry danych protokołu Measurement Protocol.

Transport

Wszystkie dane muszą być przesyłane w bezpieczny sposób za pomocą żądań HTTPS POST.

Wysyłaj żądania do tego punktu końcowego:

https://www.google-analytics.com/mp/collect

Jeśli chcesz, aby Twoje dane były przetwarzane w UE, użyj tego punktu końcowego:

https://region1.google-analytics.com/mp/collect

Oto przykładowa prośba POST:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

Zastąp PAYLOAD_DATA ładunkiem żądania.

Jeśli otrzymane zostanie żądanie HTTP, Measurement Protocol zwróci kod stanu 2xx. Measurement Protocol nie zwraca kodu błędu, jeśli ładunek jest zniekształcony, dane są nieprawidłowe lub nie są przetwarzane przez Google Analytics.

Ładunek

Ładunek składa się z 2 części:

1. Parametry zapytania.
2. Treść POST w formacie JSON.

Parametry zapytania

Treść żądania POST w formacie JSON

Zgoda

Atrybut consent konfiguruje typy i stany zgody. Jeśli nie podasz wartości parametru consent, Google Analytics użyje ustawień dotyczących zgody z odpowiednich interakcji online na kliencie lub w instancji aplikacji.

Informacje geograficzne

Atrybuty user_location i ip_override zawierają informacje geograficzne. Zasada user_location ma pierwszeństwo przed zasadą ip_override.

Oto struktura pola user_location. Podaj jak najwięcej atrybutów. Zalecamy co najmniej country_id i region_id.

Oto przykładowa user_location:

"user_location:" {
  "city:" "Mountain View",
  "region_id:" "US-CA",
  "country_id:" "US",
  "subcontinent_id:" "021",
  "continent_id:" "019"
}

ip_override to alternatywa dla user_location. Jeśli zamiast tego wyślesz ip_override, Google Analytics uzyska informacje geograficzne na podstawie adresu IP. Jeśli wyślesz user_location, Google Analytics zignoruje ip_override.

Jeśli nie wysyłasz zdarzeń user_location ani ip_override, Google Analytics uzyskuje informacje geograficzne na podstawie zdarzeń tagowania za pomocą tagu client_id.

Google Analytics stosuje do żądania ustawienia szczegółowe dotyczące danych o lokalizacji usługi niezależnie od wysłanych informacji geograficznych.

Informacje o urządzeniu

Aby wysłać informacje o urządzeniu, użyj pola device. Oto struktura pola device. Podaj jak najwięcej atrybutów. Zalecamy co najmniej category.

Ten fragment kodu pokazuje przykład ustawień device:

"device:" {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

Niezależnie od tego, czy podasz parametr Google Analytics stosuje do zapytania ustawienia szczegółowych danych o urządzeniach usługi.

Parametry niestandardowe

W danych Measurement Protocol możesz uwzględniać parametry niestandardowe ograniczone do użytkownika, zdarzenia lub produktu.

• user_properties może zawierać parametry niestandardowe ograniczone do użytkownika.
• events[].params może zawierać parametry niestandardowe ograniczone do zdarzenia.
• Parametry niestandardowe ograniczone do produktu można uwzględnić w pliku items.

Zalecane wartości w przypadku niektórych zdarzeń

Niektóre zdarzenia mają zalecane parametry. Informacje o zalecanych parametrach wszystkich obsługiwanych zdarzeń znajdziesz w sekcji Zdarzenia.

Zarezerwowane nazwy

Niektóre nazwy zdarzeń, parametrów i właściwości użytkownika są zarezerwowane i nie można ich używać:

Zarezerwowane nazwy zdarzeń

Te nazwy zdarzeń są zarezerwowane i nie można ich używać:

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

Zastrzeżone nazwy parametrów

Te nazwy parametrów są zarezerwowane i nie można ich używać:

• firebase_conversion

Nazwy parametrów nie mogą się zaczynać od:

• _ (underscore)
• firebase_
• ga_
• google_
• gtag.

Zarezerwowane nazwy właściwości użytkownika

Te nazwy właściwości użytkownika są zarezerwowane i nie można ich używać:

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

Oprócz tego nazwy właściwości użytkownika nie mogą się zaczynać od:

• _ (underscore)
• firebase_
• ga_
• google_