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:

  • 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

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:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping, verrà visualizzata una nuova riga di mapping sullo schermo.
    Esempio di schermata dellinterfaccia utente di Platform per aggiungere una nuova mappatura.

  2. 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à.

  3. 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:

      Esempio di schermata dellinterfaccia utente di Platform che mostra le mappature di Target.

    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:

      Esempio di schermata dellinterfaccia utente di Platform che mostra le mappature di Target.

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_1_seg
crm_2_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:

  1. Seleziona Destinazioni > Sfoglia per passare all'elenco delle destinazioni.
    Schermata dellinterfaccia utente di Platform che mostra le destinazioni di navigazione.

  2. Selezionare la destinazione e verificare che lo stato sia abilitato.
    Schermata dellinterfaccia utente di Platform che mostra lesecuzione del flusso di dati delle destinazioni.

  3. Passa alla scheda Dati attivazione, quindi seleziona un nome per il pubblico.
    Esempio di schermata dellinterfaccia utente di Platform che mostra i dati di attivazione delle destinazioni.

  4. Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio creato all’interno del segmento.
    Esempio di schermata dellinterfaccia utente di Platform che mostra il segmento.

  5. 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.

      Schermata del sistema CRM di Salesforce che mostra la pagina Contatti con i profili del segmento.

    • 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.

      Schermata del sistema CRM di Salesforce che mostra la pagina Dettagli contatto con gli stati aggiornati del pubblico.

    Utilizzo dei lead

    • Se hai selezionato Lead nel segmento Platform, passa alla pagina Apps > Leads.

      Schermata del sistema CRM di Salesforce che mostra la pagina Lead con i profili del segmento.

    • 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.

      Schermata del sistema CRM di Salesforce che mostra la pagina Dettagli lead con stati di pubblico aggiornati.

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.
    Schermata dellinterfaccia utente di Platform che mostra lerrore.

    • 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...

Risorse aggiuntive additional-resources

Ulteriori informazioni utili dal portale per sviluppatori Salesforce:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6