Initialisation des SDK
Suivez les étapes du diagramme Initialiser le SDK pour vous assurer que toutes les tâches nécessaires au chargement de la bibliothèque JavaScript at.js Adobe Target sont exécutées dans la séquence correcte.
Diagramme Initialisation des SDK diagram
Pour les applications multi-pages, ce flux se produit chaque fois que la page se recharge ou que le visiteur accède à une nouvelle page du site web.
{width="600" modal="regular"}
Cliquez sur les liens suivants pour accéder aux sections de votre choix :
- 1.1 : Chargement du SDK de l’API visiteur
- 1.2 : Définition de l’ID de client
- 1.3 : Configuration d’une requête de chargement de page automatique
- 1.4 : Configuration de la gestion du scintillement
- 1.5 : Configuration du mappage des données
- 1.6 : Promotion
- 1.7 : critères basés sur le panier
- 1.8 : critères basés sur la popularité
- 1.9 : critères basés sur un élément
- 1.10 : critères basés sur l’utilisateur
- 1.11 : Critères personnalisés
- 1.12 : Fournir les attributs utilisés dans les règles d’inclusion
- 1.13 : Fournissez excludedIds
- 1.14 : transmettez le paramètre entity.event.detailsOnly=true
- 1.15 : Configuration du mapping des données distantes
- 1.16 : Chargement d’at.js
1.1 : Chargement du SDK de l’API visiteur load
Cette étape permet de s’assurer que la bibliothèque VisitorAPI.js
est chargée, configurée et initialisée correctement.
{width="400" modal="regular"}
Conditions préalables
- Pour utiliser le service d’identification des visiteurs/API, votre entreprise doit être activée pour le Adobe Experience Cloud et disposer d’un Organization ID. Pour plus d’informations, voir Configuration requise de l’Experience Cloud : ID d’organisation dans le guide Aide d’Identity Service.
- Vous avez besoin du fichier
VisitorAPI.js
. Vous devriez déjà avoir ce fichier si Adobe Analytics est implémenté. Ce fichier peut également être ajouté par le biais de l’ Adobe Experience Platform extension de balises ou téléchargé à partir du Gestionnaire de code Adobe Analytics.
Configuration et référence VisitorAPI.js
Pour plus d’informations, voir Mise en oeuvre du service Experience Cloud pour Target.
Lectures
- Présentation du service d’identité Experience Cloud
- À propos du service d’ID
- Cookies et service Experience Cloud Identity
- Requête et définition d’ID par le service Identity Experience Cloud
- Comprendre la synchronisation des identifiants et les taux de correspondance
Actions
- Incorporez le fichier
VisitorAPI.js
sur vos pages web. - Découvrez les configurations disponibles pour le service d’identification des visiteurs/API.
- Une fois le fichier
VisitorAPI.js
chargé, utilisez la méthodeVisitor.getInstance
pour l’initialisation à l’aide des configurations nécessaires. - Familiarisez-vous avec les méthodes disponibles.
1.2 : Définition de l’ID de client set
Cette étape permet de s’assurer que les identifiants connus de vos visiteurs (ID CRM, ID utilisateur, etc.) sont liés à l’identifiant anonyme de Adobe pour la personnalisation sur plusieurs appareils.
{width="400" modal="regular"}
Conditions préalables
- L’identifiant connu des visiteurs doit être disponible dans la couche de données.
Définition de l’ID de client
Pour plus d’informations, voir setCustomerIDs.
Lectures
Actions
- Utilisez
visitor.setCustomerIDs
pour définir l’identifiant connu du visiteur.
Revenez au diagramme en haut de cette page.
1.3 : Configuration d’une requête de chargement de page automatique automatic
Cette étape permet à at.js de récupérer toutes les expériences qui doivent être rendues sur la page lors du chargement du fichier de bibliothèque JavaScript at.js.
{width="400" modal="regular"}
Conditions préalables
- Toutes les données de la couche de données ne doivent pas être envoyées à Target. Consultez votre équipe d’entreprise (équipe marketing numérique) pour déterminer les données qui sont utiles à l’expérimentation, l’optimisation et la personnalisation. Seules ces données doivent être envoyées à Target.
- Assurez-vous de ne pas envoyer de données d’informations d’identification personnelle à Target.
Configuration d’une requête de chargement de page automatique
Pour plus d’informations, voir targetGlobalSettings().
Lectures
Découvrez le paramètre pageLoadEnabled
dans targetGlobalSettings().
Actions
- Modifiez l’objet
window.targetGlobalSettings
pour activer les requêtes de chargement automatique de page.
1.4 : Configuration de la gestion du scintillement flicker
Cette étape permet de s’assurer qu’il n’y a pas de scintillement de page lors de la diffusion d’expériences.
{width="400" modal="regular"}
Conditions préalables
- Contactez l’équipe responsable des performances des pages web au sujet des avantages et des inconvénients du contrôle du scintillement à l’aide de la méthode par défaut utilisée par at.js. Vous pouvez rechercher des modèles de conception qui vous permettent d’utiliser une solution de gestion du scintillement personnalisée, telle que l’animation du chargeur. Si vous ne trouvez pas de modèle, vous pouvez en demander un nouveau.
Configuration de la gestion du scintillement
Pour plus d’informations, voir targetGlobalSettings().
La définition de bodyHidingEnabled
sur true
masque l’intégralité du corps de la page pendant la requête de chargement de page. Si vous n’avez pas activé la requête de chargement de page automatique pour une raison quelconque (données ultérieurement non prêtes, par exemple), il est préférable de définir ce paramètre sur false
.
Si vous avez désactivé bodyHidingEnabled
car vous ne souhaitez pas déclencher APLR et que vous souhaitez déclencher la demande de page ultérieurement, ou si vous n’avez pas besoin de gestion du scintillement, vous devez mettre en oeuvre votre propre gestion du scintillement. Vous pouvez gérer le scintillement de deux manières : en masquant les sections sous test ou en affichant un robot sur les sections sous test.
Lectures
- Gestion du scintillement par at.js
- Découvrez les objets bodyHiddenStyle et bodyHidingEnabled dans targetGlobalSettings().
Actions
- Modifiez l’objet
window.targetGlobalSettings
pour définirbodyHiddenStyle
etbodyHidingEnabled
.
1.5 : Configuration du mappage des données data-mapping
Cette étape permet de s’assurer que toutes les données qui doivent être envoyées à Target sont définies.
{width="400" modal="regular"}
Conditions préalables
-
La couche de données doit être prête avec toutes les données qui doivent être envoyées à Target.
-
Recommendations : enrichissez le profil.
- Transmettez
entity.id
pour capturer des données pour des critères et des éléments récemment consultés en fonction de critères basés sur le dernier produit consulté. - Transmettez
entity.id
pour capturer des données pour les critères de popularité basés sur la catégorie préférée. - Transmettez l’attribut de profil si des critères personnalisés sont basés sur celui-ci ou utilisés dans le filtrage des règles d’inclusion dans n’importe quel critère.
- Transmettez
-
Recommendations : ingérez des données de produit.
- D’autres paramètres d’entité (réservés et personnalisés) peuvent être transmis pour ingestion ou mise à jour du catalogue de produits dans Recommendations.
- Le catalogue de produits peut également être mis à jour à l’aide de flux d’entités à l’aide de l’interface utilisateur ou de l’API Target.
Mapper les données àTarget
Pour plus d’informations, voir targetPageParams().
Lectures
- targetPageParams()
- Planification et implémentation de Recommendations
- Configuration de votre catalogue Recommendations
Actions
- Utilisez la fonction
targetPageParams()
pour définir toutes les données requises à envoyer à Target.
1.6 : Promotion promotion
Ajoutez des éléments en promotion et contrôlez leur emplacement dans vos Target Recommendations designs.
Options disponibles
- Promouvoir par les identifiants
- Promouvoir par collection
- Promouvoir par attribut
Paramètres d’entité requis
- L’attribut d’élément dans la promotion doit être transmis lors de l’utilisation de l’option "promouvoir par attribut".
Revenez au diagramme en haut de cette page.
1.7 : critères basés sur le panier cart
Effectuez des recommandations en fonction du contenu du panier de l’utilisateur.
Critères disponibles
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
Paramètres d’entité requis
- cartIds
Lectures
Revenez au diagramme en haut de cette page.
1.8 : critères basés sur la popularité popularity
Effectuez des recommandations en fonction de la popularité globale d’un élément sur votre site ou de la popularité des éléments au sein de la catégorie, de la marque, du genre, préférée ou la plus consultée d’un utilisateur, etc.
Critères disponibles
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
Paramètres d’entité requis
entity.categoryId
ou l’attribut d’élément pour la popularité basée sur si le critère est basé sur l’élément actif ou l’attribut d’élément.- Aucun élément ne doit être transmis pour le site le plus consulté/le plus vendu.
Lectures
1.9 : critères basés sur un élément item
Effectuez des recommandations sur la base de la recherche d’éléments similaires à un élément que l’utilisateur consulte ou a récemment consulté.
Critères disponibles
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
Paramètres d’entité requis
entity.id
ou tout attribut de profil utilisé comme clé
Lectures
Revenez au diagramme en haut de cette page.
1.10 : critères basés sur l’utilisateur user
Effectuez des recommandations en fonction du comportement de l’utilisateur.
Critères disponibles
- Recently Viewed Items
- Recommended for You
Paramètres d’entité requis
entity.id
Lectures
Revenez au diagramme en haut de cette page.
1.11 : Critères personnalisés custom
Faites des recommandations en fonction d’un fichier personnalisé que vous chargez.
Critères disponibles
- Custom algorithm
Paramètres d’entité requis
entity.id
ou attribut utilisé comme clé pour l’algorithme personnalisé
Lectures
Revenez au diagramme en haut de cette page.
1.12 : Fournir les attributs utilisés dans les règles d’inclusion inclusion
1.13 : Fournissez excludedIds exclude
Transmettez les identifiants d’entité pour les entités que vous souhaitez exclure de vos recommandations. Par exemple, vous pouvez exclure des articles déjà présents dans le panier.
Revenez au diagramme en haut de cette page.
1.14 : transmettez le paramètre entity.event.detailsOnly=true
true
Utilisez les attributs d’entité pour transmettre des informations sur les produits ou le contenu à Target Recommendations.
Lectures
Revenez au diagramme en haut de cette page.
1.15 : configuration du mapping des données distantes (à distance)
Cette étape garantit que toutes les données qui doivent être envoyées à Target sont définies.
{width="400" modal="regular"}
Conditions préalables
- La couche de données doit être prête avec toutes les données qui doivent être envoyées à Target.
Configuration des fournisseurs de données
Pour plus d’informations, voir Fournisseurs de données.
Lectures
Actions
Utilisez la fonction targetPageParams()
pour définir toutes les données requises à envoyer à Target.
Revenez au diagramme en haut de cette page.
1.16 : Chargement d’at.js web
Cette étape garantit que la bibliothèque JavaScript at.js est chargée et initialisée.
{width="400" modal="regular"}
Conditions préalables
- Téléchargez ou demandez à votre équipe de marketing numérique le fichier de bibliothèque JavaScript
at.js 2.*x*
.
Lectures
- Fonctionnement de Target
- Fonctionnement d’at.js
- Mise en œuvre de Target sans gestionnaire de balises
Actions
Incorporez le fichier at.js sur toutes vos pages web où l’expérimentation, l’optimisation, la personnalisation et la collecte de données doivent se produire.
Revenez au diagramme en haut de cette page.
Passez à l’étape 2 : Configuration de la collecte de données.