Measurement Protocol Referansı

Bu belgede, Measurement Protocol kullanarak Google Analytics'e nasıl veri gönderebileceğiniz açıklanmaktadır.

Genel bakış

Measurement Protocol kullanarak Google Analytics'e veri göndermek için iki bölüm vardır:

  • Verileri nereye ve nasıl göndereceğinize taşıma
  • 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 kullanarak ve aşağıdaki uç noktaya HTTP istekleri göndererek gönderirsiniz:

https://www.google-analytics.com/collect

Tüm veriler HTTPS protokolüyle güvenli bir şekilde gönderilmelidir.

POST veya GET isteklerini kullanarak veri gönderebilirsiniz.

POST kullanma

Daha fazla 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 özellikleri ile ilgili boyutları hesaplamak 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 BODY değeri. Gövde, tam olarak 1 URI kodlamalı yük içermeli ve 8.192 bayttan uzun olmamalıdır.
  • IP Adresi - HTTP isteğinde örtülü olarak gönderilir ve Google Analytics'teki tüm coğrafi / ağ boyutlarını hesaplamak için kullanılır.

GET

POST verisi gönderemediğiniz ortamlar için 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 8.000 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. Önbelleği bozmak için Measurement Protocol, 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 son parametre olarak eklemenizi önemle tavsiye ederiz.

https://www.google-analytics.com/collect?payload_data&z=123456

Yanıt Kodları

HTTP isteği alınmışsa Measurement Protocol, bir 2xx durum kodu döndürür. Yük verileri hatalıysa, yükteki veriler yanlışsa veya Google Analytics tarafından işlenmemişse Measurement Protocol hata kodu döndürmez.

2xx durum kodu almazsanız isteği DENEMEYİN. 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ğ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ün şu kuralları belirleyen 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 ele alınmıştır.

Measurement Protocol kullanarak gönderebileceğiniz tüm parametrelerin tam listesi için Parametre Referansı'nı okuyun.

Tüm İsabetler için Gerekli Değerler

Her yükte aşağıdaki parametreler olmalı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 öğelerine giden 5555 adlı kullanıcıyı izlemek isterseniz aşağıdaki 3 yükü gönderirsiniz:

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 bunun UTF-8, ardından da URL olarak kodlanmış olduğundan emin olmanız gerekir. Bu şekilde son 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 doküman yönlendiren alanı maksimum 2.048 Bayt uzunluğundadı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ı belirli bir türe aittir. Bu türlerin her birinin kendi doğrulama kuralları vardır. 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:

Her veri alanının kendi kısıtlamaları olabileceğini unutmayın. Tüm veri alanları ve kabul edilen türlerin tam listesi için Alan Referansı'na bakın.

Metin

Dizeleri temsil etmek 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 indirilir. Bu dönüşüm işlemi, ham metne herhangi bir kesme işlemi yapılmadan önce uygulanır. Örneğin:

   Hello      World

şu hale gelir:

Hello World

Currency

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. Bir para birimi alanı için aşağıdakiler geçerlidir:

1000.000001

Değer Google Analytics'e gönderildikten sonra, ilk haneye, - karakterine veya . (ondalık) karakterine kadar tüm metin 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ğru
  • 0 - 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.