Kwiga Help Center Servizi, integrazioni, API, Impostazioni Impostazioni generali Utilizzo delle variabili nel progetto, elenco delle variabili disponibili

Utilizzo delle variabili nel progetto, elenco delle variabili disponibili

Articoli:

3 settimane fa • Aggiornato

Questo articolo spiega come utilizzare le variabili nel tuo progetto: dove applicarle, quali dati sono disponibili e come usarle per l'automazione e la personalizzazione. Include un elenco con descrizioni ed esempi per email, webhook, pulsanti, lezioni e altro ancora.

Informazioni generali sulle variabili

Le variabili sono un modo conveniente per inserire dati personalizzati in vari elementi del tuo progetto. Possono essere utilizzate nei seguenti contesti:

1. Webhook nelle automazioni

Le variabili possono essere inserite:

nell'URL del webhook, ad esempio:
https://example.com/hook?user={user.email}
nei parametri del corpo della richiesta
negli header

Questo consente di trasmettere automaticamente dati personali a servizi di terze parti.

2. CTA (Call to Action)

Nelle pulsanti e nei link, le variabili possono essere utilizzate per:

personalizzare il testo del pulsante
trasmettere dati attraverso i link, come l'ID utente o i tag UTM

3. Nei parametri

Le variabili possono essere utilizzate nei parametri dei moduli o di altri elementi:

email dell'utente
ID dell'abbonamento
codici unici e tag
qualsiasi altra variabile disponibile nel contesto

4. Nel link di reindirizzamento (se non si utilizza il passaggio al pagamento)

È possibile aggiungere manualmente variabili nel link di reindirizzamento:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Nei blocchi informativi delle lezioni

Le variabili funzionano all'interno dei testi dei blocchi informativi. Ad esempio:

Saluto per nome: Ciao, {user.first_name}!
Visualizzazione del nome del corso, della data, dello stato, ecc.

6. Nelle email

L'uso delle variabili nelle email consente di rendere la comunicazione più personalizzata ed efficace. Con variabili come {nome}, {data} o {nome del corso}, l'email appare indirizzata personalmente al cliente. Questo aumenta la fiducia, il coinvolgimento e la probabilità che l'utente legga l'email fino alla fine o esegua l'azione desiderata. Inoltre, le variabili semplificano l'automazione degli invii di massa senza perdere l'approccio individuale.

Elenco delle variabili disponibili

Elenco delle variabili disponibili che possono essere utilizzate ovunque sia possibile usare variabili.

Variabile	Valore
contact.id	ID del contatto
contact.user_id	ID dell'utente
contact.first_name	Nome del contatto
contact.last_name	Cognome del contatto
contact.middle_name	Patronimico del contatto
contact.name	Nome completo del contatto
contact.email	Email del contatto
contact.phone	Telefono del contatto
contact.country	Paese del contatto. Ad esempio: Ucraina
contact.timezone	Fuso orario del contatto. Ad esempio: Europe/Kyiv
contact.currency	Valuta del contatto. Ad esempio: USD
contact.city	Città del contatto
contact.utm_source	Elenco delle utm_source uniche del contatto (separatore ", ")
contact.utm_medium	Elenco unico di contatti utm_medium (separatore ", ")
contact.utm_campaign	Elenco unico di contatti utm_campaign (separatore ", ")
contact.utm_term	Elenco unico di contatti utm_term (separatore ", ")
contact.utm_content	Elenco unico di contatti utm_content (separatore ", ")
contact.field_<id>	Campi personalizzati (descrizione sotto)
datetime	Data e ora in UTC nel formato YYYY-MM-DD HH:mm:ss
contact.visit_source	Fonte della visita

Campi personalizzati

{contact.field_<id>}

Esempio {contact.field_123}

<id> - id del campo che può essere ottenuto nelle impostazioni dei campi di contatto (esempio https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Variabili che possono essere utilizzate ulteriormente nei CTA

nei parametri
nel link di reindirizzamento (se non si utilizza il passaggio al pagamento)

Variabile	Valore
first_name	Nome dalla richiesta
last_name	Cognome dalla richiesta
middle_name	Secondo nome dalla domanda
name	Nome completo dalla richiesta
email	Email dalla richiesta
phone	Telefono dalla richiesta
field_<id>	Campi personalizzati Telefono dalla domanda (descrizione sotto)
utm_source	utm_source - specifico della visita da cui è stata inviata la richiesta
utm_medium	utm_medium - specifico della visita da cui è stata inviata la richiesta
utm_campaign	utm_campaign - specifico della visita da cui è stata inviata la richiesta
utm_term	utm_term - specifico della visita da cui è stata inviata la richiesta
utm_content	utm_content - specifico della visita da cui è stata inviata la richiesta
widget_landing	Url della landing da cui è stata inviata la richiesta
widget_landign_referer	Referer che era sulla landing quando è stata inviata la richiesta
In alcune forme possono essere disponibili le variabili descritte di seguito nelle Variabili disponibili nei webhook di automazione Per ordine ({order.}) - Se è selezionata l'opzione di modulo Accesso al prodotto (Accesso completo/Per offerta) Per prodotto({product.}) - Se è selezionata l'opzione di modulo Accesso al prodotto + Accesso completo Per offerta ({offer.*}) - Se è selezionata l'opzione di modulo Accesso al prodotto + Per offerta

Campi personalizzati

{field_<id>}

Esempio {contact.field_123}

<id> - id del campo che può essere ottenuto nelle impostazioni dei campi di contatto (esempio https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Se sulla pagina dove è posizionato il CTA o lo script Kwiga per il tracciamento delle visite ci sono state visite con tag utm, e il cliente ha lasciato una richiesta sulla landing page già senza tag utm, allora in queste variabili saranno assenti. Ma saranno disponibili nelle variabili {contact.utm_...}, che sono descritte sopra.

Variabili disponibili nei webhook di automazione (url, parametri, email)