Le hub d'intégration UCP dans Merchant Center vous guide tout au long du test et de la validation de votre implémentation UCP.
Accéder au hub d'intégration UCP
Le hub d'intégration UCP est progressivement déployé aux États-Unis. L'Australie et le Canada suivront en début d'année prochaine. Vous trouverez un hub d'intégration UCP dédié dans le menu de navigation.
- Dans votre compte Google Merchant Center, cliquez sur Paramètres dans le menu de navigation.
- Sélectionnez Intégration UCP.
La page est divisée en deux onglets :
- Présentation : s'ouvre par défaut et vous guide tout au long de la configuration technique, des tests en bac à sable et de la validation en production.
- Données analytiques : obtenez une visibilité sur votre entonnoir de paiement UCP dans les parcours d'achat agentiques et suivez les métriques de performances clés.
Parcours de validation personnalisés
Merchant Center propose des parcours de validation personnalisés en fonction des capacités UCP que vous avez choisies. Les étapes et les exigences d'intégration s'adaptent à votre sélection :
- "Je prends en charge le transfert vers le panier du marchand" : bénéficiez d'un parcours de validation accéléré pour permettre aux acheteurs de transférer des articles vers votre site afin de finaliser leur achat. Ce parcours simplifié ne nécessite pas de configurer un flux de produits complet, ni d'ajouter des avertissements sur les produits ou des informations sur le service client.
- "Je prends en charge le paiement natif sur Google" : suivez une checklist de validation simplifiée pour permettre aux acheteurs d'acheter directement sur Google. Ce parcours se concentre sur l'implémentation des points de terminaison de l'API de paiement.
- "Je prends en charge l'association d'identité" : activez les avantages fidélité et les paiements authentifiés en implémentant vos points de terminaison OAuth 2.0 et en publiant vos métadonnées pour l'association d'identité.
Le processus d'intégration se déroule en trois étapes clés :
- Implémenter l'UCP en suivant les instructions du guide : familiarisez-vous avec les concepts de base et les exigences techniques de l'UCP.
- Tester votre implémentation UCP dans un environnement sandbox : testez et déboguez votre intégration de manière sécurisée.
- Intégrer l'UCP et valider vos capacités en production : sélectionnez vos capacités, publiez votre profil et vérifiez que votre intégration fonctionne correctement dans un environnement de production.
Implémenter l'UCP à l'aide du guide du développeur
Consultez le guide d'implémentation de l'UCP pour comprendre les étapes d'intégration. Ce guide couvre les spécifications et les concepts de base de l'API.
Tester votre implémentation UCP dans un environnement sandbox
Cliquez sur Tester dans la fiche Tester votre implémentation UCP dans un environnement sandbox pour accéder à la page "Intégration UCP dans un bac à sable". Cela vous permet de tester votre intégration de manière sécurisée dans différents cas d'utilisation et d'examiner les réponses de votre serveur.
Configurer les clés Checkout API
Pour permettre à Google d'appeler vos API pour les tests et la production, fournissez des clés API provenant de votre système. Ces clés servent à authentifier les requêtes envoyées par Google à vos points de terminaison.
- Exigences : Google chiffre et stocke vos domaines et les clés API associées. Générez des clés dédiées pour cette intégration.
- Environnements : fournissez des clés API distinctes pour vos environnements de préproduction (sandbox) et de production.
- Envoi : contactez-nous par e-mail pour discuter des méthodes acceptées et échanger des clés. Vous trouverez notre adresse e-mail de contact en accédant à Paramètres > Intégration UCP.
Indiquer l'emplacement de votre profil UCP et vos identifiants
Pour tester votre intégration UCP dans l'environnement sandbox, fournissez les informations suivantes :
- Emplacement du profil UCP : indiquez le chemin d'accès au fichier
/.well-known/ucpque vous souhaitez tester. Cette URL permet à Google de découvrir les capacités et les points de terminaison d'API de votre serveur. - Clé API : saisissez la clé API si votre environnement de test en a besoin pour authentifier les requêtes.
- Remplacer access_token : fournissez éventuellement un jeton de support OAuth spécifique à utiliser pour les requêtes API.
Simuler des actions de transfert de panier
Si vous implémentez la fonctionnalité de transfert de panier, développez la section Transfert de panier/API pour simuler des requêtes et vous assurer que votre système gère correctement les paniers :
- Créer un panier : teste le lancement d'une nouvelle session de panier lorsqu'un utilisateur transfère des articles de Google vers votre site.
- Récupérer le panier : (facultatif) teste la récupération de l'état actuel d'une session de panier active.
- Mettre à jour le panier : (facultatif) teste la gestion des mises à jour d'un panier existant (par exemple, la modification du nombre d'articles).
- Annuler le panier : (facultatif) teste l'arrêt ou l'abandon d'une session de panier.
Simuler des actions de paiement natif
Si vous implémentez le paiement natif, développez la section Paiement natif pour simuler le parcours d'achat principal :
- Créer une page de paiement : teste le lancement d'un nouveau processus de paiement. Saisissez les détails de la requête dans l'éditeur JSON fourni, puis cliquez sur Tester.
- Mettre à jour la page de paiement : teste la gestion des mises à jour d'un paiement existant (par exemple, lorsqu'un utilisateur modifie les informations de livraison).
- Finaliser la page de paiement : simule l'étape d'achat finale pour vérifier que la transaction a bien été effectuée.
Valider vos capacités UCP en production pour le lancement
Sélectionnez Démarrer sur la fiche Validez vos capacités UCP en production pour le lancement afin d'initier le processus de validation en production. Ce flux de validation vous guide dans la sélection des capacités, la publication de votre profil et la validation de votre intégration.
Étape 1 : Sélectionner les capacités UCP
Sélectionnez les fonctionnalités UCP que vous souhaitez activer pour votre intégration. Un aperçu de l'expérience client s'affiche sur la droite.
- Transférer vers le panier du marchand : permettez aux acheteurs d'ajouter des produits à leur panier sur Google, puis de transférer facilement ces produits vers votre site pour finaliser la commande en implémentant l'API Cart.
- Paiement natif sur Google : permettez aux acheteurs d'acheter directement sur Google en implémentant trois points de terminaison REST principaux pour la création, la mise à jour et la finalisation des sessions.
- Association de l'identité : activez les avantages fidélité et les paiements authentifiés en implémentant OAuth 2.0.
Étape 2 : Publier le profil UCP
Indiquez l'emplacement de votre profil UCP. En fonction de cet emplacement, Google vérifie les capacités que vous avez choisi de prendre en charge. Assurez-vous que les capacités déclarées dans votre profil UCP correspondent exactement à celles que vous avez sélectionnées à l'étape 1 (par exemple, si vous avez sélectionné l'association de l'identité, elle doit être présente dans votre profil).
- Saisissez l'URL d'emplacement du profil UCP (par exemple,
https://example.com/.well-known/ucp). - Cliquez sur Ajouter. Google vérifie votre profil et affiche les capacités détectées.
- En savoir plus sur le profil UCP marchand
Étape 3 : Valider l'implémentation de l'UCP
En fonction des capacités sélectionnées, une checklist détaillée s'affiche pour poursuivre le processus de validation. Suivez la checklist qui s'applique à votre parcours d'intégration :
Capacité de transfert vers le panier du marchand uniquement
Si vous n'implémentez que le transfert de panier, une checklist simplifiée s'affiche :
- Configurer votre compte Merchant Center pour l'UCP : assurez-vous que la configuration de l'ID produit correspondant est terminée.
- Valider le transfert de panier : effectuez des tests pour vous assurer que votre API Cart est bien implémentée.
Capacité de paiement natif sur Google
Si votre intégration inclut le paiement natif, votre checklist comprend les étapes suivantes.
- Configurer votre compte Merchant Center pour l'UCP : assurez-vous que toutes les configurations sont terminées.
- Valider l'association de l'identité (facultatif) : si cette option est activée, implémentez vos points de terminaison OAuth 2.0 et publiez vos métadonnées.
- Valider l'intégration du paiement natif : implémentez et validez les trois points de terminaison REST principaux. Vous pouvez prévisualiser la feuille de paiement natif. En sélectionnant Payer avec GPay, vous pouvez lancer le processus de validation.
- Valider l'état des commandes : configurez des webhooks pour envoyer les mises à jour des commandes à Google.
- Lire et accepter l'avenant au programme UCP.
Une fois toutes les étapes de validation terminées, l'équipe d'assistance Google examine votre intégration UCP. Vous recevez une notification vous indiquant si votre compte est opérationnel ou si des problèmes de configuration doivent être corrigés.
Pour en savoir plus sur les étapes d'intégration, consultez le guide d'implémentation de l'UCP, qui couvre les spécifications et les concepts de base de l'API.