eVar (marchandisage)

Cette page d’aide décrit comment implémenter des eVars de marchandisage. Pour plus d’informations sur le fonctionnement des eVars de marchandisage en tant que dimension, consultez eVar (Dimension de marchandisage) dans le guide d’utilisation Composants.

Les eVars de marchandisage lient une valeur à des produits individuels, de sorte que les événements de succès impliquant chaque produit soient crédités à la valeur liée à ce produit. Vous pouvez définir la valeur de l’une des deux façons suivantes :

Pour connaître le fonctionnement de la liaison, de l’attribution et de l’expiration, consultez eVar (dimension de marchandisage).

Configurer des eVars dans les paramètres de la suite de rapports

Avant d’utiliser des eVars dans votre mise en œuvre, veillez à configurer l’eVar selon la syntaxe souhaitée dans les paramètres de la suite de rapports. Reportez-vous à la section Variables de conversion dans le guide Administrateur.

Choisir une syntaxe

Utilisez ​ Syntaxe du produit ​ lorsque la valeur de marchandisage est disponible au moment où vous définissez la variable de products ou lorsque les produits d’un même accès ont besoin de valeurs différentes. Utilisez ​ Syntaxe de la variable de conversion ​ lorsque la valeur est connue avant le produit, par exemple le terme de recherche ou la campagne interne qui a amené le visiteur au produit. Pour une comparaison complète🔗 consultez la section Fonctionnement de la liaison et de l’affectation .

Mise en œuvre à l’aide de la syntaxe du produit

Lorsque la syntaxe du produit est activée, la valeur de marchandisage est définie directement dans la variable products, de sorte que les événements de liaison ne sont pas utilisés. Les eVars de marchandisage se trouvent dans le dernier segment de chaque produit :

s.products = "[category];[name];[quantity];[revenue];[events];[eVars]";

Délimitez plusieurs eVars de marchandisage sur le même produit avec une barre verticale (|). Les espaces réservés vides pour la quantité, le chiffre d’affaires et les événements sont requis même si vous ne les utilisez pas. Sans eux, la valeur eVar est ignorée.

La valeur est liée au produit sur cet accès. Le remplacement d’une liaison existante par une valeur ultérieure dépend du paramètre Allocation. Voir Fonctionnement de la liaison et de l’affectation.

// The bare minimum to set a merchandising eVar with product syntax
s.products = ";Example product;;;;eVar1=Example merchandising value";

// An example single product with product syntax
s.products = "Example category;Example product;1;5.99;event1=1;eVar1=Turtles";

// Tie a merchandising eVar to different values on two different products
s.products = "Birds;Scarlet Macaw;1;4200;;eVar1=talking bird,Birds;Turtle dove;2;550;;eVar1=love birds";

Syntaxe de produit utilisant le SDK Web

Si vous utilisez l’objet XDM, les variables de marchandisage de syntaxe de produit utilisent les champs XDM suivants :

L’exemple suivant illustre un seul produit utilisant plusieurs eVars et événements de marchandisage :

"productListItems": [
  {
    "name": "Bahama Shirt",
    "priceTotal": "12.99",
    "quantity": 3,
    "_experience": {
      "analytics": {
        "customDimensions" : {
          "eVars" : {
            "eVar10" : "green",
            "eVar33" : "large"
          }
        },
        "event1to100" : {
          "event4" : {
            "value" : 1
          },
          "event10" : {
            "value" : 2,
            "id" : "abcd"
          }
        }
      }
    }
  }
]

L’exemple d’objet ci-dessus serait envoyé à Adobe Analytics en tant que ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large".

Si vous utilisez l’objet de données, les eVars de marchandisage de syntaxe de produit sont définies dans data.__adobe.analytics.products, en utilisant la même syntaxe que la variable de products AppMeasurement. Équivalent de l’objet de données de l’exemple XDM ci-dessus :

"data": {
  "__adobe": {
    "analytics": {
      "products": ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large"
    }
  }
}

Mise en œuvre à l’aide de la syntaxe de variable de conversion

Utilisez ​ Syntaxe de la variable de conversion ​ lorsque la valeur eVar n’est pas disponible pour être définie dans la variable products. Ce scénario signifie généralement que votre page de produit ne comporte aucun contexte du canal de marchandisage ou de la méthode de recherche. Dans ce cas, définissez l’eVar de marchandisage sur ou avant la page sur laquelle l’événement de liaison se produit. La valeur persiste jusqu’à son expiration ou jusqu’à ce qu’elle soit remplacée par une nouvelle valeur.

Lorsqu’un accès contient à la fois la variable products et un événement de liaison de marchandisage sélectionné, la valeur actuelle d’eVar se lie à chaque produit de cet accès. Définir eVar avec un produit sans événement de liaison ne lie pas la valeur. Le remplacement d’une liaison existante par une liaison ultérieure dépend du paramètre Allocation. Voir Fonctionnement de la liaison et de l’affectation.

Pour obtenir un exemple qui définit plusieurs eVars de méthode de recherche de produit à la fois, consultez Bonne pratique : méthodes de recherche de produit.

L’exemple suivant définit une eVar de marchandisage avant l’événement de liaison :

// Place on the same or previous page before the binding event:
s.eVar1 = "Aviary";

// Place on the page where the binding event occurs:
s.events = "prodView";
s.products = ";Canary";

Si Événement d’affichage du produit est un événement de liaison, la valeur "Aviary" pour eVar1 est liée au "Canary" du produit. Les événements de succès suivants impliquant ce produit sont crédités à "Aviary". La valeur "Aviary" se lie également aux produits lors des accès ultérieurs qui contiennent un événement de liaison, jusqu’à ce que l’une des conditions suivantes soit remplie :

Syntaxe des variables de conversion utilisant le SDK Web

Si vous utilisez l’objet XDM, la syntaxe fonctionne de la même manière que l’implémentation d’autres eVars et events. Si vous utilisez l’objet de données, la syntaxe suit AppMeasurement.

La mise en miroir XDM de l’exemple AppMeasurement ci-dessus se présenterait comme suit.

Définissez l’eVar sur le même appel d’événement ou l’appel d’événement précédent :

"_experience": {
  "analytics": {
    "customDimensions": {
      "eVars": {
        "eVar1" : "Aviary"
      }
    }
  }
}

Définissez l’événement de liaison et les valeurs de la chaîne des produits :

"commerce": {
  "productViews" : {
    "value" : 1
  }
},
"productListItems": [
  {
    "name": "Canary"
  }
]

Les objets de données reflétant l’exemple d’AppMeasurement ci-dessus ressembleraient à ce qui suit.

Définissez l’eVar sur le même appel d’événement ou l’appel d’événement précédent :

"data": {
  "__adobe": {
    "analytics": {
      "eVar1": "Aviary"
    }
  }
}

Définissez l’événement de liaison et les valeurs de la chaîne des produits :

"data": {
  "__adobe": {
    "analytics": {
      "events": "prodView",
      "products": ";Canary"
    }
  }
}