1. Présentation
Les formulaires web intégrés placent un formulaire de captation AES sur n’importe quel site avec une seule balise de script. Les envois arrivent directement dans l’environnement AES du client, avec attribution complète de la page, de la campagne et du référent, sans stockage intermédiaire.
2. Intégration
<div data-omb-webform="slug-de-votre-formulaire"></div>
<script src="https://omb.cloud/embed/webform.js" async></script>Le script lit chaque élément portant data-omb-webform et affiche le formulaire défini pour ce slug. Plusieurs formulaires peuvent figurer sur une même page.
3. Configuration
La définition des champs, les libellés, la validation, la langue et le style se configurent dans AES et sont servis au moment de l’affichage. Modifier un formulaire n’exige pas de toucher au site hôte.
| Attribut | Description |
|---|---|
data-omb-webform | Slug du formulaire. Obligatoire. |
data-omb-locale | Remplace la langue du formulaire pour cette instance. |
data-omb-source | Remplace la source enregistrée. Par défaut, l’URL de la page hôte. |
data-omb-campaign | Attribution de campagne. Retombe sur les paramètres UTM présents sur la page. |
4. Attribution
Chaque envoi enregistre l’URL de la page hôte, le référent, et tout paramètre UTM présent. Lorsque le client exploite plusieurs implantations, l’unité de destination est résolue à l’envoi et voyage avec l’enregistrement.
5. Événements
Le script émet des événements navigateur pour que le site hôte réagisse sans interrogation.
document.addEventListener('omb:webform:ready', e => { /* e.detail.slug */ });
document.addEventListener('omb:webform:submit', e => { /* avant envoi */ });
document.addEventListener('omb:webform:success', e => { /* e.detail.id */ });
document.addEventListener('omb:webform:error', e => { /* e.detail.msg */ });Utiliser omb:webform:success pour déclencher une balise de conversion ou rediriger vers une page de remerciement.
6. Confidentialité et consentement
L’intégration ne dépose aucun cookie publicitaire et n’effectue aucun suivi inter-sites. Le texte de consentement et ses liens font partie de la définition du formulaire, de sorte qu’ils restent cohérents où qu’il soit placé.
7. Remise
Les envois sont enregistrés dans AES immédiatement. Lorsque le client l’a configuré, ils sont également poussés via le Lead Delivery Webhook.
Contact
Questions sur cette spécification : developers@omb.cloud.