Measurement Protocol etkinliklerini Google Analytics'e gönderme

Bu kılavuzda, Google Analytics Ölçümü Protokol 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.

  • measurement_id: Bir akışla ilişkili ölçüm kimliği. Şurada bulunur: 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.

  • 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

Şu örneği kullanarak:tutorial_begin Google 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: {},
    }]
  })
});

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.
  • Measurement Protocol etkinliklerinden etkinlik düzeyinde ilişkilendirme, Dönüşümün dışa aktarılacağı en son online etiketleme etkinliğinden 63 gün sonra Reklamlar ve diğer medya entegrasyonları (kullanıcının dönüşüm aralığı olsa bile) dönüşüm etkinliğinin 63 günden uzun olduğunu varsayalım. Oysa etkinlik düzeyinde Dönüşümün tamamında, online etkinlikleri etiketleme ilişkilendirme destekleniyor penceresini kapatın.
  • Yeniden pazarlama amacıyla Measurement Protocol etkinliklerini etkinliği izleyen bir gündem olan en son çevrimiçi etkinlikten sonra ilişkili çerez veya cihaz kimliği:
    • Web akışı: 30 gün
    • Uygulama akışı: 42 gün
  • Google Analytics 4'e gönderilen Uygulama Measurement Protocol etkinlikleri doldurulmuyor Uygulama kullanıcıları için Google Ads'de kitleler arayın.