L'inventaire v1 correspond à une structure hiérarchique des entités de flux au format JSON-LD. Ce schéma a permis aux partenaires du programme en accès anticipé de l'utiliser pour l'intégrer à Ordering de bout en bout. Le schéma d'inventaire v1 est désormais obsolète.
La dernière version des spécifications du flux de données, l'inventaire v2, présente une structure plate et utilise un modèle de schéma relationnel. Les partenaires peuvent ainsi extraire et transformer plus facilement les entités de leur base de données relationnelle pour créer les flux de données. L'inventaire v2 est au format NDJSON, qui est un format JSON délimité par un retour à la ligne.
Pourquoi passer de la version 1 à la version 2 ?
Bien que nous continuions à fournir une assistance de maintenance aux partenaires avec les intégrations de schéma d'inventaire Commander de bout en bout v1, toutes les nouvelles intégrations de partenaires doivent utiliser l'inventaire v2.
Il est possible que les nouvelles fonctionnalités de l'inventaire v2 ne soient pas disponibles dans l'inventaire v1. Pour obtenir un exemple, consultez la section Accord.
Étapes de migration
L'utilisation de la version 2 de l'inventaire nécessite un projet de commande de bout en bout distinct et une nouvelle intégration. Le processus suivant explique comment migrer un inventaire v1 vers un inventaire v2.
- Pour créer un projet v2, suivez d'abord la procédure d'intégration.
- Pour implémenter les flux de données, utilisez le schéma d'inventaire relationnel.
- Le cas échéant, réutilisez le point de terminaison de traitement de votre projet v1.
- Lorsque votre projet v2 est prêt pour le lancement, procédez comme suit:
- Assurez-vous que votre projet v2 respecte la checklist de préparation au lancement.
- Pour empêcher la diffusion de vos schémas d'inventaire v1 et v2 auprès des utilisateurs finaux, annulez le déploiement de la version de production de votre projet v1. L'inventaire de votre projet v1 cesse d'être diffusé en production quelques minutes après cette étape.
- Créez une version de production pour votre projet v2 et informez-en votre consultant Google.
Étapes de rollback
Si vous souhaitez effectuer un rollback vers la version v1 après le déploiement de votre projet v2 en production, vous pouvez annuler le déploiement de la version de production dans votre projet v2, puis redéployer la version de production de votre projet v1.
Impact sur les données des partenaires et le classement des fournisseurs
Vous trouverez ci-dessous les conséquences potentielles sur les données des partenaires et le classement des fournisseurs.
- Les journaux de transactions et les données d'analyse de votre projet v1 ne sont pas transférés vers votre projet v2.
- Les métriques de performances, telles que les taux de conversion et les métriques d'API de votre projet v1, ne sont pas transférées vers le projet v2. Cette opération réinitialise votre classement de fournisseur dans l'étape de commande de bout en bout.