Connessione Salesforce CRM
Panoramica overview
Salesforce CRM è una popolare piattaforma di gestione delle relazioni con i clienti (CRM) e supporta i tipi di profili descritti di seguito:
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.
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.
(_)
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:
Di seguito è riportato un esempio di creazione di campi personalizzati in Salesforce, Passaggio 2 - Immettere i dettagli per il campo personalizzato:
- 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
, utilizzareAdobe_test_segment
otest_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.
- 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:
Username
Password
Security Token
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
Per informazioni su come ottenere questo valore dall'interfaccia Salesforce, consulta la Salesforce documentazione.
d5i000000isb4eak-dev-ed
.my.salesforce.com,come valore sarà necessario
d5i000000isb4eak-dev-ed
.Client ID
Consumer Key
.Per informazioni su come ottenere questo valore dall'interfaccia Salesforce, consulta la Salesforce documentazione.
Client Secret
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.
Identità supportate supported-identities
Salesforce CRM supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
SalesforceId
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
- 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.
- 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
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.
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
.Ad esempio, se il tuo dominio è
d5i000000isb4eak-dev-ed
.my.salesforce.com, devi fornire d5i000000isb4eak-dev-ed
come valore.Consumer Key
connessa a Salesforce.Consumer Secret
connessa a Salesforce.
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.
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
-
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
Di seguito è riportato un esempio che indica la posizione dell'Salesforce CRM ID mappatura:
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.
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.