Note: You must implement Analytics for API on a whitelisted domain. Bazaarvoice manages the domain allowlist (sometimes called a "whitelist") internally. If you are in the implementation stage of a project, contact your Bazaarvoice implementation team to request changes to the allowlist. If you are in the support stage, contact Bazaarvoice Support to request changes.

Effectuez les actions suivantes pour configurer les modèles et les balises de Signal :

  1. Ajoutez des événements pour déclencher les balises.

    Ces événements ont été testés et approuvés par Bazaarvoice, leur utilisation est donc hautement recommandée. Même si ces événements recommandés ne sont pas indispensables, leur configuration est spécifique. Soyez prudent(e) si vous avez l'intention de les modifier.

    Remarque : si Ratings & Reviews est déployé sur un site HTTPS, vous devez fournir les URL des images dans un emplacement HTTPS de votre catalogue produits. En cas de non-respect de cette précaution, vos clients verront un avertissement les prévenant du mélange des contenus.

    Dans l'interface utilisateur de Signal, les événements sont des évènements conditionnels utilisés dans les règles de déclenchement d'une balise.

    Nom de l'événement

    Définition

    Utilisé par

    bvConversion

    		Déclencheur : cliquer sur Sélecteur: .bvConversionConversion (hors commerce)

    Pour des conversions multiples, il faut un Sélecteur et un Nom d'événement différents pour chaque type de fonctionnalité.
    Par exemple: bvConversionCatalog (Sélecteur .bvConversionCatalog),
    bvConversionLocator (Sélecteur .bvConversionLocator).

    bvFeature

    		Déclencheur : cliquer sur Sélecteur: .bvFeatureFeatureUsed

    Pour des fonctionnalités multiples, il faut un Sélecteur et un Nom d'événement différent pour chaque type de fonctionnalité.

    Par exemple : bvFeatureSort (Sélecteur .bvFeatureSort), bvFeaturePaginate (Sélecteur .bvFeaturePaginate)

    bvViewRawEvent

    		Déclencheur : charger, faire défiler, redimensionner Sélecteur: windowFeatureUsedInView

    bvTransaction

    		Déclencheur : cliquer sur Sélecteur: .bvTransactionConversionTransaction et PIIConversionTransaction

    bvViewedUGC

    		Déclencheur : bvViewedUGC Sélecteur: windowFeatureUsedViewedUGC

    onLoad

    		Déclencheur : charger Sélecteur: windowPageViewProduct et PageViewCategory

    Les éléments de l'interface utilisateur et HTML dans Signal génèrent des événements déclenchés par un clic, ce qui déclenche ensuite la balise associée. Dans certains cas, comme avec ConversionTransaction et PIIConversionTransaction, la balise est déclenchée par le chargement d'une page plutôt que par la sélection d'un bouton.

  2. Effectuez un mapping des données contenant des informations pertinentes et nécessaires pour les balises.

    Les noms de données utilisés dans votre mapping de données peuvent être modifiés selon vos besoins. Le lien avec les données sur vos pages produits est déterminé par l'organisation des données sur chaque page.

    Nom de donnée

    Description des données

    Note moyenne

    Note moyenne de ce produit, exprimée en étoiles.

    Prise en charge des balises :

    • PageViewProduct (facultatif)

    Nom de la marque

    Nom public de la marque à laquelle le produit appartient, si disponible.

    Prise en charge des balises :

    • FeatureUsed (facultatif)
    • FeatureUserdInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewProduct (facultatif)

     

    Catégorie (clé)

    Clé de catégorie des articles dans l'objet JSON, qui doit refléter le nom exact de la clé dans l'objet JSON.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    ID de catégorie

    ID client de la catégorie consultée. Cet ID est unique dans votre catalogue de produits.

    Prise en charge des balises :

    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewCategory (obligatoire)
    • PageViewProduct (facultatif)

    Ville

    La ville à associer à l'événement.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    ID client

    Votre ID client Bazaarvoice. En général, c'est une constante dans le modèle.

    Prise en charge des balises :

    • Conversion (obligatoire)
    • ConversionTransaction (obligatoire)
    • FeatureUsed (obligatoire)
    • FeatureUsedInView (obligatoire)
    • FeatureUsedViewedUGC (obligatoire)
    • PageViewCategory (obligatoire)
    • PageViewProduct (obligatoire)
    • PIIConversionTransaction (obligatoire)

    Type de conversion

    Le type de conversion qui a lieu. Une balise de conversion différente doit être créée pour chaque type de conversion.

    Prise en charge des balises :

    • Conversion (obligatoire)

    Valeur de la conversion

    La valeur numérique à attribuer à la conversion.

    Prise en charge des balises :

    • Conversion (obligatoire)

    Code de devise

    Code alphabétique ISO 4217 de la devise.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    Country

    Le pays associé à l'événement.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    Période de stabilisation

    Le laps de temps en millisecondes imposé entre des événements. Généralement, c'est une valeur constante de 250 ms par défaut.

    Prise en charge des balises :

    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)

    Date de livraison

    Utilisée pour programmer l'envoi de l'e-mail. Bazaarvoice enverra l'e-mail x jours à partir de cette date suivant ce que vous avez spécifié dans emailDelayDays. Si cette dernière n'est pas spécifiée, la date et l'heure actuelles seront utilisées automatiquement.

    Prise en charge des balises :

    • PIIConversionTransaction (facultatif)

    Détail 1

    Détail de premier niveau pour la fonctionnalité. 

    Bazaarvoice recommande que les champs filter, sort et paginate soient balisés et libellés dans ce champ.

    Prise en charge des balises :

    • FeatureUsed (obligatoire)

    Détail 2

    Détail de deuxième niveau pour la fonctionnalité. 

    Prise en charge des balises :

    • FeatureUsed (facultatif)

    Code d'affichage

    Code pour l'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez prendre contact avec le support technique.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewCategory (facultatif)
    • PageViewProduct (facultatif)
    • PIIConversionTransaction (facultatif)

    E-mail

    L'adresse e-mail de l'utilisateur.

    Prise en charge des balises :

    • PIIConversionTransaction (obligatoire)

    Nom de la fonctionnalité

    Nom de la fonctionnalité utilisée, par exemple sort, paginate ou InView. Une balise FeatureUsed distincte doit être créée pour chaque fonctionnalité utilisée.

    Prise en charge des balises :

    • FeatureUsed (obligatoire)

    Nom d'hôte

    Nom d'hôte de la page depuis laquelle l'événement a été envoyé. Si rien n'est spécifié, la valeur par défaut est window.location.host.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewCategory (facultatif)
    • PageViewProduct (facultatif)
    • PIIConversionTransaction (facultatif)

    URL de l'image (clé)

    Clé de l'URL de l'image pour les articles dans l'objet JSON. Ceci devrait correspondre au nom exact de la clé dans l'objet JSON.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    Temps In-View

    Laps de temps en millisecondes durant lequel le conteneur du CGU doit être visible pour être considéré comme « vu ». En général, il s'agit d'une valeur constante de 5 000 ms (5 secondes) par défaut.

    Prise en charge des balises :

    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)

    Objet des articles

    C'est un objet au format JSON ou apparenté JSON, référencé par le dictionnaire de données. Cet objet référencé contient les informations de commande au niveau de l'article.

    Prise en charge des balises :

    • ConversionTransaction (obligatoire)
    • PIIConversionTransaction (obligatoire)

    Libellé

    Un libellé descriptif à appliquer à la conversion.

    Prise en charge des balises :

    • Conversion (facultatif)

    Min. de pixels visibles

    Le nombre minimum de pixels verticaux du conteneur du CGU qui doivent être affichés pour que celui-ci soit considéré comme visible. En général, c'est une valeur constante. Par défaut, elle est de 100 pixels.

    Prise en charge des balises :

    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)

    Nombre de réponses

    Nombre de réponses pour cet article. 

    Prise en charge des balises :

    • PageViewProduct (facultatif)

    Nombre de questions

    Nombre de questions pour ce produit.

    Prise en charge des balises :

    • PageViewProduct (facultatif)

    Nombre d'avis

    Nombre d'avis pour ce produit. 

    Prise en charge des balises :

    • PageViewProduct (facultatif)

    ID de la commande

    L'ID unique de la commande.

    Prise en charge des balises :

    • ConversionTransaction (obligatoire)
    • PIIConversionTransaction (obligatoire)

    Total de la commande

    Le montant total de la commande.

    Prise en charge des balises :

    • ConversionTransaction (obligatoire)
    • PIIConversionTransaction (obligatoire)

    Pourcentage de recommendations

    Pourcentage d’utilisateurs qui recommandent ce produit. Cette valeur est comprise entre 0 et 100.

    Prise en charge des balises :

    • PageViewProduct (facultatif)

    Prix (clé)

    Clé de prix pour les articles dans l'objet JSON. Ceci devrait correspondre au nom exact de la clé dans l'objet JSON.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    ID du produit

    ID de produit public pour les fonctionnalités utilisées dans le contexte d'un produit. Cet ID est unique dans votre catalogue de produits.

    Prise en charge des balises :

    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewProduct (obligatoire)

    Nom du produit (clé)

    Clé du nom de produit pour les articles dans l'objet JSON. Ceci devrait correspondre au nom exact de la clé dans l'objet JSON.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    Quantité (clé)

    Clé de quantité pour les articles dans l'objet JSON. Ceci devrait correspondre au nom exact de la clé dans l'objet JSON.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    URL de référence

    Référence de la page depuis laquelle l'événement a été envoyé, si disponible. La valeur par défaut est document.referrer.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewCategory (facultatif)
    • PageViewProduct (facultatif)
    • PIIConversionTransaction (facultatif)

    ID de la catégorie racine

    ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété categoryId. Cet ID est unique dans votre catalogue de produits.

    Prise en charge des balises :

    • FeatureUsed (facultatif)
    • FeatureUsedInView (facultatif)
    • FeatureUsedViewedUGC (facultatif)
    • PageViewCategory (facultatif)
    • PageViewProduct (facultatif)

    Montant des frais de livraison

    Le coût de livraison de la commande.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    UGS (clé)

    Clé d'ID Produit ou d'Unité de Gestion des Stocks pour les articles dans l'objet JSON. Ceci devrait correspondre au nom exact de la clé dans l'objet JSON.

    Remarque : ce paramètre DOIT correspondre à l'attribut ExternalId du produit envoyé à Bazaarvoice dans votre catalogue produits. Si l'identifiant que vous avez défini pour le paramètre sku (UGS) ne figure pas dans votre catalogue produits, le produit NE sera PAS inclus dans la demande d'avis (anciennement post-interaction email ou EPI).

    Prise en charge des balises :

    • ConversionTransaction (obligatoire)
    • PIIConversionTransaction (obligatoire)

    État

    L'État à associer à l'événement.

    Prise en charge des balises :

    • Conversion (facultatif)
    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    Montant de taxe

    Le montant des taxes appliquées à la commande.

    Prise en charge des balises :

    • ConversionTransaction (facultatif)
    • PIIConversionTransaction (facultatif)

    ID du conteneur du CGU

    L'ID DOM du conteneur qui renferme le CGU de Bazaarvoice. Ceci indique à la balise quel objet DOM surveiller pour la visibilité.

    Prise en charge des balises :

    • FeatureUsedInView (obligatoire)
    • FeatureUsedViewedUGC (obligatoire)

    ID de l'utilisateur

    L'ID unique de l'utilisateur.

    Prise en charge des balises :

    • PIIConversionTransaction (facultatif)

    Pseudo de l'utilisateur

    Le prénom ou le pseudo de l'utilisateur.

    Prise en charge des balises :

    • PIIConversionTransaction (facultatif)

    Code postal

    Le code postal à associer à l'événement.

    Prise en charge des balises :

    • PIIConversionTransaction (facultatif)
  3. Complétez les modèles de balises avec les mappings de données.
  4. Complétez l'événement déclencheur de la balise.
Remarque: Vous pouvez utiliser les balises d'outils d'analyse comme le BV Pixel en recourant aux balises BVConversion et BVTransaction de Signal.

Balise Conversion

La balise Conversion indique une conversion non-commerciale. Les conversions permettent de suivre les activités des utilisateurs qui sont intéressantes même si elles ne génèrent pas de revenu direct, comme lorsqu'un utilisateur recherche un revendeur près de chez lui ou commande un catalogue gratuit.

Remarque: Les balises d'outils d'analyses pour API ConversionTransaction, PIIConversionTransactionet Conversion remplissent ensemble les mêmes fonctions que la balise BV Pixel.  Si vous avez déjà mis en place la balise BV Pixel, il n'est pas nécessaire de changer votre implémentation pour utiliser ces balises.

Reportez-vous à la section Implémenter le BV Pixel avec les balises d'outils d'analyse pour obtenir des exemples d'implémentation intégrale.

Liaison d'événement

Une conversion peut être déclenchée explicitement par le bouton de conversion, comme indiqué dans l'exemple suivant :

<button onclick="_bvapiq.push(['Conversion', ConversionData]);">Test Conversion</button>

Données et mapping

ChampMapping intégréDescription
clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

Typeconversion.type, conversion.category.type

Type de conversion en cours.

Priorité : Obligatoire

valueconversion.value, conversion.attributes.value

Valeur attribuée à la conversion.

Priorité : Obligatoire

cityconversion.city, conversion.profile.address.cityVille associée à la transaction.

Priorité : Recommandé

countryconversion.country, conversion.profile.address.countryPays associé à la transaction.

Priorité : Recommandé

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

Libelléconversion.label, conversion.attributes.label

Libellé descriptif à appliquer à la conversion.

Priorité : Recommandé

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

stateconversion.state, conversion.profile.address.state

État associé à la transaction.

Priorité : Recommandé

host

page.host, page.pageInfo.hostName

Nom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

Balise ConversionTransaction

La balise ConversionTransaction indique une transaction commerciale ou une conversion. Les transactions de conversion permettent de suivre les achats et sont essentielles pour le calcul de l'évolution des conversions.

Remarque: Les balises d'outils d'analyses pour API ConversionTransaction, PIIConversionTransactionet Conversion remplissent ensemble les mêmes fonctions que la balise BV Pixel.  Si vous avez déjà mis en place la balise BV Pixel, il n'est pas nécessaire de changer votre implémentation pour utiliser ces balises.

Reportez-vous à la section Implémenter le BV Pixel avec les balises d'outils d'analyse pour obtenir des exemples d'implémentation intégrale.

Liaison d'événement

Insérez la balise ConversionTransaction au chargement d'une page de confirmation, comme indiqué dans l'exemple suivant :

<script> window._bvapiq = window._bvapiq || []; _bvapiq.push(['ConversionTransaction', TransactionData]); $.getScript('//magpie-static.ugc.bazaarvoice.com/magpie-api/1.4/ bvAnalyticsAPITracker.min.js.gz'); </script>

Données et mapping

ChampMapping intégréDescription
clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

orderIdtransaction.orderId, transaction.transactionID

ID unique de la commande.

Priorité : Obligatoire

sku

items[].sku, items[].productInfo.sku

Il s'agit de l'External ID du produit Bazaarvoice. Il revêt parfois la forme d'un code UGS, mais est le plus souvent constitué d'un autre ID produit. Il est utilisé spécifiquement avec Bazaarvoice pour identifier vos produits de manière unique.

Remarque : ceci DOIT correspondre à l'attribut ExternalId du produit envoyé à Bazaarvoice dans votre catalogue produits. Si l'identifiant que vous avez défini pour le paramètre sku (UGS) ne figure pas dans votre catalogue produits, le produit NE sera PAS inclus dans la demande d'avis.

Priorité : Obligatoire

totaltransaction.total, transaction.total.transactionTotal

Montant total de la commande.

Priorité : Obligatoire

cityconversion.city, conversion.profile.address.city

Ville associée à la transaction.

Priorité : Recommandé

countryconversion.country, conversion.profile.address.country

Pays associé à la transaction.

Priorité : Recommandé

currencytransaction.currency, transaction.total.currency

Code alphabétique ISO 4217 de la devise.

Priorité : Recommandé

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

Libelléconversion.label, conversion.attributes.label

Libellé descriptif à appliquer à la conversion.

Priorité : Recommandé

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

stateconversion.state, conversion.profile.address.state

État associé à la transaction.

Priorité : Recommandé

categoryitems[].category, items[].category.primaryCategory

Catégorie de produit.

Priorité : Facultatif

hostpage.host, page.pageInfo.hostName

Nom d'hôte de la page depuis laquelle l'événement a été envoyé.

Priorité : Facultatif

URL de l'imageitems[].imageUrl, items[].productInfo.productImage

URL de l'image du produit.

Priorité : Facultatif

nameitems[].name, items[].productInfo.productName

Nom du produit.

Priorité : Facultatif

priceitems[].price, items[].price.basePrice

Prix du produit.

Priorité : Facultatif

quantityitems[].quantity

Quantité d'achat.

Priorité : Facultatif

shippingtransaction.shipping, transaction.total.shipping

Coût de livraison de la commande.

Priorité : Facultatif

taxtransaction.tax, transaction.total.taxAmount

Montant des taxes appliquées à la commande.

Priorité : Facultatif

Balise FeatureUsed

FeatureUsed indique une interaction de l'utilisateur avec le conteneur et les commandes du contenu généré par les utilisateurs. Cette balise devrait être utilisée pour les fonctionnalités telles que :

  • Filtres
  • Tri
  • Pagination

Liaison d'événement

Associez la balise FeatureUsed à l'événement de clic sur n'importe quel élément de l'interface utilisateur, comme indiqué dans l'exemple suivant :

    <button onclick="_bvapiq.push(['FeatureUsed', { clientID: 'testClient', bvProduct: 'AskAndAnswer', environment: 'staging', dc: 'custom_DC', name: 'Feature_Button', brand: 'Test Brand', productId: '1234567-bunnyhat', categoryId: 'hats', detail1: 'First feature detail', detail2: 'Second feature detail' }]);">Feature Button</button>

Données et mapping

ChampMapping intégréDescription
brandproduct.brand, product.productInfo.brandID

Nom public de la marque à laquelle le produit appartient, si disponible.

Priorité : Recommandé

bvProductbvProduct

Nom du produit Bazaarvoice au sujet duquel l'événement a été envoyé. Les valeurs possibles incluent RatingsAndReviews et AskAndAnswer.

Priorité : Obligatoire

categoryIdproduct.categoryId, product.category.primaryCategory

ID public de la catégorie consultée.

Unique dans le catalogue produits du client.

Priorité : Recommandé

clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

detail1event.detail1, event[].detail1, event.category.subDetail1, event[].category.subDetail1, (attribute) bvDetail1

Sous-détail de premier niveau pour la fonctionnalité.

Bazaarvoice recommande que les champs filter, sort et paginate soient balisés et libellés dans ce champ.

Les statistiques sur l'utilisation des fonctionnalités sont automatiquement agrégées par nom de fonctionnalité, detail1 et detail2 (dans l'ordre) afin que vous puissiez extraire des statistiques hiérarchisées dotées d'attributs soigneusement élaborés.

Priorité : Obligatoire

detail2event.detail2, event[].detail2, event.category.subDetail2, event[].category.subDetail2, (attribute) bvDetail2

Sous-détail de deuxième niveau pour la fonctionnalité. Voir « detail1 ». Par défaut = _bvGetState("event.detail2").

Priorité : Recommandé

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

host

page.host, page.pageInfo.hostName

Nom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

nameevent.name, event[].name, (attribute) bvName

Nom de la fonctionnalité utilisée, comme par exemple « sort », « paginate », « InView ».

Priorité : Obligatoire

productIdproduct.productId, product.productInfo.productID

ID de produit public pour les fonctionnalités utilisées dans le contexte d'un produit.

Unique dans le catalogue produits du client.

Remarque : ceci DOIT correspondre à l'attribut ExternalId de votre catalogue produits.

Priorité : Obligatoire

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

rootCategoryIdproduct.rootCategoryId, product.category.rootCategory

ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété <categoryId>.

Unique dans le catalogue produits du client.

Priorité : Facultatif

Balise FeatureUsedInView

La balise FeatureUsedInView indique que le CGU est visible sur la page. Étant donné que cette balise est déclenchée dès que du contenu généré par les utilisateurs est rendu visible, les utilisateurs n'ont pas encore eu le temps d'interagir avec le contenu. Cette balise n'est déclenchée qu'une fois par chargement de page.

Liaison d'événement

FeatureUsedInView est associée à FeatureUsedViewedUGG et exécutée au moment du chargement d'une page. Cette balise est liée à l'événement bvViewedUGC comme indiqué dans l'exemple suivant :

    var InViewData = { clientID: 'testClient', bvProduct: 'RatingsAndReviews', environment: 'staging', bvAttributes: { minVisiblePixels: 100, debouncePeriodMs: 250, inviewTime: 5000, containerId: 'bvUGC' }, dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments' }; _bvapiq.push(['FeatureUsedInView', InViewData]); $(window).on('resize, scroll', function(event) {_bvapiq.push(['FeatureUsedInView', InViewData]); }); $(window).on('bvViewedUGC', function(event) {_bvapiq.push(['FeatureUsedViewedUGC', InViewData]); });
Remarque : Cette balise est liée à des événements à fort volume. Le code interne à la balise filtre les événements, afin d'éviter que des tests ne soient exécutés à chaque occurrence d'un événement. Ce filtre limite la fréquence des tests, afin d'éviter une surcharge du processeur.

Données et mapping

ChampMapping intégréDescription
brandproduct.brand, product.productInfo.brandIDNom public de la marque à laquelle le produit appartient, si disponible.

Priorité : Recommandé

bvProductbvProduct

Nom du produit Bazaarvoice au sujet duquel l'événement a été envoyé. Les valeurs possibles incluent RatingsAndReviews et AskAndAnswer.

Priorité : Obligatoire

categoryIdproduct.categoryId, product.category.primaryCategory

ID public de la catégorie consultée.

Unique dans le catalogue produits du client.

Priorité : Recommandé

clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

debouncePeriodMsbvAttributes.dbouncePeriodMs

Le laps de temps en millisecondes imposé entre les événements.

Valeur par défaut : 250

Priorité : Facultatif

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

host

page.host, page.pageInfo.hostName

Nom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

productIdproduct.productId, product.productInfo.productID

ID de produit public pour les fonctionnalités utilisées dans le contexte d'un produit.

Unique dans le catalogue produits du client.

Remarque : ceci DOIT correspondre à l'attribut ExternalId de votre catalogue produits.

Priorité : Obligatoire

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

rootCategoryIdproduct.rootCategoryId, product.category.rootCategory

ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété <categoryId>.

Unique dans le catalogue produits du client.

Priorité : Facultatif

Le tableau suivant vous présente un ensemble de paramètres de commande qui ne sont pas envoyés avec la balise, mais contrôlent son comportement. Les paramètres doivent apparaître dans la couche de données.

bvAttributeDescription
containerId

ID DOM du conteneur qui renferme les éléments du CGU.

Priorité : Obligatoire

debouncePeriodMs

Le laps de temps en millisecondes imposé entre les événements.

Valeur par défaut : 250

Priorité : Facultatif

inviewTime

Durée en millisecondes durant laquelle le conteneur du CGU doit être visible pour être considéré comme « vu ».

Valeur par défaut : 5000

Priorité : Facultatif

minVisiblePixels

Nombre minimum de pixels verticaux du conteneur du CGU qui doivent être affichés pour que celui-ci soit considéré visible.

Valeur par défaut : 100

Priorité : Facultatif

Balise FeatureUsedViewedUGC

Cinq secondes (ou autre délai défini par le client) après le déclenchement de l'événement FeatureUsedViewedUGC, un événement bvViewedUGC se produit. La balise ViewedUGC est déclenchée si le contenu généré par les utilisateurs est toujours visible dans la fenêtre d'affichage lors du traitement de cet événement. ViewedUGC ne se déclenche qu'une fois par chargement de page. Si le contenu généré par les utilisateurs n'est pas visible lors du test effectué par ViewedUGC, la balise réarme l'événement bvViewedUGC et refait une tentative ultérieurement.

Liaison d'événement

La balise FeatureUsedViewedUGG est associée à FeatureUsedInView et exécutée au moment du chargement d'une page. Cette balise est liée à l'événement bvViewedUGC comme indiqué dans l'exemple suivant :

    var InViewData = { clientID: 'testClient', bvProduct: 'Sampling', environment: 'staging', bvAttributes: { minVisiblePixels: 100, debouncePeriodMs: 250, inviewTime: 5000, containerId: 'bvUGC' }, dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments' }; _bvapiq.push(['FeatureUsedInView', InViewData]); $(window).on('resize, scroll', function(event) {_bvapiq.push(['FeatureUsedInView', InViewData]); }); $(window).on('bvViewedUGC', function(event) {_bvapiq.push(['FeatureUsedViewedUGC', InViewData]); });

Données et mapping

Les données et le mapping utilisés par FeatureUsedViewedUGC correspondent aux données et au mapping utilisés par FeaturesUsedInView. Ces deux balises sont pour ainsi dire deux versions d'un même événement.

ChampMapping intégréDescription
brandproduct.brand, product.productInfo.brandIDNom public de la marque à laquelle le produit appartient, si disponible.

Priorité : Recommandé

bvProductbvProduct

Nom du produit Bazaarvoice au sujet duquel l'événement a été envoyé. Les valeurs possibles incluent RatingsAndReviews et AskAndAnswer.

Priorité : Obligatoire

categoryIdproduct.categoryId, product.category.primaryCategory

ID public de la catégorie consultée.

Unique dans le catalogue produits du client.

Priorité : Recommandé

clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

debouncePeriodMsbvAttributes.dbouncePeriodMs

Le laps de temps en millisecondes imposé entre les événements.

Valeur par défaut : 250

Priorité : Facultatif

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

hostpage.host, page.pageInfo.hostNameNom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

productIdproduct.productId, product.productInfo.productID

ID de produit public pour les fonctionnalités utilisées dans le contexte d'un produit.

Unique dans le catalogue produits du client.

Remarque : ceci DOIT correspondre à l'attribut ExternalId de votre catalogue produits.

Priorité : Obligatoire

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

rootCategoryIdproduct.rootCategoryId, product.category.rootCategory

ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété <categoryId>.

Unique dans le catalogue produits du client.

Priorité : Facultatif

Le tableau suivant vous présente un ensemble de paramètres de commande qui ne sont pas envoyés avec la balise, mais contrôlent son comportement. Les paramètres doivent apparaître dans la couche de données.

bvAttributeDescription
containerId

ID DOM du conteneur qui renferme les éléments du CGU.

Priorité : Obligatoire

debouncePeriodMs

Le laps de temps en millisecondes imposé entre les événements.

Valeur par défaut : 250

Priorité : Facultatif

inviewTime

Durée en millisecondes durant laquelle le conteneur du CGU doit être visible pour être considéré comme « vu ».

Valeur par défaut : 5000

Priorité : Facultatif

minVisiblePixels

Nombre minimum de pixels verticaux du conteneur du CGU qui doivent être affichés pour que celui-ci soit considéré visible.

Valeur par défaut : 100

Priorité : Facultatif

Balise PageViewCategory

La balise PageViewCategory indique qu'un utilisateur a chargé une page de catégorie de produit. La balise PageViewCategory devrait être déclenchée sur chaque page de catégorie, à chaque chargement.

Liaison d'événement

PageViewCategory devrait être activée au moment du chargement de l'outil d'analyse Javascript afin que la balise soit déclenchée immédiatement au moment du chargement de la page, comme indiqué dans le code suivant :

window._bvapiq = window._bvapiq || []; _bvapiq.push(['PageViewCategory', CategoryData]); $.getScript('http://magpie-static.ugc.bazaarvoice.com/magpie-api/1.2/bvAnalyticsAPITracker.js')

Données et mapping

ChampMapping intégréDescription
clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

categoryIdproduct.categoryId, product.category.primaryCategory

ID public de la catégorie consultée.

Unique dans le catalogue produits du client.

Priorité : Recommandé

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

rootCategoryIdproduct.rootCategoryId, product.category.rootCategory

ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété <categoryId>.

Unique dans le catalogue produits du client.

Priorité : Recommandé

hostpage.host, page.pageInfo.hostNameNom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

Exemples de données

var ProductData = { clientID: 'example_client_name', environment: 'staging', page: { pageInfo: { region: "custom_dc", hostName: "bazaarvoice.com" } }, product: { category: { categoryID: 'testCategory', rootCategory: 'testing' } } }; var ProductDataFlat = { clientID: 'example_client_name', environment: 'staging', dc: "custom_dc", host: "bazaarvoice.com", categoryId: 'testCategory', rootCategoryId: 'testing' };

Balise PageViewProduct

PageViewProduct indique qu'un utilisateur a chargé une page de produit. La balise PageViewProduct devrait être déclenchée sur chaque page de produit, à chaque chargement. Elle ne doit pas être masquée derrière un onglet ni empêchée de quelque manière que ce soit de se déclencher au moment du chargement de la page. Cette balise fonctionne en combinaison avec la balise ConversionTransaction pour prendre en charge une grande partie des rapports internes de Bazaarvoice.

Liaison d'événement

Comme indiqué dans l'exemple suivant, le chargement du code Javascript des outils d'analyse active PageViewProduct. La balise est alors déclenchée dés le chargement de la page:

    _bvapiq.push(['PageViewProduct', { clientID: 'testClient', bvProduct: 'RatingsAndReviews', environment: 'staging', dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments', numReviews: 1, numQuestions: 0, numAnswers: 0, avgRating: 5.0, percentRecommended: 100 } ]);

Données et mapping

ChampMapping intégréDescription
avgRatingproduct.avgRating, product.attributes.ugc.averageRating

Note moyenne de ce produit, exprimée en étoiles.

Inclure si cette valeur apparaît à l'utilisateur, même si celle-ci est de 0. Dans le cas contraire, ne pas inclure ce champ.

Priorité : Recommandé

brandproduct.brand, product.productInfo.brandIDNom public de la marque à laquelle le produit appartient, si disponible.

Priorité : Recommandé

bvProductbvProduct

Nom du produit Bazaarvoice au sujet duquel l'événement a été envoyé. Les valeurs possibles incluent RatingsAndReviews et AskAndAnswer.

Priorité : Obligatoire

categoryIdproduct.categoryId, product.category.primaryCategory

ID public de la catégorie consultée.

Unique dans le catalogue produits du client.

Priorité : Recommandé

clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

hostpage.host, page.pageInfo.hostNameNom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.language

Priorité : Facultatif

numAnswersproduct.numAnswers, product.attributes.ugc.numAnswers

Nombre de réponses pour ce produit.

Inclure si cette valeur apparaît à l'utilisateur, même si celle-ci est de 0. Dans le cas contraire, ne pas inclure ce champ.

Priorité : Obligatoire si bvProduct:'AskAndAnswer'

numQuestionsproduct.numQuestions, product.attributes.ugc.numQuestions

Nombre de questions pour ce produit.

Inclure si cette valeur apparaît à l'utilisateur, même si celle-ci est de 0. Dans le cas contraire, ne pas inclure ce champ.

Priorité : Obligatoire si bvProduct:'AskAndAnswer'

numReviewsproduct.numReviews, product.attributes.ugc.numReviews

Nombre d'avis pour ce produit.

Inclure si cette valeur apparaît à l'utilisateur, même si celle-ci est de 0. Dans le cas contraire, ne pas inclure ce champ.

Priorité : Obligatoire si bvProduct:'RatingsandReviews'

percentRecommendedproduct.percentRecommended, product.attributes.ugc.percentRecommended

Pourcentage d’utilisateurs qui recommandent ce produit. Cette valeur doit être comprise entre 0 et 1.

Inclure si cette valeur apparaît à l'utilisateur, même si celle-ci est de 0. Dans le cas contraire, ne pas inclure ce champ.

Priorité : Facultatif

productIdproduct.productId, product.productInfo.productID

ID de produit public pour les fonctionnalités utilisées dans le contexte d'un produit.

Unique dans le catalogue produits du client.

Remarque : ceci DOIT correspondre à l'attribut ExternalId de votre catalogue produits.

Priorité : Obligatoire

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

rootCategoryIdproduct.rootCategoryId, product.category.rootCategory

ID client de la catégorie racine relative à la catégorie identifiée par la valeur de propriété <categoryId>.

Unique dans le catalogue produits du client.

Priorité : Recommandé

Balise PIIConversionTransaction

PIIConversionTransaction indique qu'une conversion commerciale s'est produite et qu'elle comporte des informations personnelles (PII), mais qu'elle est un doublon de ConversionTransaction. Cette balise est envoyée via différents canaux vers différentes destinations afin de parer aux problèmes de confidentialité. Les informations PII recueillies sont transmises, stockées et utilisées exclusivement pour les demandes d'avis.

Remarque: Les balises d'outils d'analyses pour API ConversionTransaction, PIIConversionTransactionet Conversion remplissent ensemble les mêmes fonctions que la balise BV Pixel.  Si vous avez déjà mis en place la balise BV Pixel, il n'est pas nécessaire de changer votre implémentation pour utiliser ces balises.

Reportez-vous à la section Implémenter le BV Pixel avec les balises d'outils d'analyse pour obtenir des exemples d'implémentation intégrale.

Liaison d'événement

Insérez la balise PIIConversionTransaction au chargement d'une page de confirmation, comme indiqué dans l'exemple suivant :

<script> window._bvapiq = window._bvapiq || []; _bvapiq.push(['PIIConversionTransaction', TransactionData]); $.getScript('//magpie-static.ugc.bazaarvoice.com/magpie-api/1.4/bvAnalyticsAPITracker.min.js.gz'); </script>

Données et mapping

ChampMapping intégréDescription
clientIDclientID

Nom du client Bazaarvoice au nom duquel l'événement a été envoyé.

La valeur est identique à l'identifiant de connexion Workbench.

Priorité : Obligatoire

emailtransaction.email, transaction.profile.profileInfo.email

Adresse e-mail de l'utilisateur.

Priorité : Obligatoire

orderIdtransaction.orderId, transaction.transactionID

ID unique de la commande.

Priorité : Obligatoire

sku

items[].sku, items[].productInfo.sku

Il s'agit de l'External ID du produit Bazaarvoice. Il revêt parfois la forme d'un code UGS, mais est le plus souvent constitué d'un autre ID produit. Il est utilisé spécifiquement avec Bazaarvoice pour identifier vos produits de manière unique.

Remarque : ceci DOIT correspondre à l'attribut ExternalId du produit envoyé à Bazaarvoice dans votre catalogue produits. Si l'identifiant que vous avez défini pour le paramètre sku (UGS) ne figure pas dans votre catalogue produits, le produit NE sera PAS inclus dans la demande d'avis.

Priorité : Obligatoire

totaltransaction.total, transaction.total.transactionTotal

Montant total de la commande.

Priorité : Obligatoire

userIdaucun, sauf si utilisation de l'authentification sur le site

Le champ userId doit correspondre au userToken (ID utilisateur), qui est transmis à Bazaarvoice au cours du processus de soumission d'avis. Peut être omis si aucun ID n'est créé, comme par exemple avec les acheteurs en mode visiteur.

Remarque : assurez-vous que votre fiche de configuration des e-mails de demande d'avis reflète bien cette situation.

Priorité : Recommandé

cityconversion.city, conversion.profile.address.cityVille associée à la transaction.

Priorité : Recommandé

countryconversion.country, conversion.profile.address.countryPays associé à la transaction.

Priorité : Recommandé

currencytransaction.currency, transaction.total.currency

Code alphabétique ISO 4217 de la devise.

Priorité : Recommandé

dcpage.dc, page.pageInfo.region

Code d'affichage ou autre identifiant de variante d'IU. Si ce code ne vous est pas familier, veuillez contacter le support technique.

Valeur par défaut : window.navigator.language

Priorité : Obligatoire

environmentenvironment

Environnement applicatif depuis lequel l'événement a été envoyé. « prod » est destiné au code de production. « staging » est destiné aux tests et au débogage.

Valeur par défaut : 'prod'

Priorité : Recommandé

nicknametransaction.nickname, transaction.profile.profileInfo.userName

Prénom ou pseudo de l'utilisateur.

Priorité : Recommandé

refpage.ref, page.pageInfo.referringURLRéférence de la page depuis laquelle l'événement a été envoyé, si disponible.

Valeur par défaut : document.referrer

Priorité : Recommandé

stateconversion.state, conversion.profile.address.state

État associé à la transaction.

Priorité : Recommandé

ZIPtransaction.zip, transaction.profile.address.postalCode

Code postal associé à la transaction.

Priorité : Recommandé

categoryitems[].category, items[].category.primaryCategory

Catégorie de produit.

Priorité : Facultatif

shippingDatetransaction.shippingDate, transaction.total.shippingDate

Utilisé pour programmer l'envoi de l'e-mail. Nous enverrons l'e-mail au bout de x jours à compter de cette date, conformément à ce que vous avez spécifié pour la valeur emailDelayDays.

Sauf indication spécifique, la date et l'heure actuelles seront utilisées automatiquement.

Doit respecter le format suivant : AAAA-MM-JJTHH:mm:ss.SSS.

Priorité : Facultatif

hostpage.host, page.pageInfo.hostNameNom d'hôte de la page depuis laquelle l'événement a été envoyé.

Valeur par défaut : window.location.hostname

Priorité : Facultatif

URL de l'imageitems[].imageUrl, items[].productInfo.productImage

URL de l'image du produit.

Priorité : Facultatif

nameitems[].name, items[].productInfo.productName

Nom du produit.

Priorité : Facultatif

priceitems[].price, items[].price.basePrice

Prix du produit.

Priorité : Facultatif

quantityitems[].quantity

Quantité d'achat.

Priorité : Facultatif

shippingtransaction.shipping, transaction.total.shipping

Coût de livraison de la commande.

Priorité : Facultatif

taxtransaction.tax, transaction.total.taxAmount

Montant des taxes appliquées à la commande.

Priorité : Facultatif