Bu dokümanda, Measurement Protocol kullanılarak Google Analytics'e nasıl veri gönderileceği açıklanmaktadır.
Genel bakış
Measurement Protocol'ü kullanarak Google Analytics'e veri göndermek için 2 bölüm vardır:
- Taşıma: Verileri nereye ve nasıl göndereceğinize
- 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ı
Verileri, Measurement Protocol'u kullanarak aşağıdaki uç noktaya HTTP isteklerinde bulunarak gönderirsiniz:
https://www.google-analytics.com/collect
Tüm veriler, HTTPS protokolüyle güvenli bir şekilde gönderilmelidir.
Verileri POST veya GET isteklerini kullanarak gönderebilirsiniz.
POST kullanma
Daha büyük bir yüke izin verdiği için verileri POST üzerinden 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 özellikler boyutlarını hesaplamak için kullanılan ve
biçimlendirilmiş bir kullanıcı aracısı dizesidir.
Bu değer ayarlanmazsa yukarıdaki veriler hesaplanmaz.
- payload_data – Yayın isteğinin
BODY
değeri. Gövde, tam olarak 1 URI kodlamalı yük içermeli ve 8.192 bayttan uzun olmamalıdır. - IP Adresi – Dolaylı olarak HTTP isteğinde gönderilir ve Google Analytics'teki tüm coğrafi / ağ boyutlarını hesaplamak için kullanılır.
GET
POST verilerini gönderemediğiniz ortamlarda aynı uç noktaya HTTP GET istekleri de 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 yer. Kodlanmış URL'nin tamamının uzunluğu 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önderilmeyebilir. Measurement Protocol, önbelleği incelemek 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ınmamasını sağlar.
Önbellek engelleyici 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ğinin alınması durumunda Measurement Protocol, bir 2xx
durum kodu döndürür. Yük verileri bozuksa veya yükteki veriler yanlışsa ya da Google Analytics tarafından işlenmemişse Measurement Protocol hata kodu döndürmez.
2xx
durum kodu almazsanız isteği
DENEMEMENİZ gerekir. Bunun yerine, HTTP isteğinizdeki hataları durdurup düzeltmeniz gerekir.
Yük Verileri
Google Analytics tarafından Measurement Protocol kullanılarak toplanan tüm veriler yük olarak gönderilir. Yük, her parametrenin bir anahtar ve değere sahip olduğu, =
karakteriyle ayrıldığı ve her çiftin &
karakteriyle ayrıldığı bir URL sorgu dizesine benzer.
Örneğin:
key1=val1&key2=val2
Her yükün geçerli kuralları vardır: gerekli değerler, URI kodlaması, birlikte gönderilebilen parametreler ve parametre uzunluğu. Ayrıca her parametrenin, belirli bir biçim gerektiren kendine özgü bir türü vardır. Bu kurallar, aşağıdaki bölümlerde incelenmektedir.
Measurement Protocol kullanarak gönderebileceğiniz tüm parametrelerin tam listesi için Parametre Referansı'nı okuyun.
Tüm İsabetler için Zorunlu Değerler
Her 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üne veri gönderileceğini belirleyen kimlik. |
İstemci Kimliği | cid |
cid=xxxxx |
Belirli bir kullanıcıya özgü kimlik. |
İsabet Türü | t |
t=pageview |
Belirli bir kullanıcı için toplanan etkileşim türü. |
Client ID
ve Hit Type
verileri, doğrudan Google Analytics veri modeliyle eşlenen değerlerdir.
/pageA
, /pageB
ve /pageC
sayfalarına giden 5555
adlı kullanıcıyı 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 kodlamalı olmalıdır.
dp
anahtarını /my page €
değeriyle göndermek için önce bunun UTF-8, ardından URL olarak kodlandığından emin olmanız gerekir. Bu sayede nihai dize elde edilir:
dp=%2Fmy%20page%20%E2%82%AC
Karakterlerden herhangi biri yanlış kodlanırsa unicode değiştirme karakteri xFFFD
ile değiştirilir.
Belirli İsabet Türleri İçin Gerekli Değerler
Bazı parametreler yalnızca belirli isabet türleriyle gönderilebilir.
Örneğin, pageview
isabet türü için Sayfa Yolu parametresinin (dp
) de ayarlanması gerekir. 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
belge yönlendiren alanının maksimum uzunluğu 2.048 Bayttır. Değerlerden herhangi biri maksimum uzunluklardan büyükse otomatik olarak kısaltılır. Çok baytlı bir karakter maksimum uzunluğu aşarsa karakterin tamamı kesilir.
Desteklenen Veri Türleri
Measurement Protocol'daki her veri alanı, her birinin kendi doğrulama kurallarına sahip olan belirli bir türe aittir. Parametre değerlerinden herhangi biri doğrulama kurallarına uymuyorsa söz konusu 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:
Her bir veri alanı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ırlar vb.) dahili çalıştırmaları tek bir boşluk karakterine indirgenir. Bu dönüşüm, ham metne herhangi bir kesme işlemi yapılmadan önce uygulanır. Örneğin:
Hello World
şu şekilde olur:
Hello World
Para Birimi
Para biriminin toplam değerini göstermek için kullanılır. Ondalık nokta, para biriminin tam ve kesirli kısmı arasında ayırıcı olarak kullanılır. En fazla 6 ondalık basamak olabilir. Aşağıdakiler bir para birimi alanı için geçerlidir:
1000.000001
Değer Google Analytics'e gönderildikten sonra ilk haneye, -
veya .
(ondalık) karakterine kadar tüm metin kaldırılır. Bu durumda:
$-55.00
şu şekilde olur:
-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ıyı veya kayan nokta sayısını temsil etmek için kullanılır.