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.

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:

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