Documentazione Experience Platform Guida alle destinazioni

Connessione Salesforce CRM

Last update: Thu Jul 18 2024 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 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 gestione delle relazioni con i clienti di Salesforce, è 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 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 speciali🔗, consulta la documentazione Salesforce 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 IP Experienci 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 ID mappatura 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 dell'Experience Platform per il gruppo di campi Dettagli appartenenza pubblico.

Per ogni pubblico che si attiva da 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 Nome campo che corrisponda esattamente al valore specificato in ID mappatura per ogni segmento di Platform attivato. Ad esempio, la schermata seguente mostra un campo personalizzato denominato crm_2_seg. Quando attivi un pubblico in questa destinazione, aggiungi crm_2_seg come ID mappatura 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 - Seleziona 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 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 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 è possibile 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 ID mappatura devi rimuovere da Salesforce gli attributi personalizzati utilizzati per memorizzare lo stato del pubblico rispetto ai tipi di pubblico precedenti 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 Salesforce documentazione.

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 Salesforce documentazione.

Client Secret

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

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 Experienci 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

Basato su profilo

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 Platform, in base al valore ID mappatura 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 Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. 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.

All'interno di Destinazioni > Catalogo, 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 Connetti alla destinazione. Per ulteriori informazioni, consulta la sezione Raccogli Salesforce CRM credenziali.

Credenziali

Descrizione

Nome utente

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.

Dominio personalizzato

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

ID client

L'app Consumer Key connessa a Salesforce.

Segreto client

L'app Consumer Secret connessa a Salesforce.

Schermata dellinterfaccia utente di Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. Sarà 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.

Nome: un nome con cui riconoscerai questa destinazione in futuro.
Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
Tipo ID Salesforce:
- Selezionare Contatto se le identità che si desidera esportare o aggiornare sono di tipo Contatto.
- Selezionare Lead se le identità che si desidera esportare o aggiornare sono di tipo Lead.

Schermata dellinterfaccia utente di Platform che mostra 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 per la connessione di destinazione, seleziona Avanti.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti 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 Visualizza grafo identità Controllo di accesso.
{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 Platform e i corrispondenti equivalenti dalla destinazione.

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

Gli attributi specificati nel campo Source 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 Aggiungi nuovo mapping, verrà visualizzata una nuova riga di mapping sullo schermo.
Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM oppure scegli lo spazio dei nomi Seleziona identità e seleziona un'identità.

Nella finestra Seleziona campo di destinazione, scegli Seleziona spazio dei nomi identità e seleziona un'identità oppure scegli Seleziona attributi personalizzati categoria e seleziona un attributo o definiscine uno utilizzando il campo Nome attributo, in base alle esigenze. 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 le mappature 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 le mappature per la connessione di destinazione, seleziona Avanti.

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 Platform al relativo campo personalizzato in Salesforce.

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

Se ad esempio il campo personalizzato Salesforce è crm_2_seg, specificare questo valore in Salesforce CRM ID mappatura 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 dell'Salesforce CRM ID mappatura:
Esempio di schermata dellinterfaccia utente di Platform che mostra lesportazione pianificata del pubblico.

Come mostrato sopra il Salesforce Nome campo corrisponde esattamente al valore specificato in Salesforce CRM ID mappatura.

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

Nome segmento Salesforce CRM

Salesforce Nome Campo

Salesforce CRM ID mappatura

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

Ripeti questa sezione per ogni segmento di Platform attivato.

Convalidare l’esportazione dei dati exported-data

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

Seleziona Destinazioni > Sfoglia per passare all'elenco delle destinazioni.
Selezionare la destinazione e verificare che lo stato sia abilitato.
Passa alla scheda Dati attivazione, quindi seleziona un nome per il 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 aggiunti o aggiornati.

Utilizzo dei contatti
- Se hai selezionato Contatti nel segmento 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 Platform, in base al valore ID mappatura fornito durante la pianificazione del pubblico.
Utilizzo dei lead
- Se hai selezionato Lead nel segmento 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 Platform, in base al valore ID mappatura 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 l'ID Mapping 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 Experienci 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 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