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'te görüntüleyebilirsiniz. Google Analytics raporlarınız.

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

İsteği biçimlendirme

Google Analytics 4 için Measurement Protocol yalnızca HTTP POST'yi destekler kabul edersiniz.

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.

  • firebase_app_id: Firebase uygulama kimliği, Firebase konsolunda şunun altında bulunur: Proje Ayarları > Genel > Uygulamalarınız > Uygulama kimliği.

    firebase_app_id, app_instance_id ile aynı değil. İlgili içeriği oluşturmak için kullanılan firebase_app_id uygulamanızı tanımlarken app_instance_id tanımlar ve uygulamayı tekrar yüklemelisiniz.

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

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

  • 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ğinde bulunabilirsiniz.

    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:

  {
   "app_instance_id": "12345678901234567890123456789012",
   "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

Şu örneği kullanarak:tutorial_begin Google Analytics sunucusu:

const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;

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

firebase_app_id biçimi platforma özgüdür. Application ID (Uygulama Kimliği) sayfasını inceleyin. Firebase yapılandırma dosyaları ve nesneleri bölümünde bulabilirsiniz.

Geçersiz kılma zaman damgası

Measurement Protocol aşağıda bulduğu ilk zaman damgasını kullanır. listesi:

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

Aşağıdaki örnek, istekteki etkinlikler. 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 bir Google Analytics 4 mülkü için daha az, 500 karakterden daha az 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 4'e gönderilen Uygulama Measurement Protocol etkinlikleri doldurulmuyor Uygulama kullanıcıları için Google Ads'de kitleler arayın.

Her kullanım alanıyla ilgili ek şartlar için yaygın kullanım alanlarına göz atın.