Initialisation des SDK
Suivez les étapes du diagramme Initialiser 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 l’ordre approprié.
Diagramme Initialiser les SDK diagram
Pour les applications comportant plusieurs pages, ce flux se produit chaque fois que la page se recharge ou que le visiteur accède à une nouvelle page du site web.
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 de la requête de chargement automatique de page
- 1.4 : Configuration de la gestion du scintillement
- 1.5 : Configuration du mapping des données
- 1.6 : Promotion
- 1.7 : Critères basés sur le panier
- 1.8 : Critères de popularité
- 1.9 : Critères par article
- 1.10 : Critères fondé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 : Fournir des ID exclus
- 1.14 : transmettez le paramètre entity.event.detailsOnly=true .
- 1.15 : Configuration du mappage 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.
Conditions préalables
- Pour utiliser le service d’ID de visiteur/API, votre société doit être activée pour le Adobe Experience Cloud et disposer d’un ID d’organisation. Pour plus d’informations, voir [Conditions requises pour Experience Cloud : ID d’organisation](https://experienceleague.adobe.com/docs/id-service/using/reference/requirements.html?lang=fr ?){target=_blank} dans le guide Aide d’Identity Service.
- Vous avez besoin du fichier
VisitorAPI.js. Vous devriez déjà disposer de ce fichier si vous l’avez Adobe Analytics implémenté. Ce fichier peut également être ajouté via l’extension Adobe Experience Platform tags ou téléchargé à partir du Gestionnaire de code Adobe Analytics.
Configuration et renvoi de VisitorAPI.js
Pour plus d’informations, voir Implémentation du service Experience Cloud pour Target.
Lectures
- Présentation d’Experience Cloud Identity Service
- À propos du service d’ID
- Cookies et Experience Cloud Identity Service
- Requête et définition d’ID par le service Experience Cloud Identity
- Comprendre la synchronisation des identifiants et les taux de correspondance
Actions
- Incorporez le fichier
VisitorAPI.jsdans vos pages web. - Découvrez les configurations disponibles pour le service d’ID visiteur/API.
- Une fois le fichier
VisitorAPI.jschargé, utilisez la méthodeVisitor.getInstancepour initialiser à 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 (identifiant CRM, identifiant utilisateur, etc.) sont liés à l’identifiant anonyme d’Adobe pour la personnalisation sur l’ensemble des appareils.
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.setCustomerIDspour définir l’identifiant connu du visiteur.
Revenez au diagramme en haut de cette page.
1.3 : Configuration de la requête automatique de chargement de page 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.
Conditions préalables
- Toutes les données de la couche de données ne doivent pas être envoyées à Target. Consultez votre équipe commerciale (équipe de marketing numérique) pour déterminer quelles données sont utiles à des fins d’expérimentation, d’optimisation et de personnalisation. Seules ces données doivent être envoyées à Target.
- Assurez-vous de ne pas envoyer de données d’informations d’identification personnelle (PII) à Target.
Configurer la requête de chargement automatique de page
Pour plus d’informations, voir targetGlobalSettings().
Lectures
Découvrez le paramètre pageLoadEnabled dans targetGlobalSettings().
Actions
- Modifiez l’objet
window.targetGlobalSettingspour activer les requêtes de chargement de page automatique.
1.4 : Configuration de la gestion du scintillement flicker
Cette étape permet de s’assurer qu’aucune page ne scintille lors de la diffusion d’expériences.
Conditions préalables
- Discutez 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 avec l’équipe responsable des performances des pages web. Vous pouvez rechercher des modèles de conception qui vous permettent d’utiliser une solution personnalisée de gestion du scintillement, telle que l’animation du chargeur. Si vous ne trouvez pas de modèle, vous pouvez demander un nouveau modèle.
Configurer 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 lorsque la requête de chargement de page est en cours. Si vous n’avez pas activé la demande de chargement automatique de page pour une raison quelconque (les données ne sont pas prêtes ultérieurement, par exemple), il est préférable de définir ce paramètre sur false.
Si vous avez désactivé bodyHidingEnabled parce que vous ne souhaitez pas déclencher APLR et que vous souhaitez déclencher la requête de page ultérieurement, ou que vous n’avez pas besoin de gérer le scintillement, vous devez implémenter votre propre gestion du scintillement. Vous pouvez gérer le scintillement de deux manières : en masquant les sections en cours de test ou en affichant un déclencheur sur les sections en cours de test.
Lectures
- Gestion du scintillement par at.js
- Découvrez les objets bodyHiddenStyle et bodyHiddenEnabled dans targetGlobalSettings().
Actions
- Modifiez l’objet
window.targetGlobalSettingspour définirbodyHiddenStyleetbodyHidingEnabled.
1.5 : Configuration du mapping 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.
Conditions préalables
-
La couche de données doit être prête avec toutes les données qui doivent être envoyées à Target.
-
Recommendations : enrichissement du profil.
- Transmettez des
entity.idpour capturer des données pour les critères récemment consultés et les éléments basés sur les critères du dernier produit consulté. - Transmettez des
entity.idpour capturer des données pour les critères de popularité en fonction de 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 des
-
Recommendations : ingestion des données de produit.
- D’autres paramètres d’entité (réservés et personnalisés) peuvent être transmis pour ingérer ou mettre à jour le catalogue de produits dans Recommendations.
- Le catalogue de produits peut également être mis à jour à l’aide de flux d’entités dans l’interface utilisateur ou l’API Target.
Mapper les données àTarget
Pour plus d’informations, voir targetPageParams().
Lectures
- targetPageParams()
- Planifier et implémenter des recommandations
- Configurer votre catalogue de recommandations
Actions
- Utilisez la fonction
targetPageParams()pour définir toutes les données requises qui doivent être envoyées à Target.
1.6 : Promotion promotion
Ajoutez des éléments en promotion et contrôlez leur placement dans vos Target Recommendations conceptions.
Options disponibles
- Promouvoir par ID
- 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
Faites des recommandations en fonction du contenu du panier de l’utilisateur.
Critères disponibles
- Les personnes qui ont consulté ces , ont consulté ces
- Les Personnes Qui Les Ont Consultés Les Ont Achetés
- Les gens qui ont acheté ceci, ont acheté cela
Paramètres d’entité requis
- cartIds
Lectures
Revenez au diagramme en haut de cette page.
1.8 : Critères de popularité popularity
Faites des recommandations en fonction de la popularité globale d’un élément sur votre site ou en fonction de la popularité des éléments dans la catégorie, la marque, le genre préféré ou le plus consulté d’un utilisateur, etc.
Critères disponibles
- Les plus consultés sur le site
- Les plus consultés par catégorie
- Éléments les plus consultés par attribut d’élément
- Meilleurs vendeurs sur le site
- Meilleurs vendeurs par catégorie
- Meilleurs vendeurs par attribut d’article
- En tête par mesure Analytics
Paramètres d’entité requis
entity.categoryIdou l’attribut article pour la popularité basée sur l’article actuel ou l’attribut article si le critère est basé sur l’article actuel.- Rien ne doit être transmis pour les objets les plus consultés/les plus vendus sur le site.
Lectures
1.9 : Critères par article item
Faites des recommandations basées sur la recherche d’éléments similaires à un élément que l’utilisateur consulte ou a récemment consulté.
Critères disponibles
- Les personnes qui ont consulté ceci ont consulté cela
- Les personnes qui ont consulté ceci ont acheté cela
- Les personnes qui ont acheté ceci ont acheté cela
- Éléments avec des attributs similaires
Paramètres d’entité requis
entity.idou tout attribut de profil utilisé comme clé
Lectures
Revenez au diagramme en haut de cette page.
1.10 : Critères fondés sur l’utilisateur user
Faites des recommandations basées sur le comportement de l’utilisateur.
Critères disponibles
- Éléments récemment consultés
- Recommandé
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 basées sur un fichier personnalisé que vous téléchargez.
Critères disponibles
- Algorithme personnalisé
Paramètres d’entité requis
entity.id ou l’attribut utilisé comme clé pour l’algorithme personnalisé
Lectures
1.12 : fournir les attributs utilisés dans les règles d’inclusion inclusion
Revenez au diagramme en haut de cette page.
1.13 : Fournir des ID exclus exclude
Transmettez les ID 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 : Transmettre le paramètre entity.event.detailsOnly=true true
Utilisez les attributs d’entité pour transmettre des informations sur les produits ou le contenu aux Target Recommendations.
Lectures
Revenez au diagramme en haut de cette page.
1.15 : Configuration du mappage de données à distance (à distance)
Cette étape permet de s’assurer que toutes les données qui doivent être envoyées à Target sont définies.
Conditions préalables
- La couche de données doit être prête avec toutes les données qui doivent être envoyées à Target.
Configurer 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 qui doivent être envoyées à Target.
1.16 : chargement d’at.js web
Cette étape garantit que la bibliothèque JavaScript at.js est chargée et initialisée.
Conditions préalables
- Téléchargez le fichier de bibliothèque JavaScript
at.js 2.*x*ou demandez-le à votre équipe de marketing numérique.
Lectures
- Fonctionnement de Target
- Fonctionnement d’at.js
- Mise en œuvre de Target sans gestionnaire de balises
Actions
Insérez le fichier at.js dans toutes les pages web où l’expérimentation, l’optimisation, la personnalisation et la collecte de données doivent avoir lieu.
Revenez au diagramme en haut de cette page.
Passez à l’étape 2 : Configurer la collecte de données.