Utilisation de fragments dynamiques dynamic-fragments

Sur cette page : découvrez comment utiliser la résolution de fragment dynamique dans Adobe Journey Optimizer pour sélectionner le fragment publié qui est injecté dans un message au moment de l’exécution, en fonction des attributs de profil, des recherches de jeux de données ou des données contextuelles transmises au moment de l’envoi.

Adobe Journey Optimizer prend en charge la résolution de fragment dynamique au moment de l’exécution, ce qui vous permet de sélectionner le fragment publié qui est injecté dans un message en fonction des attributs de profil, des recherches de jeux de données ou des données contextuelles transmises au moment de l’envoi. Cela permet d’obtenir du contenu hautement personnalisé sans dupliquer la logique de campagne ou de parcours.

Vue d’ensemble overview

Les fragments statiques sont incorporés dans un message au moment de la conception ; le même fragment est utilisé pour chaque destinataire. Les fragments dynamiques résolvent l’identifiant de fragment au moment de l’exécution par destinataire, ce qui signifie que différents profils peuvent recevoir des blocs de contenu entièrement différents dans la même campagne ou le même parcours.

Les identifiants de fragments dynamiques peuvent provenir de trois sources :

Conditions préalables prerequisites

Avant d’utiliser des fragments dynamiques, assurez-vous que les éléments suivants sont en place :

Étape 1 : créer et publier le fragment create-fragment

Avant de référencer un fragment de manière dynamique, il doit être publié dans Journey Optimizer.

Étape 2 : créez le message avec une référence de fragment dynamique author-message

Dans l’éditeur de personnalisation, insérez l’espace réservé du fragment dynamique en utilisant la syntaxe suivante :

{{fragment id=dynamic_fragment_id}}

L’identifiant dynamic_fragment_id est un nom de variable. Sa valeur doit être résolue avant que la recherche de fragment ne soit effectuée. Vous la résolvez à l’aide d’une expression de recherche de jeu de données, d’un attribut de profil ou de données contextuelles.

Résoudre à partir d’une recherche de jeu de données resolve-from-dataset

Si l’identifiant du fragment est stocké dans un jeu de données AEP (par exemple, une table de mappage style-à-fragment), utilisez la fonction d’assistance datasetLookup pour le résoudre :

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

Dans cet exemple, le jeu de données contient des lignes indexées par une valeur de style (telle que style1). Pour un profil donné, la recherche récupère la valeur de la colonne fragmentId correspondante et l’affecte à dynamic_fragment_id, qui est ensuite utilisée pour résoudre le fragment.

Résoudre à partir des données contextuelles resolve-from-context

Si l’ID de fragment est fourni au moment de l’envoi dans le contexte de la requête API, référencez-le à l’aide de l’espace de noms context :

{{fragment id=context.audiencePayload.fragmentId}}

Le chemin d’accès context.audiencePayload est le préfixe requis pour tous les attributs provenant d’un fichier d’audience CSV ou transmis via le contexte de la requête API. Le nom de la colonne du fichier CSV (par exemple, fragmentId) suit le préfixe .

Résoudre à partir d’un attribut de profil resolve-from-profile

Si l’identifiant du fragment est stocké en tant qu’attribut de profil dans Adobe Experience Platform, référencez-le directement :

{{fragment id=profile.mi.fragmentId}}

Étape 3 : Configurer votre jeu de données pour l’approche de recherche configure-dataset

Si vous utilisez l’approche de recherche de jeu de données, mettez à jour le schéma et les données du jeu de données pour qu’ils contiennent l’identifiant du fragment.

Exemple de structure de jeu de données :

Étape 4 : transmettre les données contextuelles au moment de l’envoi pass-context-data

Si vous résolvez l’ID de fragment à partir des données contextuelles (par exemple, à partir d’un fichier de recommandation d’audience CSV), transmettez l’ID de fragment dans la requête API sous le préfixe de contexte requis.

Lors de l’utilisation de l’API de relecture Campaign, incluez l’identifiant du fragment dans l’objet context :

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

Le préfixe context.audiencePayload est obligatoire. Les attributs imbriqués sous cette clé mappent directement aux colonnes du fichier d’audience CSV lors de l’exécution de la campagne active.

Étape 5 : Vérifier et valider proof-validate

Avant d’activer la campagne, utilisez l’API de vérification de campagne pour vérifier que le fragment dynamique est correctement résolu et que la sortie d’e-mail générée est correcte.

Pour plus d’informations sur l’API Campaign, consultez la documentation des API Journey Optimizer 🔗.

Mécanismes de sécurisation et limitations guardrails

Les restrictions suivantes s’appliquent lors de l’utilisation de fragments dynamiques :

D’autres mécanismes de sécurisation s’appliquant aux fragments sont disponibles dans cette section.

Traitement des erreurs error-handling

Si la résolution d’un fragment dynamique échoue au moment de l’exécution, un événement d’exclusion est généré pour le profil affecté. Actuellement, tous les échecs de rendu de fragment sont classés comme un type d’erreur globale unique.

Pour déboguer les échecs de résolution de fragment :