Trigger einer Smart Campaign in Marketo Engage mit der REST-API und Token

In diesem Tutorial erfahren Sie, wie Sie mit der REST-API den Trigger einer Smart Campaign in Marketo Engage vornehmen und die E-Mail mit „Meine Token“ personalisieren. Dieser Anwendungsfall eignet sich ideal für kundenausgelöste Benachrichtigungen wie Webinar-Erinnerungen, Onboarding-Schritte oder Follow-up nach dem Kauf.

Anwendungsfall use-case

Eine Person registriert sich über eine externe Plattform (z. B. benutzerdefinierte App, Pendo, Eventbrite) für ein Webinar. Sie möchten automatisch:

Dies kann über die REST-API und „Meine Token“ erfolgen.

Schritt 1: Erstellen der Smart-Kampagne step-one

Schritt 2: E-Mail-Inhalt definieren step-two

Erstellen oder bearbeiten Sie ein E-Mail-Asset das sowohl auf Person als auch auf Meine Token verweist.

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

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

Join here: {{my.JoinLink}}

Wenn Sie ein Token verwenden, um eine Bild-URL dynamisch einzufügen (z. B. {{my.WebinarImage}}), müssen Sie das Token in ein HTML-Bild-Tag einschließen:

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

Schritt 3: Hinzufügen von Token zum Programm step-three

Um Werte dynamisch über die API zu übergeben, müssen die Token bereits in Marketo Engage vorhanden sein. Sie müssen sie auf der Registerkarte Meine Token Ihres Programms erstellen.

Schritt 4: Festlegen von Kampagnenqualifizierungsregeln und Aktivieren der Kampagne step-four

Schritt 5: Trigger der Kampagne über die REST-API step-five

Kampagnen-ID suchen find-the-campaign-id

Um eine Smart Campaign über eine API Trigger, benötigen Sie die Kampagnen-ID:

Verwenden Sie den folgenden Endpunkt:

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

Beispiel:

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

Beispiel-Anfrageinhalt example-request-body

{
  "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/de/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}

Autorisierung authorization

Alle Marketo REST-API-Anfragen erfordern ein OAuth 2.0-Zugriffstoken.

Verwenden Sie den folgenden Endpunkt, um Ihr Zugriffs-Token abzurufen:

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

Nachdem Sie Ihr Zugriffs-Token erhalten haben, fügen Sie es als Abfrageparameter in alle API-Anfragen ein:

Authorization: Bearer YOUR_ACCESS_TOKEN

Bewährte Methoden best-practices

Zusammenfassung summary

Mit diesem Ansatz können Sie die Kommunikation mithilfe von Smart-Kampagnen personalisieren, die von externen Plattformen über die API ausgelöst werden. Dies ist für Szenarien wie Registrierungsbestätigungen für Webinare, Onboarding-E-Mails und Transaktionsbenachrichtigungen nützlich, während gleichzeitig Echtzeitdaten mithilfe von „Meine Token“ eingefügt werden.