Wysyłaj zdarzenia Measurement Protocol do Google Analytics

Z tego przewodnika dowiesz się, jak wysyłać zdarzenia z sieci i aplikacji protokołu pomiaru Google Analytics na serwer Google Analytics, aby wyświetlać zdarzenia z platformy Measurement Protocol w raportach Google Analytics.

Wybierz platformę, którą chcesz wyświetlić w tym przewodniku:

Formatowanie żądania

Measurement Protocol do Google Analytics 4 obsługuje tylko żądania HTTP POST.

Aby wysłać zdarzenie, użyj tego formatu:

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

W adresie URL prośby musisz podać:

  • api_secret: SECRET interfejsu API wygenerowany w interfejsie użytkownika Google Analytics.

    Aby utworzyć nowy obiekt tajny, kliknij Administracja > Strumienie danych > wybierz swój strumień > Measurement Protocol > Utwórz.

  • measurement_id: identyfikator pomiaru powiązany ze strumieniem, który znajdziesz w interfejsie Google Analytics w sekcji Administracja > Strumienie danych > wybierz strumień > Identyfikator pomiaru.

    measurement_id nie jest Twoim identyfikatorem strumienia.

Dokładne informacje znajdziesz w sekcji Parametry zapytania.

W treści żądania musisz podać:

  • client_id: unikalny identyfikator klienta. Różni się to od app_instance_id w Firebase. Użyj tagu gtag.js('get').

  • user_id: opcjonalnie. Unikalny identyfikator użytkownika. Może zawierać tylko znaki UTF-8. Więcej informacji o tym identyfikatorze znajdziesz w sekcji Korzystanie z funkcji User-ID do analizy obejmującej wiele platform.

  • consent: opcjonalnie. Dowiedz się, jak skonfigurować ustawienia dotyczące zgody użytkownika.

  • events: tablica elementów zdarzeń. W jednym żądaniu możesz uwzględnić wiele zdarzeń.

    Aby aktywność użytkownika była wyświetlana w raportach takich jak Czas rzeczywisty, wartości engagement_time_msec i session_id muszą być dostarczone w ramach elementu params dotyczącego event. Parametr engagement_time_msec powinien odzwierciedlać czas zaangażowania zdarzenia w milisekundach.

    Oto przykład:

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Chociaż session_start to zarezerwowana nazwa zdarzenia, utworzenie nowej sesji session_id spowoduje utworzenie nowej sesji bez konieczności wysyłania zdarzenia session_start. Dowiedz się, jak zliczane są sesje.

Wypróbuj

Aby wysłać zdarzenie tutorial_begin na swój serwer Google Analytics, możesz:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Ograniczenia

W przypadku wysyłania do Google Analytics zdarzeń Measurement Protocol obowiązują te ograniczenia:

  • Prośby mogą obejmować maksymalnie 25 zdarzeń.
  • Zdarzenia mogą zawierać maksymalnie 25 parametrów.
  • Zdarzenia mogą obejmować maksymalnie 25 właściwości użytkownika.
  • Nazwa właściwości użytkownika może mieć maksymalnie 24 znaki.
  • Wartości właściwości użytkownika mogą się składać z maksymalnie 36 znaków.
  • Nazwy zdarzeń mogą mieć maksymalnie 40 znaków, zawierać tylko znaki alfanumeryczne i znaki podkreślenia oraz zaczynać się od litery.
  • Nazwy parametrów (w tym parametry produktów) mogą mieć maksymalnie 40 znaków, zawierać tylko znaki alfanumeryczne i znaki podkreślenia oraz zaczynać się od litery.
  • Wartości parametrów wraz z wartościami parametrów produktów mogą mieć maksymalnie 100 znaków.
  • Parametry produktu mogą mieć maksymalnie 10 parametrów niestandardowych.
  • Treść posta musi być mniejsza niż 130 kB.
  • Atrybucja na poziomie zdarzenia na podstawie zdarzeń Measurement Protocol jest obsługiwana do 63 dni po ostatnim otagowaniu zdarzenia online na potrzeby eksportu konwersji do Google Ads i innych integracji multimedialnych, nawet jeśli okno konwersji dla zdarzenia konwersji jest dłuższe niż 63 dni. W przeciwieństwie do tego atrybucja na poziomie zdarzenia jest obsługiwana w przypadku tagowania zdarzeń online dla całego okna konwersji.
  • Na potrzeby remarketingu możesz złączać zdarzenia Measurement Protocol z powiązanym plikiem cookie lub identyfikatorem urządzenia po upływie maksymalnie kilku dni od ostatniego zdarzenia online:
    • Strumień danych z sieci: 30 dni
    • Strumień danych z aplikacji: 42 dni
  • Zdarzenia z protokołu App Measurement Protocol wysyłane do Google Analytics 4 nie wypełniają w Google Ads list odbiorców w sieci wyszukiwania w przypadku użytkowników aplikacji.