(API) Salesforce Marketing Cloud connessione

Panoramica

(API) Salesforce Marketing Cloud (precedentemente noto come ExactTarget) è una suite di marketing digitale che consente di creare e personalizzare percorsi per consentire a visitatori e clienti di personalizzare la propria esperienza.

Questo Adobe Experience Platform destinazione sfrutta Salesforce Marketing Cloud aggiorna contatti API, che consente di aggiungere contatti/aggiornare i dati di contatto per le esigenze aziendali dopo averli attivati in una nuova Salesforce Marketing Cloud segmento.

Salesforce Marketing Cloud utilizza OAuth 2 con credenziali client come meccanismo di autenticazione per comunicare con Salesforce Marketing Cloud API. Istruzioni per l’autenticazione Salesforce Marketing Cloud sono riportati di seguito, nella Autentica nella destinazione sezione.

Casi d’uso

Per aiutarti a capire meglio come e quando utilizzare il (API) Salesforce Marketing Cloud destinazione: ecco un caso d’uso di esempio che i clienti di Adobe Experience Platform possono risolvere utilizzando questa destinazione.

Invia e-mail ai contatti per campagne di marketing

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 o aggiornare quelli esistenti (e i loro indirizzi e-mail) tramite Adobe Experience Platform, crea segmenti dai propri dati offline e invia tali segmenti a Salesforce Marketing Cloud, che può quindi essere utilizzato per inviare l’e-mail della campagna di marketing.

Prerequisiti

Prerequisiti in Experience Platform

Prima di attivare i dati in (API) Salesforce Marketing Cloud destinazione, è necessario disporre di un schema, a set di dati, e segmenti creato in Experience Platform.

Prerequisiti in (API) Salesforce Marketing Cloud

Prendi nota dei seguenti prerequisiti per esportare i dati da Platform al Salesforce Marketing Cloud account:

Devi avere un Salesforce Marketing Cloud account

A Salesforce Marketing Cloud account con un abbonamento a Coinvolgimento account Marketing Cloud prodotto è obbligatorio per procedere.

Contatta in Salesforce Supporto se non ha un Salesforce Marketing Cloud o il tuo account non dispone del Marketing Cloud Account Engagement abbonamento al prodotto.

Creare attributi in Salesforce Marketing Cloud

Quando si attivano i segmenti in (API) Salesforce Marketing Cloud destinazione, è necessario immettere un valore nella ID mappatura per ogni segmento attivato, nel campo Pianificazione del segmento passaggio.

Salesforce richiede che questo valore legga e interpreti correttamente i segmenti provenienti da Experience Platform e che aggiorni il loro stato di segmento in Salesforce Marketing Cloud. Consulta la documentazione dell’Experience Platform per Gruppo di campi schema Dettagli appartenenza segmento se hai bisogno di informazioni sugli stati dei segmenti.

Per ogni segmento che attivi da Platform a Salesforce Marketing Cloud, è necessario creare un attributo del tipo Text entro Salesforce. Utilizza il Salesforce Marketing Cloud Contact Builder per creare attributi. I nomi dei campi attributo vengono utilizzati per (API) Salesforce Marketing Cloud campo di destinazione e deve essere creato nel Email Demographics system attribute-set. Puoi definire il carattere del campo con un massimo di 4000 caratteri, in base ai requisiti aziendali. Consulta la Salesforce Marketing Cloud Tipi di dati delle estensioni dati per ulteriori informazioni sui tipi di attributi.

Consulta la sezione Salesforce Marketing Cloud documentazione per creare attributi per informazioni sulla creazione di attributi.

Un esempio della schermata di progettazione dati in Salesforce Marketing Cloud, in cui si aggiunge l'attributo è mostrato di seguito:

Una vista della Salesforce Marketing Cloud Email Demographics il set di attributi è mostrato di seguito:

Il (API) Salesforce Marketing Cloud la destinazione utilizza Salesforce Marketing Cloud Search Attribute-Set Definitions REST API per recuperare in modo dinamico gli attributi e i relativi set di attributi definiti in Salesforce Marketing Cloud.

Questi vengono visualizzati nel Campo di destinazione finestra di selezione quando si imposta mappatura nel flusso di lavoro a attivare i segmenti nella destinazione. Tieni presente che solo i mapping per gli attributi definiti all’interno di Salesforce Marketing Cloud Email Demographics set di attributi supportati.

Esempio di creazione di attributi in Salesforce Marketing Cloud, è mostrato di seguito:

Raccogli Salesforce Marketing Cloud credenziali

Annota gli elementi riportati di seguito prima di eseguire l’autenticazione in (API) Salesforce Marketing Cloud destinazione.

Guardrail

• Salesforce impone alcuni limiti di tariffa.
  • Consulta la sezione Salesforce Marketing Cloud documentazione per risolvere eventuali limiti probabili riscontrati e ridurre gli errori durante l'esecuzione.
  • Consulta la sezione Salesforce Marketing Cloud Prezzi di coinvolgimento pagina a Scarica il grafico di confronto dell'edizione completa in un pdf che descrive i limiti imposti dal piano.
  • Il Panoramica API limiti aggiuntivi per i dettagli della pagina.
  • Fai riferimento a qui per una pagina che raccoglie questi dettagli.
• Il conteggio di campi personalizzati consentiti per oggetto varia a seconda della versione di Salesforce.
  • Consulta la sezione Salesforce documentazione per ulteriori informazioni.
  • Se hai raggiunto il limite definito per campi personalizzati consentiti per oggetto entro Salesforce Marketing Cloud sarà necessario
    • Rimuovi gli attributi precedenti prima di aggiungere nuovi attributi in Salesforce Marketing Cloud.
    • Aggiorna o rimuovi eventuali segmenti attivati nelle destinazioni Platform che utilizzano questi nomi di attributi precedenti come valore fornito per ID mappatura durante il programmazione dei segmenti passaggio.

Identità supportate

(API) Salesforce Marketing Cloud supporta l’attivazione delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Tipo e frequenza di esportazione

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

Connetti alla destinazione

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

Entro Destinazioni > Catalogo, cerca (API) Salesforce Marketing Cloud. In alternativa, è possibile posizionarlo sotto il E-mail marketing categoria.

Autentica nella destinazione

Per eseguire l’autenticazione nella destinazione, compila i campi richiesti di seguito e seleziona Connetti alla destinazione. Consulta la sezione Raccogli Salesforce Marketing Cloud credenziali sezione per eventuali indicazioni.

Se i dettagli forniti sono validi, nell’interfaccia utente viene visualizzato un Connesso con un segno di spunta verde, puoi quindi procedere al passaggio successivo.

Inserisci i dettagli della destinazione

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: nome con cui riconoscerai questa destinazione in futuro.
• Descrizione: descrizione che ti aiuterà a identificare questa destinazione in futuro.

Abilita avvisi

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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attiva i segmenti in questa destinazione

Letto Attivare profili e segmenti nelle destinazioni di esportazione di segmenti in streaming per istruzioni sull’attivazione dei segmenti di pubblico in questa destinazione.

Considerazioni sulla mappatura ed esempio

Per inviare correttamente i dati sul pubblico da Adobe Experience Platform a (API) Salesforce Marketing Cloud destinazione, devi passare attraverso 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 su (API) Salesforce Marketing Cloud campi di destinazione, segui i passaggi indicati di seguito.

1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Viene visualizzata una nuova riga di mappatura.
   

2. In Seleziona campo di origine finestra, scegli la Seleziona attributi e selezionare l'attributo XDM o scegliere il Seleziona lo spazio dei nomi dell’identità e seleziona un’identità.

3. In Seleziona campo di destinazione finestra, scegli la Seleziona lo spazio dei nomi dell’identità e seleziona un’identità o scegli Seleziona attributi personalizzati categoria e selezionare un attributo dalla Email Demographics attributi visualizzati in base alle esigenze. Il (API) Salesforce Marketing Cloud la destinazione utilizza Salesforce Marketing Cloud Search Attribute-Set Definitions REST API per recuperare in modo dinamico gli attributi e i relativi set di attributi definiti in Salesforce Marketing Cloud. Questi vengono visualizzati nel Campo di destinazione popup quando si imposta mappatura nel attivare i segmenti in un flusso di lavoro. Si noti che solo i mapping per gli attributi definiti all'interno del Salesforce Marketing Cloud Email Demographics set di attributi supportati.

   • Ripeti questi passaggi per aggiungere le seguenti mappature tra lo schema del profilo XDM e (API) Salesforce Marketing Cloud: Campo di origine|Campo di destinazione| obbligatorio| |—|—|—| |IdentityMap: contactKey|Identity: salesforceContactKey| Mandatory |\

     |xdm: person.name.firstName|Attribute: Email Demographics.First Name| - |
     |xdm: personalEmail.address|Attribute: Email Addresses.Email Address| - |

   • Di seguito è riportato un esempio che utilizza queste mappature:

     

Una volta completate le mappature per la connessione di destinazione, seleziona Successivo.

Esempio di esportazione di segmenti programmati

Durante l'esecuzione di Pianificare l’esportazione di segmenti , devi mappare manualmente i segmenti di Platform su attributi in Salesforce Marketing Cloud.

A questo scopo, seleziona ogni segmento, quindi inserisci il nome dell’attributo da Salesforce Marketing Cloud nel (API) Salesforce Marketing Cloud ID mappatura campo. Consulta la sezione Crea attributo in Salesforce Marketing Cloud sezione per indicazioni e best practice sulla creazione di attributi in Salesforce Marketing Cloud.

Ad esempio, se Salesforce Marketing Cloud l'attributo è salesforce_mc_segment_1, specifica questo valore in (API) Salesforce Marketing Cloud ID mappatura per popolare i tipi di pubblico del segmento da Experience Platform in questo attributo.

Un attributo di esempio da Salesforce Marketing Cloud è mostrato di seguito:

Un esempio che indica la posizione del (API) Salesforce Marketing Cloud ID mappatura è mostrato di seguito:

Come mostrato nella (API) Salesforce Marketing Cloud ID mappatura deve corrispondere esattamente al valore specificato in Salesforce Marketing Cloud NOME CAMPO.

Ripeti questa sezione per ogni segmento di Platform attivato.

A seconda del caso d’uso, tutti i segmenti attivati possono essere mappati allo stesso Salesforce Marketing Cloud NOME CAMPO o a diversi NOME CAMPO in (API) Salesforce Marketing Cloud. Un esempio tipico basato sull’immagine mostrata sopra potrebbe essere.
| (API) Salesforce Marketing Cloud nome segmento | Salesforce Marketing Cloud NOME CAMPO | (API) Salesforce Marketing Cloud ID mappatura | | — | — | — | | salesforce mc segmento 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 | | Salesforce mc segmento 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

Convalidare l’esportazione dei dati

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

1. Seleziona Destinazioni > Sfoglia per passare all’elenco delle destinazioni.
   

2. Seleziona la destinazione e verifica che lo stato sia abilitato.
   

3. Passa a Activation data , quindi seleziona un nome di segmento.
   

4. Monitora il riepilogo dei segmenti e assicurati che il conteggio dei profili corrisponda al conteggio creato all’interno del segmento.
   

5. Accedi a Salesforce Marketing Cloud sito Web. Quindi vai al Audience Builder > Contact Builder > All contacts > Email e verificare se i profili del segmento sono stati aggiunti.
   

6. Per verificare se i profili sono stati aggiornati, passa alla E-mail e verificare se i valori degli attributi per il profilo dal segmento sono stati aggiornati. In caso di esito positivo, puoi vedere che lo stato di ciascun segmento in Salesforce Marketing Cloud è stato aggiornato con il corrispondente stato del segmento da Platform, in base al ID mappatura valore fornito nella programmazione dei segmenti passaggio.
   

Utilizzo dei dati e governance

Tutti Adobe Experience Platform le destinazioni 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, consulta la sezione Panoramica sulla governance dei dati.

Errori e risoluzione problemi

Sono stati riscontrati errori sconosciuti durante la trasmissione degli eventi al Marketing Cloud Salesforce

• 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, verifica che ID mappatura che hai fornito nel flusso di lavoro di attivazione a (API) Salesforce Marketing Cloud La destinazione corrisponde esattamente al nome dell'attributo creato in Salesforce Marketing Cloud. Consulta la sezione Crea attributo in Salesforce Marketing Cloud sezione di orientamento.

• Quando attivi un segmento, potresti ricevere un messaggio di errore: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

  • Per risolvere il problema, contattare il Salesforce Marketing Cloud amministratore dell’account da aggiungere Experience Platform di indirizzi IP al tuo Salesforce Marketing Cloud intervalli IP attendibili degli account. Consulta la sezione Salesforce Marketing Cloud Indirizzi IP da includere nei Marketing Cloud di in Inserire nell'elenco Consentiti se hai bisogno di ulteriore assistenza.

Risorse aggiuntive

• Salesforce Marketing Cloud API
• Salesforce Marketing Cloud documentazione spiegazione di come i contatti vengono aggiornati con le informazioni specificate nei gruppi di attributi specificati.

Risorse Business.Adobe.com