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é à injecter 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é à injecter 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 tous les destinataires. Les fragments dynamiques résolvent l’ID 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 ID de fragments dynamiques peuvent provenir de trois sources différentes :

Conditions préalables prerequisites

Avant d’utiliser des fragments dynamiques, vérifiez ce qui suit :

É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éer 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ésolution à partir d’une recherche de jeu de données resolve-from-dataset

Si l’ID 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’attribue à dynamic_fragment_id, qui est ensuite utilisé pour résoudre le fragment.

Résolution à partir de données contextuelles resolve-from-context

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

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

Le chemin 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 demande d’API. Le nom de la colonne du fichier CSV (par exemple, fragmentId) suit le préfixe.

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

Si l’ID 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 le 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’ID 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 demande d’API sous le préfixe de contexte requis.

Lors de l’utilisation de l’API de relecture de campagne, incluez l’ID 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 requis. Les attributs imbriqués sous cette clé sont directement associés 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 relecture 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 de campagne, consultez la documentation relative aux API Journey Optimizer.

Mécanismes de sécurisation et limites 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 :