Ti trovi qui:
Utilizzo di un handler di moduli per aggiornare gli oggetti Salesforce con i dati dei moduli
Utilizzare un handler di moduli per acquisire dati da un modulo su un sito Web esterno e utilizzarli per creare o aggiornare record in Salesforce. Gli handler di moduli consentono di utilizzare i moduli esistenti nel sito senza aggiornare il sito per utilizzare i moduli creati in Salesforce. Quando si crea un handler di moduli, si specificano i nomi dei campi nel modulo esistente e i campi Salesforce a cui vengono mappati.
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 |
Quando si crea un handler di moduli, si crea anche una fonte di dati in Data 360. Questa fonte di dati memorizza i dati acquisiti dal modulo. Prima di creare un handler di moduli e una fonte di dati corrispondente, pensare a come strutturare al meglio i dati acquisiti dal modulo. Esistono due schemi generali per progettare la struttura di dati: nomi di campi espliciti e nomi di campi generici.
In una fonte di dati che utilizza nomi di campi espliciti, specificare ogni nome di campo nel modello di dati. Questa struttura è facile da capire, ma richiede la modifica dell'oggetto ogni volta che si aggiunge un campo. Un modello di dati con una struttura esplicita assomiglia a questo esempio.
| Nome campo | Tipo |
|---|---|
| Nome | Testo |
| Cognome | Testo |
| Testo | |
| Indirizzo | Testo |
| Professione | Testo |
| ... | ... |
In alternativa, una fonte di dati può utilizzare nomi di campi generici o più spesso una combinazione di nomi di campi espliciti e generici. Questo approccio offre maggiore flessibilità, consentendo di gestire i nuovi nomi di campo senza modificare l'oggetto. Tuttavia, i nomi dei campi generici sono ambigui e richiedono l'uso di metadati per descrivere gli attributi nel payload. Un modello di dati con una struttura generica è simile a questo esempio.
| Nome campo | Tipo |
|---|---|
| Nome | Testo |
| Cognome | Testo |
| Testo | |
| Attributo1 | Testo |
| Attributo2 | Testo |
| Attributo3 | Testo |
| ... | ... |
Creazione di un handler modulo
- Nella scheda Contenuto, selezionare un'area di lavoro del contenuto in cui creare l'handler modulo.
- Fare clic su Aggiungi | Contenuto .
- Nella finestra Crea contenuto CMS, selezionare Handler modulo e quindi fare clic su Crea.
-
Nell'angolo superiore sinistro della finestra, accanto a Senza titolo, fare clic sull'icona a forma di matita (
). Immettere un nome per l'handler modulo.
-
Aggiungere una fonte di dati.
- Nel riquadro a destra, in Fonte di dati, fare clic su Aggiungi fonte di dati.
- Immettere un nome per la fonte di dati.
- Per Tipo, selezionare Record Salesforce.
- Per Oggetto, selezionare il tipo di record su cui opera l'handler modulo. Ad esempio, per aggiornare i record Referente, selezionare Referente.
- Salva le modifiche.
-
Mappare i campi del modulo.
- Dal riquadro a sinistra, fare clic su un campo da acquisire dal modulo e trascinarlo al centro della pagina. Ad esempio, selezionare l'oggetto Referente se il modulo raccoglie informazioni sul Nome, Cognome o Indirizzo email dell'utente. Ripetere questo passaggio per ogni campo con cui interagiscono i dati del modulo.
- Al centro della pagina, fare clic su uno dei nomi dei campi aggiunti. Quindi, nel riquadro a destra, immettere il nome di un campo esterno. Ripetere questo passaggio per tutti i campi selezionati.
Il nome del campo esterno è il link tra il modulo del sito Web e Salesforce. Collega ogni campo del modulo al campo Salesforce in cui è memorizzato il valore inviato. Tenere presenti questi requisiti quando si specificano i campi da acquisire:
- Il nome del campo esterno immesso deve corrispondere esattamente all'attributo nome HTML del campo nel modulo.
- I valori di data utilizzano il formato
YYYY-MM-DD. - I valori di ora utilizzano il formato
hh:mm:ss. - I valori DateTime utilizzano il formato
YYYY-MM-DDTHH:mm:ss.sssZ(formato ISO 8601). - Per i valori delle caselle di controllo, se la casella di controllo è selezionata nel modulo, Salesforce la registra come
truenell'oggetto.
- Salva le modifiche.
Per informazioni sull'aggiornamento del sito per gestire gli invii di moduli in modo sicuro, vedere Documentazione per sviluppatori: Integrare l'invio dei moduli con l'API Connect.
Aggiunta della protezione antispam a un handler di moduli (facoltativo)
Per proteggersi da hacking e spam, aggiungere un campo honeypot nascosto al modulo. Quando un bot tenta di inviare un modulo, spesso completa tutti i campi del modulo, inclusi i campi nascosti. Se si include un campo honeypot nel modulo, l'handler del modulo blocca tutti gli invii che contengono un valore in quel campo.
- Dal riquadro Campi di protezione dallo spam, aggiungere il campo Honeypot.
-
Per Nome campo esterno, immettere un nome di campo da utilizzare per l'Honeypot.
Suggerimento I bot tentano di sfruttare i campi modulo che consentono agli utenti di immettere testo liberamente. Cercano i campi con etichette generiche, ad esempiocompany,websiteofax. Immettere un nome che renda il campo honeypot una destinazione attraente, ma che non si sovrapponga ai dati da acquisire nel modulo. Non utilizzare un nome ovvio, ad esempiohoneypotodo_not_fill. - Nell'HTML del modulo, aggiungere un campo di input nascosto con l'attributo name corrispondente.
Automazione delle azioni con un flusso
Per automatizzare operazioni come la creazione di lead o l'invio di email dopo che un utente ha inviato un modulo, collegare un flusso all'handler del modulo. Nella sezione Flusso dell'handler di moduli, fare clic su Nuovo flusso per aprire Flow Builder.
Quando si crea un flusso dalla pagina dell'handler modulo, i nomi dei campi esterni specificati sono disponibili come risorse nel flusso. Utilizzare i valori di questi campi esterni nelle fasi decisionali del flusso, per personalizzare il contenuto dei messaggi e in altre azioni del flusso. Utilizzare queste risorse anche per modificare qualsiasi oggetto, non solo l'oggetto selezionato durante la creazione dell'handler modulo.
Configurazione dei reindirizzamenti invio
Nella sezione Reindirizzamento invio, immettere gli URL completi a cui indirizzare gli utenti quando l'invio di un modulo ha esito positivo o negativo.
Pubblicazione dell'handler modulo
Pubblicare l'handler modulo per generare il codice che collega il modulo del sito Web a Salesforce.
- Quando si è pronti a pubblicare il modulo e il relativo flusso, fare clic su Pubblica.
- Attivare il tracciamento Web per monitorare il coinvolgimento degli utenti.
Dopo la pubblicazione, l'handler modulo genera il codice utilizzato per configurare il modulo per inviare dati all'handler modulo.
