Uso de fragmentos dinámicos dynamic-fragments

En esta página: Aprenda a utilizar la resolución dinámica de fragmentos en Adobe Journey Optimizer para seleccionar qué fragmento publicado se inserta en un mensaje en tiempo de ejecución, en función de atributos de perfil, búsquedas de conjuntos de datos o datos de contexto pasados en el momento de envío.

Adobe Journey Optimizer admite resolución dinámica de fragmentos durante la ejecución, lo que le permite seleccionar qué fragmento publicado se inserta en un mensaje en función de atributos de perfil, búsquedas de conjuntos de datos o datos de contexto pasados en el momento del envío. Esto permite contenido altamente personalizado sin duplicar la lógica de campaña o de recorrido.

Información general overview

Los fragmentos estáticos están incrustados en un mensaje en tiempo de diseño; se utiliza el mismo fragmento para cada destinatario. Los fragmentos dinámicos resuelven el ID de fragmento en tiempo de ejecución por destinatario, lo que significa que distintos perfiles pueden recibir bloques de contenido totalmente diferentes dentro de la misma campaña o recorrido.

Los ID de fragmento dinámicos pueden proceder de tres fuentes:

Requisitos previos prerequisites

Antes de usar fragmentos dinámicos, asegúrese de que lo siguiente esté configurado:

Paso 1: Crear y publicar el fragmento create-fragment

Antes de hacer referencia a un fragmento de forma dinámica, debe publicarse en Journey Optimizer.

Paso 2: Crear el mensaje con una referencia de fragmento dinámico author-message

En el editor de personalización, inserte el marcador de posición del fragmento dinámico con la siguiente sintaxis:

{{fragment id=dynamic_fragment_id}}

El identificador dynamic_fragment_id es un nombre de variable. Su valor debe resolverse antes de que se produzca la búsqueda de fragmentos. La resolución se realiza mediante una expresión de búsqueda del conjunto de datos, un atributo de perfil o datos de contexto.

Resolver a partir de una búsqueda de conjuntos de datos resolve-from-dataset

Si el ID de fragmento está almacenado en un conjunto de datos de AEP (por ejemplo, una tabla de asignación de estilo a fragmento), utilice la función de ayuda datasetLookup para resolverlo:

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

{{fragment id=dynamic_fragment_id}}

En este ejemplo, el conjunto de datos contiene filas marcadas por un valor de estilo (como style1). Para un perfil determinado, la búsqueda recupera el valor de columna fragmentId correspondiente y lo asigna a dynamic_fragment_id, que luego se utiliza para resolver el fragmento.

Resolver a partir de datos de contexto resolve-from-context

Si el ID de fragmento se proporciona en el momento de envío como parte del contexto de solicitud de API, haga referencia a él mediante el área de nombres context:

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

La ruta de acceso context.audiencePayload es el prefijo necesario para todos los atributos procedentes de un archivo de audiencia CSV o pasados a través del contexto de solicitud de API. El nombre de columna del CSV (por ejemplo, fragmentId) sigue el prefijo.

Resolución a partir de un atributo de perfil resolve-from-profile

Si el ID de fragmento se almacena como un atributo de perfil en Adobe Experience Platform, haga referencia a él directamente:

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

Paso 3: Configurar el conjunto de datos para el enfoque de búsqueda configure-dataset

Si utiliza el método de búsqueda de conjuntos de datos, actualice el esquema y los datos del conjunto de datos para que lleven el ID de fragmento.

Ejemplo de estructura del conjunto de datos:

Paso 4: Pasar datos de contexto en el momento del envío pass-context-data

Si está resolviendo el ID de fragmento a partir de datos de contexto (por ejemplo, desde un archivo de recomendación de audiencia CSV), pase el ID de fragmento en la solicitud de API bajo el prefijo de contexto requerido.

Cuando utilice la API de revisión de campaña, incluya el ID de fragmento en el objeto context:

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

El prefijo context.audiencePayload es obligatorio. Los atributos anidados en esta clave se asignan directamente a las columnas del archivo de audiencia CSV cuando se ejecuta la campaña en directo.

Paso 5: Prueba y validación proof-validate

Antes de activar la campaña, utilice la API de prueba de campaña para comprobar que el fragmento dinámico se resuelve correctamente y que el resultado del correo electrónico procesado es el esperado.

Para obtener más información sobre la API de campaña, consulte la documentación de las API de Journey Optimizer.

Mecanismos de protección y limitaciones guardrails

Al utilizar fragmentos dinámicos, se aplican las siguientes limitaciones:

Hay más protecciones aplicables a los fragmentos disponibles en esta sección.

Control de errores error-handling

Si un fragmento dinámico no se puede resolver durante la ejecución, se genera un evento de exclusión para el perfil afectado. Actualmente, todos los errores de procesamiento de fragmentos se clasifican como un solo tipo de error general.

Para depurar errores de resolución de fragmentos: