Documentazione Experience Platform Guida alle destinazioni

Connessione Salesforce CRM

Last update: Tue Nov 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Destinazioni

Creato per:

Amministratore
Utente

Panoramica overview

Salesforce CRM è una popolare piattaforma di gestione delle relazioni con i clienti (CRM) e supporta i tipi di profili descritti di seguito:

Lead - Un lead è il nome di una persona o di un'azienda che potrebbe essere interessata ai prodotti o ai servizi venduti.
Contatti - Un contatto è una persona con cui uno dei tuoi rappresentanti ha stabilito una relazione ed è stato qualificato come potenziale cliente.

Questa Adobe Experience Platform destinazione sfrutta Salesforce composite API, che supporta entrambi i tipi di profili descritti in precedenza.

Quando attivi segmenti, puoi selezionare lead o contatti e aggiornare attributi e dati sul pubblico in Salesforce CRM.

Salesforce CRM utilizza OAuth 2 con concessione password come meccanismo di autenticazione per comunicare con l'API REST di Salesforce. Le istruzioni per l'autenticazione nell'istanza Salesforce CRM sono riportate di seguito, nella sezione Autentica nella destinazione.

Casi d’uso use-cases

In qualità di addetto al marketing, puoi fornire esperienze personalizzate ai tuoi utenti, in base agli attributi dei loro profili Adobe Experience Platform. Puoi creare tipi di pubblico dai dati offline e inviarli a Salesforce CRM per aggiornare l’iscrizione a CRM non appena tipi di pubblico e profili vengono aggiornati in Adobe Experience Platform.

Prerequisiti prerequisites

Prerequisiti in Experience Platform prerequisites-in-experience-platform

Prima di attivare i dati nella destinazione di Salesforce CRM, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.

Prerequisiti in Salesforce CRM prerequisites-destination

Per esportare i dati da Experience Platform al tuo account Salesforce, tieni presente i seguenti prerequisiti in Salesforce CRM:

Devi avere un account Salesforce prerequisites-account

Vai alla pagina Salesforce prova per registrarti e creare un account Salesforce, se non ne hai già uno.

Configurare un'app connessa in Salesforce prerequisites-connected-app

Devi innanzitutto configurare un'app Salesforce connessa nel tuo account Salesforce, se non ne hai già una. Salesforce CRM sfrutterà l'app connessa per connettersi a Salesforce.

Quindi, abilitare OAuth Settings for API Integration per Salesforce connected app. Consulta la documentazione di Salesforce per maggiori informazioni.

Inoltre, assicurati che ambiti menzionati di seguito siano selezionati per Salesforce connected app.

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

Infine, assicurati che la sovvenzione password sia abilitata nel tuo account Salesforce. Per informazioni sugli scenari specialiSalesforce, consulta la documentazione Flusso nome utente-password OAuth 2.0.

IMPORTANT

Se l'amministratore dell'account Salesforce ha limitato l'accesso agli intervalli IP attendibili, è necessario contattarli per inserire nell'elenco Consentiti gli IP di Experience Platform. Se hai bisogno di ulteriori indicazioni, consulta la documentazione Salesforce Limita l'accesso agli intervalli IP attendibili per un'app connessa.

Crea campi personalizzati in Salesforce prerequisites-custom-field

Quando si attivano i tipi di pubblico nella destinazione Salesforce CRM, è necessario immettere un valore nel campo Mapping ID per ogni pubblico attivato, nel passaggio Pianificazione pubblico.

Salesforce CRM richiede questo valore per leggere e interpretare correttamente i tipi di pubblico provenienti da Experience Platform e per aggiornare il loro stato di pubblico entro Salesforce. Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione di Experience Platform per il gruppo di campi dello schema Dettagli sull'iscrizione al pubblico.

Per ogni pubblico che si attiva da Experience Platform a Salesforce CRM, è necessario creare un campo personalizzato di tipo Text Area (Long) entro Salesforce. Puoi definire la lunghezza del carattere di campo di qualsiasi dimensione compresa tra 256 e 131.072 caratteri in base alle tue esigenze aziendali. Per ulteriori informazioni sui tipi di campi personalizzati, vedere la pagina della documentazione Salesforce Tipi di campi personalizzati. Consulta anche la documentazione di Salesforce per creare campi personalizzati in caso di assistenza nella creazione dei campi.

IMPORTANT

Non includere spazi nel nome del campo. Utilizzare invece il carattere di sottolineatura (_) come separatore.
In Salesforce è necessario creare campi personalizzati con un Field Name che corrisponda esattamente al valore specificato in Mapping ID per ogni segmento Experience Platform attivato. Ad esempio, la schermata seguente mostra un campo personalizzato denominato crm_2_seg. Quando si attiva un pubblico in questa destinazione, aggiungere crm_2_seg come Mapping ID per popolare i tipi di pubblico da Experience Platform in questo campo personalizzato.

Di seguito è riportato un esempio di creazione di campi personalizzati in Salesforce, Passaggio 1 - Seleziona il tipo di dati:
Schermata dellinterfaccia utente di Salesforce che mostra la creazione di campi personalizzati, passaggio 1 - Selezionare il tipo di dati.

Di seguito è riportato un esempio di creazione di campi personalizzati in Salesforce, Passaggio 2 - Immettere i dettagli per il campo personalizzato:
Schermata dellinterfaccia utente di Salesforce che mostra la creazione di campi personalizzati, passaggio 2 - Immetti i dettagli per il campo personalizzato.

TIP

Per distinguere tra i campi personalizzati utilizzati per i tipi di pubblico di Experience Platform e altri campi personalizzati all'interno di Salesforce, è possibile includere un prefisso o un suffisso riconoscibile durante la creazione del campo personalizzato. Ad esempio, invece di test_segment, utilizzare Adobe_test_segment o test_segment_Adobe
Se in Salesforce sono già stati creati altri campi personalizzati, è possibile utilizzare lo stesso nome del segmento Experience Platform per identificare facilmente il pubblico in Salesforce.

NOTE

Gli oggetti in Salesforce sono limitati a 25 campi esterni. Vedere Attributi di campo personalizzati.
Questa restrizione implica che puoi avere solo un massimo di 25 iscrizioni di pubblico Experience Platform attive in qualsiasi momento.
Se hai raggiunto questo limite in Salesforce, prima di poter utilizzare un nuovo Mapping ID devi rimuovere da Salesforce gli attributi personalizzati utilizzati per memorizzare lo stato del pubblico rispetto ai tipi di pubblico meno recenti in Experience Platform.

Raccogli Salesforce CRM credenziali gather-credentials

Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione Salesforce CRM:

Credenziali

Descrizione

Esempio

Username

Nome utente dell'account Salesforce.

Password

Password dell'account Salesforce.

Security Token

Il token di sicurezza Salesforce che verrà in seguito aggiunto alla fine della password Salesforce per creare una stringa concatenata da utilizzare come Password durante l'autenticazione alla destinazione.
Consulta la documentazione di Salesforce per reimpostare il token di sicurezza per scoprire come rigenerarlo dall'interfaccia di Salesforce se non disponi del token di sicurezza.

Custom Domain

Il prefisso del dominio Salesforce.
Per informazioni su come ottenere questo valore dall'interfaccia Salesforce , consulta la documentazioneSalesforce.

Se il dominio Salesforce è
d5i000000isb4eak-dev-ed.my.salesforce.com,
come valore sarà necessario d5i000000isb4eak-dev-ed.

Client ID

Salesforce Consumer Key.
Per informazioni su come ottenere questo valore dall'interfaccia Salesforce , consulta la documentazioneSalesforce.

Client Secret

Salesforce Consumer Secret.
Per informazioni su come ottenere questo valore dall'interfaccia Salesforce , consulta la documentazioneSalesforce.

Guardrail guardrails

Salesforce bilancia i carichi delle transazioni imponendo limiti di richiesta, frequenza e timeout. Per ulteriori informazioni, consulta Limiti di richieste e allocazioni API.

Se l'amministratore dell'account Salesforce ha applicato restrizioni IP, sarà necessario aggiungere indirizzi IP Experience Platform agli intervalli IP attendibili degli account Salesforce. Se hai bisogno di ulteriori indicazioni, consulta la documentazione Salesforce Limita l'accesso agli intervalli IP attendibili per un'app connessa.

IMPORTANT

Quando si attivano i segmenti è necessario selezionare tra i tipi Contatto o Lead. Assicurati che i tipi di pubblico dispongano della mappatura dei dati appropriata in base al tipo selezionato.

Identità supportate supported-identities

Salesforce CRM supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione

Descrizione

Considerazioni

SalesforceId

L'identificatore Salesforce CRM per le identità di contatto o lead esportate o aggiornate tramite il segmento.

Obbligatorio

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento

Tipo

Note

Tipo di esportazione

Profile-based

Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
Ogni stato del pubblico in Salesforce CRM viene aggiornato con lo stato del pubblico corrispondente da Experience Platform, in base al valore Mapping ID fornito durante il passaggio pianificazione del pubblico.

Frequenza di esportazione

Streaming

Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT

Per connettersi alla destinazione, sono necessarie le View Destinations e le Manage Destinations autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.

Entro Destinations > Catalog, cerca Salesforce CRM. In alternativa, è possibile individuarlo nella categoria CRM.

Autenticarsi nella destinazione authenticate

Per eseguire l'autenticazione nella destinazione, compilare i campi obbligatori e selezionare Connect to destination. Per ulteriori informazioni, consulta la sezione Raccogli Salesforce CRM credenziali.

Credenziali

Descrizione

Username

Nome utente dell'account Salesforce.

Password

Stringa concatenata composta dalla password dell'account Salesforce a cui è stato aggiunto il token di sicurezza Salesforce.
Il valore concatenato è {PASSWORD}{TOKEN}.
Nota: non utilizzare parentesi graffe o spazi.
Ad esempio, se la password Salesforce è MyPa$$w0rd123 e il token di sicurezza Salesforce è TOKEN12345....0000, il valore concatenato che utilizzerai nel campo Password è MyPa$$w0rd123TOKEN12345....0000.

Custom Domain

Il prefisso del dominio Salesforce.
Ad esempio, se il tuo dominio è d5i000000isb4eak-dev-ed.my.salesforce.com, devi fornire d5i000000isb4eak-dev-ed come valore.

Client ID

L'app Salesforce connessa a Consumer Key.

Client Secret

L'app Salesforce connessa a Consumer Secret.

Schermata dellinterfaccia utente di Experience Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connected con un segno di spunta verde. È quindi possibile procedere al passaggio successivo.

Inserire i dettagli della destinazione destination-details

Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.

Name: nome con cui riconoscerai questa destinazione in futuro.
Description: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
Salesforce ID Type:
- Selezionare Contact se le identità da esportare o aggiornare sono di tipo Contatto.
- Selezionare Lead se le identità da esportare o aggiornare sono di tipo Lead.

Schermata dellinterfaccia utente di Experience Platform con i dettagli della destinazione.

Abilita avvisi enable-alerts

Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.

Dopo aver fornito i dettagli della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Per attivare i dati, sono necessarie le View Destinations, Activate Destinations, View Profiles e View Segments autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
Per esportare identità, è necessario disporre dell'autorizzazione View Identity Graph per il controllo degli accessi.
{width="100" modal="regular"}

Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.

Considerazioni sulla mappatura ed esempio mapping-considerations-example

Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione Salesforce CRM, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Experience Platform e i corrispondenti equivalenti dalla destinazione.

Gli attributi specificati in Target field devono essere denominati esattamente come descritto nella tabella dei mapping degli attributi, in quanto tali attributi formeranno il corpo della richiesta.

Gli attributi specificati in Source field non seguono alcuna restrizione di questo tipo. Puoi mapparlo in base alle tue esigenze, ma assicurati che il formato dei dati di input sia valido in base alla Salesforce documentazione. Se i dati di input non sono validi, la chiamata di aggiornamento a Salesforce non riuscirà e i contatti/lead non verranno aggiornati.

Per mappare correttamente i campi XDM ai campi di destinazione (API) Salesforce CRM, effettua le seguenti operazioni:

Nel passaggio Mapping, seleziona Add new mapping, verrà visualizzata una nuova riga di mappatura sullo schermo.
Nella finestra Select source field, scegli la categoria Select attributes e seleziona l'attributo XDM oppure scegli Select identity namespace e seleziona un'identità.

Nella finestra Select target field, scegli Select identity namespace e seleziona un'identità oppure scegli la categoria Select custom attributes e seleziona un attributo o definiscine uno utilizzando il campo Attribute name come necessario. Per informazioni sugli attributi supportati, consulta la Salesforce CRM documentazione.

Ripeti questi passaggi per aggiungere le seguenti mappature tra lo schema del profilo XDM e (API) Salesforce CRM:

Utilizzo dei contatti

Se lavori con Contatti all'interno del segmento, fai riferimento al Riferimento agli oggetti in Salesforce per Contatto per definire i mapping per i campi da aggiornare.
Puoi identificare i campi obbligatori cercando la parola Obbligatorio, indicata nelle descrizioni dei campi nel collegamento precedente.

A seconda dei campi che desideri esportare o aggiornare, aggiungi mappature tra lo schema del profilo XDM e (API) Salesforce CRM:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Campo origine	Campo di destinazione	Note
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Cognome del contatto fino a 80 caratteri.
`xdm: person.name.firstName`	`Attribute: FirstName`	Il nome del contatto può contenere un massimo di 40 caratteri.
`xdm: personalEmail.address`	`Attribute: Email`	L’indirizzo e-mail del contatto.

Di seguito è riportato un esempio che utilizza queste mappature:

Utilizzo dei lead

Se lavori con Lead all'interno del segmento, fai riferimento al Riferimento agli oggetti in Salesforce per Lead per definire i mapping per i campi da aggiornare.
Puoi identificare i campi obbligatori cercando la parola Obbligatorio, indicata nelle descrizioni dei campi nel collegamento precedente.

A seconda dei campi che desideri esportare o aggiornare, aggiungi mappature tra lo schema del profilo XDM e (API) Salesforce CRM:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Campo origine	Campo di destinazione	Note
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Cognome della sequenza fino a 80 caratteri.
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`. L'azienda del lead.
`xdm: personalEmail.address`	`Attribute: Email`	Indirizzo e-mail del lead.

Di seguito è riportato un esempio che utilizza queste mappature:

Dopo aver fornito i mapping per la connessione di destinazione, selezionare Next.

Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example

Durante l'esecuzione del passaggio Pianifica esportazione pubblico è necessario mappare manualmente i tipi di pubblico attivati da Experience Platform al campo personalizzato corrispondente in Salesforce.

A questo scopo, selezionare ogni segmento, quindi immettere il nome del campo personalizzato da Salesforce nel campo Salesforce CRM Mapping ID. Consulta la sezione Creare campi personalizzati all'interno di Salesforce per indicazioni e best practice sulla creazione di campi personalizzati in Salesforce.

Ad esempio, se il campo personalizzato Salesforce è crm_2_seg, specifica questo valore in Salesforce CRM Mapping ID per popolare i tipi di pubblico da Experience Platform in questo campo personalizzato.

Di seguito è riportato un esempio di campo personalizzato da Salesforce:
Schermata dell'interfaccia utente Salesforce che mostra il campo personalizzato.

Di seguito è riportato un esempio che indica la posizione di Salesforce CRM Mapping ID:
Esempio di schermata dellinterfaccia utente di Experience Platform che mostra lesportazione pianificata del pubblico.

Come mostrato sopra, Salesforce Field Name corrisponde esattamente al valore specificato in Salesforce CRM Mapping ID.

A seconda del caso d'uso, tutti i tipi di pubblico attivati possono essere mappati allo stesso campo personalizzato Salesforce o a Field Name diversi in Salesforce CRM. Un esempio tipico basato sull’immagine mostrata sopra potrebbe essere.

Nome segmento Salesforce CRM

Salesforce Field Name

Salesforce CRM Mapping ID

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

Ripeti questa sezione per ogni segmento di Experience Platform attivato.

Convalidare l’esportazione dei dati exported-data

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

Selezionare Destinations > Browse per passare all'elenco delle destinazioni.
Selezionare la destinazione e verificare che lo stato sia enabled.
Passa alla scheda Activation data, quindi seleziona un nome di pubblico.
Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio creato all’interno del segmento.
Infine, accedi al sito web Salesforce e verifica se i profili del pubblico sono stati aggiornati.

Utilizzo dei contatti
- Se hai selezionato Contatti all'interno del segmento Experience Platform, passa alla pagina Apps > Contacts.
- Seleziona un Contatto e verifica se i campi sono aggiornati. È possibile vedere che ogni stato del pubblico in Salesforce CRM è stato aggiornato con lo stato del pubblico corrispondente da Experience Platform, in base al valore Mapping ID fornito durante la pianificazione del pubblico.
Utilizzo dei lead
- Se hai selezionato Lead nel segmento Experience Platform, passa alla pagina Apps > Leads.
- Seleziona un lead e controlla se i campi sono aggiornati. È possibile vedere che ogni stato del pubblico in Salesforce CRM è stato aggiornato con lo stato del pubblico corrispondente da Experience Platform, in base al valore Mapping ID fornito durante la pianificazione del pubblico.

Utilizzo dei dati e governance data-usage-governance

Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.

Errori e risoluzione problemi errors-and-troubleshooting

Sono stati riscontrati errori sconosciuti durante la trasmissione degli eventi alla destinazione unknown-errors

Durante il controllo di un'esecuzione del flusso di dati, è possibile che venga visualizzato il seguente messaggio di errore: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- Per correggere questo errore, verificare che Mapping ID fornito nel flusso di lavoro di attivazione alla destinazione Salesforce CRM corrisponda esattamente al valore del tipo di campo personalizzato creato in Salesforce. Consulta la sezione Creare campi personalizzati all'interno di Salesforce.
Quando si attiva un segmento, è possibile che venga visualizzato un messaggio di errore: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- Per risolvere l'errore, contattare l'amministratore dell'account Salesforce per aggiungere indirizzi IP Experience Platform agli intervalli IP attendibili degli account Salesforce. Se hai bisogno di ulteriori indicazioni, consulta la documentazione Salesforce Limita l'accesso agli intervalli IP attendibili per un'app connessa.

Risorse aggiuntive additional-resources

Ulteriori informazioni utili dal portale per sviluppatori di Salesforce:

Guida introduttiva
Crea un record
Tipi di pubblico per consigli personalizzati
Utilizzo di risorse composite
Questa destinazione sfrutta l'API Upsert Multiple Records invece della chiamata API Upsert Single Record.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6