Axiom

Axiom’u bağlayın

1. 1

   Bir veri kümesi oluşturun

   formbase kayıtlarını alacak Axiom veri kümesini oluşturun veya seçin.

2. 2

   Bir alım token’ı oluşturun

   Bu veri kümesine alım izni olan bir API token’ı oluşturun.

3. 3

   formbase’de bağlanın

   Çalışma alanı → Entegrasyonlar → Analitik’i açın, Axiom’da Bağlan’a basın, Veri kümesi ve API token’ını girin, Bölge’yi seçin ve Bağlan’a basın.

4. 4

   Bir test etkinliği gönderin

   Herhangi bir formu açın → Ayarlar → Entegrasyonlar → Analytics akışı ve Test etkinliği gönder’e tıklayın.

İki bölge seçeneği vardır: US East 1 (AWS) ve EU Central 1 (AWS). Axiom kuruluşunuzun bulunduğu bölgeyi seçin — formbase alım uç noktasını buradan türetir ve yanlış bölgeye alım reddedilir.

Analitik etkinlikleri

Axiom’u bağlamak, çalışma alanındaki her form için yanıt içermeyen etkinlik iletimini açar. Kayıtlar form_view, form_engaged ve form_submit etkinlik adlarını kullanır; aynı parametreler Analytics akışı sayfasında belgelenmiştir.

['your-dataset']
| where ['event'] in ('form_view', 'form_engaged', 'form_submit')
| summarize events=count() by ['event']

Her kayıt, etkinlik parametrelerini üst düzeye düzleştirir; böylece form_id, source, device ve diğerleri filtreleyip özetleyebileceğiniz sıradan sütunlar olur.

Etkinlik iletimi en iyi çaba ilkesiyle çalışır ve yeniden denenmez. Tek bir form için bunu Form ayarları → Entegrasyonlar → Analytics akışı → Analitik etkinliklerini ilet altından kapatın.

Katılımcı yanıtları

Axiom, tamamlanan her gönderim için bir tam kayıt da alabilir. Bu akış varsayılan olarak kapalıdır ve her form için ayrı ayrı Katılımcı yanıtlarını gönder ile etkinleştirilmelidir.

Bir yanıt kaydı, bir özel webhook’un aldığı olay zarfının aynısıdır, artı bir Axiom _time alanı: etkinlik kimliği, türü, createdAt, apiVersion ve test, ve data altında form, gönderim (kimlik, katılımcı e-postası, gönderim zamanı, PDF bağlantısı, dil), alan anahtarına göre anahtarlanmış bir answers nesnesi ve aynı anahtarları okunabilir metin olarak taşıyan bir display nesnesi. Bir isteği yanıtlayan gönderimler ayrıca sizin dış kimliğinizi ve meta verilerinizi taşıyan bir request bloğu içerir. Tam biçim webhook referansında yer alır.

Yanıtlar, bir gönderim tamamlandığında ve bir katılımcı onu düzenlediğinde tekrar akışa aktarılır. Terk edilmiş taslaklar bu yolla Axiom’a asla ulaşmaz — yanıt akışının boşta kalma penceresi yoktur.

Yanıt teslimatı ve hatalar

Yanıt kayıtları gönderim teslimat kuyruğunu kullanır: üstel geri çekilmeyle en fazla 5 deneme. Art arda 20 başarısızlıktan sonra hedef kuyruğa alınmaktan çıkarılır; böylece kötü bir token veya reddedilen bir veri kümesi her yeni gönderim için başarısız bir teslimat oluşturamaz. Yeni bir API token’ı kaydetmek hatayı temizler ve teslimatı devam ettirir.

Etkinlik iletimi ve yanıt akışının bağımsız anahtarları vardır. Her form için yanıtları etkinlikler olmadan, etkinlikleri yanıtlar olmadan, ikisini birden veya hiçbirini gönderebilirsiniz.

Sorun giderme

Sonraki adımlar