Etkinlikleri doğrulama

Google Analytics 4 için Google Analytics Measurement Protocol, bir etkinlik hatalı biçimlendirilmiş veya gerekli parametreler eksik olsa bile HTTP hata kodu döndürmez. Etkinliklerinizin geçerli olduğundan emin olmak için bunları üretime dağıtmadan önce Measurement Protocol Doğrulama Sunucusu'nda 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 çağırabilir veya GA4 Etkinlik Oluşturucu'yu kullanabilirsiniz. GA4 Etkinlik Oluşturucu, etkinlikleri etkileşimli olarak oluşturmanıza olanak tanır ve bunları doğrulamak için Measurement Protocol Doğrulama Sunucusu'nu kullanır.

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

Etkinlikleri doğrulama için gönderme

Measurement Protocol ve Measurement Protocol Doğrulama Sunucusu'na gönderilen etkinlikler için yapılan istekteki 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ı

Aşağıda, Doğrulama Sunucusu'nun önceki etkinliğe verdiği yanıt verilmiştir:

{
  "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 Array<ValidationMessage> Doğrulama mesajları dizisi.

ValidationMessage

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

ValidationCode

Değer Açıklama
VALUE_INVALID fieldPath için sağlanan 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 Girilen ad, ayrılmış adlardan biriydi. Ayrılmış adları inceleyin.
VALUE_OUT_OF_BOUNDS Sağlanan değer çok büyük. Sınırlamalara bakın.
EXCEEDED_MAX_ENTITIES İstekte çok fazla parametre vardı. Sınırlamalara bakın.
NAME_DUPLICATED İstekte aynı ad birden fazla kez sağlandı.