Loading
Marketing Cloud Next
Connessione di un modulo esterno a un handler di moduli

Ti trovi qui:

  1. Guida di Salesforce
  2. Documenti
  3. Marketing Cloud Avanti

Connessione di un modulo esterno a un handler di moduli

Dopo aver creato e pubblicato un handler di moduli, configurare il modulo esterno per l'invio di dati a Salesforce.

Versioni (Edition) richieste

Visualizzare le versioni supportate.

Autorizzazioni utente richieste
Per creare un handler di moduli:

Insieme di autorizzazioni Responsabile Marketing Cloud

E

Qualsiasi ruolo Contributor dell'area di lavoro CMS
Per pubblicare un handler di moduli:

Insieme di autorizzazioni Responsabile Marketing Cloud

E

Ruolo contributore dell'area di lavoro CMS di amministratore contenuto o responsabile contenuto
Per configurare l'elenco consentiti CORS: Modifica tutti i dati

Prima di completare questi passaggi, creare e pubblicare un handler di moduli.

Esistono due modi per inviare dati dal modulo a Salesforce. Selezionare il tipo di connessione più adatto alla struttura e alle funzionalità del sito.

  Snippet JavaScript (lato client)

URL POST diretto (lato server)
Come funziona Uno script sulla pagina invia i dati del modulo a Salesforce quando un visitatore invia il modulo. Il modulo invia i dati direttamente a un URL Salesforce, senza script nella pagina.
Aggiungi al tuo sito Un tag <script> e attributi del modulo che vengono incollati nell'HTML della pagina. URL impostato come azione per la destinazione del modulo o del webhook.
Più adatto per Pagine in cui è possibile controllare l'HTML e aggiungere script. Generatori di moduli di terze parti che non consentono script personalizzati, pagine con regole CSP (Content Security Policy) rigorose e moduli pubblicati da un server di backend.
Supporta il tracciamento Web sì No
Supporta la risoluzione dell'identità sì No
Richiede una voce elenco consentiti CORS Sì Sì

Entrambi i metodi inviano i dati allo stesso handler di moduli e attivano lo stesso flusso. Entrambi i metodi richiedono anche l'autorizzazione del dominio nell'elenco consentiti CORS.

Con entrambi i tipi di connessione, assicurarsi che ogni campo del modulo utilizzi un attributo name HTML che corrisponda esattamente al nome del campo esterno corrispondente nell'handler del modulo. Se i nomi non corrispondono, l'handler modulo non acquisisce il valore. Ad esempio, se è stato mappato il nome del campo esterno email_address al campo Email, anche l'attributo name per il campo corrispondente nel modulo deve essere email_address.

Opzione 1: Configurazione del modulo per l'utilizzo di una connessione lato client

Utilizzare questo metodo quando si controlla l'HTML della pagina e si può aggiungere uno script alla pagina. Poiché lo script viene eseguito nel browser del visitatore, questo metodo supporta il tracciamento Web e la risoluzione dell'identità. Di conseguenza, questo metodo può collegare l'invio di un modulo all'attività Web di un visitatore.

  1. Pubblicare l'handler modulo.
  2. Nella scheda Snippet di codice, in Handler modulo lato client, copiare lo script di tracciamento. Lo script è simile a questo esempio. 
    <script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script>
  3. Nel codice HTML del sito, incollare lo script prima del tag </body> di chiusura.
  4. Copiare gli attributi del modulo nella scheda Snippet di codice. Gli attributi sono simili a questo esempio. 
    <form id="CONTENT_KEY" data-uma-forms="true"></form>
  5. Nel codice HTML, aggiungere gli attributi id e data-uma-forms al tag <form>.
  6. Verificare che l'attributo name HTML per ogni campo modulo corrisponda al nome del campo esterno mappato.
  7. Aggiungere il dominio che ospita il modulo all'elenco consentiti CORS. Questo passaggio autorizza il dominio a inviare invii a Salesforce.
  8. Per monitorare il coinvolgimento degli utenti, attivare il tracciamento Web.

Quando un visitatore invia il modulo, lo script invia i dati a Salesforce e l'handler del modulo elabora l'invio e attiva il flusso. L'handler modulo li reindirizza quindi all'URL di esito positivo o di errore configurato.

Opzione 2: Configurazione del modulo per l'utilizzo di una connessione lato server

Utilizzare una connessione lato server quando non è possibile aggiungere codice alla pagina o eseguire configurazioni personalizzate del codice. Con questo metodo, l'handler modulo fornisce un URL di destinazione e si configura il modulo in modo che invii i suoi dati a tale URL. Poiché non si incorpora uno script, questo metodo funziona con gli strumenti modulo che non consentono JavaScript personalizzato. Questo metodo è utile anche con le pagine che hanno regole CSP (Content Security Policy) rigorose e con i moduli inviati da un server di backend.

  1. Nella scheda Snippet di codice dell'handler modulo, in Handler modulo lato server, copiare l'URL dell'azione modulo. L'URL è simile a questo esempio. 
    https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY
  2. Configurare il modulo per inviare i dati a Salesforce. Le fasi di implementazione dipendono da come viene implementato il modulo.
    Se si utilizza un generatore di moduli o un plug-in di terze parti Nelle impostazioni dello strumento di terze parti, trovare il campo per configurare l'azione del modulo, l'URL post-to o la destinazione del webhook. Immettere l'URL Salesforce in quel campo.
    Se è possibile modificare l'HTML ma non è possibile aggiungere uno script Impostare l'attributo action del tag <form> sull'URL Salesforce e l'attributo method su POST.
    Se il modulo utilizza un processo di backend Inviare una richiesta POST all'URL Salesforce con i dati del modulo, con codifica application/x-www-form-urlencoded.
  3. Verificare che il nome di ogni campo corrisponda esattamente al nome del campo esterno mappato.
    L'handler modulo acquisisce i campi solo quando corrispondono esattamente.
  4. Aggiungere il dominio che ospita il modulo all'elenco consentiti CORS. Questo passaggio autorizza il dominio a inviare invii a Salesforce.

Configurazione dell'elenco consentiti CORS

Entrambi i metodi di connessione richiedono l'autorizzazione del dominio prima che Salesforce accetti l'invio dei moduli. Se non si autorizza il dominio, Salesforce blocca l'invio prima che venga elaborato. Per autorizzare il dominio, aggiungerlo all'elenco consentiti CORS.

  1. Identificare il dominio che ospita il modulo, ad esempio https://www.example.com. Per autorizzare tutti i sottodomini, utilizzare un carattere jolly, ad esempio https://*.example.com.
  2. Aggiungere il dominio all'elenco consentiti CORS.

Test del modulo

Dopo aver collegato il modulo all'handler di moduli, testarlo per assicurarsi che si comporti nel modo previsto.

  1. Nel modulo, inviare una voce di prova e confermare di essere stati inviati all'URL di esito positivo.
  2. In Salesforce, verificare se un record corrispondente alla voce di test è stato creato o aggiornato.
    Suggerimento
    Suggerimento Se un record non viene creato o aggiornato dopo aver inviato una voce di prova, verificare che l'attributo name di ogni campo modulo corrisponda al nome di un campo esterno. Se l'handler modulo è collegato a un flusso, verificare che il flusso venga completato senza errori.
 
Caricamento
Salesforce Help | Article