Intégrer à Adobe Campaign v7/v8 integrating-with-adobe-campaign-v7-v8

Sur cette page : Connectez Journey Optimizer à Adobe Campaign v7 ou v8 pour que vos parcours puissent envoyer des e-mails, des notifications push et des messages mobiles par le biais des messages transactionnels de Campaign.

Si vous utilisez Adobe Campaign Classic v7 ou Campaign v8, une action personnalisée spécifique est disponible dans vos parcours afin d’intégrer Adobe Journey Optimizer à Adobe Campaign. Cette intégration vous permet d’envoyer des e-mails, des notifications push et des messages mobiles à l’aide des fonctionnalités de messagerie transactionnelle d’Adobe Campaign. En savoir plus dans ce cas d’utilisation complet.

Pour chaque action configurée, une activité d’action Campaign est disponible dans la palette du concepteur de parcours.

Activation access

En cas de demande, la connexion entre les environnements Journey Optimizer et Adobe Campaign est configurée par Adobe au moment de l’approvisionnement. Si vous n’avez pas demandé la connexion lors de l’approvisionnement, contactez l’assistance Adobe Journey Optimizer pour en demander l’activation. Vous devez fournir les informations suivantes :

Pour Adobe Journey Optimizer
  • ID d’organisation (OrgID Adobe)
  • Nom du sandbox
Pour Adobe Campaign
  • URL du serveur Campaign
  • URL du serveur temps réel
  • Votre version d’Adobe Campaign

Mécanismes de sécurisation et limites important-notes

  • Aucune limitation du débit des messages n’est appliquée. Le système limite à 4 000 le nombre de messages pouvant être envoyés toutes les 5 minutes, en fonction du contrat SLA Campaign actuel. C’est la raison pour laquelle Journey Optimizer ne devrait être utilisé que dans des cas d’utilisation unitaires (événements individuels, pas d’audiences).

  • Vous devez configurer une action sur la zone de travail pour chaque modèle à utiliser. Vous devez configurer une action dans Journey Optimizer pour chaque modèle que vous souhaitez utiliser dans Adobe Campaign.

  • Pour cette intégration, nous vous recommandons d’utiliser une instance Message Center dédiée, hébergée ou gérée dans le cadre de Managed Services, afin de ne pas perturber les autres opérations Campaign en cours. Le serveur marketing peut être hébergé ou On-Premise.

  • Aucune vérification de la validité de la payload ou du message Campaign n’est effectuée.

  • Vous ne pouvez pas utiliser une action de campagne avec un événement de qualification d’audience.

Conditions préalables prerequisites

Dans Adobe Campaign, vous devez créer et publier un message transactionnel ainsi que l’événement associé. Reportez-vous à la documentation d’Adobe Campaign ​.

Vous pouvez créer la payload JSON correspondant à chaque message selon le modèle ci-dessous. Vous devrez ensuite coller cette payload lors de la configuration de l’action dans Journey Optimizer (voir ci-dessous).

Exemple - E-mail
code language-json
{
    "channel": "email",
    "eventType": "welcome",
    "email": "Email address",
    "ctx": {
        "firstName": "First name"
    }
}
Exemple - SMS
code language-json
{
    "channel": "sms",
    "eventType": "Campaign transactional event internal name",
    "mobilePhoneNumber": "Recipient phone number",
    "ctx": {
        "firstName": "First name"
    }
}
  • channel : canal défini pour votre modèle transactionnel Campaign, par exemple email ou sms.
  • eventType : nom interne de votre événement transactionnel Campaign. Il s’agit du nom de l’événement Campaign qui n’est pas identique à l’événement d’entrée de parcours.
  • Champ du destinataire : l’adresse du destinataire attendue par le canal. Pour l’e-mail, utilisez email. Pour les SMS, le numéro du destinataire est lu à partir de mobilePhoneNumber (utilisez ce nom exact, et non mobilePhone ou phoneNumber).
  • ctx : variables de personnalisation utilisées dans votre message. Les propriétés dépendent du message transactionnel Campaign.

Une payload incomplète ou incorrecte, telle qu’un champ manquant ou mal orthographié, peut renvoyer une erreur HTTP 400.

Configurer l’action configure-action

Dans Journey Optimizer, vous devez configurer une action par message transactionnel.

Pour créer une action Campaign, procédez comme suit :

  1. Créez une action. Découvrez comment créer des actions personnalisées.
  2. Saisissez un nom et une description.
  3. Dans le champ Type d’action, sélectionnez Adobe Campaign Classic.
  4. Cliquez dans le champ Payload et collez un exemple de payload JSON correspondant au message Campaign Contactez Adobe pour obtenir ce payload.
  5. Définissez chaque champ comme statique ou variable selon que vous souhaitez le mapper ou non sur la zone de travail du parcours. Par exemple, les champs tels que les paramètres de canal e-mail et les champs de personnalisation (ctx) doivent généralement être définis en tant que variables afin de pouvoir s’adapter dynamiquement au sein du parcours.
  6. Cliquez sur Enregistrer.

Mettre à jour une action existante update-action

Si vous devez mettre à jour une action personnalisée Campaign v7/v8 existante, par exemple lorsque le point d’entrée en temps réel (RT) change après la configuration initiale, procédez comme suit :

  1. Dans le menu Administration, sélectionnez Configurations, puis accédez à Actions.
  2. Recherchez et sélectionnez l’action Campaign à mettre à jour dans la liste des actions.
  3. Cliquez sur Modifier pour ouvrir la configuration de l’action.
  4. Mettez à jour le champ URL avec la nouvelle URL du point d’entrée RT. Assurez-vous que le format du point d’entrée est correct et accessible.
  5. Si nécessaire, mettez à jour la configuration Payload pour qu’elle corresponde à toutes les modifications apportées à la structure du message transactionnel Campaign.
  6. Cliquez sur Tester pour valider la connexion au nouveau point d’entrée. Vérifiez que le test renvoie une réponse indiquant une réussite avant de poursuivre.
  7. Une fois la validation effectuée, cliquez sur Enregistrer pour appliquer vos modifications.
NOTE
Tous les parcours qui utilisent cette action utiliseront automatiquement la configuration mise à jour. Si des parcours actifs utilisent cette action, surveillez-les étroitement après la mise à jour du point d’entrée pour assurer une diffusion correcte des messages.
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 integrate Journey Optimizer with Adobe Campaign v7 or v8 so journeys can send emails, push notifications, and mobile messages through Adobe Campaign Transactional Messaging.

Intents:

  • Request activation of the connection between Journey Optimizer and Adobe Campaign environments
  • Prepare the transactional message, its associated event, and the JSON payload in Adobe Campaign
  • Configure a Campaign action of type Adobe Campaign Classic in Journey Optimizer
  • Set payload fields as static or variable for mapping on the journey canvas
  • Update an existing Campaign action when the Real-Time endpoint changes

Glossary:

  • Campaign action: The action available in the journey designer palette for each configured Adobe Campaign v7/v8 action (product-specific)
  • Transactional Messaging: The Adobe Campaign capability used to send emails, push notifications, and mobile messages triggered from Journey Optimizer (product-specific)
  • eventType: The internal name of the Adobe Campaign transactional event referenced in the JSON payload; it is the Campaign event name, not the journey entry event (product-specific)
  • mobilePhoneNumber: The payload field that carries the recipient phone number for the SMS channel; the exact field name, not mobilePhone or phoneNumber (product-specific)
  • ctx: The payload object holding variables based on the personalization present in the Campaign message (product-specific)

Guardrails:

  • There is no throttling of messages; the system caps the number of messages that can be sent to 4,000 per 5 minutes, based on the current Campaign SLA.
  • Because of that cap, Journey Optimizer should only be used in unitary use cases (individual events, not audiences).
  • You must configure one action on the canvas per template, meaning one action in Journey Optimizer for each Adobe Campaign template you wish to use.
  • There is no validation that the payload or Campaign message is correct.
  • An incomplete or incorrect payload, such as a missing or misspelled field, can return an HTTP 400 error.
  • You cannot use a Campaign action with an audience qualification event.
  • Adobe recommends using a dedicated Message Center hosted or Managed Services instance to avoid impacting other Campaign operations.

Terminology:

  • Canonical name: Adobe Campaign v7/v8 integration — Acronym: ACC (Adobe Campaign Classic v7/v8) — variants: Campaign action, Campaign v7/v8 custom action
  • Do not confuse: “Campaign action” (Adobe Campaign v7/v8 integration) ≠ other custom actions (created through the generic action creation procedure that the page links to)

FAQ:

  • Q: How is the connection between Journey Optimizer and Adobe Campaign established? — It is set up by Adobe at provisioning time; if it was not requested then, contact Adobe Journey Optimizer support and provide the Org ID, Sandbox Name, Campaign Server URL, Real-Time Server URL, and Campaign version.
  • Q: What is the message sending cap for this integration? — There is no throttling, but the system caps messages to 4,000 per 5 minutes based on the current Campaign SLA.
  • Q: Why should this integration be used only for unitary use cases? — Because there is no throttling and messages are capped to 4,000 per 5 minutes, it suits individual events rather than audiences.
  • Q: Can a Campaign action be used with an audience qualification event? — No, you cannot use a Campaign action with an audience qualification event.
  • Q: How do I update a Campaign action when the Real-Time endpoint changes? — Edit the action, update the URL field with the new RT endpoint, adjust the Payload if needed, click Test to validate the connection, then Save.
  • Q: What field carries the recipient phone number in an SMS payload? — The mobilePhoneNumber field; use this exact name, not mobilePhone or phoneNumber. An incomplete or incorrect payload can return an HTTP 400 error.

Personas:

  • developer: Can build the JSON payload for each Campaign transactional message, using the channel, eventType, recipient address (email for email, mobilePhoneNumber for SMS), and ctx fields. The page states that ctx is the payload object holding variables based on the personalization in the message. Where: “Prerequisites”.
  • admin: Can configure one action in Journey Optimizer for each Adobe Campaign template to use. The page states that the system caps messages sent over to 4,000 per 5 minutes, based on the current Campaign SLA. Where: “Guardrails and limitations”.

Onboarding:

  • Level: Intermediate
  • First minimal step: Create a new action in Journey Optimizer for the Campaign transactional message.
  • Success check: The test returns a successful response, confirming the connection to the new endpoint.
  • Previous: Learn how to create a custom action before creating a Campaign action: Get started with actions (action/action.md)
  • Next: Use the Campaign action activity available in the journey designer palette: Adobe Campaign v7/v8 actions (building-journeys/using-adobe-campaign-v7-v8.md); See an end-to-end use case for sending a message using Campaign v7/v8: Send a message using Campaign v7/v8 (building-journeys/ajo-ac.md)
recommendation-more-help
journey-optimizer-help