Panoramica
Le variabili dinamiche ti consentono di personalizzare le Email per i singoli contatti sfruttando i dati di Apollo e, nel caso delle variabili dinamiche personalizzate, le tue ricerche sui dati. Le variabili dinamiche avanzate sono leggermente diverse dalle variabili dinamiche di base perché consentono una logica condizionale limitata.
Questo significa che le variabili dinamiche avanzate possono fornire un fallback se non ci sono dati per un campo specifico di un contatto. Puoi usare la logica condizionale nelle Prompt di ricerca AI o nelle Email con variabili per aiutarle a essere inviate correttamente.
Consulta le sezioni seguenti per saperne di più sulle variabili dinamiche avanzate.
Tipi di variabili dinamiche avanzate
Le variabili dinamiche avanzate sono disponibili in diversi tipi:
- Fallback vuoto
- Fallback dinamico
- Operatori di maiuscole/minuscole e pluralizzazione
- Operatori data/ora attuale
- Operatori data personalizzata
Ognuno di questi tipi di variabili dinamiche avanzate ti consente di personalizzare ulteriormente i modelli Email per i tuoi clienti.
Fallback vuoto
Usa la variabile dinamica avanzata con fallback vuoto per inviare Email senza temere che non vengano inviate perché una variabile dinamica di base non ha dati. Con un fallback vuoto, la tua Email viene inviata con uno spazio vuoto al posto della variabile se Apollo non ha dati per un contatto.
Immagina di voler inviare un'Email che saluti ogni destinatario per nome. Potresti usare la {{first_name}} variabile dinamica di base per dire:
Greetings {{first_name}},
Tuttavia, se Apollo non ha il nome di un contatto nella tua sequenza, la variabile dinamica non viene risolta e Apollo sposta la tua Email nella cartella Non inviata.
Per evitare questa situazione, usa la variabile dinamica avanzata {{#if first_name}}{{#endif}} per creare un fallback generico:
Greetings {{#if first_name}}{{#endif}},
Se Apollo ha i dati per un destinatario Email, la variabile dinamica viene visualizzata nell'Email:
Greetings John,
Se Apollo non ha i dati, l'Email viene comunque inviata con uno spazio vuoto al posto della variabile dinamica:
Greetings ,
Fallback dinamico
Le variabili dinamiche avanzate con fallback dinamico fanno un passo in più rispetto a quelle con fallback vuoto. Queste variabili dinamiche inseriscono il testo che definisci nel caso in cui non ci siano dati pertinenti per un contatto.
Immagina di voler usare un testo generico se il nome del destinatario non è disponibile. Per farlo, usa la seguente variabile dinamica avanzata per creare un fallback dinamico:
Hi {{#if first_name}}{{first_name}}{{#else}}there{{#endif}},
Se Apollo ha i dati per un destinatario Email, il nome viene visualizzato nell'Email:
Hi John,
Se Apollo non ha i dati necessari, l'Email viene visualizzata con there al posto della variabile:
Hi there,
È importante capire cosa fa ogni parte della variabile dinamica. La prima parte, {{#if firstname}}{{firstname}}, indica l'inizio della logica condizionale. Dice ad Apollo "Se esiste un valore per il nome, visualizza quel primovalore del nome nell'Email aperta". È simile alla variabile dinamica di base {{firstname}}, con l'aggiunta di un Prompt {{#if}}.
La parte successiva, {{#else}}there, dice ad Apollo "Se non è disponibile alcun valore del nome per questo contatto, usa invece il testo there".
La parte finale, {{#endif}}, indica ad Apollo che questa è la fine della logica condizionale per questa variabile dinamica.
Operatori di maiuscole/minuscole e pluralizzazione
Le variabili dinamiche avanzate con operatori di maiuscole/minuscole e pluralizzazione prendono il valore di un campo e ne modificano le maiuscole/minuscole o la pluralizzazione.
Questi tipi avanzati di variabili dinamiche funzionano solo con tipi di campo string. Non funzionano con altri tipi di campo.
Gli esempi seguenti mostrano come utilizzare gli operatori di maiuscole/minuscole e pluralizzazione:
| Variabili dinamiche | Descrizione | Esempio |
|---|---|---|
{{title->lowercase}} |
Prende il valore della qualifica di un contatto e converte tutte le lettere in minuscolo. |
Engineering Manager diventa engineering manager
|
{{title->capitalize_each_word}} |
Prende il valore della qualifica di un contatto e converte in maiuscola la prima lettera di ogni parola. |
engineering manager diventa Engineering Manager
|
{{title->plural}} |
Prende il valore della qualifica di un contatto e lo converte nella forma plurale. |
Engineering Manager diventa Engineering Managers
|
Aggiungi un -> all'interno della variabile per combinare più operatori di maiuscole/minuscole e pluralizzazione. Ad esempio, per convertire la qualifica di un contatto in maiuscolo e nella forma plurale, combina gli operatori all'interno della stessa variabile:
{{title->capitalize_each_word->plural}}
Questa variabile dinamica visualizza la qualifica engineering manager come Engineering Managers.
Operatori Now-Date/Time
Le variabili dinamiche avanzate con gli operatori {{nowmonth}}, {{nowday}}, e {{now_time}} prendono la data corrente e la modificano in vari modi.
Questi tipi avanzati di variabili dinamiche funzionano solo con tipi di campo date. Non funzionano con altri tipi di campo.
I seguenti esempi mostrano come è possibile usare gli operatori di data e ora correnti:
| Variabili dinamiche | Descrizione | Esempio |
|---|---|---|
{{now_day->plus_X}} |
Prende il giorno corrente e lo sposta in avanti del numero specificato di giorni lavorativi. Se il numero di giorni lavorativi supera il numero di giorni del mese corrente, Apollo gestisce il passaggio e continua il conteggio dal primo giorno del mese successivo. Qui puoi usare qualsiasi numero intero (integer) . |
Se oggi è il 15° giorno del mese ed è mercoledì, la variabile dinamica {{now_day->plus_5}} viene visualizzata come 22 nell'Email aperta. |
{{now_day->minus_X}} |
Prende il giorno corrente e lo sposta indietro del numero specificato di giorni lavorativi. Se il numero di giorni lavorativi supera il numero di giorni del mese corrente, Apollo gestisce il passaggio e continua il conteggio dall'ultimo giorno del mese precedente. Qui puoi usare qualsiasi numero intero (integer) . |
Se oggi è il 15° giorno del mese ed è mercoledì, la variabile dinamica {{now_day->minus_5}} viene visualizzata come 8 nell'Email aperta. |
{{now_month->plus_X}} |
Prende il mese corrente e lo sposta in avanti del numero specificato di mesi. Puoi usare qualsiasi numero intero (integer) compreso tra 1 e 11. |
Se il mese corrente è aprile, la variabile dinamica {{now_month->plus_1}} viene visualizzata come May nell'Email aperta. |
{{now_month->minus_X}} |
Prende il mese corrente e lo sposta indietro del numero specificato di mesi. Puoi usare qualsiasi numero intero (integer) compreso tra 1 e 11. |
Se il mese corrente è aprile, la variabile dinamica {{now_month->minus_2}} viene visualizzata come February nell'Email aperta. |
{{now_year->plus_X}} |
Prende l'anno corrente e lo sposta in avanti del numero specificato di anni. Qui puoi usare qualsiasi numero intero (integer). |
Se l'anno corrente è il 2024, la variabile dinamica {{now_year->plus_2}} verrà visualizzata come 2026 nell'Email aperta. |
{{now_year->minus_X}} |
Prende l'anno corrente e lo sposta indietro del numero specificato di anni. Qui puoi usare qualsiasi numero intero (integer). |
Se l'anno corrente è il 2024, la variabile dinamica {{now_year->minus_1}} verrà visualizzata come 2023 nell'Email aperta. |
{{now_time_of_day}} |
Mostra la fase temporale corrente della giornata (morning, afternoon, evening). |
Se l'ora attuale è le 9:00, la variabile dinamica Good {{now_time_of_day}}, viene visualizzata come Good morning, nell'email aperta. |
Operatori data personalizzati
I campi personalizzati e le variabili dinamiche che usano operatori data personalizzati sono disponibili solo per i clienti con determinati piani Apollo. Se non hai accesso e vuoi passare a un piano superiore, contatta il team commerciale di Apollo.
Le variabili dinamiche avanzate con operatori data personalizzati usano campi personalizzati configurati per le date e li manipolano in vari modi.
Questi tipi avanzati di variabili dinamiche funzionano solo con i tipi di campo date-type. Non funzionano con altri tipi di campo.
Immagina di creare un campo personalizzato chiamato product_announcement per la data dell'annuncio annuale del tuo prodotto, che si terrà il 15 ottobre 2024. Quel campo personalizzato include mese, giorno e anno, quindi puoi usare operatori data personalizzati in una variabile dinamica per estrarre elementi specifici.
La variabile dinamica {{productannouncement->day}} viene visualizzata come 15, la variabile dinamica {{productannouncement->month}} viene visualizzata come October, e la variabile dinamica {{product_announcement->year}} viene visualizzata come 2024 nell'email aperta.
Inoltre, puoi usare la variabile dinamica {{product_announcement->weekday}} per estrarre il giorno della settimana della tua data personalizzata. In questo caso, viene visualizzata come Tuesday nell'email aperta perché il 15 ottobre 2024 è un martedì.
Esempio di caso d'uso per variabili dinamiche avanzate
In questo esempio, il testo è formattato per distinguere le variabili dinamiche dal testo normale e sono state inserite interruzioni di riga tra ogni Prompt di logica condizionale per facilitarne la lettura. In Apollo, devi scrivere le variabili dinamiche come un'unica riga continua.
Per ulteriore contesto, dai un'occhiata a un esempio reale di come usare le variabili dinamiche avanzate nel tuo modello email. All'interno di un Task email automatico, abbiamo creato un modello email con un testo che usa diversi tipi di variabili dinamiche avanzate.
Ciao
{{#if first_name}}{{first_name}}{{#else}}there{{#endif}},Sappiamo che molte aziende come
{{#if industry == Marketing}}Company 1 {{#else}}{{#if industry == Big Data}}Company 2 {{#else}}Company 3{{#endif}}{{#endif}}stanno cercando nuovi strumenti da implementare per
{{now_year->plus_1}}, e ci piacerebbe illustrarti la nostra piattaforma così che tu possa comprendere bene tutte le nostre funzionalità.{{now_weekday->plus_2}}o{{now_weekday->plus_3}}{{now_time_of_day}}funzionano per te?
Spiegazione del caso d'uso: variabili dinamiche nidificate che puntano a valori di campo specifici
La variabile dinamica {{#if firstname}}{{firstname}}{{#else}}there{{#endif}} imposta un fallback per il nome, che verrà visualizzato come there se non sono disponibili dati sul nome del destinatario dell'email.
La parte {{#if industry == Marketing}}Company 1 della variabile dinamica indica ad Apollo di visualizzare il testo come Company 1 se il campo Settore del destinatario dell'email è Marketing.Marketing. Se il settore non è
La parte {{#else}}{{#if industry == Big Data}}Company 2 indica ad Apollo di visualizzare il testo come Company 2 se il campo Settore del destinatario dell'email è Big Data. Se il campo Settore non è Marketing o Big Data, Apollo passa alla parte di fallback della logica condizionale.
La variabile dinamica {{#else}}Company 3 è il fallback se il campo Settore del destinatario dell'email non corrisponde a Marketing o Big Data. In questo caso, il testo viene visualizzato come Company 3 nell'email aperta.
La parte finale della variabile dinamica, {{#endif}}{{#endif}}, chiude la logica condizionale. Sono necessarie due Prompt {{endif}} perché ci sono Prompt {{#if}} nidificate.
{{endif}} ho bisogno?Come regola generale, per ogni Prompt {{#if}} nella tua variabile dinamica, ti serve una corrispondente {{#endif}} per chiudere la variabile dinamica.
Spiegazione del caso d'uso: variabili dinamiche now-time
La variabile dinamica {{now_year->plus_1}} indica ad Apollo di prendere l'anno corrente 2024 e aggiungervi 1 anno. Quando il destinatario apre questa Email, questa variabile viene visualizzata come 2025.
La variabile dinamica {{now_weekday->plus_2}} indica ad Apollo di prendere il giorno corrente della settimana e farlo avanzare di 2 giorni. Se Apollo invia l'Email di lunedì, il testo nell'Email viene visualizzato come Wednesday. Se Apollo invia questa Email di giovedì, il testo visualizzerà la variabile dinamica come Monday perché è il giorno feriale successivo disponibile.
La variabile dinamica {{now_weekday->plus_3}} indica ad Apollo di prendere il giorno corrente della settimana e farlo avanzare di 3 giorni. Se Apollo invia l'Email di martedì, il testo nell'Email verrà visualizzato come Friday. Se Apollo invia l'Email di mercoledì, il testo viene visualizzato come Monday. Apollo visualizza la variabile dinamica come il giorno lavorativo successivo disponibile se il giorno della settimana specificato dalla variabile dinamica cade in un giorno del fine settimana.
Infine, la {{now_time_of_day}} variabile dinamica indica ad Apollo di mostrare la fase oraria corrente della giornata per il destinatario in base alla sua ora locale nel suo fuso orario locale (quando disponibile) e visualizza morning, afternoon, o evening.