Implémenter le retail

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page fournit des instructions détaillées pour mettre en œuvre l'API Retail.

Introduction

Lorsque vous utilisez Recommendations AI ou Retail Search, l'API Retail vous permet d'ingérer des données d'événements utilisateur et de catalogue, et de diffuser des prédictions ou des résultats de recherche sur votre site.

L'API Retail utilise les mêmes données pour Recommendations AI et Retail Search. Vous n'avez donc pas besoin d'importer deux fois les données si vous utilisez les deux outils.

Pour connaître les données d'événements utilisateur utilisées par Retail et Retail Search, consultez la section Exigences et bonnes pratiques concernant les événements utilisateur. Si vous utilisez des modèles Recommendations AI, la section Exigences relatives aux données d'événements utilisateur répertorie des exigences supplémentaires en fonction du type de modèle et de l'objectif d'optimisation. Ces exigences aident l'API Retail à générer des résultats de qualité.

Le temps d'intégration moyen pour l'API Retail est de l'ordre de quelques semaines. Notez que pour Retail Search, la durée réelle dépend fortement de la qualité et de la quantité de données à ingérer.

Si vous utilisez Google Tag Manager ou Google Merchant Center, vous pouvez mettre en œuvre l'API Retail avec les outils Google.

Vous pouvez utiliser l'API Retail pour obtenir des résultats personnalisés pour votre site Web, que vous utilisiez ou non des outils Google supplémentaires. Si ce n'est pas le cas, consultez Mettre en œuvre l'API Retail.

Ne mettez jamais en cache les résultats personnalisés d'un utilisateur final et ne les renvoyez jamais à un autre utilisateur final.

Implémenter l'API Retail avec les outils Google

Si vous utilisez Google Tag Manager et Google Merchant Center, vous pouvez utiliser ces produits pour fournir des données que l'API Retail peut utiliser.

Étape Description
1. Configurer un projet Google Cloud Vous pouvez utiliser un projet Google Cloud existant si vous en avez déjà un.
2a. Importer votre catalogue de produits à l'aide de Merchant Center

Vous pouvez également importer directement votre catalogue de produits, mais l'association à Merchant Center réduit la procédure d'importation.

Notez que Merchant Center n'accepte pas le type de produit de collections. Avant de procéder à l'importation, consultez les limitations de Merchant Center pour vérifier que cette solution correspond bien à vos besoins de catalogue.

2b. Configurer Tag Manager pour enregistrer les événements utilisateur Les événements utilisateur suivent les actions des utilisateurs, telles que les clics sur un produit, les ajouts d'articles à un panier ou les achats d'articles. Vous pouvez commencer à enregistrer les événements utilisateur en parallèle de l'importation du catalogue. Une fois l'importation du catalogue terminée, rejoignez à nouveau les événements importés avant la fin de l'importation.
3. Importer des événements utilisateur historiques

Vos modèles ont besoin d'une quantité suffisante de données d'entraînement avant de pouvoir fournir des prédictions précises. Les données d'historique d'événements utilisateur vous permet de commencer l'entraînement des modèles sans avoir à attendre des mois pour qu'une quantité suffisante de données d'événements utilisateur soit collectée à partir de votre site. En savoir plus

4. Créer la configuration, le modèle et les contrôles de diffusion

Une configuration de diffusion est une entité de diffusion qui associe un modèle et, éventuellement, des commandes. Ils sont utilisés lors de la génération des résultats de recherche ou des recommandations. Lorsque vous créez une configuration de diffusion, vous pouvez simultanément créer un modèle (pour Recommendations AI uniquement) et des commandes. Vous pouvez également les créer séparément.

Si vous utilisez Recommendations AI, choisissez un type de modèle en fonction de l'emplacement de votre configuration de diffusion et de ses objectifs. Consultez les types de recommandations disponibles, les objectifs d'optimisation et les autres options de réglage des modèles afin de déterminer les options les mieux adaptées à vos objectifs commerciaux. (Pour les configurations de diffusion Retail Search, un modèle par défaut est créé automatiquement par l'API Retail.)

5. Prévoir du temps pour le réglage du modèle

La création d'un modèle a pour effet de démarrer l'entraînement du modèle. L'entraînement et le réglage initial du modèle prennent deux à cinq jours, mais cela peut prendre plus de temps pour les grands ensembles de données.

6. Prévisualiser votre configuration de diffusion

Une fois votre modèle activé, prévisualisez les recommandations ou les résultats de recherche de votre configuration de diffusion pour vous assurer que la configuration fonctionne comme prévu.

7. Configurer un test A/B (facultatif)

Vous pouvez effectuer un test A/B pour comparer les performances de votre site Web avec l'API Retail aux performances d'une version de référence qui n'utilise pas l'API Retail.

8. Évaluer votre configuration

Évaluez les métriques fournies par la console Google Cloud pour déterminer l'impact de l'intégration de l'API Retail sur votre entreprise.

Affichez les métriques de votre projet sur la page Analytics de la console Google Cloud.

Implémenter l'API Retail sans outils Google supplémentaires

Si vous n'utilisez pas Tag Manager et Merchant Center, suivez les étapes ci-dessous pour intégrer Retail à votre site Web.

Étape Description
1. Configurer un projet Google Cloud

Pour utiliser l'API Retail, créez un projet Google Cloud et créez des identifiants d'authentification, y compris une clé API et un jeton OAuth (à l'aide d'un compte utilisateur ou d'un compte de service) pour accéder au projet.

2a. Importez votre catalogue de produits

Vous pouvez ajouter des articles à votre catalogue de produits individuellement en utilisant la méthode Products.create. Pour les catalogues de produits volumineux, nous vous recommandons d'ajouter des articles de manière groupée en utilisant la méthode Products.import.

2b. Enregistrez des événements utilisateur

Les événements utilisateur suivent les actions des utilisateurs, telles que les clics sur un produit, les ajouts d'articles à un panier, les achats d'articles, etc. L'API Retail s'appuie sur les données d'événements utilisateur pour générer des résultats personnalisés. Les événements utilisateur doivent être ingérés en temps réel pour refléter avec précision le comportement des utilisateurs.

Vous pouvez commencer à enregistrer les événements utilisateur en parallèle de l'importation du catalogue. Une fois l'importation du catalogue terminée, rejoignez à nouveau les événements importés avant la fin de l'importation.

3. Importer des événements utilisateur historiques

Vos modèles ont besoin d'une quantité suffisante de données d'entraînement avant de pouvoir fournir des prédictions précises. Les données d'historique d'événements utilisateur vous permet de commencer l'entraînement des modèles sans avoir à attendre des mois pour qu'une quantité suffisante de données d'événements utilisateur soit collectée à partir de votre site. En savoir plus

4. Créer la configuration, le modèle et les contrôles de diffusion

Une configuration de diffusion est une entité de diffusion qui associe des paramètres à un modèle et, éventuellement, à des commandes. Ils sont utilisés lors de la génération des résultats de recherche ou des recommandations.

Lorsque vous créez une configuration de diffusion, vous pouvez créer simultanément un modèle et des commandes, ou les créer séparément.

Pour Recommendations AI, l'emplacement de votre configuration de diffusion et ses objectifs ont une incidence sur le réglage du modèle. Consultez les types de recommandations disponibles, les objectifs d'optimisation et les autres options de réglage des modèles afin de déterminer les options les mieux adaptées à vos objectifs commerciaux.

5. Prévoir du temps pour l'entraînement

La création de votre modèle ou de votre configuration de diffusion lance l'entraînement. L'entraînement et le réglage initial du modèle prennent deux à cinq jours, mais cela peut prendre plus de temps pour les grands ensembles de données.

6. Prévisualiser votre configuration de diffusion

Une fois la configuration activée, prévisualisez les recommandations ou les résultats de recherche de votre configuration de diffusion pour vous assurer que la configuration fonctionne comme prévu.

7. Configurer un test A/B (facultatif)

Vous pouvez effectuer un test A/B pour comparer les performances de votre site Web avec l'API Retail aux performances d'une version de référence qui n'utilise pas l'API Retail.

8. Évaluer votre configuration

Évaluez les métriques fournies par la console Google Cloud pour déterminer l'impact de l'intégration de l'API Retail sur votre entreprise.

Affichez les métriques de votre projet sur la page Analytics de la console Google Cloud.

Conditions d'utilisation

L'utilisation du produit est soumise aux Conditions d'utilisation de Google Cloud ou à une variante hors connexion pertinente. L'Avis de confidentialité de Google Cloud explique comment nous collectons et traitons vos informations personnelles liées à l'utilisation de Google Cloud et d'autres services Google Cloud.

À des fins d'assurance qualité, un petit ensemble de requêtes et de résultats de recherche issus des journaux de l'API Retail, incluant des données client, sont envoyés à des fournisseurs tiers divulgués en tant que sous-traitants indirects pour Retail Search. Des tests supplémentaires qui utilisent des requêtes et des résultats de recherche issus des journaux de la recherche Google et qui sont des ensembles de données collectés publiquement sont envoyés pour évaluation manuelle à différents fournisseurs tiers à des fins d'assurance qualité. Les journaux de la recherche Google ne sont pas classés en tant que données client.