Connessione (API) Salesforce Marketing Cloud
Panoramica overview
(API) Salesforce Marketing Cloud (precedentemente noto come ExactTarget) è una suite di marketing digitale che consente di creare e personalizzare percorsi per i visitatori e i clienti per personalizzare la propria esperienza.
Rispetto a Salesforce Marketing Cloud Account Engagement, più orientato al marketing B2B, la destinazione (API) Salesforce Marketing Cloud è ideale per i casi d'uso B2C con cicli decisionali transazionali più brevi. È possibile consolidare set di dati più grandi che rappresentano il comportamento del pubblico di destinazione per regolare e migliorare le campagne di marketing assegnando priorità e segmentando i contatti, in particolare dai set di dati esterni a Salesforce. Nota: l'Experience Platform dispone anche di una connessione per Salesforce Marketing Cloud Account Engagement.
Questa Adobe Experience Platform destinazione utilizza l'API Salesforce Marketing Cloud aggiorna contatti, che ti consente di aggiungere contatti e aggiornare i dati dei contatti per le tue esigenze aziendali dopo averli attivati in un nuovo segmento Salesforce Marketing Cloud.
Salesforce Marketing Cloud utilizza OAuth 2 con credenziali client come meccanismo di autenticazione per comunicare con l'API Salesforce Marketing Cloud. Le istruzioni per l'autenticazione nell'istanza Salesforce Marketing Cloud sono riportate di seguito, nella sezione Autentica nella destinazione.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione (API) Salesforce Marketing Cloud, ecco un esempio di caso d'uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa destinazione.
Invia e-mail ai contatti per campagne di marketing use-case-send-emails
Il reparto vendite di una piattaforma di noleggio a domicilio desidera inviare un’e-mail di marketing a un pubblico di clienti mirato. Il team marketing della piattaforma può aggiungere nuovi contatti/aggiornare i contatti esistenti (e i relativi indirizzi e-mail) tramite Adobe Experience Platform, creare tipi di pubblico dai propri dati offline e inviare tali tipi di pubblico a Salesforce Marketing Cloud, che può quindi essere utilizzato per inviare l'e-mail della campagna di marketing.
Prerequisiti prerequisites
Prerequisiti in Experience Platform prerequisites-in-experience-platform
Prima di attivare i dati nella destinazione (API) Salesforce Marketing Cloud, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.
Prerequisiti in (API) Salesforce Marketing Cloud prerequisites-destination
Per esportare i dati da Platform al tuo account Salesforce Marketing Cloud, tieni presente i seguenti prerequisiti:
Devi avere un account Salesforce Marketing Cloud prerequisites-account
Per continuare è obbligatorio un account Salesforce Marketing Cloud con una sottoscrizione al prodotto Marketing Cloud Engagement.
Contatta il Salesforce Supporto se non disponi di un account Salesforce Marketing Cloud o se il tuo account non dispone dell'abbonamento al prodotto Marketing Cloud Engagement.
Crea attributi in Salesforce Marketing Cloud prerequisites-attribute
Quando si attivano i tipi di pubblico nella destinazione (API) Salesforce Marketing Cloud, è necessario immettere un valore nel campo ID mappatura per ogni pubblico attivato, nel passaggio Pianificazione pubblico.
Salesforce 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 Marketing Cloud. 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 attivato da Platform a Salesforce, è necessario disporre di un attributo di tipo Text
collegato all'estensione dati Email Demographics all'interno di Salesforce Marketing Cloud. Utilizzare Salesforce Marketing Cloud Contact Builder per creare gli attributi. Per informazioni sulla creazione degli attributi, consulta la documentazione di Salesforce Marketing Cloud per creare gli attributi.
I nomi dei campi attributo vengono utilizzati per il campo di destinazione (API) Salesforce Marketing Cloud durante il passaggio Mappatura. Puoi definire il carattere del campo con un massimo di 4000 caratteri, in base ai requisiti aziendali. Per ulteriori informazioni sui tipi di attributo, vedere la pagina della documentazione Salesforce Marketing Cloud Tipi di dati estensioni.
Di seguito è riportato un esempio della schermata di progettazione dati in Salesforce Marketing Cloud, in cui verrà aggiunto l'attributo:
Di seguito è riportata una visualizzazione di un gruppo di attributi Salesforce Marketing Cloud Email Data con attributi corrispondenti allo stato del pubblico all'interno dell'estensione dati Email Demographics:
La destinazione (API) Salesforce Marketing Cloud utilizza l'Salesforce Marketing Cloud Search Attribute-Set Definitions REST API per recuperare in modo dinamico le estensioni dei dati e i relativi attributi collegati' definiti in Salesforce Marketing Cloud.
Questi vengono visualizzati nella finestra di selezione del campo di destinazione quando imposti la mappatura nel flusso di lavoro per attivare il pubblico nella destinazione.
salesforce_mc_segment_1
. Quando si attiva un pubblico in questa destinazione, aggiungere salesforce_mc_segment_1
come ID mappatura per popolare i tipi di pubblico da Experience Platform in questo attributo.Di seguito è riportato un esempio di creazione di attributi in Salesforce Marketing Cloud:
- Durante la creazione dell’attributo, non includere spazi nel nome del campo. Utilizzare invece il carattere di sottolineatura
(_)
come separatore. - Per distinguere tra gli attributi utilizzati per i tipi di pubblico di Platform e altri attributi all'interno di Salesforce Marketing Cloud, è possibile includere un prefisso o un suffisso riconoscibile per gli attributi utilizzati per i segmenti di Adobe. Ad esempio, invece di
test_segment
, utilizzareAdobe_test_segment
otest_segment_Adobe
. - Se in Salesforce Marketing Cloud sono già stati creati altri attributi, è possibile utilizzare lo stesso nome del segmento Platform per identificare facilmente il pubblico in Salesforce Marketing Cloud.
Assegna ruoli utente e autorizzazioni in Salesforce Marketing Cloud prerequisites-roles-permissions
Poiché Salesforce Marketing Cloud supporta ruoli personalizzati a seconda del caso d'uso, all'utente devono essere assegnati i ruoli appropriati per aggiornare gli attributi in Salesforce Marketing Cloud. Di seguito è riportato un esempio di ruoli assegnati a un utente:
A seconda dei ruoli assegnati all'utente Salesforce Marketing Cloud, è inoltre necessario assegnare le autorizzazioni all'estensione dati Salesforce Marketing Cloud collegata ai campi che si desidera aggiornare.
Poiché questa destinazione richiede l'accesso a data extension
, è necessario consentire l'accesso. Ad esempio, per Email
data extension è necessario consentire come mostrato di seguito:
Per limitare il livello di accesso, è inoltre possibile sostituire l'accesso individuale utilizzando privilegi granulari.
Per istruzioni dettagliate, consultare le pagine Marketing Cloud Roles e Marketing Cloud Roles and Permissions.
Raccogli Salesforce Marketing Cloud credenziali gather-credentials
Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione (API) Salesforce Marketing Cloud.
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,è necessario fornire
mcq4jrssqdlyc4lph19nnqgzzs84
come valore.Guardrail guardrails
-
Salesforce impone alcuni limiti di tariffa.
- Consulta la Salesforce Marketing Cloud documentazione per risolvere eventuali probabili limiti che potresti incontrare e ridurre gli errori durante l'esecuzione.
- Consultare la pagina Salesforce Marketing Cloud Determinazione prezzi per l'accordo per Scaricare il grafico di confronto dell'edizione completa in formato pdf con informazioni dettagliate sui limiti imposti dal piano.
- Nella pagina Panoramica API sono riportati ulteriori limiti.
- Fai riferimento a qui per una pagina che raccoglie questi dettagli.
-
Il numero di campi personalizzati consentiti per oggetto varia in base alla versione Salesforce.
-
Per ulteriori informazioni, consulta la Salesforce documentazione.
-
Se hai raggiunto il limite definito per campi personalizzati consentiti per oggetto entro Salesforce Marketing Cloud, dovrai
- Rimuovere gli attributi precedenti prima di aggiungere nuovi attributi in Salesforce Marketing Cloud.
- Aggiorna o rimuovi eventuali tipi di pubblico attivati nelle destinazioni Platform che utilizzano questi nomi di attributi meno recenti come valore fornito per ID mappatura durante il passaggio pianificazione del pubblico.
-
Identità supportate supported-identities
(API) Salesforce Marketing Cloud supporta l'attivazione delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
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 segmento in Salesforce Marketing Cloud viene aggiornato con lo stato del pubblico corrispondente da Platform, in base al valore ID mappatura fornito durante il passaggio pianificazione del pubblico.
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.
In Destinazioni > Catalogo, cerca (API) Salesforce Marketing Cloud. In alternativa puoi trovarlo nella categoria E-mail marketing.
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 Marketing Cloud credenziali.
Ad esempio, se il dominio è
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,è necessario fornire
mcq4jrssqdlyc4lph19nnqgzzs84
come valore.Client ID
.Client Secret
.
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.
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 (API) Salesforce Marketing Cloud, è 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.
Per mappare correttamente i campi XDM ai campi di destinazione (API) Salesforce Marketing Cloud, effettua le seguenti operazioni.
-
Anche se i nomi degli attributi corrispondono a quelli dell'account Salesforce Marketing Cloud, le mappature per
contactKey
epersonalEmail.address
sono obbligatorie. -
L'integrazione con l'API Salesforce Marketing Cloud è soggetta a un limite di impaginazione del numero di attributi che gli Experienci Platform possono recuperare da Salesforce. Ciò significa che durante il passaggio Mappatura, lo schema del campo di destinazione può visualizzare un massimo di 2000 attributi dal tuo account Salesforce.
-
Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.
-
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 categoria e seleziona un attributo dalle estensioni di dati visualizzate in base alle esigenze. La destinazione (API) Salesforce Marketing Cloud utilizza l'Salesforce Marketing Cloud Search Attribute-Set Definitions REST API per recuperare in modo dinamico le estensioni dei dati e i relativi attributi collegati' definiti in Salesforce Marketing Cloud. Questi vengono visualizzati nel popup del campo Target quando imposti mapping nel flusso di lavoro attiva tipi di pubblico.
-
Ripeti questi passaggi per aggiungere le seguenti mappature tra lo schema del profilo XDM e (API) Salesforce Marketing Cloud:
table 0-row-3 1-row-3 2-row-3 3-row-3 Campo origine Campo di destinazione Obbligatorio IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
dall'estensione dati Salesforce Marketing Cloud Email Addresses.Mandatory
, durante l'aggiunta di nuovi contatti.xdm: person.name.firstName
Attribute: First Name
dall'estensione dati Salesforce Marketing Cloud desiderata.- -
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
Quando esegui il passaggio Pianifica esportazione pubblico, devi mappare manualmente i tipi di pubblico di Platform agli attributi in Salesforce Marketing Cloud.
A tale scopo, selezionare ogni segmento, quindi immettere il nome dell'attributo da Salesforce Marketing Cloud nel campo (API) Salesforce Marketing Cloud ID mappatura. Consulta la sezione Creare un attributo all'interno di Salesforce Marketing Cloud per indicazioni e best practice sulla creazione di attributi in Salesforce Marketing Cloud.
Se ad esempio l'attributo Salesforce Marketing Cloud è salesforce_mc_segment_1
, specificare questo valore nell'ID (API) Salesforce Marketing Cloud Mapping per popolare i tipi di pubblico di Experience Platform in questo attributo.
Di seguito è riportato un attributo di esempio da Salesforce Marketing Cloud:
Di seguito è riportato un esempio che indica la posizione dell'(API) Salesforce Marketing Cloud ID mappatura:
Come mostrato, (API) Salesforce Marketing Cloud L'ID mappatura deve corrispondere esattamente al valore specificato in Salesforce Marketing Cloud NOME CAMPO.
Ripeti questa sezione per ogni segmento di Platform attivato.
Un esempio tipico basato sull’immagine mostrata sopra potrebbe essere.
salesforce_mc_segment_1
salesforce_mc_segment_1
salesforce_mc_segment_2
salesforce_mc_segment_2
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 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.
-
Accedere al sito Web Salesforce Marketing Cloud. Quindi passa alla pagina Audience Builder > Contact Builder > All contacts > Email e controlla se i profili del pubblico sono stati aggiunti.
-
Per verificare se i profili sono stati aggiornati, passa alla pagina E-mail e verifica se i valori degli attributi per il profilo dal pubblico sono stati aggiornati. In caso di esito positivo, puoi vedere che ogni stato del pubblico in Salesforce Marketing Cloud è stato aggiornato con lo stato del pubblico corrispondente da Platform, in base al valore ID mappatura fornito nel passaggio 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 al Marketing Cloud Salesforce 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 per la destinazione (API) Salesforce Marketing Cloud corrisponda esattamente al nome dell'attributo creato in Salesforce Marketing Cloud. Consulta la sezione Creare un attributo all'interno di Salesforce Marketing Cloud per maggiori informazioni.
-
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 Marketing Cloud per aggiungere indirizzi IP Experienci Platform agli intervalli IP attendibili degli account Salesforce Marketing Cloud. Se hai bisogno di ulteriori indicazioni, consulta la Salesforce Marketing Cloud Indirizzi IP per l'inclusione nei Inserisce nell'elenco Consentiti di accesso ai Marketing Cloud di accesso ai sistemi di accesso ai dati (IP), nella documentazione di.
Risorse aggiuntive additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud documentazione che spiega come i contatti vengono aggiornati con le informazioni specificate.
Changelog changelog
Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
---|---|---|
Mese di rilascio | Tipo di aggiornamento | Descrizione |
Ottobre 2023 | Aggiornamento della documentazione |
|
Aprile 2023 | Aggiornamento della documentazione |
|
Febbraio 2023 | Aggiornamento della documentazione | La sezione Prerequisiti nel Marketing Cloud (API) Salesforce è stata aggiornata per includere un collegamento di riferimento che indica che Salesforce Marketing Cloud Engagement è una sottoscrizione obbligatoria per l'utilizzo di questa destinazione. |
Febbraio 2023 | Aggiornamento della funzionalità | È stato risolto un problema che causava l’invio a Salesforce di un JSON non valido a causa di una configurazione errata nella destinazione. Questo causava la mancata attivazione di un numero elevato di identità da parte di alcuni utenti. (PLATIR-26299) |
Gennaio 2023 | Aggiornamento della documentazione |
|
Ottobre 2022 | Versione iniziale | Versione di destinazione iniziale e pubblicazione della documentazione. |