Axiom

Axiom verbinden

1. 1

   Ein Dataset erstellen

   Erstelle oder wähle das Axiom-Dataset, das formbase-Datensätze empfangen soll.

2. 2

   Ein Ingest-Token erstellen

   Erstelle ein API-Token mit der Berechtigung, in dieses Dataset einzuspeisen.

3. 3

   In formbase verbinden

   Öffne Workspace → Integrationen → Analytics, drücke bei Axiom auf Verbinden, gib Dataset und API-Token ein, wähle die Region und drücke Verbinden.

4. 4

   Ein Testereignis senden

   Öffne ein beliebiges Formular → Einstellungen → Integrationen → Analytics-Streaming und klicke auf Testereignis senden.

Die beiden Regionsoptionen sind US East 1 (AWS) und EU Central 1 (AWS). Wähle die, in der deine Axiom-Organisation liegt — formbase leitet daraus den Ingest-Endpunkt ab, und das Einspeisen in die falsche Region wird abgelehnt.

Analytics-Ereignisse

Das Verbinden von Axiom schaltet die antwortfreie Ereignisweiterleitung für jedes Formular im Workspace ein. Datensätze verwenden die Ereignisnamen form_view, form_engaged und form_submit, mit denselben Parametern, die unter Analytics-Streaming dokumentiert sind.

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

Jeder Datensatz flacht die Ereignisparameter auf die oberste Ebene ab, sodass form_id, source, device und der Rest gewöhnliche Spalten sind, nach denen du filtern und zusammenfassen kannst.

Die Weiterleitung von Ereignissen ist Best-Effort und wird nicht wiederholt. Deaktiviere sie für ein Formular unter Formulareinstellungen → Integrationen → Analytics-Streaming → Analytics-Ereignisse weiterleiten.

Antworten der Befragten

Axiom kann außerdem einen vollständigen Datensatz pro abgeschlossener Einreichung empfangen. Dieser Stream ist standardmäßig aus und muss für jedes Formular separat mit Antworten der Befragten senden aktiviert werden.

Ein Antwort-Datensatz ist derselbe Ereignis-Umschlag, den ein individueller Webhook erhält, plus ein Axiom-Feld _time: die Ereignis-ID, der Typ, createdAt, apiVersion und test, und unter data das Formular, die Einreichung (ID, E-Mail der befragten Person, Zeitpunkt der Einreichung, PDF-Link, Sprache), ein answers-Objekt, das nach Feldschlüssel benannt ist, und ein display-Objekt mit denselben Schlüsseln als lesbarer Text. Einreichungen, die eine Anfrage beantwortet haben, tragen außerdem einen request -Block mit deiner externen ID und Metadaten. Die vollständige Form steht in der Webhook-Referenz.

Antworten werden gestreamt, wenn eine Einreichung abgeschlossen wird, und erneut, wenn eine befragte Person sie bearbeitet. Abgebrochene Entwürfe erreichen Axiom auf diesem Weg nie — das Antwort-Streaming hat kein Leerlauffenster.

Antwortzustellung und Fehler

Antwort-Datensätze nutzen die Zustellungswarteschlange für Einreichungen: bis zu 5 Versuche mit exponentiellem Backoff. Nach 20 aufeinanderfolgenden Fehlern wird das Ziel nicht mehr eingereiht, sodass ein fehlerhaftes Token oder ein abgelehntes Dataset nicht bei jeder neuen Einreichung eine fehlschlagende Zustellung erzeugen kann. Das Speichern eines neuen API-Tokens löscht den Fehler und nimmt die Zustellung wieder auf.

Die Weiterleitung von Ereignissen und das Antwort-Streaming haben unabhängige Schalter. Du kannst für jedes Formular Antworten ohne Ereignisse senden, Ereignisse ohne Antworten, beides oder keins von beidem.

Fehlerbehebung

Nächste Schritte