En testant votre action auprès des utilisateurs, vous pouvez recevoir des commentaires à l'avance et résoudre les problèmes techniques ou d'expérience utilisateur avant le lancement officiel.
La console Actions est compatible avec les environnements de publication. Vous pouvez ainsi autoriser un nombre limité d'utilisateurs à tester une nouvelle action ou une version plus récente de votre action existante, avant de la déployer en mode public.
Cycle de vie d'une version
Le schéma suivant illustre les chemins potentiels que le cycle de vie d'une action peut suivre:
La console Actions accepte deux types d'environnements de release de préproduction:
Alpha: ce canal permet de tester rapidement les premières versions de votre action.
- Vous permet de distribuer votre action à un petit groupe d'utilisateurs sans avoir à effectuer un examen complet de Google.
- Les utilisateurs reçoivent des avertissements indiquant que l'action n'a pas été examinée pour vérifier qu'elle respecte les règles.
- Idéal pour les tests internes.
Version bêta : cette chaîne vous permet de distribuer une action à un nombre limité d'utilisateurs après avoir passé un examen Google complet.
- Utilisez ce canal pour permettre aux utilisateurs externes à votre organisation d'accéder aux premières versions de l'action.
- Les utilisateurs seront informés que l'action est une version bêta.
- Étant donné que la version bêta a été approuvée par Google, vous pouvez choisir de la rendre publique à tout moment, sans aucun autre examen de Google.
Comparaison de l'environnement des versions
Le tableau ci-dessous récapitule les différences entre les canaux de déploiement.
| Simulateur | Alpha | Bêta | Production | |
|---|---|---|---|---|
| Audience visée | Développeur uniquement | Premiers testeurs de votre équipe, de vos amis et de votre famille | Testeurs externes à votre équipe | Tous les utilisateurs de l'Assistant Google |
| Examen Google requis | Non | Non | Oui | Oui |
| Autorisations d'accès | Développeur uniquement | Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent activer cette option. | Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent activer cette option. | Accessible à tous les utilisateurs de l'Assistant Google |
| Nombre maximal d'utilisateurs | 1 | 20 | 200 | N/A |
| Pays dans lesquels l'assistant Wi-Fi est disponible | Simulateur et tous les appareils dotés de l'Assistant | Tous les appareils dotés de l'Assistant | Tous les appareils dotés de l'Assistant | Tous les appareils dotés de l'Assistant |
| Actions Builder | Compatible | Compatible | Compatible | Oui |
| SDK Actions | Compatible | Compatible | Compatible | Oui |
| Dialogflow | Compatible | Compatible | Compatible | Oui |
| Maison connectée | Compatible (nécessite l'association de comptes) | Non compatible | Non compatible | Oui |
| Modèles | Compatible | Incompatible | Non compatible | Oui |
| Appel explicite | Compatible | Compatible | Compatible | Oui |
| appel implicite | Compatible | Compatible | Compatible | Oui |
| Associer des comptes | Compatible | Compatible | Compatible | Oui |
Gérer les tests des versions alpha ou bêta
Pour configurer vos tests alpha ou bêta, procédez comme suit:
- Cliquez sur Gérer les testeurs alpha ou Gérer les testeurs alpha.
Saisissez les adresses e-mail des testeurs, séparées par une virgule. Vous pouvez spécifier jusqu'à 20 testeurs alpha et 200 testeurs bêta.
Copiez le lien d'activation à partager avec vos testeurs.
Cliquez sur Enregistrer.
Vous devez envoyer un e-mail d'invitation à vos testeurs avec un lien vers la version alpha ou bêta de votre action (le lien d'activation). Pour en savoir plus, consultez Recevoir des commentaires.
Lien d'activation
Le lien d'activation représente votre page de répertoire d'actions et ne change jamais. Le lien redirige les testeurs vers votre page d'annuaire et affiche la fiche d'activation de l'environnement éligible. Si vous avez répertorié les mêmes testeurs pour les versions alpha et bêta, ils sont éligibles aux deux et une fiche d'activation s'affiche en premier.
Implémenter le fulfillment pour une version alpha ou bêta
Les informations sur la version disponible ne sont pas incluses dans la demande HTTP envoyée à l'Assistant par votre fulfillment. Pour gérer les canaux de publication dans votre traitement, vous devez fournir différentes URL de traitement (par exemple, une URL de traitement pour la version bêta et une autre pour la version de production de votre action).
Obtenez des retours
Une fois que votre action est lancée en version alpha ou bêta, vous devez inviter vos testeurs en partageant votre lien d'activation (identique à celui qui figure dans la liste de l'annuaire de l'Assistant).
Veillez à indiquer à vos testeurs qu'ils doivent:
- Téléchargez l'application Assistant Google sur votre appareil mobile pour effectuer des tests alpha ou bêta.
- Connectez-vous à l'application Assistant Google avec le compte que vous avez désigné comme testeur alpha ou bêta.
Une fois votre action déployée, tous les nouveaux testeurs doivent attendre au moins trois heures avant de pouvoir accéder à l'action à l'aide du lien d'activation.
Lorsque les utilisateurs cliquent sur ce lien, ils sont redirigés vers la page de répertoire de l'action correspondante. Il doit cliquer sur le bouton J'accepte en bas de la page de l'annuaire de l'action pour se connecter en tant que testeur.
Une fois que le testeur a activé l'option sur son téléphone, votre action est immédiatement disponible sur tous ses appareils. Votre action s'affiche dans la section Mes applications de l'application Assistant Google pour les testeurs et porte un des libellés suivants: Alpha, Bêta ou Aucun test. L'option Aucun test permet de diffuser la version de production de votre action, le cas échéant. S'il n'y a pas de version de production, les utilisateurs ne recevront rien.
Bonnes pratiques
- Assurez-vous que les utilisateurs peuvent participer aux tests. Vos testeurs doivent disposer d'un compte Google (@gmail.com) ou G Suite pour participer à un test.
- Choisissez le type de test approprié. Un groupe de test alpha doit être réduit et tester les versions expérimentales les moins stables de vos actions (par exemple, au sein de votre entreprise ou de votre équipe). Utilisez des tests bêta avec un groupe d'utilisateurs plus important pour tester des versions stables de vos actions qui sont presque prêtes.
- Fournissez à vos testeurs un canal sur lequel ils peuvent vous envoyer leurs commentaires. Les versions alpha et bêta ne sont disponibles que pour vos testeurs. Assurez-vous de leur permettre d'envoyer leurs commentaires par e-mail, via un site Web, un forum ou un autre mécanisme approprié.
- Exécutez des tests simultanés sur la même action. Vous pouvez exécuter des tests alpha et bêta simultanément.
Problèmes connus
- L'annuaire de l'Assistant pour le Web n'est pas compatible avec les versions alpha ou bêta. Assurez-vous que vos testeurs suivent le lien sur leur appareil mobile (Android ou iOS).
- L'application de vos modifications peut prendre quelques heures. Veuillez patienter un moment avant de partager le lien d'activation avec vos utilisateurs.
Créer une version alpha ou bêta
Pour déployer votre action en version alpha ou bêta, procédez comme suit:
- Dans la console Actions, cliquez sur Déployer > Publier.
Cliquez sur Lancer une nouvelle version.
Sélectionnez Alpha ou Bêta, puis cliquez sur Envoyer.
Si vous y êtes invité, indiquez que vous avez suivi les étapes requises dans la checklist Vérification de l'action requise.
Le cas échéant, sélectionnez les langues de votre release.
Cliquez sur Envoyer.
Une fois la version alpha ou bêta envoyée, elle apparaît dans la section Gérer les versions.
Passer d'une version alpha ou bêta à une version de production existante
Les versions de production peuvent être un déploiement complet auprès de tous les utilisateurs de l'Assistant Google, un déploiement par étapes dans des régions spécifiques ou un pourcentage d'utilisateurs. Les déploiements par étapes vous aident à tester la stabilité de votre projet d'action. Il est préférable de déployer votre application auprès d'un petit groupe d'utilisateurs et d'effectuer des augmentations progressives jusqu'à atteindre 100% des utilisateurs. Vous pouvez ainsi corriger les bugs avant de déployer l'outil à l'ensemble de la base d'utilisateurs.
Déploiement par étapes
Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant auprès d'un sous-ensemble d'utilisateurs et en les étendant progressivement à tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs concernés par votre déploiement.
Pour déployer votre action par étapes, procédez comme suit:
- Sous Gérer les versions, sélectionnez la version à mettre à niveau vers le déploiement en production.
- Cliquez sur Gérer les déploiements.
- Sélectionnez Déployer en production.
- Sélectionnez Déploiement par étapes.
- Cliquez sur Sélectionner le type de déploiement.
Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour en savoir plus sur cette sélection, consultez Déploiement par zones géographiques spécifiées ou Déploiement par pourcentage de la base d'utilisateurs.
Cliquez sur Envoyer.
Pour avancer l'étape de votre déploiement, consultez Avancer la phase de déploiement d'une version.
Déploiement complet
Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs de tous les pays que vous ciblez.
Pour déployer votre action en tant que déploiement complet, procédez comme suit:
- Sous Gérer les versions, sélectionnez la version à mettre à niveau vers le déploiement en production.
Cliquez sur Gérer les déploiements.
Sélectionnez Déployer en production.
Sélectionnez Déploiement complet.
Cliquez sur Envoyer.
Créer une release de production sans tests alpha ni bêta
Les versions de production peuvent être un déploiement complet auprès de tous les utilisateurs de l'Assistant Google, un déploiement par étapes dans des régions spécifiques ou un pourcentage d'utilisateurs. Les déploiements par étapes vous aident à tester la stabilité de votre projet d'action. Il est préférable de déployer votre application auprès d'un petit groupe d'utilisateurs et d'effectuer des augmentations progressives jusqu'à atteindre 100% des utilisateurs. Vous pouvez ainsi corriger les bugs avant de déployer l'outil à l'ensemble de la base d'utilisateurs.
Déploiement par étapes
Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant auprès d'un sous-ensemble d'utilisateurs et en les étendant progressivement à tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs concernés par votre déploiement.
Pour déployer votre action par étapes, procédez comme suit:
- Dans la console Actions, cliquez sur Déployer > Publier.
Cliquez sur Lancer une nouvelle version.
Sélectionnez Production.
Si vous y êtes invité, indiquez que vous avez suivi les étapes requises dans la checklist Vérification de l'action requise.
Le cas échéant, sélectionnez les langues de votre release.
Sélectionnez Déploiement par étapes.
Cliquez sur Sélectionner le type de déploiement.
Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour en savoir plus sur cette sélection, consultez Déploiement par zones géographiques spécifiées ou Déploiement par pourcentage de la base d'utilisateurs.
Cliquez sur Envoyer.
Déploiement en fonction des zones géographiques spécifiées
Si vous sélectionnez cette option, votre projet d'action sera disponible dans les pays ou régions de votre choix.
Pour déployer votre action par lieu, procédez comme suit:
- Cliquez sur Sélectionner des pays ou régions et cochez les cases correspondant aux régions à cibler pour votre version.
Cliquez sur Envoyer.
Déploiement par pourcentage de la base d'utilisateurs
Cette option publie votre action auprès d'un pourcentage d'utilisateurs sélectionnés au hasard.
Pour déployer votre action auprès d'un certain pourcentage d'utilisateurs, procédez comme suit:
- Cliquez sur Pourcentage d'utilisateurs.
Sélectionnez le pourcentage d'utilisateurs auquel vous souhaitez abandonner votre action.
Cliquez sur Envoyer.
Déploiement complet
Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs de tous les pays que vous ciblez.
Pour déployer votre action en tant que déploiement complet, procédez comme suit:
- Dans la console Actions, cliquez sur Déployer > Publier.
Cliquez sur Lancer une nouvelle version.
Sélectionnez Production.
Si vous y êtes invité, indiquez que vous avez suivi les étapes requises dans la checklist Vérification de l'action requise.
Le cas échéant, sélectionnez les langues de votre release.
Sélectionnez Déploiement complet.
Cliquez sur Envoyer.
Une fois la version de production envoyée, elle apparaît dans la section Gérer les versions.
Modifier une version ou annuler son déploiement
Une fois que vous avez soumis votre action à une version disponible, vous pouvez toujours apporter des modifications. Vous pouvez tester la version actuelle, retirer la version de l'examen, afficher les détails de la version, gérer les déploiements, annuler le déploiement et mettre à niveau les étapes de déploiement. Vous pouvez également y consulter les informations sur les versions précédentes.
Afficher et modifier une version
Pour afficher les détails de la release ou la modifier, procédez comme suit:
- Sous Gérer les versions, sélectionnez la version sous Nom de l'album.
- Sélectionnez Modifier le déploiement, Gérer les déploiements ou Voir plus.
Avancer la phase de déploiement d'une version
Pour avancer l'étape de déploiement de votre action, procédez comme suit:
- Sous Gérer les versions, sélectionnez la version à mettre à niveau.
- Cliquez sur le bouton Modifier le déploiement.
- Apportez les modifications souhaitées à votre déploiement. Par exemple, vous pouvez faire passer la base d'utilisateurs de 5% à 20%.
- Cliquez sur Envoyer.
Annuler le déploiement en production
- Si vous devez mettre votre déploiement par étapes hors connexion, cliquez sur Modifier le déploiement sous Gérer les versions. Vous pouvez effacer toutes les régions ou sélectionner 0%, selon que votre déploiement est effectué par zone géographique ou par pourcentage de base d'utilisateurs.
- Pour annuler le déploiement d'une action entièrement déployée (100% de la base d'utilisateurs), cliquez sur le bouton Gérer les déploiements sous Gérer les versions, puis sélectionnez Annuler le déploiement en production.