Mise en œuvre du code du site Web du localisateur de revendeurs basé sur les produits
Étape 1 : Inclure le script dans le site Web
L'exemple ci-dessous montre ce qui est nécessaire pour intégrer le widget Acheter maintenant à votre site. Mettez simplement à jour les paramètres souhaités, puis copiez l'extrait de code sur votre site Web.
- <script id="omacro-widget-buynow" src="https://buynow.omacro.com/embedded/bn.loader.js?company=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&country=auto&validate=false&debug=false" asynchrone></script>
Le paramètre entreprise est pré-rempli avec l'identifiant de votre entreprise, pas besoin de modifier cette valeur. Tous les paramètres d'extrait de code sont ajoutés à la source du script et doivent être conformes aux normes des identificateurs de ressource uniformes .
- compagnie obligatoire
- Il s'agit de l'identifiant de votre entreprise fourni par Omacro. Cet ID a été attribué lors de la création de votre compte d'entreprise et ne changera jamais. L'exemple d'extrait ci-dessus inclut déjà l'identifiant de votre entreprise.
- pays
- Il s'agit d'un code de pays ISO à deux chiffres ISO 3166-1 alpha-2 ou auto . S'il n'est pas fourni, une carte sera présentée pour permettre à l'utilisateur de sélectionner son pays. Lorsqu'il est fourni et non défini sur automatique , l'utilisateur voit immédiatement les résultats pour le pays spécifié. Lorsqu'il est réglé sur auto , le pays sera automatiquement déterminé par l'adresse IP de l'utilisateur.
- valider
- Lorsque la valeur est true , l'extrait vérifie que chaque identifiant de produit disponible sur la page est valide et renvoie un produit. Une fois la validation terminée, l'extrait de code ajoutera la classe CSS correspondante à l'élément déclencheur : obn-validate-pass ou obn-validate-fail . Pendant que la validation est en attente, l'élément déclencheur aura la classe CSS obn-validate-pending .
- déboguer
- Lorsqu'il est vrai , l'extrait de code aidera au débogage en enregistrant toutes les activités et notifications sur la console de votre navigateur. Il est recommandé de désactiver cette fonctionnalité une fois le débogage terminé.
-
L'exemple ci-dessous illustre une simple balise d'ancrage (lien) utilisée comme déclencheur de produit. Vous pouvez facilement utiliser des éléments existants ou nouveaux sur votre site Web en ajoutant simplement le paramètre de produit requis.
- <a href="#obn" data-product="Votre identifiant de produit">Lien du produit</a>
Les paramètres de déclenchement ont priorité sur les paramètres d'extrait de code, ce qui permet aux paramètres d'être définis globalement avec des exceptions si nécessaire. Tous les paramètres de déclenchement sont des attributs de données HTML qui nécessitent qu'ils commencent par ' data- '.
- produit obligatoire
- Il s'agit de l'identifiant du produit. Il peut s'agir d'un GTIN (UPC, EAN ou ISBN), d'un SKU, d'un nom de modèle ou d'un identifiant Omacro. Nous suggérons fortement d'utiliser un GTIN, idéalement UPC.
- pays
- Il s'agit d'un code de pays ISO à deux chiffres ISO 3166-1 alpha-2 ou auto . S'il n'est pas fourni, une carte sera présentée pour permettre à l'utilisateur de sélectionner son pays. Lorsqu'il est fourni et non défini sur automatique , l'utilisateur voit immédiatement les résultats pour le pays spécifié. Lorsqu'il est réglé sur auto , le pays sera automatiquement déterminé par l'adresse IP de l'utilisateur.
- valider
- Lorsque la valeur est true , l'extrait vérifie que chaque identifiant de produit disponible sur la page est valide et renvoie un produit. Une fois la validation terminée, l'extrait de code ajoutera la classe CSS correspondante à l'élément déclencheur : obn-validate-pass ou obn-validate-fail . Pendant que la validation est en attente, l'élément déclencheur aura la classe CSS obn-validate-pending .