Etkinlikleri doğrulama

Platformunuzu seçin:

Google Analytics Measurement Protocol, etkinlik hatalı biçimlendirilmiş veya zorunlu parametreler eksik olsa bile HTTP hata kodları döndürmez. Etkinliklerin geçerli olduğundan emin olmak için üretim ortamına dağıtmadan önce Measurement Protocol doğrulama sunucusu ile test etmeniz gerekir. Etkinliklerinizin doğru ş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 sunucusunu doğrudan çağırabilir veya Google Analytics Etkinlik Oluşturucu'yu kullanabilirsiniz. Google Analytics Etkinlik Oluşturucu, etkinlikleri etkileşimli olarak oluşturmanıza olanak tanır ve bunları doğrulamak için Measurement Protocol doğrulama sunucusunu kullanır.

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

Doğrulama için etkinlikler gönderme

Measurement Protocol'a ve Measurement Protocol doğrulama sunucusuna gönderilen etkinlik isteklerindeki 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 kodda, Measurement Protocol doğrulama sunucusuna gönderilen geçersiz bir etkinlik gösterilmektedir:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

Doğrulama yanıtı

Doğrulama sunucusunun önceki etkinliğe verdiği yanıt:

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

Doğrulama sunucusunun, doğrulama sorunu olmayan bir isteğe verdiği yanıtı aşağıda bulabilirsiniz:

{
  "validationMessages": []
}

Yanıt

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

ValidationMessage

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

ValidationCode

Değer Açıklama
VALUE_INVALID Bir fieldPath için sağlanan değer geçersizdi. Sınırlılıklar bölümüne bakın.
VALUE_REQUIRED fieldPath için gerekli değer sağlanmadı.
NAME_INVALID Sağlanan ad geçersizdi. Sınırlılıklar bölümüne bakın.
NAME_RESERVED Sağlanan ad, ayrılmış adlardan biriydi. Ayrılmış adlar bölümüne bakın.
VALUE_OUT_OF_BOUNDS Sağlanan değer çok büyüktü. Sınırlılıklar bölümüne bakın.
EXCEEDED_MAX_ENTITIES İstekte çok fazla parametre vardı. Sınırlılıklar bölümüne bakın.
NAME_DUPLICATED İstekte aynı ad birden fazla kez sağlandı.