Configurare gli elementi di rilievo del marketing

Ultimo aggiornamento: 28 agosto 2026

Creato per:

Admin

Marketing Highlights mostra l’attività live Marketo di ogni potenziale cliente, ad esempio aperture e clic via e-mail, visite Web e riempimenti di moduli. Questo articolo spiega come connettere la tua istanza di Marketo in modo che l’attività entri.

IMPORTANT

Per completare questa installazione è necessario accedere a Adobe Developer Console e a Admin in Marketo. Rivolgiti al tuo contatto Adobe e all'amministratore Marketo per completare le quattro parti seguenti.

La configurazione è costituita da quattro parti:

Parte A: creare le credenziali API in Adobe Developer Console.
Parte B: raccogliere l’endpoint Sales Qualifier e i relativi identificatori.
Parte C: configurare un webhook in Marketo Engage.
Parte D: aggiungi il webhook a un trigger Smart Campaign.

Al termine dell’installazione, gli utenti visualizzano e filtrano questa attività in base a Potenziali clienti > Marketing Highlights.

Parte A: Creare le credenziali API part-a-create-api-credentials

Queste credenziali consentono a Marketo di eseguire l’autenticazione in modo sicuro in Sales Qualifier.

Per creare le credenziali:

Vai a Adobe Developer Console e accedi con il tuo Adobe ID.
Seleziona Crea nuovo progetto o apri un progetto esistente.
Seleziona Modifica progetto, rinomina il progetto in un elemento identificabile, ad esempio Sales Qualifier Marketing Highlights, quindi seleziona Salva.
Seleziona Aggiungi API, seleziona API Experience Platform, quindi seleziona Avanti.
Scegli OAuth Server-to-Server come tipo di autenticazione, quindi seleziona Next.

Server-to-Server OAuth consente a Marketo di chiamare l’API Sales Qualifier direttamente dal server, senza richiedere a una persona di accedere.
Immettere un nome di credenziali di almeno 45 caratteri, ad esempio Sales Qualifier Marketing Highlights Creds.
Selezionare il profilo prodotto da associare, quindi selezionare Salva API configurata.
In Credenziali connesse, apri le credenziali OAuth Server-to-Server. Seleziona Recupera segreto client, quindi copia ID client e Segreto client. Questi valori vengono utilizzati nella Parte C.

WARNING

Mantieni il segreto client privato. Considerala come una password e non inviarla tramite e-mail. Utilizza il canale sicuro approvato della tua organizzazione per condividerlo con chiunque configuri il webhook.

Parte B: Raccogliere endpoint e identificatori part-b-gather-your-endpoint-and-identifiers

Sono necessari tre valori per Parte C:

URL endpoint: l’indirizzo del webhook Sales Qualifier della tua area geografica.
imsOrg ID - Identificatore dell’organizzazione nel sistema Adobe Identity Management (IMS), nel formato {ORG_ID}@AdobeOrg.
Nome sandbox - Il nome della sandbox AEP esattamente come appare nell’URL di Sales Qualifier (il valore sname), non il nome visualizzato nell’interfaccia utente. Utilizzare il valore URL minuscolo, ad esempio prod, non Prod.

Area geografica

URL endpoint webhook

America del Nord

https://5r6xakp9k3.execute-api.us-east-1.amazonaws.com/prod/external/marketo/signals

EMEA

https://pc72i8q1k3.execute-api.eu-west-1.amazonaws.com/prod/external/marketo/signals

APAC/Australia

https://5cxxxyqlai.execute-api.ap-southeast-2.amazonaws.com/prod/external/marketo/signals

Se non sei sicuro del tuo paese, ID organizzazione IMS o nome sandbox, il contatto Adobe può confermarli.

Parte C: Configurare il webhook di Marketo part-c-configure-the-marketo-webhook

Per creare il webhook:

In Marketo, selezionare Amministratore > Webhook.
Seleziona Nuovo webhook.
Imposta URL sull’URL dell’endpoint per la tua area geografica da Parte B.
Imposta Tipo di richiesta su POST.
Imposta codifica token richiesta su JSON. Questa impostazione è obbligatoria.

Incolla il modello di payload seguente in Modello. Utilizza Inserisci token di Marketo per far corrispondere i nomi dei campi nella tua istanza.

note
NOTE
Con la codifica JSON, non racchiudere i token di stringa tra virgolette. Marketo li aggiunge automaticamente.

code language-json

{
  "leadId": {{lead.Id:default=0}},
  "email": {{lead.Email Address:default=}},
  "fullName": {{lead.Full Name:default=}},
  "company": {{company.Company Name:default=}},
  "title": {{lead.Job Title:default=}},
  "department": {{lead.Department:default=}},
  "country": {{lead.Country:default=}},
  "score": {{lead.Lead Score:default=0}},
  "rating": {{lead.Lead Rating:default=}},
  "leadStatus": {{lead.Lead Status:default=}},
  "leadSource": {{lead.Lead Source:default=}},
  "isCustomer": {{lead.Is Customer:default=false}},
  "industry": {{company.Industry:default=}},
  "annualRevenue": {{company.Annual Revenue:default=0}},
  "numEmployees": {{company.Num Employees:default=0}},
  "campaignId": {{campaign.id:default=0}},
  "campaignName": {{campaign.name:default=}},
  "programName": {{program.name:default=}},
  "occurredAt": {{system.dateTime:default=}},
  "munchkinId": {{system.munchkinId:default=}},
  "triggerName": {{trigger.Trigger Name:default=}},
  "crmId": {{lead.SFDC ID:default=}},
  "crmType": {{lead.SFDC Type:default=}},
  "crmOwnerEmail": {{lead.Lead Owner Email Address:default=}},
  "crmOwnerFirstName": {{lead.Lead Owner First Name:default=}},
  "crmOwnerLastName": {{lead.Lead Owner Last Name:default=}},
  "attributes": {
    "asset": {{trigger.Name:default=}},
    "link": {{trigger.Link:default=}},
    "subject": {{trigger.Subject:default=}},
    "webPage": {{trigger.Web Page:default=}},
    "category": {{trigger.Category:default=}},
    "details": {{trigger.Details:default=}},
    "sentBy": {{trigger.Sent By:default=}},
    "receivedBy": {{trigger.Received By:default=}},
    "referrer": {{trigger.Referrer:default=}},
    "searchEngine": {{trigger.Search Engine:default=}},
    "searchQuery": {{trigger.Search Query:default=}},
    "imDescription": {{lead.Last Interesting Moment Desc:default=}},
    "imType": {{lead.Last Interesting Moment Type:default=}},
    "imDate": {{lead.Last Interesting Moment Date:default=}},
    "imSource": {{lead.Last Interesting Moment Source:default=}},
    "chatAgentName": {{trigger.Agent Name:default=}},
    "chatAgentEmail": {{trigger.Agent Email:default=}},
    "chatConversationStatus": {{trigger.Conversation Status:default=}},
    "chatConversationSummary": {{trigger.Conversation Summary:default=}},
    "chatGoalName": {{trigger.Goal name:default=}},
    "chatMeetingStatus": {{trigger.meeting status:default=}},
    "chatScheduledFor": {{trigger.Scheduled For:default=}},
    "chatDocumentName": {{trigger.Document Name:default=}},
    "chatDocumentUrl": {{trigger.Document URL:default=}},
    "chatPageUrl": {{trigger.Page URL:default=}}
  }
}

Seleziona Azioni webhook > Imposta intestazione personalizzata, quindi aggiungi le intestazioni seguenti, utilizzando i valori di Parte A e Parte B:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
Intestazione	Valore
`Content-Type`	`application/json`
`x-client-id`	ID client
`x-client-secret`	Segreto client
`x-gw-ims-org-id`	ID della tua organizzazione IMS
`x-sandbox-name`	Nome della sandbox

Seleziona Salva.

Parte D: Aggiungere il webhook a un trigger Smart Campaign part-d-add-the-webhook-to-a-trigger-smart-campaign

Aggiungi un passaggio di flusso Chiama webhook a un trigger di Smart Campaign, esistente o nuovo. I trigger dell’elenco avanzato per tale campagna determinano le attività da inviare a Sales Qualifier.

Per aggiungere il webhook:

Apri una campagna avanzata attivatore esistente o creane una nuova (Attività di marketing > Nuove > Campagna avanzata).
Nella scheda Elenco avanzato, aggiungi il trigger o i trigger per le attività che desideri inviare, ad esempio Clic sul collegamento nell’e-mail, Compila modulo o Pagina Web visite.
Nella scheda Flusso, aggiungi un passaggio Chiama webhook e seleziona il webhook creato in Parte C.
Attiva la campagna avanzata.

L’attività di tale campagna avanzata ora scorre in Sales Qualifier. I rappresentanti visualizzano e filtrano questa attività per Potenziali > Elementi di rilievo marketing.

recommendation-more-help

sales-qualifier-help