Measurement Protocol etkinliklerini Google Analytics'e gönderme

Bu kılavuzda Google Analytics Measurement Protocol web ve uygulama akışı etkinlikleri Böylece Measurement Protocol etkinliklerini Google Analytics raporları.

Bu kılavuzda görmek istediğiniz platformu seçin:

İsteği biçimlendirme

Google Analytics Measurement Protocol yalnızca HTTP POST isteklerini destekler.

Bir etkinlik göndermek için aşağıdaki biçimi kullanın:

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

İstek URL'sinde aşağıdakileri sağlamanız gerekir:

  • api_secret: Google Analytics kullanıcı arayüzünde oluşturulan API SECRET.

    Yeni bir gizli anahtar oluşturmak için Yönetici bölümüne gidin > Veri Akışları > seç canlı yayınınıza gidin > Measurement Protocol > Oluştur.

  • measurement_id: Bir akışla ilişkili ölçüm kimliği. Bu kimlik: Google Analytics kullanıcı arayüzünde Yönetici > Veri Akışları > seçtiğiniz akış > Ölçüm Kimliği.

    measurement_id, Akış Kimliğiniz değil.

Tam referans için sorgu parametreleri bölümüne bakın.

İstek gövdesinde aşağıdakileri sağlamanız gerekir:

  • client_id: Müşteri için benzersiz bir tanımlayıcıdır. Bu, Firebase app_instance_id gtag.js('get') kullanın.

  • user_id: İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısıdır. Yalnızca UTF-8 içerebilir karakteri ekleyin. Daha fazla bilgi için Platformlar arası analiz için User-ID bölümüne bakın. hakkında daha fazla bilgi edinin.

  • consent: İsteğe bağlı. Rızayı nasıl ayarlayacağınızı öğrenin Ayarlar'da bulabilirsiniz.

  • timestamp_micros: İsteğe bağlı. için mikrosaniye cinsinden Unix sıfır etkinlikleri ve kullanıcı özelliklerini belirtir. Belirtilmezse varsayılan olarak bilgi edinin.

  • events: Etkinlik öğeleri dizisi. Tek bir etkinliğe birden fazla etkinlik ekleyebilirsiniz isteği gönderin.

    Kullanıcı etkinliğinin, Google Ads gibi raporlarda Gerçek zamanlı, engagement_time_msec ve session_id, event için params. engagement_time_msec parametresi, etkinliğin etkileşim süresini milisaniye cinsinden gösterir.

    Aşağıda bununla ilgili bir örnek verilmiştir:

  {
   "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"
        }
     }
   ]
  }

session_start, rezerve edilmiş bir etkinliktir ad, yeni bir session_id oluşturulduğunda, yeni bir oturum oluşturulur. Bunun için yeni bir session_start Oturumların sayılır.

Dene

Google Hesabınıza tutorial_begin etkinliği göndermek için kullanabileceğiniz bir örneği aşağıda bulabilirsiniz. Analytics sunucusu:

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: {},
    }]
  })
});

Geçersiz kılma zaman damgası

Measurement Protocol, aşağıdaki listede bulduğu ilk zaman damgasını kullanır istekteki her etkinlik için:

  1. Etkinliğin timestamp_micros.
  2. İsteğin timestamp_micros.
  3. Measurement Protocol'un isteği aldığı zaman.

Aşağıdaki örnek, etkinliklerdir. Sonuç olarak, Measurement Protocol hem tutorial_begin ve join_group etkinlik zaman damgası requestUnixEpochTimeInMicros.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

Aşağıdaki örnek hem istek düzeyinde bir zaman damgası hem de etkinlik düzeyinde bir zaman damgası gönderir [timestamp]. Sonuç olarak, Measurement Protocol, tutorial_begin etkinlik zaman damgası: tutorialBeginUnixEpochTimeInMicros ve join_group etkinliğin zaman damgası requestUnixEpochTimeInMicros.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

Sınırlamalar

Measurement Protocol etkinliklerinin Google'a gönderilmesiyle ilgili aşağıdaki sınırlamalar geçerlidir Analiz:

  • İsteklerin en fazla 25 etkinliği olabilir.
  • Etkinlikler en fazla 25 parametreye sahip olabilir.
  • Etkinlikler en fazla 25 kullanıcı özelliğine sahip olabilir.
  • Kullanıcı özelliği adları en fazla 24 karakterden oluşmalıdır.
  • Kullanıcı özelliği değerleri en fazla 36 karakterden oluşmalıdır.
  • Etkinlik adları en fazla 40 karakterden oluşmalıdır ve yalnızca alfanümerik karakterler içerebilir alt çizgi içermeli ve alfabetik karakterle başlamalıdır.
  • Öğe parametrelerini de içeren parametre adları en fazla 40 karakter uzunluğunda olmalıdır. yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve karakteriyle oluşturur.
  • Öğe parametresi değerlerini içeren parametre değerleri 100 karakter veya standart Google Analytics mülkü için daha az ve en fazla 500 karakter sahip olması gerekir.
  • Öğe parametreleri en fazla 10 özel parametre içerebilir.
  • Yayın gövdesi 130 kB'tan küçük olmalıdır.
  • Google Analytics'e gönderilen App Measurement Protocol etkinlikleri Arama'yı doldurmuyor uygulama kullanıcıları için Google Ads'de kitleler.

Kullanım alanlarının ek gereksinimleri için yaygın kullanım alanlarına göz atın.