Een slimme campagne activeren in Marketo Engage met de REST API en tokens

In deze zelfstudie wordt uitgelegd hoe u een slimme campagne in Marketo Engage kunt activeren met behulp van de REST API en de e-mail kunt aanpassen met Mijn tokens. Dit gebruiksgeval is ideaal voor door de klant geïnitieerde meldingen zoals webinar-herinneringen, instapstappen of follow-ups na aankoop.

Hoofdletters gebruiken use-case

Een persoon registreert zich voor een webinar door een extern platform (b.v., douane app, Pendo, Eventbrite). U wilt automatisch:

Dit kan worden gedaan gebruikend REST API en Mijn Tokens.

Stap 1: De slimme campagne maken step-one

Stap 2: De e-mailinhoud definiëren step-two

Creeer of geef een ​ e-mailactiva ​ uit die verwijzingen zowel Persoon als ​ Mijn Tokens ​.

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

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

Join here: {{my.JoinLink}}

Als u een token gebruikt om een afbeeldings-URL dynamisch te injecteren (bijvoorbeeld {{my.WebinarImage}}), moet u het token opnemen in een HTML-afbeeldingstag:

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

Stap 3: Tokens toevoegen aan het programma step-three

Als u waarden dynamisch wilt doorgeven via API, moeten de tokens al bestaan in Marketo Engage. U zult hen onder moeten creëren Mijn Tokens lusje van uw Programma.

Stap 4: Stel kwalificatieregels voor de campagne in en activeer de campagne step-four

Stap 5: Trigger de campagne via REST API step-five

Campagne-id zoeken find-the-campaign-id

Om een Slimme Campagne via API teweeg te brengen, zult u campagne identiteitskaart nodig hebben:

Gebruik het volgende eindpunt:

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

Voorbeeld:

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

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

Toestemming authorization

Voor alle Marketo REST API-aanvragen is een OAuth 2.0-toegangstoken vereist.

Om uw toegangstoken terug te winnen, gebruik het volgende eindpunt:

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

Zodra u uw toegangstoken ontvangt, omvat het als a vraagparameter in alle API verzoeken:

Authorization: Bearer YOUR_ACCESS_TOKEN

Aanbevolen procedures best-practices

Samenvatting summary

Met deze benadering, kunt u mededelingen personaliseren gebruikend Slimme Campagnes die van externe platforms via API worden teweeggebracht. Dit is handig voor scenario's zoals bevestigingen van webinar-registratie, e-mails aan boord gaan en transactionele meldingen. Dit is allemaal handig voor het injecteren van real-time gegevens met My Tokens.