Vous pouvez demander à vos clients de donner leur avis hors du cadre habituel d'évaluation d'un produit. La fonctionnalité de soumission d'un avis générique, également appelée «Product Picker», permet à vos clients de choisir le ou les produits sur lesquels ils souhaitent donner leur avis. La soumission d'avis générique augmente considérablement votre capacité à recueillir des avis précieux en dehors du cycle habituel d'achat de produits.

Vous pouvez fournir des liens de soumission d'avis générique par e-mail : Par exemple, dans le cadre d'une campagne par e-mail sollicitant des avis sur des produits, vous pouvez envoyer des e-mails à des clients qui ont acheté des produits chez vous par le passé. Même si vous ne savez pas quels produits ils ont achetés, vous pourrez leur envoyer par e-mail un lien générique « Donner un avis ». À l'aide de ce lien, vos clients pourront ouvrir un formulaire de soumission puis utiliser l'interface de recherche de produits pour sélectionner un ou plusieurs produits au sujet desquels ils souhaitent écrire un avis.

Vous pouvez fournir des liens de soumission d'avis générique sur ces pages :

  • Les pages de catégorie
  • Les pages de destination
  • Les pages des promotions spéciales

Pour activer les avis génériques, vous devez choisir si vous souhaitez utiliser la solution hébergée par Bazaarvoice ou configurer la soumission d'avis sur site. Nous vous recommandons d'utiliser la solution hébergée par Bazaarvoice si :

  • Vous ne voulez pas héberger le bouton Donner un avis et le conteneur qui l'accompagne sur votre site.
  • Vous voulez obtenir un lien direct vers la fonctionnalité de soumission d'avis générique à partir d'un e-mail ou d'une campagne de marketing.

Dans les deux cas, vous pouvez utiliser une page de conteneur qui réside sur un serveur de Bazaarvoice.

Lorsqu'un utilisateur sélectionne le lien, une fenêtre contextuelle s'ouvre et propose une sélection de produits à évaluer. Le groupe de produits initial peut appartenir à une catégorie ou une famille de produits.

  • L'affichage basé sur une catégorie permet aux utilisateurs d'effectuer des recherches et de naviguer parmi les sous-catégories. Voici un exemple pour la catégorie Vélos :

  • L'affichage basé sur les produits présente uniquement les produits appartenant à la famille de produits spécifiée. Dans l’exemple suivant, la famille de produits Vélos pour femmes a été spécifiée :

Utiliser la soumission d'avis générique hébergée par Bazaarvoice

Pour utiliser la soumission d'avis générique hébergée par Bazaarvoice, utilisez les paramètres de la chaîne de requête pour contrôler les actions de la page de conteneur. Utilisez ce lien pour afficher le formulaire hébergé :

https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic

Retirez /bvstaging si vous vous trouvez en environnement de production et remplacez les valeurs suivantes :

  • <client_name> : le nom de client fourni par Bazaarvoice. Veuillez utiliser des lettres minuscules pour la valeur.
  • <site_ID> : identifiant de la zone de déploiement que vous voulez utiliser. Cette valeur est définie dans la configuration Bazaarvoice accessible à partir du Workbench Bazaarvoice. La zone de déploiement par défaut se nomme « main_site » (site principal). Contactez votre représentant Bazaarvoice pour vous assurer que l'identifiant est correct, ou cliquez sur à droite de la zone de déploiement, sur la page Site Manager (Gestionnaire de site) pendant la configuration.
  • <locale> fait référence à la langue utilisée dans l’implémentation. Si vous n'utilisez pas l'anglais, remplacez en_US par le code de votre langue.

Vous pouvez également ajouter les options suivante à l'URL :

  • Pour empêcher l'utilisateur de fermer le formulaire, ajoutez le paramètre bvpreventClose=true. Dans le cas contraire, l'icône sera affichée (comme dans l'exemple ci-dessus) et l'utilisateur pourra fermer le formulaire. La page d'accueil s'affichera alors selon les paramètres régionaux que vous avez saisis sur la page de configuration.

    https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic&bvpreventClose=true
  • Pour limiter les produits affichés dans le formulaire à une catégorie bien précise, ajoutez le paramètre bvcategoryId=CategoryId. L'élément CategoryId doit correspondre à la valeur <ExternalId>dans le flux de produits.

    https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic&bvcategoryId=<CategoryId>
  • Pour limiter les produits affichés sur le formulaire à une famille de produits bien précise, ajoutez le paramètre bvfamilyProductId=ProductFamilyID. Remplacez ProductFamilyID par la valeur <ExternalId> de la famille de produits que vous souhaitez afficher. Vous trouverez la valeur ExternalId d'un produit dans le catalogue produits.

    https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic&bvfamilyProductId=<ProductFamilyID>
  • Pour associer des avis envoyés à une campagne spécifique via le formulaire de soumission d'avis générique, veuillez configurer le paramètre bvcampaignId=CampaignId. CampaignId est une chaîne de 255 caractères alphanumériques maximum (y compris les tirets) créée pour identifier la campagne. Spécifiez un identifiant personnalisé ou un identifiant de système ; consultez la liste des identifiants de campagne fournis avec Ratings & Reviews.

    https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic&bvcampaignId=<CampaignId>

Vous pouvez également utiliser le générateur de liens de soumission pour créer la base de l'URL de soumission simple (ssURL).

Remarque : pour accéder au générateur de liens de soumission dans la Support Community, connectez-vous d’abord au portail de Bazaarvoice. Ensuite, sélectionnez le lien Accéder à la Support Community situé en bas de la page d’accueil ou en haut de la fenêtre d’aide. Pour ouvrir la fenêtre d’aide, sélectionnez l’icône icône d'aide intégrée à l'application dans le coin supérieur droit.

Activer la soumission hébergée d'avis génériques (bv.js)

Les étapes suivantes vous expliquent le fonctionnement de la soumission d'avis générique lorsque vous activez sa version hébergée sur site :

  1. Ajoutez le code d'intégration JavaScript afin de charger le fichier JavaScript hébergé par Bazaarvoice (bv.js) sur la page où vous souhaitez que Product Picker apparaisse.
  2. Ajoutez un élément <div data-bv-show="product_picker"> sur la page. Si vous souhaitez déclencher Product Picker lorsqu'un utilisateur sélectionne un bouton ou un lien, il vous suffit d'insérer cet élément de façon dynamique au sein d'un gestionnaire d'événements de clic.
  3. Ajoutez d'autres attributs à l'élément <div data-bv-show="product_picker"> pour déterminer les produits qui seront intégrés à Product Picker, ainsi que son mode d'affichage (fenêtre ou non). Ces produits peuvent appartenir à une catégorie ou à une famille de produits selon les informations fournies à l'appel $BV.ui ou BV.ui.

Pour configurer la soumission d'avis générique hébergée sur site, suivez les étapes ci-dessous.

Remarque : avant de configurer cette fonctionnalité, assurez-vous que les mappings appropriés existent dans votre flux de produits. Le flux de produits définit tous les produits qui apparaîtront dans le Product Picker. Ceux-ci s'afficheront uniquement si les catégories ou familles de produits sont correctement associées aux produits. Veuillez ajuster votre flux de produits si ces mappings ne sont pas faits.

Étape 1 : Ajoutez le code d’intégration JavaScript

Ajoutez le code JavaScript ci-après là où vous souhaitez voir apparaître Product Picker :

<script async src="https://apps.bazaarvoice.com/deployments/<client_name>/<site_ID>/<environment>/<locale>/bv.js"></script>

Dans <script>, remplacez les éléments suivants par vos valeurs :

  • <client_name> : le nom de client fourni par Bazaarvoice. Veuillez utiliser des lettres minuscules pour la valeur.
  • <site_ID> : identifiant de la zone de déploiement que vous voulez utiliser. Cette valeur est définie dans la configuration Bazaarvoice accessible à partir du Workbench Bazaarvoice. La zone de déploiement par défaut se nomme « main_site » (site principal). Contactez votre représentant Bazaarvoice pour vous assurer que l'identifiant est correct ou connectez-vous à la plateforme de configuration pour le vérifier.
  • <environment> — fait référence à l’environnement de déploiement où vous souhaitez implémenter Bazaarvoice. Pour un environnement de production, incluez production dans le chemin d’accès. Si vous utilisez un environnement de pré-production, incluez staging dans le chemin d’accès.
  • <locale> fait référence à la langue utilisée dans l’implémentation. Si vous n'utilisez pas l'anglais, remplacez en_US par le code de votre langue.

Étape 2 : Ajoutez une balise div avec l'attribut data-bv-show du Product Picker

Ajoutez une balise <div> sur la page comprenant l'attribut data-bv-show du Product Picker :

<div data-bv-show="product_picker"></div>

En utilisant la configuration par défaut ci-dessus, le sélecteur affichera cet élément.

Vous pouvez personnaliser Product Picker en ajoutant des options facultatives :

  • data-bv-category-id : catégorie racine par défaut. Vous pouvez afficher une autre catégorie en spécifiant sa valeur ExternalId dans le flux de produits. Si la catégorie choisie a des sous-catégories, elles apparaîtront dans une liste déroulante de catégories dans la zone du fil d'Ariane.
  • data-bv-family-product-id — identifiant d'un produit de la famille de produits à afficher.
  • data-bv-inline—la valeur par défaut est vrai. Si le mode en ligne est activé, Product Picker affichera l'élément comprenant l'attribut data-bv-show. Si le mode en ligne est désactivé (data-bv-inline="false"), Product Picker générera une fenêtre.
  • data-bv-prevent-close—La valeur par défaut est faux. Si la valeur est data-bv-prevent-close="false", la fenêtre Product Picker comportera un bouton pour la fermer. Si la valeur est vrai, la fenêtre s'affichera sans bouton de fermeture : l'utilisateur ne pourra donc pas la fermer après l'avoir ouverte.

    Remarque : Cet attribut est ignoré en cas de valeur data-bv-inline="true", car la version en ligne du Product Picker ne dispose jamais d'un bouton de fermeture.

Utilisez l'une des configurations suivantes, selon que vous souhaitez que la recherche de produit porte sur des produits de votre catégorie racine, d'un identifiant de campagne, d'une autre catégorie donnée ou d'une famille de produits.

Produits basés sur la catégorie racine

Dans ce cas de figure, vous fournissez aux utilisateurs une liste de tous les produits, leur permettant de naviguer dans l'ensemble de votre hiérarchie de catégories, ainsi que dans les sous-catégories, pour trouver un produit à évaluer.

Il ne définit pas de valeur data-bv-category-id, aussi toutes les catégories définies seront intégrées dans Product Picker.

<div data-bv-show="product_picker"></div>

L'exemple suivant montre Product Picker quand aucune valeur data-bv-category-id n'est précisée, les catégories sont donc toutes disponibles.

Produits basés sur une catégorie spécifiée

Dans ce cas de figure, vous fournissez aux utilisateurs qui donnent leur avis une liste de produits associés à une catégorie que vous avez choisie, leur permettant de naviguer dans toutes les sous-catégories définies pour cette catégorie.

Remarque : Ce cas d'utilisation est une des meilleures pratiques pour les pages de listes de catégories.

Insérez l'attribut data-bv-category-id dans la balise <div> de Product Picker, remplaçant ainsi la valeur ExternalId avec la valeur ExternalId de la catégorie produits telle que définie dans le catalogue produits Bazaarvoice. Il doit correspondre à l'élément CategoryExternalId pour chaque produit de la catégorie.

<div data-bv-show="product_picker" data-bv-category-id="ExternalId"></divgt;

L'exemple suivant montre Product Picker quand la valeur data-bv-category-idest une catégorie de niveau supérieur appelée « Sièges de voiture ». En conséquence, la catégorie Sièges de voiture et ses sous-catégories sont disponibles.

Produits d'une famille

Dans ce cas de figure, vous fournissez aux utilisateurs une liste de produits appartenant à une famille définie.

Insérez l'attribut data-bv-family-product-id dans la balise <div> du Product Picker. Remplacez ProductFamilyID par la valeur ExternalId de la famille de produits que vous souhaitez afficher. Vous trouverez la valeur ExternalId d'un produit dans le catalogue produits.

Par exemple, disons que vous souhaitiez afficher la famille de produits « VélosHommes ». Vous devrez d'abord identifier un article appartenant à cette famille, tel que le modèle Endurance Challenger 1, puis saisir sa valeur ExternalId pour remplacer data-bv-family-product-id. L'élément Product Picker comprendra alors que ce produit appartient à la catégorie « VélosHommes » et affichera alors tous les produits de cette famille.

<div data-bv-show="product_picker" data-bv-family-product-id="ProductFamilyID"></div>

L'exemple suivant montre Product Picker lorsque vous avez défini la famille « VélosHommes », qui comporte plusieurs modèles de vélos. Tous les produits définis dans cette famille sont disponibles.

Attention : Il n'est pas possible de spécifier une valeur pour data-bv-family-product-id et data-bv-category-id. Vous pouvez saisir une valeur pour l'un des deux attributs, ou bien aucun d'entre eux. Dans ce cas, Product Picker affichera tous les produits. À l'inverse, si les deux paramètres sont renseignés, une erreur apparaîtra dans la console.

campaignId

Ajoutez le code suivant pour injecter l'identifiant de campagne dans le champ masqué du formulaire de soumission d'avis :

<div data-bv-show="product_picker" data-bv-campaign-id="TestCampaignID"</i>"></div>

Déclencher Product Picker à l'aide d'un bouton ou d'un lien

Si vous souhaitez déclencher Product Picker lorsqu'un utilisateur sélectionne un bouton ou un lien, il vous suffit d'insérer cet élément de façon dynamique au sein d'un gestionnaire d'événements de clic. Vous pouvez créer une balise d'ancrage ou un bouton que les utilisateurs pourront sélectionner pour lancer le processus de soumission de l'avis.

Vous pouvez également utiliser l'exemple suivant pour gérer les événements de clic pour le bouton Donner un avis. Cette fonction permet également de déterminer l'option preventClose :

        <script type="text/javascript"> function submitGeneric() { BV.ui('rr', 'submit_generic', { campaignId: 'SampleProduct' preventClose: true inline: true }) </script>

Par exemple, si votre bouton Donner un avis est défini comme suit :

<button id="grs">Write a review</button>

Vous pouvez saisir une fonction pour injecter Product Picker dans un conteneur <div> et joindre un écouteur d'événements afin de gérer tout événement de clic pour l'élément, comme indiqué dans l'exemple ci-dessous :

<div id="grs_container"></div> <script type="text/javascript"> function submitGeneric (event) { var elem = document.createElement('div'); elem.setAttribute('data-bv-show', 'product_picker'); // Set any other options you would like. elem.setAttribute('data-bv-category-id', 'sampleCategory'); // Inject the element into the page. document.getElementById('grs_container').appendChild(elem); } document.getElementById('grs').addEventListener('click', submitGeneric); </script>

Paramètres requis

Le tableau suivant identifie les paramètres/champs requis :

Paramètre Description
rr Paramètre obligatoire sous forme de chaîne.
submit_generic Paramètre obligatoire sous forme de chaîne.
campaignId Élément d'identification permettant de segmenter les données présentées dans des rapports sur une ou plusieurs campagne(s).

Paramètres facultatifs

Paramètre Description
categoryId Valeur de la chaîne d'identification de la catégorie. Ne pas transmettre si familyProductId est transmis.
familyProductId Valeur de la chaîne d'identification d'une famille de produits spécifique. Ne pas transmettre si categoryId est transmis.
En ligne La valeur par défaut est false. Si true (vrai), l'application est affichée en ligne plutôt que sous forme modale par défaut.

Activer la soumission d'avis générique hébergée (bvapi.js)

Remarque : Si votre implémentation existante utilise le fichier scout (bvapi.js), complétez les étapes suivantes au lieu de configurer une fonction de soumission d'avis génériques hébergée sur site.

Les étapes suivantes vous expliquent le fonctionnement de la soumission d'avis générique si vous activez sa version hébergée sur site :

  1. Un fichier JavaScript hébergé par Bazaarvoice (bvapi.js) est exécuté sur la page où vous placez un bouton « Donner un avis ».
  2. Le gestionnaire d'événements submitGeneric() est appelé par l'événement onclick sur le lien de soumission.
  3. Lorsqu'un utilisateur sélectionne le lien, une fenêtre contextuelle s'ouvre et propose une sélection de produits à évaluer. Le groupe initial de produits peut faire partie d'une catégorie ou d'une famille de produits, en fonction des informations fournies à l'appel $BV.ui.

Pour configurer la soumission d'avis générique hébergée sur site, suivez les étapes ci-dessous.

Remarque : avant de configurer cette fonctionnalité, assurez-vous que les mappings appropriés existent dans votre flux de produits. Le flux de produits définit tous les produits qui apparaîtront dans le Product Picker. Ceux-ci s'afficheront uniquement si les catégories ou familles de produits sont correctement associées aux produits. Veuillez ajuster votre flux de produits si ces mappings ne sont pas faits.

Étape 1 : Ajoutez le code d’intégration JavaScript

Ajoutez le code JavaScript ci-après là où vous souhaitez voir apparaître le lien :

<script type="text/javascript" src="https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/bvapi.js"></script>

Retirez /bvstaging si vous ajoutez du code en environnement de production et remplacez les valeurs suivantes :

  • <client_name> : le nom de client fourni par Bazaarvoice. Veuillez utiliser des lettres minuscules pour la valeur.
  • <site_ID> : identifiant de la zone de déploiement que vous voulez utiliser. Cette valeur est définie dans la configuration Bazaarvoice accessible à partir du Workbench Bazaarvoice. La zone de déploiement par défaut se nomme « main_site » (site principal). Contactez votre représentant Bazaarvoice pour vous assurer que l'identifiant est correct ou connectez-vous à la plateforme de configuration pour le vérifier.
  • <locale> fait référence à la langue utilisée dans l’implémentation. Si vous n'utilisez pas l'anglais, remplacez en_US par le code de votre langue.

Étape 2 : Définissez la fonction submitGeneric

Définissez la fonction submitGeneric afin de pouvoir appeler $BV.ui à l'aide des options suivantes. Vous pouvez les définir comme propriétés d'un objet que vous transmettez en tant que troisième argument à $BV.ui :

  • categoryId : catégorie racine par défaut. Vous pouvez afficher une autre catégorie en spécifiant sa valeur ExternalId. Si la catégorie choisie a des sous-catégories, elles apparaîtront dans une liste déroulante de catégories dans la zone du fil d'Ariane.
  • ProductFamilyID : identifiant de la famille de produits à afficher.
  • preventClose—Empêche l'utilisateur de fermer la boîte de dialogue. Lorsque la boîte de dialogue est fermée, une page vierge s'affiche.
  • campaignID : permet de segmenter les données présentées dans des rapports sur une ou plusieurs campagne(s). Bazaarvoice vous recommande d'inclure ce paramètre ; consultez la liste des identifiants de campagne fournie avec Ratings & Reviews.

L'exemple suivant montre la fonction utilisée pour spécifier dans l'attribut onclick d'un bouton « Donner un avis ». Cette fonction permet également de déterminer l'option preventClose :

<script> function submitGeneric() { $BV.ui('rr', 'submit_generic', { preventClose : 'True' }); } </script>

Utilisez l'un des scripts suivants, selon que vous souhaitez que la recherche de produit porte sur des produits de votre catégorie racine, d'un identifiant de campagne, d'une autre catégorie donnée ou d'une famille de produits.

Produits basés sur la catégorie racine

Dans ce cas de figure, vous fournissez aux utilisateurs une liste de tous les produits, leur permettant de naviguer dans l'ensemble de votre hiérarchie de catégories, ainsi que dans les sous-catégories, pour trouver un produit à évaluer.

Insérez le script suivant après le code d'intégration JavaScript. Il ne définit pas de valeur categoryID, aussi toutes les catégories définies seront-elles intégrées dans la recherche de produit.

<script>
    function submitGeneric() {
       $BV.ui('rr', 'submit_generic', {
       });
    }
</script>

Produits basés sur une catégorie spécifiée

Dans ce cas de figure, vous fournissez aux utilisateurs qui donnent leur avis une liste de produits associés à une catégorie que vous avez choisie, leur permettant de naviguer dans toutes les sous-catégories définies pour cette catégorie.

Remarque : Ce cas d'utilisation est une des meilleures pratiques pour les pages de listes de catégories.

Insérez le script suivant après le code d'intégration JavaScript, en remplaçant ExternalId par l'élément ExternalId défini dans le catalogue de produits Bazaarvoice. Il s'agit également de l'élément CategoryExternalId pour chaque produit de la catégorie.

<script>
    function submitGeneric() {
       $BV.ui('rr', 'submit_generic', {
          categoryId : 'ExternalId'
       });
    }
</script>

Produits d'une famille

Dans ce cas de figure, vous fournissez aux utilisateurs une liste de produits appartenant à une famille définie.

Insérez le script suivant après le code d'intégration JavaScript, en remplaçant ProductID par la valeur ExternalId définie dans le catalogue de produits.

<script> function submitGeneric() { $BV.ui('rr', 'submit_generic', { familyProductId : 'ProductFamilyID' }); } </script>

Produits d'un identifiant de campagne

Insérez le script suivant pour injecter l'identifiant de campagne afin que le formulaire de soumission inclue cette information dans les champs cachés du formulaire d'avis :

<script> function submitGeneric() { $BV.ui('rr', 'submit_generic', { campaignId : 'TestCampaignId' }); } </script>

Étape 3 : Spécifiez une fonction pour gérer l’événement onclick

Spécifiez une fonction destinée à gérer l'événement onclick de l'élément. Vous pouvez créer une balise d'ancrage ou un bouton que les utilisateurs pourront sélectionner pour lancer le processus de soumission de l'avis. Configurez l'attribut onclick avec la valeur submitGeneric().

Par exemple, définissez une simple balise d'ancrage pour initier le processus d'envoi comme suit :

<a onclick="submitGeneric()">Cliquez ici pour donner votre avis</a>
Remarque : Vous pouvez utiliser jQuery pour associer la fonction submitGeneric à l'événement de clic. Si vous souhaitez que la recherche de produit apparaisse lorsque la page se charge, appelez directement la méthode UI au lieu de l'inclure dans le corps de la fonction submitGeneric.

Utiliser jQuery pour associer des événements

Si votre page contient du jQuery, vous pouvez l'utiliser pour associer la fonction submitGeneric à l'événement de clic.

Par exemple, si votre bouton « Donner un avis » est défini comme suit :

<button id="bv-write-a-review">Donner un avis</button>

Vous pouvez associer un écouteur d'événement à l'aide de la méthode on de jQuery, comme indiqué ci-dessous :

jQuery('#bv-write-a-review').on('click', function () {
  $BV.ui('rr', 'submit_generic', {
    categoryId : 'shop'
  });
});

Utilisez ce lien pour afficher le formulaire hébergé de soumission d'avis générique hébergée par Bazaarvoice :

https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/container.htm?bvaction=rr_submit_generic&bvpreventClose=true

Si vous souhaitez ajouter du code au sein de l'environnement de production, supprimez /bvstaging, puis remplacez <client_name>, <site_ID> et <locale> par vos propres valeurs.

Pour utiliser la soumission d'avis générique hébergée sur site, ajoutez un formulaire de soumission d'avis générique sur une page spécifique de votre site en procédant comme suit :

  1. Intégrez bv.js.
  2. Ajoutez une balise <div> Product Picker sur la page avec un attribut data-bv-show spécial :
    <div data-bv-show="product_picker"></div>

    Vous pouvez inclure un élément data-bv-category-id="ExternalId" ou data-bv-family-product-id="ProductFamilyID" pour afficher la catégorie ou famille de produits de votre choix dans le menu déroulant de Product Picker. Vous pouvez également configurer data-bv-inline pour choisir le mode d'affichage de Product Picker sur la page.

    Vous pouvez également créer un bouton « Donner un avis » à l'aide du code suivant :

    <button id="grs">Write a review</button>

    Ajoutez un écouteur d'événements pour gérer tout événement de clic et injectez Product Picker dans le conteneur <div>, tel que décrit dans l'exemple suivant :

    <div id="grs_container"></div> <script type="text/javascript"> function submitGeneric (event) { var elem = document.createElement('div'); elem.setAttribute('data-bv-show', 'product_picker'); // Set any other options you would like. elem.setAttribute('data-bv-category-id', 'sampleCategory'); // Inject the element into the page. document.getElementById('grs_container').appendChild(elem); } document.getElementById('grs').addEventListener('click', submitGeneric); </script>  

Remarque : Si votre implémentation existante utilise le fichier scout (bvapi.js), complétez les étapes suivantes au lieu de configurer une fonction de soumission d'avis génériques hébergée sur site :

  1. Intégrez la balise bvapi.js.
  2. Définissez un bouton « Donner un avis » à l'aide du code suivant :
    <button id="bv-write-a-review">Donner un avis</button>
  3. Insérez un écouteur d'événement en utilisant la méthode on de jQuery. Vous trouverez un exemple ci-dessous :
    jQuery('#bv-write-a-review').on('click', function () {
      $BV.ui('rr', 'submit_generic', {
        categoryId : 'shop'
      });
    });

    Vous pouvez utiliser les paramètres ProductFamilyID : ‘productId ou categoryId : ‘categoryId dans $BV.ui pour afficher une famille ou catégorie de produits spécifique dans la liste déroulante du Product Picker.