DocumentationTargetGuide du développeur de Target

Initialisation des SDK

Dernière mise à jour : 5 mai 2025
  • Rubriques :
  • APIs/SDKs

Créé pour :

  • Expérimenté
  • Développeur

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.

CONSEIL
Cliquez sur les images de cette rubrique pour passer en mode plein écran.

Diagramme Initialisation des SDK

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.

REMARQUE
Les numéros des étapes de l’illustration suivante correspondent aux sections ci-dessous. Les numéros des étapes ne sont pas dans un ordre particulier et ne reflètent pas l’ordre des étapes effectuées dans l’interface utilisateur de Target lors de la création de l’activité.

Diagramme Initialiser les SDK

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

Cette étape permet de s’assurer que la bibliothèque VisitorAPI.js est chargée, configurée et initialisée correctement.

Voir les détails

Diagramme de chargement du SDK de l’API visiteur

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éthode Visitor.getInstance pour l’initialisation à l’aide des configurations nécessaires.
  • Familiarisez-vous avec les méthodes disponibles.

Revenez au diagramme en haut de cette page.

1.2 : Définition de l’ID de client

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.

Voir les détails

Définition de l’ID de client

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

  • Synchronisation des profils en temps réel pour mbox3rdPartyId

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

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.

Voir les détails

Configuration d’une requête de chargement de page automatique

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.

Revenez au diagramme en haut de cette page.

1.4 : Configuration de la gestion du scintillement

Cette étape permet de s’assurer qu’il n’y a pas de scintillement de page lors de la diffusion d’expériences.

Voir les détails

Configuration du diagramme de gestion du scintillement

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éfinir bodyHiddenStyle et bodyHidingEnabled.

Revenez au diagramme en haut de cette page.

1.5 : Configuration du mappage des données

Cette étape permet de s’assurer que toutes les données qui doivent être envoyées à Target sont définies.

Voir les détails

Diagramme de mappage de données

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.

  • 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.

Revenez au diagramme en haut de cette page.

1.6 : Promotion

Ajoutez des éléments en promotion et contrôlez leur emplacement dans vos Target Recommendations designs.

Voir les détails

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

Effectuez des recommandations en fonction du contenu du panier de l’utilisateur.

Voir les détails

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

  • Basé sur le panier

Revenez au diagramme en haut de cette page.

1.8 : critères basés sur la popularité

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.

Voir les détails

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

  • Popularity-based

Revenez au diagramme en haut de cette page.

1.9 : critères basés sur un élément

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é.

Voir les détails

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

  • Élément basé

Revenez au diagramme en haut de cette page.

1.10 : critères basés sur l’utilisateur

Effectuez des recommandations en fonction du comportement de l’utilisateur.

Voir les détails

Critères disponibles

  • Recently Viewed Items
  • Recommended for You

Paramètres d’entité requis

  • entity.id

Lectures

  • Basé sur l’utilisateur

Revenez au diagramme en haut de cette page.

1.11 : Critères personnalisés

Faites des recommandations en fonction d’un fichier personnalisé que vous chargez.

Voir les détails

Critères disponibles

  • Custom algorithm

Paramètres d’entité requis

entity.id ou attribut utilisé comme clé pour l’algorithme personnalisé

Lectures

  • Critères personnalisés

Revenez au diagramme en haut de cette page.

1.12 : Fournir les attributs utilisés dans les règles d’inclusion

Voir les détails

Lectures

  • Utilisation de règles d’inclusion dynamiques et statiques

Revenez au diagramme en haut de cette page.

1.13 : Fournissez excludedIds

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.

Voir les détails

Lectures

  • Puis-je exclure dynamiquement une entité ?

Revenez au diagramme en haut de cette page.

1.14 : transmettez le paramètre entity.event.detailsOnly=true

Utilisez les attributs d’entité pour transmettre des informations sur les produits ou le contenu à Target Recommendations.

Voir les détails

Lectures

  • Attributs d’entité

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.

Voir les détails

Diagramme de mappage de données distant

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

fonction targetPageParams

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

Cette étape garantit que la bibliothèque JavaScript at.js est chargée et initialisée.

Voir les détails

Chargement du diagramme Adobe Target at.js

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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3