Measurement Protocol Referansı

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ğ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.