Så här utlöser du en smart kampanj i Marketo Engage med REST API och tokens

I den här självstudiekursen får du lära dig hur du aktiverar en Smart Campaign i Marketo Engage med REST-API:t och anpassar e-postmeddelandet med Mina token. Det här användningsexemplet är idealiskt för kundutlösta meddelanden som webbinarier, introduktionssteg eller uppföljningar efter köp.

Använd skiftläge use-case

En person registrerar sig för ett webbinarium via en extern plattform (t.ex. en anpassad app, Pendo, EventBrite). Du vill automatiskt:

Detta kan göras med REST API och Mina token.

Steg 1: Skapa den smarta kampanjen step-one

Steg 2: Definiera e-postinnehållet step-two

Skapa eller redigera en e-postresurs som refererar till både person och Mina token.

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

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

Join here: {{my.JoinLink}}

Om du använder en token för att dynamiskt mata in en bild-URL (t.ex. {{my.WebinarImage}}) måste du omsluta token i en HTML-bildtagg:

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

Steg 3: Lägg till variabler i programmet step-three

Om du vill skicka värden dynamiskt via API måste tokenerna redan finnas i Marketo Engage. Du måste skapa dem på fliken Mina token i ditt program.

Steg 4: Ange regler för kampanjkvalificering och aktivera kampanj step-four

Steg 5: Trigga kampanjen via REST API step-five

Hitta kampanj-ID find-the-campaign-id

Om du vill aktivera en smart kampanj via API behöver du kampanj-ID:

Använd följande slutpunkt:

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

Exempel:

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

Exempelbegärandetext 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/sv/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}

Behörighet authorization

Alla Marketo REST API-begäranden kräver en OAuth 2.0-åtkomsttoken.

Använd följande slutpunkt för att hämta din åtkomsttoken:

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

När du har tagit emot din åtkomsttoken tar du med den som en frågeparameter i alla API-begäranden:

Authorization: Bearer YOUR_ACCESS_TOKEN

Bästa praxis best-practices

Sammanfattning summary

Med den här metoden kan ni personalisera kommunikation med smarta kampanjer som triggas från externa plattformar via API. Detta är användbart för scenarier som bekräftelser av registrering på webbinarium, e-postmeddelanden om introduktion och transaktionsmeddelanden - samtidigt som du matar in realtidsdata med Mina token.