Bu dokümanda, Measurement Protocol kullanılarak Google Analytics'e nasıl veri gönderileceği açıklanmaktadır.
Genel bakış
Measurement Protocol kullanılarak verileri Google Analytics'e göndermek için 2 bölüm vardır:
- Taşıma: Verileri nereye ve nasıl gönderdiğiniz
- Yük: gönderdiğiniz veriler
Bu dokümanda, her ikisinin de nasıl biçimlendirileceği açıklanmaktadır.
Ulaşım
URL Uç Noktası
Aşağıdaki bitiş noktasına HTTP istekleri göndererek Measurement Protocol'u kullanarak veri gönderirsiniz:
https://www.google-analytics.com/collect
Tüm veriler HTTPS protokolü ile güvenli bir şekilde gönderilmelidir.
POST veya GET isteklerini kullanarak veri gönderebilirsiniz.
POST kullanma
Daha büyük bir yüke izin verdiğinden POST aracılığıyla veri göndermenizi öneririz. POST kullanırken aşağıdaki HTTP isteğini gönderin:
User-Agent: user_agent_string POST https://www.google-analytics.com/collect payload_data
Burada:
- user_agent_string: Tarayıcı, platform ve mobil işlevlerin hesaplanması için kullanılan biçimlendirilmiş bir kullanıcı aracısı dizesidir.
Bu değer ayarlanmazsa yukarıdaki veriler hesaplanmaz.
- payload_data: Yayın isteğinin
BODYdeğeri. Gövde, tam olarak 1 URI kodlamalı yük içermeli ve 8192 bayttan uzun olmamalıdır. - IP Adresi: Dolaylı olarak HTTP isteğinde gönderilir ve Google Analytics'teki tüm coğrafi boyutları / ağ boyutlarını hesaplamak için kullanılır.
YouTube'daki
POST verileri gönderemediğiniz ortamlar için, HTTP GET isteklerini aynı uç noktaya da gönderebilirsiniz:
GET /collect?payload_data HTTP/1.1 Host: https://www.google-analytics.com User-Agent: user_agent_string
Yük verilerinin URI çıkışlı sorgu parametreleri olarak gönderildiği konum. Kodlanan URL'nin tamamı 8000 Bayt'tan uzun olmamalıdır.
Önbellek Bozma
Tarayıcılar gibi bazı ortamlarda HTTP GET istekleri önbelleğe alınabilir.
Bir istek önbelleğe alındığında, sonraki istekler önbellekten alınabilir ve Google Analytics'e gönderilemez. Measurement Protocol, önbelleği bozmak için rastgele bir sayıyla ayarlanabilen özel bir parametre (z) sağlar. Bu, tüm Measurement Protocol isteklerinin benzersiz olmasını ve sonraki isteklerin önbellekten alınmasını önler.
Önbellek engelleyiciyi kullandığınızda bu parametreyi yüke last parametresi olarak eklemenizi önemle tavsiye ederiz.
https://www.google-analytics.com/collect?payload_data&z=123456
Yanıt Kodları
HTTP isteği alındıysa Measurement Protocol bir 2xx durum kodu döndürür. Measurement Protocol, yük verileri bozuksa, yükteki veriler yanlışsa veya Google Analytics tarafından işlenmemişse hata kodu döndürmez.
2xx durum kodu almazsanız isteği YENİDEN DENEMEYİN. Bunun yerine, HTTP isteğinizdeki hataları durdurup düzeltmelisiniz.
Yük Verileri
Measurement Protocol kullanılarak Google Analytics tarafından toplanan tüm veriler bir yük olarak gönderilir. Yük, her parametrenin bir anahtar ve değer içerdiği, = karakteriyle ayrıldığı ve her çiftin bir & karakteriyle ayrıldığı bir URL sorgu dizesine benzer.
Örneğin:
key1=val1&key2=val2
Her yük için geçerli bir kural vardır: gerekli değerler, URI kodlaması, birlikte gönderilebilen parametreler ve parametre uzunluğu. Ayrıca, her parametrenin belirli bir biçimi gerektiren belirli bir türü vardır. Aşağıdaki bölümler bu kuralların üzerinden geçer.
Measurement Protocol'u kullanarak gönderebileceğiniz tüm parametrelerin tam listesi için Parametre Referansı'nı okuyun.
Tüm İsabetler için Gerekli Değerler
Her bir yükte aşağıdaki parametreler bulunmalıdır:
| Ad | Parametre | Örnek | Açıklama |
|---|---|---|---|
| Protokol Sürümü | v |
v=1 |
Protokol sürümü. Değer 1 olmalıdır. |
| İzleme Kimliği | tid |
tid=UA-123456-1 |
Hangi Google Analytics mülkünün veri göndereceğini ayırt eden kimlik. |
| Client ID | cid |
cid=xxxxx |
Belirli bir kullanıcıya özgü kimlik. |
| İsabet Türü | t |
t=pageview |
Belirli bir kullanıcı için toplanan etkileşimin türü. |
Client ID ve Hit Type verileri, doğrudan Google Analytics veri modeliyle eşlenen değerlerdir.
/pageA, /pageB ve /pageC için giden 5555 kullanıcısını izlemek isterseniz aşağıdaki 3 yükü göndermeniz gerekir:
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageA v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageB v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageC
/ öğesinin %2F olarak kodlandığına dikkat edin.
URL Kodlama Değerleri
Google Analytics'e gönderilen tüm değerler hem UTF-8 hem de URL Kodlu olmalıdır.
dp anahtarını /my page € değeriyle göndermek için önce UTF-8 kodlamalı, ardından url olarak kodlandığından emin olmanız gerekir. Bu durumda son dize oluşur:
dp=%2Fmy%20page%20%E2%82%AC
Karakterlerden herhangi biri yanlış kodlanmışsa bu karakterler unicode değiştirme karakteri xFFFD ile değiştirilir.
Belirli İsabet Türleri için Gerekli Değerler
Bazı parametreler yalnızca belirli isabet türleriyle gönderilebilir.
Örneğin, pageview isabet türü, Sayfa Yolu parametresinin (dp) de ayarlanmasını gerektirir. Parametre Referansı, hangi isabet türleri için hangi parametrelerin gerekli olduğunu açıklar.
Maksimum Uzunluk
Measurement Protocol'daki bazı metin değerlerinin bayt cinsinden belirli maksimum uzunlukları vardır. Örneğin, dr adlı doküman yönlendiren alanının maksimum uzunluğu 2.048 Bayttır. Değerlerden herhangi biri maksimum uzunluklardan yüksekse otomatik olarak kısaltılır. Çok baytlı karakter maksimum uzunluğu aşarsa karakterin tamamı kısaltılır.
Desteklenen Veri Türleri
Measurement Protocol'daki her veri alanı, her birinin kendi doğrulama kurallarına sahip belirli bir türe aittir. Parametre değerlerinden herhangi biri doğrulama kurallarına uymuyorsa bu parametre yok sayılır ve Google Analytics tarafından işlenmez. Diğer tüm parametreler normal şekilde işlenir.
Measurement Protocol aşağıdaki veri türlerini destekler:
Bağımsız veri alanlarının kendi kısıtlamaları olabileceğini unutmayın. Tüm veri alanlarının ve kabul edilen türlerin tam listesi için Alan Referansı'na bakın.
Metin
Dizeleri göstermek için kullanılır. Metin alanlarında ek işlemler yapılır. Baştaki ve sondaki tüm boşluk karakterleri kaldırılır. İki veya daha fazla boşluk karakterinin (boşluk, sekme, yeni satır vb. dahil) dahili çalıştırmaları tek bir boşluk karakterine indirilir. Bu dönüşüm, herhangi bir kesme gerçekleşmeden önce ham metne uygulanır. Örneğin:
Hello World
şu hale gelir:
Hello World
Currency
Bir para biriminin toplam değerini göstermek için kullanılır. Ondalık nokta, para biriminin tam ve kesirli kısmı arasında sınırlayıcı olarak kullanılır. En fazla 6 ondalık basamak olabilir. Aşağıdakiler, para birimi alanı için geçerlidir:
1000.000001
Değer Google Analytics'e gönderildikten sonra, ilk rakama (- veya . (ondalık) karakter) kadar tüm metinler kaldırılır. Bu durumda:
$-55.00
şu hale gelir:
-55.00
Boole
Bir değerin doğru mu yanlış mı olduğunu belirlemek için kullanılır. Valid values are:
1- Doğru0- Yanlış
Tamsayı
Bir tam sayıyı temsil etmek için kullanılır. Değer, imzalı bir int64 olarak depolanır
Sayı
Bir tam sayı veya kayan nokta sayısını temsil etmek için kullanılır.