Le flux d’activité quotidien vous permet d’exporter les données brutes de Dynamic Yield et de les intégrer dans votre propre plateforme d’analyse. Cela vous permet de relier les données de Dynamic Yield à d’autres sources de données dans votre base de données et de créer des rapports personnalisés adaptés aux besoins uniques de votre entreprise.
L’exportation se compose de deux ensembles de données :
- Données brutes : comprend les interactions brutes avec les variations de Dynamic Yield, les événements et les pages vues.
- Données d’attribution : comprend la relation entre les événements et les variations auxquelles ils ont été attribués en fonction de vos paramètres d’expérience.
Les données sont exportées quotidiennement dans un bac Amazon S3 sécurisé, où elles sont stockées pendant 30 jours.
Les données sont exportées sous forme de fichiers Apache Parquet, un format optimisé pour les grands ensembles de données. 
Ensemble de données
Données brutes
Cet ensemble de données contient toutes les interactions des types suivants :
- Variation de l’engagement : clics et impressions de la variation.
- Événements : tels que l’achat ou l’abonnement.
- Pages consultées
Par exemple, si un utilisateur consulte 3 pages, déclenche 2 événements et a 1 impression d’une variation, l’exportation contient 6 lignes.
Chaque interaction, désignée dans l’ensemble de données par le terme eventType, comporte des propriétés spécifiques. En voici un exemple :
eventType | Description | Attributs supplémentaires (exemples) |
---|---|---|
UIA | Pageview | URL, contexte de la page |
DPX | Résultat de l’événement | Propriétés de l’événement, valeur de l’événement |
VARIATION_ENGAGEMENT | Impression ou clic de la variation | Nom de la campagne, nom de la variation |
Les tableaux suivants présentent la liste complète des attributs disponibles pour chaque type d’événement.
Représente une page consultée par l’utilisateur.
Attribut | Description | Exemple |
---|---|---|
eventType Chaîne de caractères |
Le type d’activité. Pour pageview, la valeur est UIA (par opposition à VARIATION_ENGAGEMENT ou DPX). | "UIA" |
interactionId |
L’ID de l’interaction (pour un événement spécifique, par exemple un achat spécifique). Il peut être utilisé pour relier cet ensemble de données à l’ensemble de données d’attribution. |
1234567890 |
contextType Chaîne de caractères |
Le type de page, en fonction du contexte de la page. | "HOMEPAGE" |
contextData Tableau de chaînes de caractères |
Données relatives au type de page.
|
["Women","Shoes"] |
dyId Long |
L’ID interne que Dynamic Yield attribue à chaque visiteur du site ou de l’application, unique par appareil. | 123456789012345678 |
timestamp Long |
L’heure à laquelle l’activité s’est produite, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
sessionId Entier |
L’ID interne que Dynamic Yield attribue à la session d’un visiteur. | 1234567890 |
url Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché. | "https://www.example.com/?url_params=123" |
urlClean Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché, après suppression des paramètres de l’URL. | "https://www.example.com/" |
audiences Tableau d’entiers |
La liste des identifiants des audiences dont l’utilisateur est membre au moment du déclenchement de l’événement. | [1234567, 9876543] |
browser Chaîne de caractères |
Le type de navigateur à partir duquel l’événement a été déclenché. | "Safari" |
device Chaîne de caractères |
Le type d’appareil à partir duquel l’événement a été déclenché. | "Tablet" |
operatingSystem Chaîne de caractères |
Le système d’exploitation de l’appareil à partir duquel l’événement a été déclenché. | "Mac OS X" |
screenResolution Chaîne de caractères |
La résolution d’écran de l’appareil à partir duquel l’événement a été déclenché. | "Low (1024px and below)" |
reqTimestamp Long |
Timestamp de la demande interne au pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
procTimestamp Long |
Timestamp du traitement interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
resTimestamp Long |
Timestamp de résolution interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
Représente un événement Dynamic Yield déclenché par l’utilisateur.
Attribut | Description | Exemple |
---|---|---|
eventType Chaîne de caractères |
Le type d’activité. Pour le déclenchement d'un événement, la valeur est DPX (par opposition à VARIATION_ENGAGEMENT ou UIA). | "DPX" |
interactionId |
L’ID de l’interaction (pour un événement spécifique, par exemple un achat spécifique). Il peut être utilisé pour relier cet ensemble de données à l’ensemble de données d’attribution. |
1234567890 |
eventId Entier |
Un identifiant unique pour chaque événement déclenché explicitement à partir du site. | 12345 |
eventName Chaîne de caractères |
Le nom de l’événement tel qu’il est écrit dans l’API de l’événement. | "Purchase" |
eventProperties Chaîne de caractères (JSON) |
Les propriétés de l’événement telles qu’elles sont décrites dans l’API de l’événement. Celles-ci diffèrent en fonction de la valeur d'eventType. | { "transaction_id": "ABC123456", "value": 100.0, "currency": "USD", "dyType": "purchase-v1", "Brands": "Nike", "Categories": "Sneakers", "Number_of_items": 1.0, "cart": [{ "productId": "AIR-123", "quantity": 1.0, "itemPrice": 100.0 }] } |
eventValue Long |
La valeur totale de tous les articles du panier, telle qu’elle apparaît dans l’attribut eventProperties. La valeur est exprimée en cents. |
10000 |
uniqueTransactionId Chaîne de caractères |
L’ID de la transaction, tel qu’il apparaît dans l’attribut eventProperties pour un événement d’achat. |
ABC123456 |
productIds |
La liste des identifiants des produits sur lesquels une action a été effectuée. |
[“12345”] |
dyId Long |
L’ID interne que Dynamic Yield attribue à chaque visiteur du site ou de l’application, unique par appareil. | 123456789012345678 |
timestamp Long |
L’heure à laquelle l’activité s’est produite, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
sessionId Entier |
L’ID interne que Dynamic Yield attribue à la session d’un visiteur. | 1234567890 |
url Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché. | "https://www.example.com/?url_params=123" |
urlClean Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché, après suppression des paramètres de l’URL. | "https://www.example.com/" |
audiences Tableau d’entiers |
La liste des identifiants des audiences dont l’utilisateur est membre au moment du déclenchement de l’événement. | [1234567, 9876543] |
browser Chaîne de caractères |
Le type de navigateur à partir duquel l’événement a été déclenché. | "Safari" |
device Chaîne de caractères |
Le type d’appareil à partir duquel l’événement a été déclenché. | "Tablet" |
operatingSystem Chaîne de caractères |
Le système d’exploitation de l’appareil à partir duquel l’événement a été déclenché. | "Mac OS X" |
screenResolution Chaîne de caractères |
La résolution d’écran de l’appareil à partir duquel l’événement a été déclenché. | "Low (1024px and below)" |
reqTimestamp Long |
Timestamp de la requête interne au pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
procTimestamp Long |
Timestamp du traitement interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
resTimestamp Long |
Timestamp de la résolution interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
Représente une impression d’une variation ou un clic sur une variation.
Attribut | Description | Exemple |
---|---|---|
eventType Chaîne de caractères |
Le type d’activité. Pour un clic ou une impression sur une variation, la valeur est VARIATION_ENGAGEMENT (par opposition à UIA ou DPX). | "VARIATION_ENGAGEMENT" |
interactionId |
L’ID de l’interaction (pour un événement spécifique, par exemple un achat spécifique). Il peut être utilisé pour relier cet ensemble de données à l’ensemble de données d’attribution. |
1234567890 |
engagementType Chaîne de caractères |
Le type d’engagement avec la variation. Valeurs possibles :
|
"IMPRESSION" |
campaignId Entier |
L’ID de la campagne dont cette variation fait partie. Pour l’engagement avec des blocs Experience Email, ceci représente l’ID du bloc, tandis que parentCampaignId contient l’ID de la campagne Experience Email. | 123456 |
campaignName Chaîne de caractères |
Le nom de la campagne dont cette variation fait partie. Pour l’engagement avec des blocs Experience Email, ceci représente le nom du bloc, tandis que parentCampaignName contient le nom de la campagne Experience Email. | "Homepage Banner" |
experienceId Entier |
L’ID de l’expérience dont cette variation fait partie. | 123456 |
experienceName Chaîne de caractères |
Le nom de l’expérience dont cette variation fait partie. | "Summer Promo" |
experimentId Entier |
L’ID unique du test. | 123456 |
versionId Entier |
L’ID unique de la version du test. Un test A/B peut avoir plusieurs versions. | 245467 |
variationIds Tableau d’entiers |
L’ID de la variation servie à l’utilisateur (si le type est IMPRESSION) ou sur laquelle il a cliqué (si le type est CLICK). En général, la liste contient un seul ID, mais si le type de campagne est « Dynamic Content Item List » (liste d’éléments de contenu dynamique), elle contient une liste de variations, séparées par des virgules. |
[1234567, 9876543] |
attributionVariationIds Tableau d’entiers |
L’ID de la variation dans l’ensemble de données d’attribution. Cet identifiant doit être utilisé pour joindre l’ensemble de données d’attribution à l’ensemble de données brutes, où raw.attributionVariationIds = attribution.variations. En général, la liste contient un seul identifiant, mais si le type de campagne est « Dynamic Content Item List » (liste d’éléments de contenu dynamique), elle contient une liste de variations, séparées par des virgules. |
[1234567, 9876543] |
variationNames Tableau de chaînes de caractères |
Le nom de la variation servie à l’utilisateur (si le type est IMPRESSION) ou sur laquelle il a cliqué (si le type est CLICK). En général, la liste contient un seul ID, mais si le type de campagne est « Dynamic Content Item List » (liste d’éléments de contenu dynamique), elle contient une liste de variations, séparées par des virgules. |
["Blue Button", "Red Button"] |
sku Tableau de chaînes de caractères |
Si l’événement est une vue ou un clic sur un widget de recommandation (c’est-à-dire si le type d’engagement est « CLICK » ou « STRATEGY_IMPRESSION »), il s’agit de la liste des UGS recommandées ou de l’UGS sur laquelle on a cliqué. |
["1234", "9876"] |
strategyId Tableau d’entiers |
Si l’événement est une vue ou un clic sur un widget de recommandation, il s’agit de l’ID de la stratégie qui a été servie. Une seule variation peut inclure plusieurs widgets avec plusieurs stratégies. |
[126651,426356] |
strategyName |
Si l’événement est une vue ou un clic sur un widget de recommandation, il s’agit du nom de la stratégie qui a été servie. Une seule variation peut inclure plusieurs widgets avec plusieurs stratégies. |
["Most Popular","Affinity"] |
touchpointId Entier |
Dans les points de contact uniquement : l’ID du point de contact. | 245467 |
touchpointName |
Dans les points de contact uniquement : le nom du point de contact. | ["Hero Banner"] |
parentVariationId Entier |
Dans les points de contact uniquement : l’ID de la variation qui sert ce point de contact dans la campagne multi-touch. | [9876543] |
parentVariationName |
Dans les points de contact uniquement : le nom de la variation qui sert ce point de contact dans la campagne multi-touch. | "Blue Design" |
parentCampaignId |
Si l’engagement concerne un bloc Experience Email, ce champ contient L’ID de la campagne Experience Email. | 123456 |
parentCampaignName |
Si l’engagement concerne un bloc Experience Email, ce champ contient le nom de la campagne Experience Email. | "Experience Email Campaign 1" |
dyId Long |
L’ID interne que Dynamic Yield attribue à chaque visiteur du site ou de l’application, unique par appareil. | 123456789012345678 |
timestamp Long |
L’heure à laquelle l’activité s’est produite, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
sessionId Entier |
L’ID interne que Dynamic Yield attribue à la session d’un visiteur. | 1234567890 |
url Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché. | "https://www.example.com/?url_params=123" |
urlClean Chaîne de caractères |
L’URL à partir de laquelle l’événement a été déclenché, après suppression des paramètres de l’URL. | "https://www.example.com/" |
audiences Tableau d’entiers |
La liste des identifiants des audiences dont l’utilisateur est membre au moment du déclenchement de l’événement. | [1234567, 9876543] |
reqTimestamp Long |
Timestamp de la requête interne au pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
procTimestamp Long |
Timestamp du traitement interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
resTimestamp Long |
Timestamp de la résolution interne du pipeline d’analyse, en millisecondes, à partir de l’époque UNIX. | 1621798861400 |
Données d’attribution
Cet ensemble de données contient la relation entre une variation et les événements qui lui sont attribués en fonction des paramètres d’expérience.
Chaque enregistrement de l’ensemble de données représente une combinaison événement-variation distincte.
Il convient de noter qu’il existe généralement une relation de type « un pour plusieurs » entre les événements et les variations. Par exemple, si 1 achat a été attribué à 2 variations (contrôle du test A, variation du test B), l’ensemble de données contient 2 lignes.
Champ | Description |
---|---|
interactionId (int) |
Identifiant de l’interaction (pour un événement spécifique, par exemple un achat spécifique). Il peut être utilisé pour relier cet ensemble de données à l’ensemble de données d’attribution. |
eventType (varchar) |
Le type d’événement attribué à une variation. Actuellement, seuls les événements DPX sont exportés. |
dyid (int) |
L’ID de l’utilisateur qui a déclenché l’événement attribué. |
experimentId (int) |
L’ID de l’expérience à laquelle l’événement a été attribué. |
versionId (int) |
L’ID de la version de l’expérience à laquelle l’événement a été attribué. |
variations (array) |
Tableau des identifiants de variation auxquels l’événement a été attribué. Ce tableau contient généralement une seule valeur, mais peut en contenir plusieurs si l’expérience est une liste d’éléments. Cet identifiant correspond aux attributionVariationId de l’ensemble de données brutes. |
eventId (int) |
L’ID de l’événement DPX attribué à la variation. Par exemple, pour un achat, il s’agirait de l’ID de l’événement Achat. |
eventValue (int) |
La valeur de l’événement DPX attribué à la variation. Par exemple, pour un achat, il s’agit du revenu lié à l’événement Achat.
La valeur est exprimée en cents. |
Activation du flux d’activités quotidiennes
Pour activer le flux d’activités quotidiennes :
- Rendez-vous dans Settings › General Settings › Daily Activity Stream.
- Cliquez sur « Turn on daily export » (activer l’exportation quotidienne).
- Copiez le chemin d’accès et les informations d’identification du bac S3 dans un endroit sûr. Notez qu’ils ne s’affichent qu’une seule fois.
Vous avez perdu vos identifiants ?
Cliquez sur l’icône des options supplémentairespuis sur Generate New Credentials (générer de nouveaux identifiants). Gardez à l’esprit que vous ne pouvez générer de nouveaux identifiants qu’une seule fois. - C’est fini ! Le premier ensemble de données sera exporté après minuit, puis de nouvelles données seront ajoutées quotidiennement.
Remarque : si une section n’a pas de trafic un jour donné, il n’y aura pas d’exportation de données ou de dossier pour ce jour dans le bac AWS S3.
Après avoir activé le commutateur Daily Activity Stream (flux d’activité quotidien), la page affiche également l’état de l’exportation.
Vous pouvez toujours désactiver l’exportation dans le menu Options. Si vous désactivez l’exportation et que vous l’activez à nouveau, votre bac S3 reste le même, mais vous recevrez de nouveaux identifiants.
Accéder à votre bac S3
Après avoir activé le commutateur Daily Activity Stream (flux d’activité quotidien), vous aurez accès à un bac S3 avec le chemin d’accès suivant :
- s3://dy-raw-data-export/sectionId=1234567, pour le centre de données des États-Unis
- s3://dy-raw-data-export-eu/sectionId=1234567, pour le centre de données de l’Union européenne
Sous ce chemin, vous trouverez des sous-dossiers pour chaque date, où les fichiers Parquet sont stockés.
Par exemple, ce chemin contient toutes les données collectées le 2022-01-01, selon le fuseau horaire configuré dans vos paramètres généraux :
s3://dy-raw-data-export-eu/sectionId=1234567/date=2022-01-01
Sous ce chemin, vous trouverez des sous-dossiers pour chaque type de rapport
-
Ce chemin contient les données brutes actuellement exportées :
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=raw
-
Ce chemin comprend les nouvelles données d’attribution :
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=attribution
Téléchargez les fichiers localement grâce au Terminal
- Créez un dossier sur votre ordinateur qui contiendra les fichiers téléchargés.
- Ouvrez le Terminal et naviguez jusqu’au dossier que vous avez créé.
- Entrez la commande « aws configure ».
- Lorsque vous y êtes invité, saisissez votre clé d’accès et votre clé secrète, telles qu’elles ont été générées lors de la synchronisation des flux.
- Lorsque vous y êtes invité, indiquez la région de votre centre de données : eu-central-1 ou us-east-1, selon le cas.
- À l’invite suivante (sortie par défaut), appuyez simplement sur Entrée.
- Lorsque vous y êtes invité, saisissez « aws s3 sync » et le chemin d’accès S3 approprié (voir Accéder à votre bac S3). Par exemple :
aws s3 sync s3://dy-raw-data-export-eu/sectionId=SECTIONID/date=2023-05-05/reportType=raw/ - Les fichiers sont téléchargés. Vous pouvez les voir sur le Terminal et, une fois le téléchargement terminé, vous les verrez dans le dossier que vous avez créé à l’étape 1.
Importer les données sur votre plateforme d’analyse
Pour intégrer automatiquement les données du flux d’activité quotidien (Daily Activity Stream) sur votre système, vous pouvez créer une tâche pour extraire les fichiers Parquet de S3 et les charger dans la base de données de votre choix. Voici quelques liens vers des articles pertinents concernant des solutions populaires :