Aperçu et configuration de l'intégration Apple
Ce document explique comment Yext s'intègre à Plans et comment lier votre compte Apple Business à Yext.
Aperçu d'intégration
Les API Apple Business permettent de synchroniser les données avec Plans via les comptes Apple Business. Vos données apparaissent sur les listings Apple, appelés fiches de lieu sur Plans.
Pour gérer les fiches de lieu sur Plans, vous devez soit faire appel à un partenaire Apple de confiance comme Yext (qui a intégré les API Apple Business), soit gérer manuellement les données de vos établissements sur votre compte Apple Business.
Par défaut, Yext synchronise vos établissements avec Apple à l'aide du compte Business de Yext, ce qui vous permet de créer et de mettre à jour des fiches Apple sans lier votre propre compte. Toutefois, lier votre propre compte Apple Business présente des avantages considérables.
Avantages de lier votre compte Apple
Priorité supérieure des données. Les données d'un compte Apple Business lié sont prioritaires sur celles du partenaire. Si Apple reçoit des données de deux sources pour une entité donnée, il privilégie les données propres à l'entreprise. Lier votre compte garantit que vos données s'affichent exactement comme prévu.
Accès à des fonctionnalités supplémentaires. Vous devez lier votre compte pour utiliser les fonctionnalités suivantes :
- Publications de Showcases Apple
- Analyses Apple
- Synchronisation des photos de couverture.
Mises à jour groupées plus faciles. Si le compte n'est pas lié, les mises à jour d'Apple doivent s'effectuer directement dans Apple, un établissement à la fois. La gestion des données via Yext permet d'effectuer des mises à jour groupées pour tous les établissements.
Remarque : aucun nombre minimum d'établissements n'est requis pour lier votre compte Apple Business. Toutefois, si Apple estime qu'une marque n'est pas suffisamment importante, il peut vous être demandé de vérifier chaque établissement créé par Yext. Si des établissements apparaissent comme « non vérifiés », approuvez la synchronisation Yext au niveau de l'établissement sur votre compte Apple Business.
Structure du compte Apple
Les comptes Apple Business s'organisent autour de trois objets :
| Objet | Description |
|---|---|
| Entreprise | L'objet de niveau supérieur qui représente l'ensemble de votre organisation. Chaque entreprise doit disposer d'un compte Apple Business. |
| Marque | Relève de l'entreprise. Créez un dossier de marque pour chaque combinaison marque-pays (par exemple, Galaxy Grill France, Galaxy Grill Canada). |
| Établissement | Un établissement physique individuel à référencer sur Plans. Les établissements se trouvent dans un dossier de marque. |
Par exemple, Galaxy Grill, avec deux marques dans deux pays chacune, aurait une entreprise, quatre marques et plusieurs établissements répartis entre les quatre dossiers de marque.
Remarque : pour les établissements OAuth délégués, Apple exige que tous les noms d'établissement correspondent exactement aux noms de marque respectifs. Il existe quelques exceptions selon le secteur. Consultez l'article d'aide Noms de marque et d'établissement pour Apple pour en savoir plus.
Champs synchronisés avec les fiches Apple
Tous les comptes :
- Nom de l'entreprise, adresse, numéro de téléphone, catégorie, URL et horaires
- Attributs professionnels
- Coordonnées pour les trajets à pied et en voiture
- Photos de la galerie et moyens de paiement
- Liens d'action (voir Ajouter des liens d'action Apple)
Comptes délégués (liés) uniquement :
- Description Apple Business (correspond au champ « À propos » sur Apple ; limite de 500 caractères. Remarque : le champ Description général de Yext ne se synchronise pas avec Apple)
- Photos de couverture
- Logo
Pays pris en charge
Apple prend en charge la synchronisation des données dans la plupart des pays. Pour connaître les pays concernés, recherchez dans le réseau d'annuaires. Pour connaître les pays où la publication de Showcases est prise en charge, consultez l'article d'aide Publication de Showcases Apple.
Chronologie
- Validation d'un nouveau compte Apple Business : jusqu'à 5 jours
- Validation du dossier de marque : jusqu'à 3 jours
- Une fois qu'un compte est créé, vous pouvez le lier à Yext à tout moment.
Lier votre compte Apple Business à Yext
Vous avez déjà délégué l'accès ? Si vous avez précédemment délégué l'accès à Yext et que vous n'avez pas lié votre compte Apple Business à Yext, vous devrez partager l'accès à Yext avec tout nouvel établissement. Si vous liez votre compte Apple Business à Yext, l'accès sera automatiquement partagé avec Yext.
Étape 1 : créez un compte Apple Business
Si vous n'avez pas encore de compte Apple Business, créez-en un sur business.apple.com. Consultez l'article d'Apple Inscrivez-vous à Apple Business pour connaître toutes les étapes.
Une fois votre compte créé :
- Dans la navigation supérieure, sélectionnez Marques, puis Profils de marque dans la navigation de gauche.
-
Cliquez sur Ajouter en haut à droite pour créer un dossier de marque :
- Ajouter une seule marque pour en créer une manuellement
- Ajouter plusieurs marques pour rechercher votre marque et créer automatiquement tous les dossiers si elle est trouvée.
- Terminez le processus de validation de la marque pour votre première marque. Une fois la validation effectuée, créez des dossiers de marque supplémentaires pour chaque combinaison marque-pays que vous souhaitez activer.
- La validation peut prendre jusqu'à 5 jours.
- Vous aurez besoin d'un identifiant d'entreprise correspondant au pays d'enregistrement. Consultez Types d'identifiants d'entreprise acceptés dans Apple Business.
- Vous n'avez pas besoin d'ajouter manuellement les établissements individuels. Une fois qu'un dossier de marque est délégué à Yext, Yext crée automatiquement les établissements de ce dossier.
Ne créez pas et ne revendiquez pas d'établissements directement sur votre compte Apple Business. Cela peut entraîner la création d'établissements en double, ce qui empêche Yext de synchroniser les fiches Apple Plans.
Étape 2 : liez votre compte Apple dans Yext
- Accédez à Paramètres du compte > Comptes liés.
- Cliquez sur Lier le compte pour Apple.
- Dans la boîte de dialogue, connectez-vous à votre compte Apple Business.
- Sélectionnez l'entreprise que vous souhaitez connecter à Yext, puis cliquez sur Connecter.
- La page s'actualisera et affichera votre nouveau compte lié.
Attribuez le compte lié à vos établissements :
- Sur la page Comptes liés, choisissez une option d'attribution :
- Tous les établissements disponibles
- Sélectionner un dossier
- Sélectionner des établissements
- Sélectionnez les établissements concernés.
- Cliquez sur Lier ce compte, puis sur Lier le compte pour confirmer.
Étape 3 : ajoutez les identifiants de marque Apple aux entités dans Yext
Après avoir lié votre compte, ajoutez votre identifiant de marque Apple aux entités d'établissement correspondantes dans le Knowledge Graph. L'identifiant de marque est spécifique à chaque combinaison marque-pays.
Trouvez votre identifiant de marque Apple :
- Dans Apple Business, accédez à Marques > Profils de marque et sélectionnez la marque.
-
Consultez l'URL de votre navigateur :
- Le numéro qui suit
companies/est votre identifiant d'entreprise Apple (celui-ci est automatiquement renseigné dans Yext lorsque vous liez votre compte ; il est identique pour toutes vos marques et c'est ce que Yext a utilisé pour lier votre compte Apple). - Le numéro qui suit
brand/est votre identifiant de marque Apple (c'est ce que vous devez ajouter à vos établissements correspondants dans Yext).
- Le numéro qui suit
- Répétez l'opération pour chaque dossier de marque.
Ajoutez les identifiants de marque aux entités :
- Accédez à Knowledge Graph > Entités.
- Modifiez les entités que vous souhaitez lier. Options :
- Entité unique : ouvrez-la et modifiez-la directement.
- Modification groupée dans l'UI : consultez l'article d'aide Modifier plusieurs entités à la fois.
- Importation de feuille de calcul : exportez vos entités, ajoutez les identifiants de marque dans le fichier, puis importez-les à nouveau. Consultez l'article Ajouter ou modifier des entités en important une feuille de calcul.
- Votre identifiant d'entreprise Apple devrait déjà être renseigné.
-
Ajoutez l'identifiant de marque Apple dans le champ Identifiant de marque Apple pour chaque entité.
Une fois cette opération terminée, l'association est achevée et toutes les fonctionnalités liées à Apple sont disponibles dans Yext.
Commentaires
0 commentaire
Cet article n'accepte pas de commentaires.