Utilisez Query Service pour gérer les données ingérées d’Adobe Analytics dans Adobe Experience Platform sous forme de jeux de données. Les sections suivantes contiennent des exemples de requêtes que vous pouvez utiliser pour accéder aux variables de marchandisage de vos jeux de données Analytics. Pour plus d’informations sur la ingestion et mappage de données Adobe Analytics via la source Analytics
Les variables de marchandisage peuvent se conformer à l’une des deux syntaxes suivantes :
Dans Adobe Analytics, les données personnalisées au niveau du produit peuvent être collectées au moyen de variables configurées spécialement et appelées variables de marchandisage. Ils sont basés sur des événements d’eVar ou personnalisés. La différence entre ces variables et leur utilisation type est qu’elles représentent une valeur distincte pour chaque produit trouvé sur l’accès plutôt qu’une seule valeur pour l’accès.
Ces variables sont appelées variables de marchandisage de syntaxe de produit. Cela permet de collecter des informations, telles qu’un "montant de remise" par produit ou des informations sur l’"emplacement sur la page" du produit dans les résultats de recherche du client.
Pour en savoir plus sur l’utilisation de la syntaxe du produit, consultez la documentation Adobe Analytics sur implémentation d’eVars à l’aide de la syntaxe de produit.
Les sections ci-dessous décrivent les champs XDM nécessaires pour accéder aux variables de marchandisage dans vos Analytics dataset:
productListItems[#]._experience.analytics.customDimensions.evars.evar#
#
: index du tableau auquel vous accédez.evar#
: variable d’eVar spécifique à laquelle vous accédez.productListItems[#]._experience.analytics.event1to100.event#.value
#
: index du tableau auquel vous accédez.event#
: variable d’événement personnalisé spécifique à laquelle vous accédez.Les cas d’utilisation suivants visent à renvoyer un eVar de marchandisage à partir de la variable productListItems
à l’aide de SQL.
La requête ci-dessous renvoie un eVar de marchandisage et un événement pour le premier produit trouvé dans la variable productListItems
tableau.
SELECT
productListItems[0]._experience.analytics.customDimensions.evars.eVar1,
productListItems[0]._experience.analytics.event1to100.event1.value
FROM adobe_analytics_midvalues
WHERE timestamp = to_timestamp('2019-07-23')
AND productListItems[0].SKU IS NOT NULL
AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
LIMIT 10
Cette requête suivante fait exploser le productListItems
et renvoie chaque eVar de marchandisage et chaque événement par produit. Le champ _id
est inclus pour indiquer la relation avec le résultat d’origine. La variable _id
est une clé primaire unique pour le jeu de données.
La fonction explode sépare les éléments d’un tableau en plusieurs lignes. Elle exclut les valeurs "null".
SELECT
_id,
productItem._experience.analytics.customDimensions.evars.eVar1,
productItem._experience.analytics.event1to100.event1.value
FROM (
SELECT
_id,
explode(productListItems) as productItem
FROM adobe_analytics_midvalues
WHERE TIMESTAMP = to_timestamp('2019-07-23')
AND productListItems[0].SKU IS NOT NULL
AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
)
LIMIT 20
Si vous tentez de récupérer un champ qui n’existe pas dans votre jeu de données actuel, l’erreur "Aucun champ struct de ce type" se produit. Évaluez le motif renvoyé dans le message d’erreur pour identifier un champ disponible, puis mettez à jour votre requête et relancez-la.
ERROR: ErrorCode: 08P01 sessionId: XXXX queryId: XXXX Unknown error encountered. Reason: [No such struct field evar1 in eVar10, eVar13, eVar62, eVar88, eVar2;]
La syntaxe des variables de conversion est un autre type de variable de marchandisage qui se trouve dans Adobe Analytics. La syntaxe de la variable de conversion est utilisée lorsque la valeur de l’eVar ne peut pas être définie dans la variable products. Ce scénario signifie généralement que votre page n’est pas en mesure de déterminer le canal de marchandisage ou la méthode de recherche. Dans ce cas, vous devez définir la variable de marchandisage avant que l’utilisateur n’arrive sur la page du produit et la valeur persiste jusqu’à l’événement de liaison.
Par exemple, le scénario de recherche de produit ci-dessous illustre la manière dont les données requises peuvent être présentes sur une page avant la conversion ou l’événement associé au produit.
Product View
pour le « bonnet à pompon » à 12,99 €.Product View
est configuré comme un événement de liaison, le produit "bonnet à pompon" est désormais lié à la valeur eVar6 de "recherche interne : bonnet d’hiver". Chaque fois que le produit "bonnet à pompon" est collecté, il est associé à "recherche interne : bonnet d’hiver". Cela se produit jusqu’à ce que le paramètre d’expiration de l’eVar soit atteint ou qu’une nouvelle valeur d’eVar6 soit définie et que l’événement de liaison se produise à nouveau avec ce produit.Cart Add
.Product View
pour le « T-shirt de sport » à 19,99 €.Product View
est l’événement de liaison, le produit "T-shirt de sport" est désormais lié à la valeur eVar6 de "recherche interne : T-shirt d’été". Le produit précédent "bonnet à pompon" est toujours lié à une valeur eVar6 de "recherche interne : bonnet à pompon".Cart Add
.Dans les rapports, les commandes, les recettes, les consultations de produits et les ajouts au panier sont rapportés à l’eVar 6 et s’alignent sur l’activité du produit lié.
eVar6 (méthode de recherche de produits) | recettes | commandes | consultations de produit | ajouts au panier |
---|---|---|---|---|
recherche interne : T-shirt d’été | 19,99 | 1 | 1 | 1 |
recherche interne : bonnet d’hiver | 12,99 | 1 | 1 | 1 |
Pour en savoir plus sur l’utilisation de la syntaxe de variable de conversion, consultez la documentation d’Adobe Analytics sur implémentation d’eVars à l’aide de la syntaxe de variable de conversion.
Vous trouverez ci-dessous les champs XDM pour produire la syntaxe de variable de conversion dans votre Analytics dataset:
_experience.analytics.customDimensions.evars.evar#
evar#
: variable d’eVar spécifique à laquelle vous accédez.productListItems[#].sku
#
: index du tableau auquel vous accédez.Les cas d’utilisation ci-dessous reflètent des scénarios qui nécessitent une syntaxe de variable de conversion.
La requête ci-dessous associe la valeur à la paire produit-événement spécifique. Dans cet exemple, la valeur est liée à l’événement de consultation de produit.
SELECT
endUserIds._experience.aaid.id AS AAID,
timestamp,
CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
OVER(PARTITION BY endUserIds._experience.aaid.id
ORDER BY timestamp
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
END AS eVar1Bind,
EXPLODE(productListItems) AS Product_List,
commerce.productViews.value AS prodView,
commerce.purchases.value AS purchase
FROM adobe_analytics_midvalues
WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
LIMIT 100
L’exemple de requête ci-dessous conserve la valeur liée aux occurrences suivantes du produit correspondant. La sous-requête la plus basse établit la relation entre la valeur et le produit sur l’événement de liaison déclaré. La sous-requête suivante effectue l’attribution de cette valeur liée lors des prochaines interactions avec le produit concerné. Le niveau supérieur SELECT regroupe les résultats pour produire le rapport.
SELECT
Product_List.SKU,
eVar1101ConversionSyntax,
SUM(prodView) AS Product_Views,
SUM(purchase) AS Purchases
FROM
(
SELECT
Product_List,
ATTRIBUTION_LAST_TOUCH(timestamp, 'ConversionSyntax_eVar1', eVar1Bind)
OVER(PARTITION BY AAID, Product_List.SKU
ORDER BY timestamp
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
AS eVar1ConversionSyntax,
prodView,
purchase
FROM
(
SELECT
endUserIds._experience.aaid.id AS AAID,
timestamp,
CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
OVER(PARTITION BY endUserIds._experience.aaid.id
ORDER BY timestamp
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
END AS eVar1Bind,
EXPLODE(productListItems) AS Product_List,
commerce.productViews.value AS prodView,
commerce.purchases.value AS purchase
FROM adobe_analytics_midvalues
WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
)
)
WHERE eVar1ConversionSyntax IS NOT NULL
GROUP BY 1, 2
ORDER BY 3 DESC
LIMIT 100
En lisant ce document, vous devriez mieux comprendre comment renvoyer un eVar de marchandisage à l’aide de la syntaxe du produit et lier une valeur à un produit spécifique avec la syntaxe de la variable de conversion.
Si vous ne l’avez pas déjà fait, vous devez lire le Documentation sur les analyses pour les interactions web et mobiles suivant. Il fournit des cas d’utilisation courants et montre comment utiliser Query Service pour créer des informations exploitables à partir de données Adobe Analytics web et mobiles.