Bu kılavuzda, Measurement Protocol etkinliklerini Google Analytics raporlarınızda görüntüleyebilmeniz için Google Analytics Ölçüm Protokolü web ve uygulama veri akışı etkinliklerini bir Google Analytics sunucusuna nasıl göndereceğ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.
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 > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a gidin.
measurement_id
: Bir akışla ilişkili ölçüm kimliğidir. Google Analytics kullanıcı arayüzünde Yönetici > Veri Akışları > akışınızı seçin > Ölçüm Kimliği altında bulunur.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, Firebaseapp_instance_id
'ten farklıdır. 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 karakter içerebilir. Bu tanımlayıcı hakkında daha fazla bilgi edinmek istiyorsanız Platformlar arası analiz için User-ID'ye bakın.consent
: İsteğe bağlı. İzin ayarlarını nasıl yapacağınızı öğrenin.events
: Etkinlik öğeleri dizisi. Bir isteğe birden fazla etkinlik ekleyebilirsiniz.Kullanıcı etkinliğinin Gerçek zamanlı gibi raporlarda gösterilebilmesi için
event
içinparams
öğesinin bir parçası olarakengagement_time_msec
vesession_id
sağlanmalıdır.engagement_time_msec
parametresi, etkinliğin etkileşim süresini milisaniye cinsinden yansıtmalı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ış bir etkinlik adıdır ancak yeni bir session_id
oluşturduğunuzda session_start
adresine gerek kalmadan yeni bir oturum oluşturulur. Oturumların nasıl sayıldığını öğrenin.
Deneyin
Google Analytics sunucunuza 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önderilmesinde aşağıdaki sınırlamalar geçerlidir:
- İ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. 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 karakterden oluşmalıdır, yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik bir karakterle başlamalıdır.
- Öğe parametre değerleri dahil olmak üzere parametre değerleri, standart Google Analytics 4 mülkü için en fazla 100 karakter, Google Analytics 360 mülkünde ise en fazla 500 karakter uzunluğunda olmalıdır.
- Öğ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üşümleri Ads'e ve diğer medya entegrasyonlarına aktarmak üzere en son etiketleme etkinliğinden 63 güne kadar (dönüşüm etkinliğinin dönüşüm aralığı 63 günden uzun olsa bile) desteklenir. Buna karşın, online etkinlikleri etiketlemek için etkinlik düzeyinde ilişkilendirme, dönüşüm aralığının tamamında desteklenir.
- Yeniden pazarlama amacıyla, Measurement Protocol etkinliklerini en son online etkinlikten sonraki aşağıdaki gün sayısı boyunca ilişkili bir çerez veya cihaz kimliğiyle katılabilirsiniz:
- Web akışı: 30 gün
- Uygulama akışı: 42 gün
- Google Analytics 4'e gönderilen App Measurement Protocol etkinlikleri, uygulama kullanıcıları için Google Ads'deki Arama kitlelerini doldurmaz.