Loading
Marketing Cloud Next
Utilizzo di un handler di moduli per aggiornare gli oggetti Salesforce con i dati dei moduli

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
Email 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
Email Testo
Attributo1 Testo
Attributo2 Testo
Attributo3 Testo
... ...

Creazione di un handler modulo

  1. Nella scheda Contenuto, selezionare un'area di lavoro del contenuto in cui creare l'handler modulo.
  2. Fare clic su Aggiungi | Contenuto .
  3. Nella finestra Crea contenuto CMS, selezionare Handler modulo e quindi fare clic su Crea.
  4. Nell'angolo superiore sinistro della finestra, accanto a Senza titolo, fare clic sull'icona a forma di matita (Una matita che indica un campo o un'impostazione che è possibile modificare). Immettere un nome per l'handler modulo.
  5. Aggiungere una fonte di dati.
    1. Nel riquadro a destra, in Fonte di dati, fare clic su Aggiungi fonte di dati.
    2. Immettere un nome per la fonte di dati.
    3. Per Tipo, selezionare Record Salesforce.
    4. Per Oggetto, selezionare il tipo di record su cui opera l'handler modulo. Ad esempio, per aggiornare i record Referente, selezionare Referente.
    5. Salva le modifiche.
  6. Mappare i campi del modulo.
    1. 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.
    2. 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 true nell'oggetto.
  7. 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.

Nota
Nota I campi Honeypot sono un componente di una strategia efficace di prevenzione dello spam, ma non dovrebbero essere l'unico componente utilizzato. Valutare la possibilità di utilizzare altre misure antiabuso, incluso reCAPTCHA.
  1. Dal riquadro Campi di protezione dallo spam, aggiungere il campo Honeypot.
  2. Per Nome campo esterno, immettere un nome di campo da utilizzare per l'Honeypot.
    Suggerimento
    Suggerimento I bot tentano di sfruttare i campi modulo che consentono agli utenti di immettere testo liberamente. Cercano i campi con etichette generiche, ad esempio company, website o fax. 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 esempio honeypot o do_not_fill.
  3. 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.

Importante
Importante

Aggiungere e mappare tutti i campi obbligatori prima di creare un flusso. Se si modificano i campi dopo aver aggiunto il flusso, il flusso non riflette automaticamente le modifiche. Le nuove versioni del flusso includono le mappature aggiornate.

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.

Nota
Nota

Se il modulo utilizza reCAPTCHA, generare e inviare il token richiesto con l'invio del modulo.

  1. Quando si è pronti a pubblicare il modulo e il relativo flusso, fare clic su Pubblica.
  2. 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.

 
Caricamento
Salesforce Help | Article