Etkinlikleri doğrulama

Platformunuzu seçin:

Google Analytics Measurement Protocol, etkinlik hatalı biçimlendirilmiş veya zorunlu parametreler eksik bile olsa HTTP hata kodları döndürmez. Etkinliklerin geçerli olduğundan emin olmak için etkinlikleri üretim ortamına aktarmadan ö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ğrudan doğrulama sunucusunu ç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, etkinliklerin Google Analytics için Measurement Protocol doğrulama sunucusuna nasıl gönderileceği ve yanıtın nasıl yorumlanacağı açıklanmaktadır.

Doğrulama için etkinlik gönderme

Measurement Protocol'e ve Measurement Protocol doğrulama sunucusuna gönderilen etkinlikler için istekteki tek fark URL'dir.

Diğer tüm istek alanları aynıdır.

Doğrulama için aşağıdaki yaklaşımı öneririz:

• Geliştirme sırasında aşağıdaki seçeneklerden birini kullanarak katı doğrulama kontrolleri uygulayın:
  • Etkinlik Oluşturucu ile istekleri doğrulayın.
  • validation_behavior, ENFORCE_RECOMMENDATIONS olarak ayarlanmış şekilde doğrulama sunucusuna istek gönderin.
• Üretimde, Measurement Protocol tarafından reddedilen verileri en aza indirmek için istekleri validation_behavior ayarlanmadan gönderin.

Geçersiz etkinlik örneği

Aşağıdaki kod, Measurement Protocol doğrulama sunucusuna geçersiz bir etkinliğin gönderildiğini gösterir:

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

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

Geçerli bir etkinlik örneği

Aşağıdaki kodda, Measurement Protocol doğrulama sunucusuna geçerli bir etkinliğin gönderildiği gösterilmektedir. Bu istek, Doğrulama yanıtı bölümünde gösterildiği gibi yanıtta boş bir validationMessages dizisi döndürür.

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    app_instance_id: "APP_INSTANCE_ID",
    validation_behavior: "ENFORCE_RECOMMENDATIONS",
    events: [{
      name: "level_up",
      params: {
        level: 2,
        character: "MyHero"
      },
    }]
  })
});

Doğrulama yanıtı

Doğrulama sunucusunun geçersiz etkinlik örneğine verdiği yanıt aşağıda verilmiştir.

{
  "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 verilmiştir:

{
  "validationMessages": []
}

Yanıt

ValidationMessage

ValidationCode