Création et configuration des flux de données
Ce document décrit les étapes de configuration d’un flux de données dans l’interface utilisateur.
Accéder à l’espace de travail Flux de données
Vous pouvez créer et gérer des flux de données dans l’interface utilisateur de collecte de données ou d’Experience Platform en sélectionnant Flux de données dans le volet de navigation de gauche.
L’onglet Flux de données affiche une liste des flux de données existants, y compris leur nom convivial, leur identifiant et leur date de dernière modification. À afficher ses détails et configurer des services ;, sélectionnez le nom d’un flux de données.
Pour afficher d’autres options pour un flux de données spécifique, cliquez sur l’icône "plus" (…). Pour mettre à jour la variable configuration de base pour le flux de données, sélectionnez Modifier. Pour supprimer le flux de données, sélectionnez Supprimer.
Création dʼun flux de données create
Pour créer un flux de données, commencez par sélectionner Nouveau flux de données.
Le processus de création du flux de données s’affiche, en commençant à l’étape de configuration. Ensuite, vous devez fournir un nom et une description facultative pour le flux de données.
Si vous configurez un flux de données à utiliser dans Experience Platform et que vous utilisez également le SDK Web, vous devez également sélectionner une schéma XDM (Experience Data Model) basé sur un événement pour représenter les données que vous prévoyez d’ingérer.
Configuration de la géolocalisation et de la recherche réseau geolocation-network-lookup
La géolocalisation et les paramètres de recherche réseau vous aident à définir le niveau de granularité des données géographiques et réseau que vous souhaitez collecter.
Développez l’objet Géolocalisation et recherche de réseau pour configurer les paramètres décrits ci-dessous.
Active les recherches de géolocalisation pour les options sélectionnées en fonction de l’adresse IP du visiteur. Les options disponibles sont les suivantes :
- Pays: renseigne
xdm.placeContext.geo.countryCode
- Code postal: renseigne
xdm.placeContext.geo.postalCode
- Etat/Province: renseigne
xdm.placeContext.geo.stateProvince
- DMA: renseigne
xdm.placeContext.geo.dmaID
- Ville: renseigne
xdm.placeContext.geo.city
- Latitude: renseigne
xdm.placeContext.geo._schema.latitude
- Longitude: renseigne
xdm.placeContext.geo._schema.longitude
Les options Ville, Latitude ou Longitude fournissent des coordonnées jusqu’à deux décimales, indépendamment des autres options sélectionnées. Il s’agit d’une granularité au niveau de la ville.
Si vous ne sélectionnez aucune option, les recherches de géolocalisation sont désactivées. La géolocalisation a lieu avant Obscurcissement d’IP, ce qui signifie qu’il n’est pas affecté par la variable Obscurcissement d’IP .
Active les recherches réseau pour les options sélectionnées en fonction de l’adresse IP du visiteur. Les options disponibles sont les suivantes :
- Opérateur: renseigne
xdm.environment.carrier
- Domaine: renseigne
xdm.environment.domain
- FAI: renseigne
xdm.environment.ISP
Si vous activez l’un des champs ci-dessus pour la collecte de données, veillez à définir correctement la variable context
Propriété de tableau lors de la configuration du SDK Web.
Les champs de recherche de géolocalisation utilisent la variable context
chaîne de tableau "placeContext"
, tandis que les champs de recherche réseau utilisent la variable context
chaîne de tableau "environment"
.
Vérifiez également que chaque champ XDM souhaité existe dans votre schéma. Dans le cas contraire, vous pouvez ajouter l’Adobe fourni Environment Details
groupe de champs à votre schéma.
Configuration de la recherche de périphérique geolocation-device-lookup
La variable Recherche de périphérique vous permettent de sélectionner des informations spécifiques à l’appareil que vous souhaitez collecter.
Développez l’objet Recherche de périphérique pour configurer les paramètres décrits ci-dessous.
xdm.environment.browserDetails.userAgent
Sélectionnez cette option si vous souhaitez collecter une ou plusieurs des informations suivantes spécifiques à l’appareil :
-
Appareil information :
- Fabricant de l’appareil: renseigne
xdm.device.manufacturer
- Modèle de périphérique: renseigne
xdm.device.modelNumber
- Nom marketing: renseigne
xdm.device.model
- Fabricant de l’appareil: renseigne
-
Matériel information :
- Type de matériel: renseigne
xdm.device.type
- Hauteur d’affichage: renseigne
xdm.device.screenHeight
- Largeur d’affichage: renseigne
xdm.device.screenWidth
- Profondeur de couleur d’affichage: renseigne
xdm.device.colorDepth
- Type de matériel: renseigne
-
Navigateur information :
- Fournisseur du navigateur: renseigne
xdm.environment.browserDetails.vendor
- Nom du navigateur: renseigne
xdm.environment.browserDetails.name
- Version du navigateur: renseigne
xdm.environment.browserDetails.version
- Fournisseur du navigateur: renseigne
-
Système d’exploitation information :
- Fournisseur du système d’exploitation: renseigne
xdm.environment.operatingSystemVendor
- Nom du système d’exploitation: renseigne
xdm.environment.operatingSystem
- Version du système d'exploitation: renseigne
xdm.environment.operatingSystemVersion
- Fournisseur du système d’exploitation: renseigne
Les informations de recherche de périphérique ne peuvent pas être collectées avec l’agent utilisateur et les conseils client. Si vous choisissez de collecter des informations sur l’appareil, la collecte des indices de l’agent utilisateur et du client est désactivée, et vice versa.
Si vous activez l’un des champs ci-dessus pour la collecte de données, veillez à définir correctement la variable context
Propriété de tableau lors de la configuration du SDK Web.
Les informations sur le périphérique et le matériel utilisent la variable context
chaîne de tableau "device"
, tandis que les informations du navigateur et du système d’exploitation utilisent la variable context
chaîne de tableau "environment"
.
Vérifiez également que chaque champ XDM souhaité existe dans votre schéma. Dans le cas contraire, vous pouvez ajouter l’Adobe fourni Environment Details
groupe de champs à votre schéma.
Configuration des options avancées @advanced-options
Pour afficher les options de configuration avancées, sélectionnez Options avancées. Ici, vous pouvez configurer des paramètres de flux de données supplémentaires, tels que l’obscurcissement des adresses IP, les cookies d’ID propriétaires, etc.
Indique le type d’obscurcissement d’adresses IP à appliquer au train de données. Tout traitement basé sur l’adresse IP du client est affecté par le paramètre d’obscurcissement de l’adresse IP. Cela inclut tous les services Experience Cloud qui reçoivent des données de votre train de données.
Options disponibles :
-
Aucun : désactive l’obscurcissement des adresses IP. L’adresse IP complète de l’utilisateur est envoyée via la banque de données.
-
Partiel : obscurcit le dernier octet de l’adresse IP pour les adresses IPv4. Pour les adresses IPv6, l’obscurcissement masque les 80 derniers bits de l’adresse IP.
Exemples :
- IPv4 :
1.2.3.4
->1.2.3.0
- IPv6 :
2001:0db8:1345:fd27:0000:ff00:0042:8329
->2001:0db8:1345:0000:0000:0000:0000:0000
- IPv4 :
-
Complet : obscurcit l’intégralité de l’adresse IP.
Exemples :
- IPv4 :
1.2.3.4
->0.0.0.0
- IPv6 :
2001:0db8:1345:fd27:0000:ff00:0042:8329
->0:0:0:0:0:0:0:0
- IPv4 :
Impact de l’obscurcissement des adresses IP sur d’autres produits Adobe :
- Adobe Target: niveau du flux de données Obscurcissement d’IP est appliqué avant la variable Obscurcissement d’IP effectuée dans Adobe Target, sur toutes les adresses IP présentes dans la requête. Par exemple, si le niveau du flux de données Obscurcissement d’IP est définie sur Complet et l’option d’obscurcissement d’IP d’Adobe Target est définie sur Obscurcissement du dernier octet, Adobe Target reçoit une adresse IP entièrement obscurcie. Si le niveau du flux de données Obscurcissement d’IP est définie sur Partiel et l’option d’obscurcissement d’IP d’Adobe Target est définie sur Complet, Adobe Target reçoit une adresse IP partiellement obscurcie, puis lui applique l’obscurcissement complet. L’obscurcissement des adresses IP d’Adobe Target est géré indépendamment de celui du flux de données. Pour plus d’informations, consultez la documentation d’Adobe Target sur l’Obscurcissement d’adresses IP et sur la géolocalisation.
- Audience Manager: niveau du flux de données Obscurcissement d’IP est appliquée avant l’événement Obscurcissement d’IP effectuée en Audience Manager, sur toutes les adresses IP présentes dans la requête. Les recherches de géolocalisation effectuées dans Audience Manager sont affectées par l’option Obscurcissement d’adresses IP définie au niveau du train de données. Une recherche de géolocalisation dans l’Audience Manager, basée sur une adresse IP complètement obscurcie, génère une région inconnue et aucun segment basé sur les données de géolocalisation résultantes n’est réalisé. Pour plus d’informations, consultez la documentation d’Audience Manager sur l’Obscurcissement d’adresses IP.
- Adobe Analytics: si le paramètre d’obscurcissement de l’adresse IP au niveau du flux de données est défini sur Complet, Adobe Analytics traite l’adresse IP comme vide. Cela affecte tout traitement Analytics qui dépend de l’adresse IP, comme les recherches de géolocalisation et le filtrage IP. Pour qu’Analytics reçoive les adresses IP non obscurcies ou partiellement obscurcies, définissez le paramètre d’obscurcissement d’IP sur Partiel ou Aucun. Dans Analytics, il est possible d’obscurcir davantage les adresses IP partiellement obscurcies et non obscurcies. Voir Adobe Analytics documentation pour plus d’informations sur l’activation de l’obscurcissement des adresses IP dans Analytics. Si l’adresse IP est complètement obscurcie et que l’accès à la page ne comporte pas de ECID nor a VisitorID, puis Analytics abandonne l’accès plutôt que de générer une Identifiant de secours, qui est partiellement basé sur l’adresse IP.
Lors de l’activation de ce paramètre, vous devez indiquer le nom du cookie qui doit stocker l’ID.
Définit le type d’authentification qu’Edge Network accepte pour le train de données.
- Authentification mixte : lorsque cette option est activée, Edge Network accepte les demandes authentifiées et non authentifiées. Sélectionnez cette option lorsque vous prévoyez d’utiliser le SDK web ou le SDK mobile, ainsi que l’API Server.
- Authentifié uniquement : lorsque cette option est activée, Edge Network accepte uniquement les demandes authentifiées. électionnez cette option lorsque vous prévoyez d’utiliser uniquement l’API Server et que vous souhaitez empêcher le traitement des demandes non authentifiées par Edge Network.
Ensuite, si vous configurez le flux de données d’Experience Platform, suivez le tutoriel sur la Préparation des données pour la collecte de données afin de mapper les données à un schéma d’événement de Platform avant de revenir à ce guide. Sinon, sélectionnez Enregistrer et passez à la section suivante.
Afficher les détails d’un flux de données view-details
Après avoir configuré un nouveau flux de données ou sélectionné un flux de données existant à afficher, sa page de détails s’affiche. Vous y trouverez des informations supplémentaires sur le flux de données, y compris son identifiant.
À partir de l’écran de détails du flux de données, vous pouvez ajouter des services pour activer les fonctionnalités des produits Adobe Experience Cloud auxquels vous avez accès. Vous pouvez également modifier la configuration de base du flux de données, mettre à jour ses règles de mappage, copier le flux de données ou le supprimer entièrement.
Ajouter des services à un flux de données add-services
Sur la page de détails d’un flux de données, sélectionnez Ajouter un service pour commencer à ajouter les services disponibles à ce flux de données.
Sur l’écran suivant, utilisez le menu déroulant pour sélectionner un service à configurer pour ce flux de données. Seuls les services auxquels vous avez accès sont répertoriés dans cette liste.
Sélectionnez le service souhaité, renseignez les options de configuration qui s’affichent, puis sélectionnez Enregistrer pour ajouter le service au flux de données. Tous les services ajoutés s’affichent dans la vue des détails du flux de données.
Les sous-sections ci-dessous décrivent les options de configuration de chaque service.
Paramètres d’Adobe Analytics analytics
Ce service contrôle si et comment les données sont envoyées à Adobe Analytics. Voir Envoi de données à Adobe Analytics.
visitorID
dans Analytics.Paramètres d’Adobe Audience Manager audience-manager
Ce service contrôle si et comment les données sont envoyées à Adobe Audience Manager. Il suffit d’activer cette section pour envoyer des données à Audience Manager. Les autres paramètres sont facultatifs, mais recommandés.
Paramètres d’Adobe Experience Platform aep
Ce service contrôle si et comment les données sont envoyées à Adobe Experience Platform.
Pour plus d’informations sur les fonctionnalités d’Offer Decisioning, consultez la Documentation d’Adobe Journey Optimizer.
Vous pouvez utiliser cette option conjointement avec Destinations de personnalisation pour les cas d’utilisation de la personnalisation de la même page et de la page suivante via destinations de périphérie ou Offer Decisioning.
Consultez la documentation des destinations pour obtenir des instructions spécifiques sur la configuration des destinations de personnalisation.
L’activation de cette option permet au flux de données de renvoyer du contenu personnalisé à partir de campagnes entrantes web et basées sur des applications dans Adobe Journey Optimizer. Cette option nécessite Segmentation Edge pour être active. If Segmentation Edge n’est pas cochée, cette option est grisée.
Paramètres d’Adobe Target target
Ce service contrôle si et comment les données sont envoyées à Adobe Target.
Le jeton de propriété se trouve dans l’interface utilisateur d’Adobe Target sous Configuration > Propriétés.
Une bonne pratique consiste à définir ce paramètre différemment pour chacun des environnements de flux de données
dev
, stage
et prod
afin de simplifier le processus. Cependant, si des environnements Adobe Target sont déjà définis, vous pouvez les utiliser.mbox3rdPartyId
que vous souhaitez utiliser pour ce flux de données. Pour plus d’informations, consultez le guide sur la mise en œuvre de mbox3rdPartyId
avec le SDK web.Paramètres Transfert d’événement
Ce service contrôle si et comment les données sont envoyées au transfert d’événement.
Copier un flux de données copy
Vous pouvez créer une copie d’un flux de données existant et en modifier les détails si nécessaire.
À partir de la page principale de l’espace de travail Flux de données, sélectionnez les points de suspension (…) pour le flux de données en question, puis sélectionnez Copier.
Vous pouvez également sélectionner Copier le flux de données dans la vue des détails d’un flux de données particulier.
Une boîte de dialogue de confirmation s’affiche, vous invitant à fournir un nom unique pour la création du flux de données, ainsi que des détails sur les options de configuration qui seront copiées. Une fois prêt, sélectionnez Copier.
La page principale de l’espace de travail Flux de données réapparaît avec le nouveau flux de données répertorié.
Étapes suivantes
Ce guide explique comment gérer les flux de données dans l’interface utilisateur de collecte de données. Pour plus d’informations sur l’installation et la configuration du SDK web après la configuration d’un flux de données, consultez le Guide E2E de collecte de données.