Une fois que vous avez bien ajouté la balise de script à votre site Web (voir Ajouter des balises Knowledge à votre site Web), vous pouvez ajouter du contenu destiné aux clients à vos pages à l'aide de codes intégrés. Cela vous permet d'afficher le contenu des entités stockées dans Yext sur votre site Web. Ainsi, dès que vous actualisez le contenu d'une entité, cette mise à jour est automatiquement répercutée sur votre site Web.
Remarque : vous devez ajouter la balise <script> à votre page avant de pouvoir utiliser les codes intégrés pour ajouter du contenu.
Pour ajouter du contenu destiné aux clients à votre site :
- Cliquez sur Pages dans la barre de navigation, puis sur Knowledge Tags.
- Cliquez sur le bouton Ajouter Knowledge Tags à un site Internet.
- Cliquez sur le bouton Sélectionner l'entité puis choisissez l'entité souhaitée.
- Le cas échéant, sélectionnez les paramètres régionaux souhaités.
- Le cas échéant, sélectionnez les paramètres d'analyse souhaités.
- Récupérez les codes intégrés des champs que vous souhaitez optimiser à l'aide du Knowledge Graph de Yext. Pour voir plus de champs d'entités, cliquez sur le lien Plus de champs.
- Ajoutez les codes intégrés à l'endroit où vous souhaitez qu'ils apparaissent sur votre site Web.
Exemple
Vous pouvez utiliser la balise d'intégration suivante pour afficher n'importe quel contenu des entités Yext directement sur une page Web.
<span data-yext-field="name"></span>
Pour sélectionner un champ de Yext, mettez à jour la valeur de data-yext-field avec le nom de l'API du champ que vous souhaitez afficher. Dans l'exemple ci-dessus, nous affichons le champ Nom. Consultez Afficher le nom de l'API pour un champ pour localiser les noms d'API des champs d'entité.
Pages contenant plusieurs entités
Si votre page affiche du contenu pour plusieurs entités, assurez-vous que vos codes intégrés incluent également la propriété data-yext-id qui spécifie les données de l'entité à utiliser dans la balise. Par exemple :
Si votre page affiche du contenu pour plusieurs entités, assurez-vous que vos codes intégrés incluent également la propriété data-yext-id qui spécifie les données de l'entité à utiliser dans la balise. Par exemple :
- Si votre page concerne une seule entité, le code d'adresse ressemblera à ceci :
<span data-yext-field="address.line1"></span>
- Si votre page affiche plusieurs champs d'adresse, le code de chaque adresse ressemblera à ceci :
<span data-yext-field="address.line1" data-yext-id="815"></span>
Pour récupérer des données de plusieurs entités, vous devez inclure un paramètre entity_id par entité dans votre requête Knowledge Tag (par exemple, entity_id=exemple1&entity_id=exemple2).
Champs personnalisés
Pour afficher le contenu stocké dans les champs personnalisés sur vos pages, vous pouvez créer des codes intégrés au format suivant :
<span data-yext-field="c_myCustomField"></span>
Ici, c_myCustomField est le nom API du champ personnalisé, et la balise HTML (dans l'exemple, <span>) variera selon le type de champ.
Champs de liste
Pour afficher le contenu des champs de type liste sur votre page, vous pouvez utiliser l'une des balises HTML suivantes :
-
<ul>: listes à puces -
<ol>: listes numérotées -
<span>: liste séparée par des virgules sur une ligne -
<div>: série d'éléments<div>, chacun sur une ligne distincte
Par exemple, pour afficher une liste à puces de vos produits, vous utiliseriez la balise d'intégration suivante :
<ul data-yext-field=”products”></ul>
Pour afficher un champ personnalisé qui contient une liste, vous utiliseriez ce qui suit :
<ul data-yext-field="c_listField"></ul>
Champs supplémentaires
Vous trouverez ci-dessous une liste de certains champs pouvant être utilisés pour intégrer du contenu sur des pages. Ces champs sont mis en évidence, les Knowledge Tags renvoyant les données dans un format spécifique.
| Nom de champ | Balise d'intégration | Afficher |
|---|---|---|
| Heures (avec jour de la semaine) | <span data-yext-field="hours"></span> |
Lundi 12 h 00 - 23 h 00 |
| Horaires | <span data-yext-field="hours-monday"></span> |
12 h 00 - 23 h 00 |
| Horaires d'ouverture des jours fériés | <span data-yext-field="holidayHoursFormatted"></span> |
Samedi 2 juillet 2020 Fermé |
| Adresse | <span data-yext-field="address.line1"></span> |
61 9th Avenue |
| Repas servis (liste d'options) | <span data-yext-field="mealsServed" <span> |
Liste des options sélectionnées (par exemple, petit-déjeuner, déjeuner, brunch, dîner, happy hour, soirée) |
| PLATS SERVIS | <span data-yext-field="mealsServed[0]" <span> |
Option spécifique (par exemple, PETIT-DÉJEUNER) |
| Adresse électronique | info@contact.com | |
| Lien Obtenir l'itinéraire | |
Obtenir l'itinéraire(le lien mène à Google Maps en ciblant l'adresse) |
| Logo | <img data-yext-field="logo.url"> |
 |
| Attributs Google | <span data-yext-field="googleAttributesFormatted"></span> |
Liste des caractéristiques pertinentes séparées par des virgules (par exemple, est détenu par des femmes, propose des cours en ligne). |
| Date et heure de début de l'événement | <div data-yext-field="start-datetime"</div> |
Le 5 octobre 2022 à 13 h 00 |
| Date et heure de fin de l'événement | <div data-yext-field="start-datetime"</div> |
Le 5 octobre 2022 à 16 h 00 |
Pour obtenir une liste complète de la manière dont toutes les autres données d'entité seront nommées et formatées, consultez la documentation de l'API Content Delivery.