Documentazione Marketo Engage Tutorial su Marketo Engage

Come attivare una campagna avanzata in Marketo Engage utilizzando l’API REST e i token

Ultimo aggiornamento: 5 maggio 2025

Argomenti:

Creato per:

Esperto
Amministratore
Sviluppatore

Questo tutorial illustra come attivare una campagna avanzata in Marketo Engage utilizzando l’API REST e personalizzare l’e-mail utilizzando I miei token. Questo caso d’uso è ideale per le notifiche attivate dai clienti, ad esempio i promemoria dei webinar, i passaggi di onboarding o i follow-up successivi all’acquisto.

Caso di utilizzo

Una persona si registra per un webinar tramite una piattaforma esterna (ad esempio, app personalizzata, Pendo, Eventbrite). Si desidera eseguire automaticamente le operazioni seguenti:

Attivare un messaggio e-mail di promemoria da Marketo Engage
Personalizzalo con:
- Nome della persona
- Titolo webinar
- Un collegamento di unione univoco

Questa operazione può essere eseguita utilizzando l’API REST e I miei token.

Passaggio 1: creare la campagna avanzata

Vai a Attività di marketing e crea nella cartella Programmi una nuova Campagna avanzata denominata Send Webinar Reminder.
Nella scheda Elenco avanzato, aggiungi un trigger per consentire la chiamata della campagna tramite l'API:
- Seleziona La campagna è richiesta come attivatore
- Imposta Source su Web Service API

Configurazione trigger elenco avanzato

Passaggio 2: definire il contenuto dell’e-mail

Crea o modifica una risorsa e-mail che fa riferimento sia a Persona che a I miei token.

NOTE

Assicurati di inserire i token direttamente nel contenuto dell’e-mail, come mostrato di seguito.

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

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

Join here: {{my.JoinLink}}

Se utilizzi un token per inserire dinamicamente un URL immagine (ad esempio, {{my.WebinarImage}}), devi racchiudere il token in un tag immagine HTML:

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

IMPORTANT

Marketo Enagage non eseguirà il rendering dell'immagine a meno che il token non venga inserito all'interno di un tag immagine valido.

Leditor di posta elettronica mostra lutilizzo del token

Passaggio 3: aggiungere token al programma

Per trasmettere i valori in modo dinamico tramite API, i token devono già esistere in Marketo Engage. Devi crearli nella scheda I miei token del programma.

Vai alla scheda I miei token del programma principale.
Trascina un Token di testo dal pannello a destra per ogni valore dinamico.

{{my.WebinarTitle}} - Token di testo
{{my.JoinLink}} - Token di testo
{{my.WebinarImage}} - Token di testo (verrà utilizzato come src in un tag <img>)

Scheda I miei token nella campagna

Passaggio 4: impostare le regole di qualificazione della campagna e attivare la campagna

Configura le regole di qualificazione per controllare la frequenza con cui una persona può eseguire Smart Campaign.
Una volta configurata, fai clic su Attiva per abilitare Smart Campaign a ricevere richieste attivate da API.

Regola di qualificazione per Smart Campaign

Passaggio 5: attivare la campagna tramite API REST

Trovare l’ID campagna

Per attivare una campagna avanzata tramite API, è necessario l'ID campagna:

Trova e seleziona la campagna avanzata da attivare.
Osserva l’URL nel browser. Si presenterà così: https://app-XXX.marketo.com/#/classic/SC1234A1ZN38.
Le 4 cifre dopo SC sono l'ID della tua campagna; nell'esempio precedente l'ID della campagna avanzata è '1234'

Utilizza il seguente endpoint:

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

Esempio:

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

Esempio di corpo della richiesta

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

IMPORTANT

Sostituisci 1002200 nell'esempio di corpo di cui sopra con l'ID persona corretto dalla tua istanza di Marketo Engage.

Authorization

Tutte le richieste API REST di Marketo richiedono un token di accesso OAuth 2.0.

Per recuperare il token di accesso, utilizza il seguente endpoint:

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

Una volta ricevuto il token di accesso, includilo come parametro query in tutte le richieste API:

Authorization: Bearer YOUR_ACCESS_TOKEN

Best practice

Aggiungi valori di fallback/predefiniti ai token per il test e il controllo qualità
Usa {{lead.token}} per i campi persona e {{my.token}} per i valori dinamici con ambito campagna
Marketo Engage supporta fino a 100 persone per richiesta
Le persone devono soddisfare i criteri dell’elenco avanzato, altrimenti vengono ignorate automaticamente

Riepilogo

Con questo approccio, puoi personalizzare le comunicazioni utilizzando campagne intelligenti attivate da piattaforme esterne tramite API. È utile per scenari come le conferme di registrazione ai webinar, le e-mail di onboarding e le notifiche transazionali, il tutto mentre si inseriscono dati in tempo reale utilizzando I miei token.

recommendation-more-help