Etkinlikleri doğrulama

Genel bakış

Google Analytics 4 için Google Analytics Measurement Protocol, bir etkinlik yanlış yapılandırılmış veya gerekli parametreler eksik olsa bile HTTP hata kodlarını döndürmez. Etkinliklerinizin geçerli olduğundan emin olmak için bunları üretime dağıtmadan önce Measurement Protocol Doğrulama Sunucusu ile karşılaştırarak test etmeniz gerekir. Etkinliklerinizin düzgün şekilde yapılandırıldığını doğruladıktan sonra, doğru anahtarları kullandığınızdan emin olmak için uygulamanızı doğrulamanız gerekir.

Doğrulama Sunucusu'nu doğrudan arayabilir veya GA4 Etkinlik Oluşturucu'yu kullanabilirsiniz. GA4 Etkinlik Oluşturucu, etkinlikleri etkileşimli olarak oluşturmanızı sağlar ve bunları doğrulamak için Measurement Protocol Doğrulama Sunucusu'nu kullanır.

Bu kılavuzda, Google Analytics 4 Doğrulama Sunucusu için Measurement Protocol'a nasıl etkinlik gönderileceği ve yanıtı nasıl yorumlayacağınız açıklanmaktadır.

Önemli: Doğrulama Sunucusu'na gönderilen etkinlikler raporlarda görünmez.

Etkinlikleri doğrulama için gönderme

Measurement Protocol ve Measurement Protocol Doğrulama Sunucusu'na gönderilen etkinlikler için istekte bulunan tek fark URL'dir.

Sunucu	URL
Measurement Protocol	/mp/collect
Measurement Protocol Doğrulama Sunucusu	/debug/mp/collect

Diğer tüm istek alanları aynıdır. Geçerli bir istek oluşturmayla ilgili tüm ayrıntılar için protokol referansına bakın.

Aşağıdaki kod, Measurement Protocol Doğrulama Sunucusu'na gönderilen geçersiz bir etkinliği gösterir:

Firebase gtag.js

Doğrulama yanıtı

Doğrulama Sunucusu'nun önceki etkinliğe verdiği yanıt aşağıdadır:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

Yanıt

Anahtar	Tür	Açıklama
validationMessages	Dizi<VerifiedationMessage>	Doğrulama mesajları dizisi.

Doğrulama Mesajı

Anahtar	Tür	Açıklama
fieldPath	string	Geçersiz alanın yolu.
description	string	Hatanın açıklaması.
validationCode	Doğrulama Kodu	Hataya karşılık gelen bir ValidationCode.

Doğrulama Kodu

Değer	Açıklama
VALUE_INVALID	fieldPath için girilen değer geçersizdi. Sınırlamalara bakın.
VALUE_REQUIRED	fieldPath için gerekli bir değer sağlanmadı.
NAME_INVALID	Sağlanan ad geçersizdi. Sınırlamalara bakın.
NAME_RESERVED	Sağlanan ad, ayrılmış adlardan biriydi. Ayrılmış adlara bakın.
VALUE_OUT_OF_BOUNDS	Sağlanan değer çok büyüktü. Sınırlamalara bakın.
EXCEEDED_MAX_ENTITIES	İstekte çok fazla parametre vardı. Sınırlamalara bakın.
NAME_DUPLICATED	Talepte aynı ad birden fazla defa belirtilmiş.