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 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 BODY değ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ğ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ı veya kayan nokta sayısını temsil etmek için kullanılır.