OneTrace.pro Yardım merkezi

Olay şeması

Olay şeması, projeye hangi olayların hangi özelliklerle gelmesi gerektiğini tanımlar: order_completed zorunlu ve sayı türünde bir tutarla, currency yalnızca EUR veya USD değeriyle. OneTrace.pro her olayı şemayla karşılaştırır ve ihlalleri gösterir: olay adında yazım hatası, metin olarak gelen tutar, eksik özellik. Sitedeki veya entegrasyondaki izleme hataları, bir segment ya da rapor yanlış hesaplandıktan sonra değil, hemen fark edilir.

Şemayı ihlal eden bir olay yine de kabul edilir ve profile yazılır: şemanın kendisi hatalı olsa bile veriler kaybolmaz. Olay şeması “Büyüme” tarifesinden itibaren kullanılabilir.

Olayları tanımlama

Veri kataloğu'nu açın ve Olay şeması sekmesine geçin. Şemayı “Olay kataloğunu yönetme” yetkisine sahip roller — “Müdür” ve üzeri — değiştirebilir; diğerleri şemayı ve ihlalleri görür.

  1. Mevcut olayları ekle düğmesine basın: katalogdaki tüm olaylar, özellikleri ve görülen türleriyle birlikte şemaya eklenir. Ya da olayları Olay ekle düğmesiyle tek tek ekleyin.
  2. Her olayın özelliklerini kontrol edin:
Sütun Neyi belirler
Özellik Site veya sunucunun gönderdiği şekliyle özellik anahtarı, örneğin amount
Tür Metin, sayı, evet/hayır, tarih ve saat, liste veya nesne. Tarih ve saat değeri, metin türündeki bir özelliğe de uyar
Zorunlu Bu özelliği içermeyen veya değeri boş olan olay bir ihlaldir
İzin verilen değerler Virgülle ayrılarak, yalnızca metin ve sayılar için. Listede olmayan bir değer ihlaldir; büyük/küçük harf ayrımı yapılır: eur ve EUR farklı değerlerdir
Açıklama Geliştiriciler için: özelliğin ne anlama geldiği
  1. Artık gelmemesi gereken olayları ve özellikleri kaldırın: gelirlerse “Olay tanımlı değil” veya “Özellik tanımlı değil” ihlali oluşur.
  2. Şemayı kaydet düğmesine basın ve Olayları şemaya göre denetle seçeneğini açın.

Değişiklikler ekranda birikir ve birlikte kaydedilir. Kaydettikten sonra ihlal sayaçları sıfırdan başlar: öncekiler eski şemaya aittir. Şemadaki, henüz hiç gelmemiş bir olay Olaylar sekmesinde “Henüz gelmedi” olarak, şemadaki olaylar ise “Şemada” işaretiyle gösterilir.

Veri kataloğunda olay şeması

Platformun sistem olayları ($identify, $page, $message_sent ve diğerleri) ile identify çağrıları, sayfa ve uygulama ekranı görüntülemeleri denetlenmez: bunların şemasını platform belirler.

İhlaller

İhlal Örnek
Olay tanımlı değil product_viewed yerine product_viewd geldi
Özellik tanımlı değil order_completed olayında şemada olmayan coupon özelliği geldi
Zorunlu özellik eksik quantity olmadan add_to_cart
Yanlış tür Tutar 1250 sayısı yerine "1250" metni olarak geldi
İzin verilmeyen değer currency = eur, şemada ise EUR ve USD var

Son 7 günün ihlalleri, şemadaki olayların listesinin üstünde görünür: kaç kez ve en son ne zaman oluştuğu, örnek olarak değerin türü veya izin verilmeyen değerin kendisi. Kişisel verileri görme yetkiniz yoksa örnek maskelenir. Bir olay izleme hatası yüzünden değil de şemadaki bir hata yüzünden tanımlı değilse Şemaya ekle düğmesine basın: olay, katalogdaki özellikleriyle birlikte taslağa eklenir.

Aynı ihlaller ve ihlalli olayların 24 saatlik grafiği Tanılama bölümünde yer alır.

Tanılamada olay şeması

İçe aktarma, dışa aktarma ve API

JSON dışa aktar kaydedilmiş şemayı indirir, JSON içe aktar ise dosyayı taslağa yükler: kontrol edip kaydedin. Böylece aynı şema projeler arasında taşınır: örneğin bir mağaza zincirinin tüm mağazalarına veya test projesinden canlı projeye.

Genel API üzerinden şema okunur (GET /api/v1/event-schema) ve bütünüyle değiştirilir (PUT /api/v1/event-schema, “Olay şemasını değiştirme” anahtar yetkisi); haftalık ihlaller ise GET /api/v1/event-schema/violations isteğiyle alınır. Dosyanın ve API'nin biçimi aynıdır:

{
  "enabled": true,
  "events": [
    {
      "name": "order_completed",
      "label": "Sipariş verdi",
      "properties": [
        { "key": "amount", "type": "number", "required": true },
        { "key": "currency", "type": "string", "required": true, "values": ["EUR", "USD"] }
      ]
    }
  ]
}

Belgede bulunmayan olaylar şemadan çıkar, ancak etiketleri ve istatistikleriyle birlikte veri kataloğunda kalır. events içermeyen bir belge yalnızca denetimi açar veya kapatır.