Informations sur les différentes méthodes que vous pouvez utiliser pour obtenir des données dans Adobe Target, notamment les paramètres de page, les attributs de profil de la page, les attributs de profil de script, les fournisseurs de données, l'API de mise à jour de profil en bloc, l'API de mise à jour de profil unique et les attributs du client.
Les paramètres de page sont des paires nom/valeur transmises directement par le biais du code de page qui ne sont pas enregistrées dans le profil du visiteur pour une utilisation ultérieure.
Les paramètres de page sont utiles pour envoyer à Target des données de page supplémentaires qui ne doivent pas être enregistrées avec le profil du visiteur pour une utilisation ultérieure dans le cadre du ciblage. Ces valeurs sont utilisées pour décrire la page ou l’action effectuée par l’utilisateur sur cette page spécifique.
Les paramètres de page sont transmis à Target via un appel au serveur sous la forme d’une paire nom/valeur de chaîne. Les noms et les valeurs de paramètre sont personnalisables (cependant, certains noms sont réservés à des utilisations spécifiques).
Exemples :
page=productPage
categoryId=homeLoans
Pages de produit : envoyez les informations relatives au produit spécifique consulté (c’est ainsi que fonctionnent les recommandations).
Détails de la commande : envoyez l’identifiant de la commande, orderTotal, etc. pour la collecte de la commande.
Affinité catégorielle : envoyez les informations de consultation de catégorie à Target afin de développer la connaissance de l’affinité de l’utilisateur pour des catégories de site particulières.
Données tierces : envoyez des informations provenant de sources de données tierces, telles que les fournisseurs de ciblage météo, les fournisseurs de données de compte (par exemple, DemandBase), les fournisseurs de données démographiques (par exemple, Experian), etc.
Les données sont envoyées à Target en temps réel et peuvent être utilisées sur le même appel au serveur que celui sur lequel elles ont été transmises.
Nécessite une mise à jour du code de page (directement ou par l’intermédiaire d’un système de gestion des balises).
Si les données doivent être utilisées pour le ciblage sur une page/un appel au serveur ultérieur, elles doivent être converties en script de profil.
Les caractères contenus dans les chaînes de requête doivent obligatoirement respecter les standards de l’Internet Engineering Task Force (IETF).
En plus des caractères mentionnés sur le site de l’IETF, Target autorise l’utilisation des caractères suivants dans les chaînes de requête :
< > # % " { } | \\ ^ \[\] \
`
Le reste doit être encodé en URL. La norme spécifie le format suivant ( https://www.ietf.org/rfc/rfc1738.txt ), comme illustré ci-dessous :
Ou la liste complète, pour plus de simplicité :
targetPageParamsAll (ajoute les paramètres à tous les appels de mbox sur la page) :
function targetPageParamsAll() { return "param1=value1¶m2=value2&p3=hello%20world";
targetPageParams (ajoute les paramètres à la mbox globale sur la page) :
function targetPageParams() { return "param1=value1¶m2=value2&p3=hello%20world";
Paramètres dans le code mboxCreate :
<div class="mboxDefault"> default content to replace by offer </div> <script> mboxCreate('mboxName','param1=value1','param2=value2'); </script>
Recommandations : implémentation selon le type de page
Confirmation de commande : suivi des conversions
Affinité catégorielle : affinité catégorielle
Les attributs de profil internes à la page sont des paires nom/valeur transmises directement par le biais du code de page qui sont enregistrées dans le profil du visiteur pour une utilisation ultérieure.
Les attributs de profil internes à la page permettent d’enregistrer les données spécifiques à l’utilisateur dans le profil de Target pour un ciblage et une segmentation ultérieurs.
Les attributs de profil internes à la page sont transmis à Target via un appel au serveur sous la forme d’une paire nom/valeur de chaîne précédée du préfixe « profile » .
Les noms et les valeurs d’attribut sont personnalisables (cependant, certains noms sont réservés à des utilisations spécifiques).
Exemples :
profile.membershipLevel=silver
profile.visitCount=3
Informations de connexion : partagez les données non personnelles avec Target selon la connexion de l’utilisateur. Il peut par exemple s’agir du statut de membre, de l’historique des commandes ou autres données non personnelles.
Informations de boutique : déterminez quelle est la boutique de prédilection de cet utilisateur.
Interactions précédentes : effectuez le suivi des activités précédentes de l’utilisateur sur le site afin d’informer la personnalisation ultérieure.
Les données sont envoyées à Target en temps réel et peuvent être utilisées sur le même appel au serveur que celui sur lequel elles ont été transmises.
Nécessite des mises à jour du code de page (directement ou par l’intermédiaire d’un système de gestion des balises).
Les attributs et valeurs sont visibles dans les appels au serveur, ce qui signifie qu’un visiteur peut les voir. Cette approche n’est peut-être pas appropriée si vous partagez des informations telles que des fourchettes de score de crédit ou d’autres informations potentiellement confidentielles.
targetPageParamsAll (ajoute les attributs à tous les appels de mbox sur la page) :
function targetPageParamsAll() { return "profile.param1=value1&profile.param2=value2&profile.p3=hello%20world"; }
targetPageParams (ajoute les attributs à la mbox globale sur la page) :
function targetPageParams() { return profile.param1=value1&profile.param2=value2&profile.p3=hello%20world"; }
Attributs dans le code mboxCreate :
<div class="mboxDefault"> default content to replace by offer </div> <script> mboxCreate('mboxName','profile.param1=value1','profile.param2=value2'); </script>
Les attributs de profil de script sont des paires nom/valeur définies dans la solution Target. La valeur est déterminée grâce à l’exécution d’un fragment de code JavaScript sur le serveur de Target à chaque appel de serveur.
Les utilisateurs écrivent de petits fragments de code qui s’exécutent à chaque appel de mbox, avant l’évaluation de l’appartenance d’audience et de l’appartenance à une activité d’un visiteur.
Les attributs de profil de script sont créés dans la section Audiences de Target. Tout nom d’attribut est valide et la valeur est le résultat d’une fonction JavaScript écrite par l’utilisateur de Target. Les noms d’attributs sont automatiquement précédés du préfixe « user. » dans Target pour les distinguer des attributs de profil internes à la page.
Les fragments de code sont écrits dans le langage JavaScript Rhino et peuvent référencer des jetons et d’autres valeurs.
Abandon de panier : lorsque le visiteur accède au panier, définissez le script de profil sur 1. Lorsque le visiteur convertit, redéfinissez-le sur 0. Si la valeur = 1, le visiteur a un article dans le panier.
Nombre de visites : à chaque nouvelle visite, incrémentez le compteur de 1 pour effectuer le suivi des visites récurrentes d’un visiteur sur le site.
Ne nécessite aucune mise à jour du code de page.
S’exécute avant les décisions concernant l’appartenance d’audience et l’appartenance à une activité, ce qui signifie que les attributs de script de profil peuvent affecter l’appartenance sur un appel au serveur unique.
Peut être très robuste. Jusqu’à 2 000 instructions peuvent être exécutées par script.
Exige la connaissance de JavaScript.
L’ordre d’exécution des scripts de profil ne peut être garanti, ils ne peuvent donc pas dépendre les uns des autres.
Peut être difficile à déboguer.
Les scripts de profil sont assez souples :
user.purchase_recency: var dayInMillis = 3600 * 24 * 1000; if (mbox.name == 'orderThankyouPage') { user.setLocal('lastPurchaseTime', new Date().getTime()); } var lastPurchaseTime = user.getLocal('lastPurchaseTime'); if (lastPurchaseTime) { return ((new Date()).getTime()-lastPurchaseTime)/dayInMillis; }
L’option Fournisseurs de données est une fonctionnalité qui vous permet de transmettre facilement des données provenant de tiers à Target.
Remarque : La section Fournisseurs de données doit disposer du fichier at.js 1.3 ou d’une version ultérieure.
Le paramètre window.targetGlobalSettings.dataProviders
est un tableau de fournisseurs de données.
Pour plus d’informations sur la structure de chaque fournisseur de données, voir Fournisseurs de données.
Collectez des données auprès d’un tiers (par exemple, un service météorologique, une plateforme de gestion des données, ou même votre propre service Web). Vous pouvez ensuite utiliser ces données pour créer des audiences, cibler du contenu et enrichir le profil du visiteur.
Ce paramètre permet aux clients de collecter des données auprès de fournisseurs de données tiers tels que Demandbase, BlueKai ou des services personnalisés, et de les transmettre à Target sous forme de paramètres mbox dans la requête globale mbox.
Cette fonction prend en charge la collecte des données en provenance de fournisseurs multiples via des requêtes synchrones et asynchrones.
Cette approche permet de gérer aisément le scintillement du contenu de la page par défaut, tout en incluant des délais d’attente indépendants pour chaque fournisseur afin de limiter l’impact sur les performances de la page
Si les fournisseurs de données ajoutés à window.targetGlobalSettings.dataProviders
sont asynchrones, ils sont exécutés en parallèle. La requête d’API Visitor sera exécutée en parallèle avec des fonctions ajoutées à window.targetGlobalSettings.dataProviders
afin de permettre un temps d’attente minimal.
at.js ne tentera pas de mettre les données en cache. Si le fournisseur de données extrait les données en une seule fois, il doit s’assurer que les données sont mises en cache et que, lorsque la fonction du fournisseur est appelée, les données du cache sont envoyées pour le second appel.
Vous trouverez plusieurs exemples dans la section Fournisseurs de données.
Documentation : Fournisseurs de données
L’API permet d’envoyer à Target un fichier .csv contenant les mises à jour des profils d’un grand nombre de visiteurs. Chaque profil du visiteur peut être mis à jour avec plusieurs attributs de profil internes à la page en un seul appel.
Cette option est très similaire à l’option Attributs du client, avec quelques différences :
mbox3rdPartyId
.mbox3rdPartyID
: signe plus (+) et barre oblique (/).Le fichier .csv doit désigner chaque visiteur par son PCID ou son mboxThirdPartyId Target. L’Experience Cloud ID (ECID) n’est pas pris en charge. Tous les attributs/valeurs de profil sont créés et mis à jour via l’API. Les détails relatifs au format sont disponibles dans la documentation de l’API.
Votre logiciel de gestion de la relation client ou autre système interne stocke des données importantes sur vos visiteurs que vous souhaitez constamment mettre à jour dans Target, sans exposer les données du profil dans l’implémentation de votre page.
Nombre d’attributs de profil illimité.
Les attributs de profil envoyés via le site peuvent être mis à jour via l’API et vice versa.
La taille du fichier de traitement par lot doit être inférieure à 50 Mo. En outre, le nombre total de lignes ne doit pas dépasser 500 000 lignes par téléchargement.
Le nombre de lignes pouvant être téléchargées en lots ultérieurs sur une période de 24 heures est illimité. Cependant, le processus d’assimilation peut être ralenti pendant les heures ouvrables pour s’assurer que les autres processus s’exécutent efficacement.
Les appels de mise à jour de lots V2 consécutifs non espacés par des appels mbox pour le même identifiant tiers remplacent les propriétés mises à jour au premier appel de mise à jour de lots.
Voir Mise à jour des profils.
Presque identique à l’API de mise à jour des profils en masse, mais un seul profil du visiteur est mis à jour à la fois, en ligne dans l’appel de l’API plutôt qu’au moyen d’un fichier .csv.
Le visiteur doit être identifié à l’aide de la valeur mboxPC ou mboxThirdPartyId de Target. L’Experience Cloud ID (ECID) n’est pas pris en charge.
Vous souhaitez mettre à jour Target en temps réel lorsqu’un visiteur effectue une action hors ligne, telle que contacter un centre d’appel, financer un prêt, utiliser une carte de fidélité en boutique, accéder à un kiosque, etc.
Nombre d’attributs de profil illimité.
Les attributs de profil envoyés via le site peuvent être mis à jour via l’API et vice versa.
Limite de 1 000 000 d’appels de l’API (1 million) par période de 24 heures.
Met à jour le profil uniquement. Ne prend pas en charge la création d’un profil pour un utilisateur que Target n’a pas encore vu.
Prise en charge des commandes GET et POST. https://CLIENT.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01_00&profile.attr1=0&profile.attr2=1...
Les attributs du client permettent de télécharger les données des profils de visiteur vers Experience Cloud par FTP. Une fois le chargement effectué, vous pouvez exploiter les données dans Adobe Analytics et Adobe Target.
Les clients Target Standard peuvent utiliser 5 attributs et les clients Target Premium peuvent utiliser 200 attributs.
Un fichier .csv contenant des Experience Cloud IDs (ECID) et des paires nom/valeur d’attributs est chargé par FTP ou manuellement dans l’interface utilisateur d’Experience Cloud.
Votre logiciel de gestion de la relation client ou autre système interne stocke des informations importantes que vous voulez partager avec la solution Experience Cloud d’Adobe, notamment Target et Analytics.
Le chargement des données d’un client crée une entrée de profil pour ce visiteur dans Target, même si Target ne l’a pas encore vu.
Les mêmes données sont automatiquement disponibles dans Target et Analytics.
Le chargement par FTP peut constituer une méthode d’implémentation plus simple que l’API.
Les clients Target Standard peuvent utiliser 5 attributs et les clients Target Premium peuvent utiliser 200 attributs.
Les valeurs peuvent uniquement être mises à jour par le biais des attributs du client, pas sur la page.
Cette méthode requiert l’implémentation de l’Experience Cloud ID (ECID).
Vous trouverez des détails dans Création d’une source d’attributs du client et téléchargement du fichier de données.
Création d’une source d’attributs du client et transfert du fichier de données.