Documentation Marketo Engage Tutoriels Marketo Engage

Déclenchement d’une campagne intelligente dans Marketo Engage à l’aide de l’API REST et de jetons

Last update: Thu Aug 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Expérimenté
Administration
Développeur

Ce tutoriel vous explique comment déclencher une campagne intelligente dans Marketo Engage à l’aide de l’API REST et personnaliser l’e-mail à l’aide de Mes jetons. Ce cas d’utilisation est idéal pour les notifications déclenchées par le client comme les rappels de webinaire, les étapes d’intégration ou les suivis après achat.

Cas d’utilisation

Une personne s’inscrit à un webinaire par le biais d’une plateforme externe (par exemple, une application personnalisée, Pendo, Eventbrite). Vous souhaitez effectuer automatiquement les opérations suivantes :

Déclencher un e-mail de rappel depuis Marketo Engage
Personnalisez-le avec :
- Prénom de la personne
- Titre du webinaire
- Un lien de jointure unique

Vous pouvez le faire à l’aide de l’API REST et de Mes jetons.

Étape 1 : créer la campagne intelligente

Accédez à Activités marketing, puis dans votre dossier Programmes, créez une Campagne intelligente appelée Send Webinar Reminder.
Dans l'onglet Smart List , ajoutez un déclencheur pour permettre l'appel de la campagne via l'API :
- Sélectionnez Campagne demandée comme déclencheur
- Définir le Source sur Web Service API

Configuration du déclencheur de liste dynamique

Étape 2 : définir le contenu de l’e-mail

Créez ou modifiez une ressource e-mail qui fait référence à la fois à la personne et à Mes jetons.

NOTE

Veillez à insérer les jetons directement dans le contenu de l’e-mail, comme illustré ci-dessous.

Hi {{lead.First Name:default=Customer}}

You're registered for **{{my.WebinarTitle}}**.

Join here: {{my.JoinLink}}

Si vous utilisez un jeton pour injecter dynamiquement une URL d’image (par exemple, {{my.WebinarImage}}), vous devez encapsuler le jeton dans une balise d’image HTML :

<img src="{{my.WebinarImage}}" alt="Webinar banner" />

IMPORTANT

Marketo Enagage ne rendra pas’image à moins que le jeton ne soit placé dans une balise d’image valide.

Éditeur d’e-mail affichant l’utilisation des jetons

Étape 3 : ajouter des jetons au programme

Pour transmettre des valeurs de manière dynamique via l’API, les jetons doivent déjà exister dans Marketo Engage. Vous devrez les créer sous l’onglet Mes jetons de votre programme.

Accédez à l’onglet Mes jetons de votre programme parent.
Faites glisser un jeton de texte depuis le panneau de droite pour chaque valeur dynamique.

{{my.WebinarTitle}} - Jeton de texte
{{my.JoinLink}} - Jeton de texte
{{my.WebinarImage}} - Jeton de texte (il sera utilisé comme src dans une balise <img>)

Onglet Mes jetons dans la campagne

Étape 4 : définir les règles de qualification de la campagne et activer la campagne

Configurez les règles de qualification pour contrôler la fréquence à laquelle une personne peut exécuter la campagne intelligente.
Une fois la configuration terminée, cliquez sur Activer pour permettre à la campagne intelligente de recevoir les requêtes déclenchées par l’API.

Règle de qualification de campagne intelligente

Étape 5 : déclencher la campagne via l’API REST

Trouver l’identifiant de la campagne

Pour déclencher une campagne dynamique à l’aide de l’API, vous devez disposer de l’identifiant campaign :

Recherchez et sélectionnez la campagne intelligente à déclencher.
Examinez l’URL dans votre navigateur. Il ressemblera à ceci : https://app-XXX.marketo.com/#/classic/SC1234A1ZN38.
Les 4 chiffres après SC représentent votre identifiant de campagne. Dans l’exemple ci-dessus, l’identifiant de campagne intelligente est « 1234 »

Utilisez le point d’entrée suivant :

POST /rest/v1/campaigns/{campaignId}/trigger.json

Exemple :

POST /rest/v1/campaigns/1234/trigger.json

Exemple de corps de requête

{
  "input": {
    "leads": [
      {
        "id": 1002200
      }
    ],
    "tokens": [
      {
        "name": "{{my.WebinarTitle}}",
        "value": "Scaling Customer Engagement in 2025"
      },
      {
        "name": "{{my.JoinLink}}",
        "value": "https://webinars.company.com/join/abc123"
      },
      {
        "name": "{{my.WebinarImage}}",
        "value": "https://experienceleague.adobe.com/fr/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}

IMPORTANT

Remplacez 1002200 dans l’exemple de corps ci-dessus par l’ID de personne correct de votre instance Marketo Engage.

Autorisation

Toutes les requêtes d’API REST Marketo nécessitent un jeton d’accès OAuth 2.0.

Pour récupérer votre jeton d’accès, utilisez le point d’entrée suivant :

GET /identity/oauth/token?grant_type=client_credentials&client_id=XXX&client_secret=YYY

Une fois que vous avez reçu votre jeton d’accès, incluez-le en tant que paramètre de requête dans toutes les requêtes API :

Authorization: Bearer YOUR_ACCESS_TOKEN

Meilleures pratiques

Ajoutez des valeurs de secours/par défaut à vos jetons pour le test et l’assurance qualité.
Utiliser des {{lead.token}} pour les champs de personne et des {{my.token}} pour les valeurs dynamiques de la campagne
Marketo Engage prend en charge jusqu’à 100 personnes par demande
Les personnes doivent répondre aux critères de la liste dynamique, sinon elles sont silencieusement ignorées.

Résumé

Grâce à cette approche, vous pouvez personnaliser les communications à l’aide de campagnes intelligentes déclenchées à partir de plateformes externes via l’API. Cela s’avère utile pour des scénarios tels que les confirmations d’enregistrement à un webinaire, les e-mails d’intégration et les notifications transactionnelles, tout en injectant des données en temps réel à l’aide de Mes jetons.

recommendation-more-help