Cosa Sono le Variabili e Come Utilizzarle

In Connectif, le variabili rappresentano dati che possono cambiare valore a seconda del contatto che naviga e del suo contesto web. Questo permette di creare contenuti ed esperienze personalizzate, in base all'utente e al suo comportamento, che aumentano la fidelizzazione e la conversione. 

 

1. Proprietà

  • Una variabile in Connectif è la rappresentazione di dati che cambiano in base al contatto e al suo comportamento.
  • Qualsiasi dato raccolto in un workflow può essere assegnato a una variabile, che sia relativo, ad esempio, a informazioni su prodotti o sul contatto.
  • Ogni variabile si distingue per un nome e un identificatore univoco.
 

L'identificatore della variabile non può includere spazi e può contenere solo lettere, numeri e i simboli trattino ( - ) e underscore ( _ ).

  • Le variabili possono avere un tipo di formato specifico in base ai dati che rappresentano. Questi formati sono Numero, Data, Valuta e Percentuale. Per impostazione predefinita, le variabili sono definite come Senza formato. Questo tipo indefinito viene utilizzato per rappresentare testo o dati che non devono essere visualizzati in un modo particolare.
 

Se vuoi saperne di più sul formato delle variabili in email, contenuto web, notifica push o SMS, clicca qui.

  • Le variabili possono essere incluse in qualsiasi tipo di contenuto dai rispettivi editor e collegate a qualsiasi dato raccolto nei nodi precedenti di un workflow.
  • L'assegnazione dei dati alle variabili avviene nella configurazione dei nodi di azione incaricati di inviare contenuto al contatto: "Invia contenuto web", "Invia email", "Mostra push" e "Invia SMS".
  • Quando si crea una variabile è possibile definire un valore predefinito, che sarà assegnato automaticamente quando non ci sono valori da collegare dalla fonte dei dati. Nel caso in cui non sia collegata a nessun dato e non abbia questo valore predefinito, verrà mostrato uno spazio vuoto al suo posto.

 

2. Come si usa in Connectif

2.1. Uso di variabili predefinite

Esistono alcune variabili che Connectif fornisce per poter utilizzare nei contenuti senza la necessità di effettuare un'associazione esplicita dei dati nei nodi che inviano o mostrano i contenuti:

Queste variabili non ammettono la definizione di un valore predefinito.

  • {{__cn_available_width}} : questa variabile è disponibile in tutti i contenuti di Connectif tranne nelle Notifiche Web Push. Viene sostituita automaticamente con il valore in pixel della larghezza della cella in cui è posizionata la variabile.
 

Ad esempio, se creiamo un popup largo 600px e vi aggiungiamo un contenuto dinamico con questa variabile configurata per mostrare righe di 4 celle uguali, ogni cella del contenuto dinamico avrà 150px. 

  • {{__cn_email_subject}} : questa variabile è disponibile solo nel tipo di contenuto email. Può essere utilizzata in qualsiasi parte dell'email, e viene automaticamente sostituita con l'Oggetto dell'email. 
  • {{__cn_email_from}} : questa variabile è disponibile solo nel tipo di contenuto email. Può essere utilizzata in qualsiasi parte dell'email, e viene automaticamente sostituita con il From utilizzato per inviare l'email. 

 

2.2. Creazione di variabili

Contenuti web

1.  Accedi a "Contenuti > Contenuto web" e clicca su  Crea nuovo contenuto web. Se vuoi creare variabili in un design di contenuto web esistente, clicca su  Altro per aprire il menu e premi su Modifica.

2. Aggiungi o seleziona nel tuo design il componente dove desideri creare una nuova variabile.

3. Clicca su  (Modifica elemento).

4. Nell'editor, clicca sul pulsante Variabili.

Actualización variables - 1-min.png

5. Scrivi un nome per distinguere la variabile in Identificatore della variabile.

6. (Opzionale) Imposta il Valore predefinito se necessario.

7. (Opzionale) Assegna un Tipo di dato se necessario.

Actualización variables - 2-min.png

8. Clicca su  Accetta per salvare le modifiche nel nodo e su  Salva per salvare le modifiche nel workflow.

 

Email

1.  Accedi a "Contenuti > Email" e clicca su  Crea nuova email. Se vuoi creare variabili in un design di email esistente, clicca su  Altro per aprire il menu e premi su Modifica.

2. Aggiungi o seleziona nel tuo design il componente dove desideri creare una nuova variabile.

3. Clicca su  (Modifica elemento).

4. Nell'editor, clicca sul pulsante Variabili.

Actualización variables - 3-min.png

5. Scrivi un nome per distinguere la variabile in Identificatore della variabile.

6. (Opzionale) Imposta il Valore predefinito se necessario.

Actualización variables - 4-min.png

8. Clicca su  Accetta per salvare le modifiche nel nodo e su  Salva per salvare le modifiche nel workflow.

 

Notifiche web push

1.  Accedi a "Contenuti > Notifiche Push" e clicca su  Crea nuova notifica push. Se vuoi creare variabili in un design esistente, clicca su  Altro per aprire il menu e premi su Modifica.

2. Nelle schede Contenuto o Versione compatta, clicca sul pulsante {} (Definisci una variabile dinamica)

3. Scrivi un nome per distinguere la variabile in Identificatore della variabile.

4. (Opzionale) Imposta il Valore predefinito se necessario.

Actualización variables - 5-min.png

5. Clicca su  Accetta.

6. Clicca su  Accetta per salvare le modifiche nel nodo e su  Salva per salvare le modifiche nel workflow.

 

SMS

1.  Accedi a "Contenuti > SMS" e clicca su  Crea nuovo SMS. Se vuoi creare variabili in un design esistente, clicca su  Altro per aprire il menu e premi su Modifica.

2. Nella scheda Contenuto, clicca sul pulsante {} (Definisci una variabile dinamica).

3. Scrivi un nome per distinguere la variabile in Identificatore della variabile.

4. (Opzionale) Imposta il Valore predefinito se necessario.

Actualización variables - 6-min.png

5. Clicca su  Accetta.

6. Clicca su  Accetta per salvare le modifiche nel nodo e su  Salva per salvare le modifiche nel workflow.

 

2.3. Modifica del tipo di dati di una variabile

  

È possibile modificare i tipi di dati di una variabile solo nei contenuti di tipo web ed email.

1. Nell'editor, clicca su   Proprietà generali.

2. Seleziona la scheda Variabili.

3. Clicca su   (Modifica).

4. Modifica il tipo di dato.

Actualización variables - 7-min.png

5. Clicca su  Accetta per salvare le modifiche nella variabile e su  Salva per salvare le modifiche nel design.

 

2.4. Assegnazione di variabili

Nodo "Invia contenuto web"

1.  Accedi a "Workflows" e clicca su  Crea nuovo workflow. Se vuoi assegnare variabili in una strategia esistente, clicca su  Altro per aprire il menu e premi su Modifica.

  

Per poter seguire i passaggi di questa sezione, è necessario un contenuto web con variabili, e un workflow che contenga almeno un nodo "Invia contenuto web".
Ricorda che puoi utilizzare un modello esistente in Connectif, ad esempio, Raccomandatore nella home.

2. Nel nodo "Invia contenuto web", clicca su  (Modifica configurazione del nodo).

3. Seleziona il contenuto web con variabili.

4. Clicca su Avanti  .

5. Nel secondo passaggio, imposta la configurazione dell'invio in base al tipo di contenuto web.

  

Per saperne di più sul nodo "Invia contenuto web", clicca qui.

6. Nel terzo passaggio della configurazione, stabilisci la relazione tra i dati ottenuti nei nodi precedenti e le variabili create nel design del contenuto web.

Actualización variables - 8-min.png

7. Clicca su Fine  .

8. Nel workflow, clicca su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

Nodo "Invia email"

1. Accedi a "Workflows" e clicca su  Crea nuovo workflow. Se vuoi assegnare variabili in una strategia esistente, clicca su  Altro per aprire il menu e premi su Modifica.

  

Per seguire i passaggi di questa sezione, sarà necessario un design di email con variabili  e un workflow che contenga almeno un nodo "Invia email". 
Ricorda che puoi usare un modello esistente in Connectif, ad esempio, Campagna email di massa.

2. Nel nodo "Invia email", clicca su  (Modifica configurazione del nodo).

3. Seleziona il design di email con variabili.

4. Clicca su Avanti  .

5. Nel secondo passaggio, imposta la configurazione e i parametri di invio.

6. Nel terzo passaggio della configurazione, stabilisci la relazione tra i dati ottenuti nei nodi precedenti e le variabili create nel design del contenuto web.

Actualización variables - 9-min.png

7. Clicca su Fine  .

8. Nel workflow, clicca su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

Nodo "Mostra push"

1.  Accedi a "Workflows" e clicca su  Crea nuovo workflow. Se vuoi assegnare variabili in una strategia esistente, clicca su  Altro per aprire il menu e premi su Modifica.

  

Per seguire i passaggi di questa sezione, sarà necessario un design di notifica web push con variabili, e un workflow che contenga almeno un nodo "Mostra push".
Ricorda che puoi usare un modello esistente in Connectif, ad esempio, Richiedere iscrizione alle notifiche web push.

2. Nel nodo "Mostra push", clicca su  (Modifica configurazione del nodo).

3. Seleziona il design della notifica web push con variabili.

4. Clicca su Avanti  .

5. Nel secondo passaggio della configurazione, stabilisci la relazione tra i dati ottenuti nei nodi precedenti e le variabili create nel design del contenuto web.

Actualización variables - 10-min.png

6. Clicca su Fine  .

7. Nel workflow, clicca su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

Nodo "Invia SMS"

1.  Accedi a "Workflows" e clicca su  Crea nuovo workflow. Se vuoi assegnare variabili in una strategia esistente, clicca su  Altro per aprire il menu e premi su Modifica.

  

Per seguire i passaggi di questa sezione, sarà necessario un design di SMS con variabili e un workflow che contenga almeno un nodo "Invia SMS".
Ricorda che puoi usare un modello esistente in Connectif, ad esempio, Inviare un SMS dopo l'acquisto.

2. Nel nodo "Invia SMS", clicca su  (Modifica configurazione del nodo).

3. Seleziona il design di SMS con variabili.

4. Clicca su Avanti  .

5. Nel secondo passaggio, imposta la configurazione e i parametri di invio.

6. Nel terzo passaggio della configurazione, stabilisci la relazione tra i dati ottenuti nei nodi precedenti e le variabili create nel design dell'SMS.

Actualización variables - 11-min.png

7. Clicca su Fine  .

8. Nel workflow, clicca su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

2.5. Identificazione delle variabili

  

Nella colonna di sinistra viene mostrato un elenco dei dati ottenuti dai nodi precedenti del workflow.
Nella colonna di destra vengono elencate le variabili create nel contenuto dinamico.
La colonna centrale, vuota, serve per associare i dati alle variabili.

1. Assegna i dati ottenuti nel workflow alla variabile corrispondente.

  

Trascina i dati dall'elenco (colonna sinistra) che ti interessano nella colonna centrale per stabilire la relazione con la variabile (colonna destra).

Actualización variables - 12-min (2).png

 

Nel nostro esempio, sono state assegnate per prime le variabili con origine dei dati Contatto provenienti dal nodo "Inizio".

Actualización variables - 13 (1)-min.png

 

Nel nostro esempio, sono stati assegnati in secondo luogo i dati provenienti dal nodo "Ottieni prodotti", che contengono le informazioni sui prodotti, alle variabili del contenuto dinamico.

  

Alcune delle associazioni di variabili più comuni sono:
"Name" : Nome del contatto.
"Title" : Nome del prodotto.
"Description" : Descrizione dell'articolo.
"ButtonUrl" : URL dei dettagli del prodotto, alla scheda del prodotto nell'eCommerce.
"ImageUrl" : Immagine del prodotto.
"Price" : Prezzo attuale del prodotto.

 

Se vuoi saperne di più sui diversi dati inclusi nelle informazioni di prodotto, clicca qui.

2. (Opzionale). Assegna i valori letterali alle variabili che lo richiedono.

  

Un valore letterale è un dato definito, statico, che sarà comune per tutti i contatti, a differenza dei dati dinamici che cambiano in base al contatto e al suo comportamento.

Actualización variables - 14-min (1).png

 

Nel nostro esempio, i link dei pulsanti (buttonURL) portano sempre alla pagina del carrello, per questo si utilizza un valore letterale.

Il risultato sarebbe stato lo stesso se questo comportamento fosse stato implementato direttamente nella configurazione dei pulsanti nell'editor di contenuto.

3. Clicca su  Fine.

4. Nel workflow, clicca su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

  

 Congratulazioni!
Sei arrivato alla fine della lezione.

  

 Hai ancora dei dubbi?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, ti basta aprire un ticket all'assistenza cliccando sul pulsante blu “Aiuto” nella tua dashboard.

 


Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: