Dokumentation Marketo Engage Marketo Engage-Tutorials

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

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Experte
Admin
Entwickler

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

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

Trigger einer Erinnerungsnachricht von Marketo Engage
Personalisieren Sie sie mit:
- Der Vorname der Person
- Webinar-Titel
- Eindeutiger Join-Link

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

Schritt 1: Erstellen der Smart-Kampagne

Gehen Sie Marketing Aktivitäten) und erstellen Sie im Ordner Programme eine neue Smart-Kampagne namens Send Webinar Reminder.
Fügen Sie auf Registerkarte Smart-Liste einen Trigger hinzu damit die Kampagne über die API aufgerufen werden kann:
- Wählen Kampagne ist angefordert als Trigger aus
- Source auf Web Service API setzen

Einrichtung des Smart List-Triggers

Schritt 2: E-Mail-Inhalt definieren

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

NOTE

Achten Sie darauf, die Token direkt in den E-Mail-Inhalt einzufügen, wie unten dargestellt.

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" />

IMPORTANT

Marketo Engage wird das nur rendern, wenn das Token in einem gültigen Bild-Tag platziert ist.

E-Mail-Editor mit Token-Nutzung

Schritt 3: Hinzufügen von Token zum Programm

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.

Navigieren Sie zur Meine Token Registerkarte Ihres übergeordneten Programms.
Ziehen Sie für dynamischen Wert ein Text-Token) aus dem rechten Bedienfeld.

{{my.WebinarTitle}} - Text-Token
{{my.JoinLink}} - Text-Token
{{my.WebinarImage}} - Text-Token (wird als src in einem <img>-Tag verwendet)

Registerkarte „Meine Token“ in Campaign

Schritt 4: Festlegen von Kampagnenqualifizierungsregeln und Aktivieren der Kampagne

Konfigurieren Sie die Qualifizierungsregeln um zu steuern, wie oft eine Person die Smart-Kampagne durchlaufen kann.
Klicken Sie nach der Konfiguration auf Aktivieren, um die Smart-Kampagne für den Empfang von API-ausgelösten Anfragen zu aktivieren.

Smart Campaign-Qualifizierungsregel

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

Kampagnen-ID suchen

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

Suchen Sie die Smart Campaign, die Sie Trigger machen möchten, und wählen Sie sie aus.
Sehen Sie sich die URL in Ihrem Browser an. Er sieht in etwa so aus: https://app-XXX.marketo.com/#/classic/SC1234A1ZN38.
Die vier Stellen nach SC ist Ihre Kampagnen-ID, im obigen Beispiel lautet die Smart-Kampagnen-ID „1234“

Verwenden Sie den folgenden Endpunkt:

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

Beispiel:

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

Beispiel-Anfrageinhalt

{
  "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"
      }
    ]
  }
}

IMPORTANT

Ersetzen Sie 1002200 im obigen Textbeispiel durch die richtige Personen-ID aus Ihrer Marketo Engage-Instanz.

Autorisierung

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

Hinzufügen von Fallback-/Standardwerten zu Ihren Token für Tests und Qualitätssicherung
{{lead.token}} für Personenfelder und {{my.token}} für dynamische Werte im Kampagnenbereich verwenden
Marketo Engage unterstützt bis zu 100 Personen pro Anfrage
Personen müssen die Kriterien der Smart-Liste erfüllen, andernfalls werden sie im Hintergrund übersprungen.

Zusammenfassung

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.

recommendation-more-help