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:

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.


In questo articolo:


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 o nelle intestazioni

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.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
name Nome completo dalla richiesta
email Email dalla richiesta
phone Telefono dalla richiesta
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

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 CTA del modulo

Variabile Valore
cta.id ID CTA del modulo
cta.uuid UUID CTA del modulo
cta.title Nome CTA del modulo
cta_request.form_data Elenco dei dati inseriti dall'utente (separati da interruzioni di riga)
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Richiesta CTA lasciata

Variabili disponibili nei webhook di automazione (url, parametri)

Variabile Valore
referrer Referrer dalla prima visita conosciuta del contatto (Kwiga / landing con CTA)
initial_page Url della prima visita conosciuta del contatto (Kwiga / landing con CTA)
reg_from Url della pagina da cui è avvenuta la registrazione (Kwiga / landing con CTA)
tags Tag del contatto (separatore ", ")
description Descrizione dell'evento che ha attivato l'automazione. Ad esempio: Aggiunto tag test_tag al contatto

Variabili del prodotto

Variabile Valore
product.id ID del prodotto
product.title Nome del prodotto
product.productable_type Tipo di prodotto. Possono essere: course, webinar, closed_group, custom_product
product.productable_id ID del corso/webinar/gruppo chiuso/prodotto personalizzato

Disponibili al verificarsi dei seguenti eventi:

  • Accesso al prodotto aperto
  • Accesso al prodotto chiuso
  • Registrato al webinar
  • Corso completato
  • Completamento del quiz
  • Annullamento del risultato precedente del quiz
  • Il quiz è passato allo stato
  • Inizio accesso tramite abbonamento
  • Fine accesso tramite abbonamento
  • Iniziato a guardare la lezione
  • Lezione guardata
  • Accesso alla lezione aperto
  • Pratica sulla lezione completata

Variabili dell'ordine

Variabile Valore
order.id ID dell'ordine
order.price Prezzo finale. Esempio 10.99
order.currency_code Valuta dell'ordine in formato codice. Esempio: USD
order.currency_symbol Valuta dell'ordine in formato simbolo. Esempio: $
order.currency_short_title Valuta dell'ordine in nome abbreviato. Esempio: usd
order.order_stage_id ID dello stato del funnel
order.order_stage_title Nome dello stato del funnel
order.funnel_id ID del funnel
order.funnel_title Nome del funnel
order.paid_status Stato del pagamento dell'ordine not_paid / partial_paid / paid
order.paid_status_title Stato del pagamento in parole inglesi
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Abbonamento iniziato
  • Abbonamento rinnovato
  • Pagamento dell'ordine riuscito
  • Nuovo ordine
  • Pagamento dell'offerta riuscito
  • Rimborso dell'offerta
  • Accesso al prodotto aperto
  • Inizio accesso tramite abbonamento
  • Fine accesso tramite abbonamento

Variabili del pagamento

Variabile Valore
payment.id ID del pagamento
payment.price Prezzo del pagamento
payment.currency_code Valuta del pagamento in formato codice. Esempio: USD
payment.currency_symbol Valuta del pagamento in formato simbolo. Esempio: $
payment.currency_short_title Valuta del pagamento in nome abbreviato. Esempio: usd
payment.created_at Data di creazione del pagamento. Formato YYYY-MM-DD HH:mm:ss
payment.paid_at Data del pagamento. Formato YYYY-MM-DD HH:mm:ss
payment.schedule_payment_at Data di pagamento pianificata. Formato YYYY-MM-DD HH:mm:ss
платіж.номер Numero sequenziale del pagamento nell'ordine
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Pagamento dell'offerta riuscito
  • Rimborso dell'offerta

Variabili dell'offerta

Variabile Valore
offer.id ID dell'offerta
offer.title Nome dell'offerta
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Pagamento dell'offerta riuscito
  • Rimborso dell'offerta
  • Offerta gratuita accettata
  • Abbonamento iniziato
  • Abbonamento rinnovato
  • Pagamento dell'ordine riuscito
  • Nuovo ordine
  • Accesso al prodotto aperto
  • Inizio accesso tramite abbonamento
  • Fine accesso tramite abbonamento

Variabili dell'abbonamento al prodotto

Variabile Valore
subscription.id ID abbonamento al prodotto
subscription.start_at Data di inizio abbonamento. YYYY-MM-DD HH:mm:ss
subscription.end_at Data finale di scadenza abbonamento. YYYY-MM-DD HH:mm:ss
subscription.order_end_at Data di scadenza abbonamento, considerando solo i pagamenti effettuati. YYYY-MM-DD HH:mm:ss
subscription.paid_at Data del primo pagamento dell'abbonamento. YYYY-MM-DD HH:mm:ss
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Accesso al prodotto aperto
  • Inizio accesso tramite abbonamento
  • Fine accesso tramite abbonamento

Variabili del tentativo di quiz

Variabile Valore
quiz_attempt.id ID tentativo
quiz_attempt.number_version Numero di versione del passaggio
quiz_attempt.quiz_id ID quiz
quiz_attempt.course_id ID corso
quiz_attempt.course_lesson_id ID lezione
quiz_attempt.status_id ID stato
quiz_attempt.status Stato in formato testuale
quiz_attempt.scores Punti ottenuti
quiz_attempt.created_at Inizio tentativo. Formato YYYY-MM-DD HH:mm:ss
quiz_attempt.finished_at Fine tentativo. Formato YYYY-MM-DD HH:mm:ss
quiz_attempt.count_questions Numero di domande nel quiz
quiz_attempt.count_questions_incorrect Numero di domande a cui è stata data risposta errata
quiz_attempt.count_questions_correct Numero di domande a cui è stata data risposta corretta
quiz.title Nome del quiz
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Completamento del quiz
  • Annullamento del risultato precedente del quiz
  • Il quiz è passato allo stato

Variabili della lezione

Variabile Valore
lesson.id ID lezione
lesson.title Nome della lezione
L'elenco può essere ampliato.

Disponibili al verificarsi dei seguenti eventi:

  • Completamento del quiz
  • Annullamento del risultato precedente del quiz
  • Il quiz è passato allo stato
  • Iniziato a guardare la lezione
  • Lezione guardata
  • Accesso alla lezione aperto
  • Pratica sulla lezione completata