Editar contenido de campaña activado por API api-content

En esta página: Diseñe y personalice su contenido de campaña activado por API con datos contextuales pasados en la carga útil de la API para que cada mensaje se adapte en tiempo real a cada destinatario.

Para configurar el contenido del mensaje, vaya a la ficha Contenido o haga clic en el botón Editar contenido.

Diseño del contenido design

El proceso de creación de contenido depende del canal seleccionado. Conozca los pasos detallados para crear el contenido del mensaje en las siguientes páginas:

IMPORTANT
Las campañas de alto rendimiento no dependen de los perfiles de Adobe: toda personalización debe incluirse en la carga útil de la API como datos de contexto, como se detalla a continuación. Este modo solo está disponible para el canal de correo electrónico y en la región de EE. UU.

Adjuntar archivos personalizados de PDF attachments

Para las campañas de correo electrónico transaccionales activadas por la API, puede incluir hasta cinco archivos adjuntos de PDF en un correo electrónico, incluidos archivos adjuntos estáticos y personalizados. Cada destinatario puede recibir diferentes PDF personalizados. Aprenda a adjuntar archivos personalizados de PDF

Personalización del contenido mediante datos contextuales contextual

Puede pasar datos adicionales en la carga útil de la API que puede aprovechar para personalizar su mensaje.

Veamos este ejemplo en el que los clientes desean restablecer su contraseña y usted desea enviarles una URL de restablecimiento de contraseña generada en una herramienta de terceros. Con las campañas activadas por API, puede pasar esta URL generada a la carga útil de la API y aprovecharla en la campaña para agregarla al mensaje.

Para ello, debe pasarlas a la carga útil de la API y añadirlas en el mensaje mediante el editor de personalización. Utilice la sintaxis {{context.<contextualAttribute>}}, donde <contextualAttribute> debe coincidir con el nombre de la variable en su carga útil de API que contiene los datos que desea pasar.

Tenga en cuenta que, por ahora, no hay ningún atributo contextual disponible para su uso en el menú del carril izquierdo. Los atributos deben escribirse directamente en la expresión personalizada, sin que Journey Optimizer realice ninguna comprobación.

Debe leer

  • Los atributos contextuales pasados a la solicitud no pueden superar los 200 KB y siempre se consideran de tipo cadena.
  • La sintaxis context.system está restringida únicamente al uso interno de Adobe y no debe usarse para pasar atributos contextuales.
  • A diferencia de los eventos habilitados para perfiles, los datos contextuales pasados en la API de REST se utilizan para una comunicación única y no se almacenan en el perfil. Como máximo, el perfil se crea con los detalles del área de nombres, si se ha encontrado que falta.
  • El uso de un gran número o de datos contextuales pesados en el contenido puede afectar al rendimiento.

Prueba y verificación del contenido

Una vez definido el contenido, use el botón Simular contenido para previsualizar y probar el contenido. Puede utilizar cualquiera de los métodos de simulación:

  • Haga clic en Simular contenido para probar las variaciones de contenido con datos de entrada de muestra o generación automática de IA.
  • Haga clic en Simular contenido y, a continuación, seleccione Simular contenido (perfiles de AEP) en el menú desplegable para previsualizarlo con perfiles de prueba.

Obtenga información sobre cómo obtener una vista previa y probar contenido. Para volver a la pantalla de creación de campañas, haga clic en la flecha izquierda.

Próximos pasos next

Una vez que la configuración y el contenido de la campaña estén listos, puede definir la audiencia de la campaña. Más información

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to design the content of an API triggered campaign, personalize it with contextual data passed in the API payload, attach personalized PDF files, and preview it with Simulate content.

Intents:

  • Open the message content configuration from the Content tab or the Edit content button
  • Personalize a message with contextual data from the API payload
  • Attach personalized PDF files to transactional API-triggered email campaigns
  • Preview and test the content with Simulate content

Glossary:

  • Contextual data: Additional data passed into the API payload and used to personalize the message, referenced with the {{context.<contextualAttribute>}} syntax, where <contextualAttribute> matches the name of the variable in the API payload (product-specific)
  • High Throughput campaigns: A mode that does not rely on Adobe profiles; all personalization must be included in the API payload as context data (product-specific)
  • Simulate content: Button used to preview and test content with sample input data or AI auto-generation
  • Simulate content (AEP profiles): Option selected from the Simulate content dropdown to preview with test profiles

Guardrails:

  • The contextual attributes passed into the request cannot exceed 200kb (hard limit) and are always considered of type string.
  • The context.system syntax is restricted to Adobe internal usage only and should not be used to pass contextual attributes.
  • Contextual data passed in the REST API is used for one-off communication and is not stored against profile. At maximum, a profile is created with the namespace details, if it was found missing.
  • Using a large number or heavy contextual data in your content may impact performances.
  • For now, no contextual attribute is available for use in the left rail menu. Attributes must be typed directly in the personalization expression, with no check performed by Journey Optimizer.
  • A transactional API-triggered email campaign can include up to five PDF attachments in an email, including both static and personalized attachments.

Applicability:

  • Design content: Email, Mobile message, Push notification
  • Personalized PDF attachments: transactional API-triggered email campaigns
  • High Throughput campaigns: email channel only, US region only

Terminology:

  • Canonical name: API triggered campaign content
  • Do not confuse: “contextual data passed in the REST API” (one-off, not stored against profile) ≠ “profile-enabled events”
  • Do not confuse: Simulate content (sample input data or AI auto-generation) ≠ Simulate content (AEP profiles) (test profiles)

FAQ:

  • Q: How do I use data from the API payload in a message? — Pass the data into the API payload and add it in the message with the personalization editor, using {{context.<contextualAttribute>}}.
  • Q: Can contextual attributes be picked from the left rail menu? — No. No contextual attribute is available there; attributes must be typed directly in the personalization expression.
  • Q: What is the size limit for contextual attributes? — They cannot exceed 200kb and are always considered of type string.
  • Q: Is contextual data stored against the profile? — No. It is used for one-off communication and not stored against profile. At maximum, a profile is created with the namespace details, if it was found missing.
  • Q: How many PDF attachments can an email include? — For transactional API-triggered email campaigns, up to five, static and personalized attachments included.
  • Q: How do I preview content? — Click Simulate content to test with sample input data or AI auto-generation, or select Simulate content (AEP profiles) from the dropdown to preview with test profiles.

Examples:

  • A customer wants to reset a password. A password reset URL is generated in a third-party tool, passed into the API payload, and added to the message with {{context.<contextualAttribute>}}.

Related pages:

  • Creating email content: Email (email/create-email.md)
  • Creating mobile message content: Mobile message (mobile/create-mobile-message.md)
  • Creating push notification content: Push notification (push/create-push.md)
  • High Throughput campaigns: High Throughput campaigns (campaigns/api-triggered-high-throughput.md)
  • Personalized PDF attachments: Learn how to attach personalized PDF files (email/pdf-attachments.md#personalized-attachments)
  • Previewing and testing content: Learn how to preview and test content (content-management/preview-test.md)
  • Next step, defining the audience: Learn more (campaigns/api-triggered-campaign-audience.md)
recommendation-more-help
journey-optimizer-help