Axiom

Connecter Axiom

1. 1

   Créer un dataset

   Créez ou choisissez le dataset Axiom qui doit recevoir les enregistrements formbase.

2. 2

   Créer un jeton d’ingestion

   Créez un jeton API avec l’autorisation d’ingérer dans ce dataset.

3. 3

   Connecter dans formbase

   Ouvrez Espace de travail → Intégrations → Analytiques, cliquez sur Connecter sur Axiom, saisissez le Dataset et le Jeton API, choisissez la Région, puis cliquez sur Connecter.

4. 4

   Envoyer un événement de test

   Ouvrez n’importe quel formulaire → Paramètres → Intégrations → Diffusion Analytics puis cliquez sur Envoyer un événement de test.

Les deux régions possibles sont US East 1 (AWS) et EU Central 1 (AWS). Choisissez celle où se trouve votre organisation Axiom — formbase en déduit le point de terminaison d’ingestion, et ingérer dans la mauvaise région est refusé.

Événements analytiques

Connecter Axiom active la transmission d’événements sans réponses pour chaque formulaire de l’espace de travail. Les enregistrements utilisent les noms d’événements form_view, form_engaged et form_submit, avec les mêmes paramètres documentés dans Diffusion d’analytiques.

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

Chaque enregistrement aplatit les paramètres de l’événement au premier niveau, si bien que form_id, source, device et les autres sont des colonnes ordinaires que vous pouvez filtrer et agréger.

La transmission des événements est best-effort et n’est pas relancée en cas d’échec. Désactivez-la pour un formulaire sous Paramètres du formulaire → Intégrations → Diffusion Analytics → Transmettre les événements d’analyse.

Réponses des répondants

Axiom peut aussi recevoir un enregistrement complet par soumission terminée. Ce flux est désactivé par défaut et doit être activé séparément pour chaque formulaire avec Envoyer les réponses des répondants.

Un enregistrement de réponse est la même enveloppe d’événement que reçoit un webhook personnalisé, plus un champ Axiom _time : l’id de l’événement, son type, createdAt, apiVersion et test, et sous data le formulaire, la soumission (id, e-mail du répondant, heure de soumission, lien PDF, langue), un objet answers indexé par clé de champ et un objet display avec les mêmes clés en texte lisible. Les soumissions qui répondent à une demande portent aussi un bloc request avec votre id externe et ses métadonnées. La forme complète est dans la référence webhook.

Les réponses sont diffusées quand une soumission est terminée, puis à nouveau quand un répondant la modifie. Les brouillons abandonnés n’atteignent jamais Axiom par cette voie — la diffusion des réponses n’a pas de fenêtre d’inactivité.

Livraison des réponses et échecs

Les enregistrements de réponses suivent la file de livraison des soumissions : jusqu’à 5 tentatives avec délai exponentiel. Après 20 échecs consécutifs, la destination cesse d’être mise en file, de sorte qu’un jeton invalide ou un dataset rejeté ne génère pas une livraison en échec pour chaque nouvelle soumission. Enregistrer un nouveau jeton API efface l’erreur et reprend la livraison.

La transmission des événements et la diffusion des réponses ont des interrupteurs indépendants. Vous pouvez envoyer des réponses sans événements, des événements sans réponses, les deux, ou aucun, pour chaque formulaire.

Dépannage

Prochaines étapes