Measurement Protocol etkinliklerini Google Analytics'e gönderme

Bu kılavuzda, Measurement Protocol etkinliklerini Google Analytics raporlarınızda görebilmek için Google Analytics Measurement Protocol web ve uygulama veri akışı etkinliklerini bir Google Analytics sunucusuna nasıl gönderebileceğiniz açıklanmaktadır.

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 isteklerini destekler.

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 GİZLİ öğesidir.

  Yeni bir gizli anahtar oluşturmak için Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a gidin.

• measurement_id: Google Analytics kullanıcı arayüzünde, Yönetici > Veri Akışları > akışınızı seçin > Ölçüm Kimliği'ne giderek akışla ilişkili ölçüm kimliğidir.

  measurement_id, Akış kimliğiniz değildir.

Tam referans için sorgu parametrelerine bakın.

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

• client_id: İstemci için benzersiz tanımlayıcı. Bu, Firebase app_instance_id cihazından farklıdır. gtag.js('get') kullanın.

• user_id: İsteğe bağlı. Bir kullanıcıya ait benzersiz tanımlayıcı. Yalnızca utf-8 karakterleri içerebilir. Bu tanımlayıcı hakkında daha fazla bilgi için Platformlar arası analiz için User-ID bölümüne bakın.

• events: Etkinlik öğeleri dizisi. Tek bir isteğe birden çok etkinlik ekleyebilirsiniz.

  Kullanıcı etkinliğinin Gerçek zamanlı gibi raporlarda görüntülenmesi için, event için params kapsamında engagement_time_msec ve session_id sağlanmalıdır.

  Aşağıda 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, ayrılmış etkinlik adı olsa da yeni bir session_id oluşturulduğunda session_start öğesinin gönderilmesine gerek kalmadan yeni bir oturum oluşturulur. Oturumların nasıl sayıldığını öğrenin.

Deneyin

Google Analytics sunucunuza bir tutorial_begin etkinliği göndermek için kullanabileceğiniz bir örneği aşağıda bulabilirsiniz:

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 Analytics'e gönderilmesiyle ilgili aşağıdaki sınırlamalar geçerlidir:

• İstekler en fazla 25 etkinlik içerebilir.
• 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ı, yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlamalıdır.
• Öğe parametrelerini içeren parametre adları en fazla 40 karakter uzunluğunda olmalıdır, yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlamalıdır.
• Öğe parametre değerlerini içeren parametre değerleri en fazla 100 karakter uzunluğunda olmalıdır.
• Öğe parametreleri en fazla 10 özel parametreye sahip olabilir.
• Gönderinin gövdesi 130 KB'tan küçük olmalıdır.
• Google Analytics 4'e gönderilen Uygulama Measurement Protocol etkinlikleri, uygulama kullanıcıları için Google Ads'deki Arama Ağı kitlelerini doldurmaz.