Sfruttare i frammenti di espressione use-expression-fragments

Quando utilizzi l'editor di personalizzazione, puoi sfruttare tutti i frammenti di espressione creati o salvati nella sandbox corrente.

Un frammento è un componente riutilizzabile a cui è possibile fare riferimento in Journey Optimizer campagne e percorsi. Questa funzionalità consente di precreare più blocchi di contenuto personalizzati che possono essere utilizzati dagli utenti di marketing per assemblare rapidamente i contenuti in un processo di progettazione migliorato. Ulteriori informazioni sui frammenti

➡️ Scopri come gestire, creare e utilizzare i frammenti in questo video

Utilizzare un frammento di espressione use-expression-fragment

Per aggiungere frammenti di espressione al contenuto, segui i passaggi seguenti.

Usa variabili implicite implicit-variables

Le variabili implicite migliorano la funzionalità dei frammenti esistenti per migliorare l’efficienza in termini di riutilizzabilità dei contenuti e casi di utilizzo di script. I frammenti possono utilizzare variabili di input e creare variabili di output che possono essere utilizzate nel contenuto di campagne e percorsi.

Questa funzionalità può essere utilizzata, ad esempio, per inizializzare i parametri di tracciamento delle e-mail, in base alla campagna o al percorso corrente, e utilizzarli nei collegamenti personalizzati aggiunti al contenuto dell’e-mail.

Sono possibili i seguenti casi d’uso:

Utilizzare frammenti di espressione all’interno di cicli fragments-in-loops

Quando si utilizzano frammenti di espressione nei cicli di {{#each}}, è importante comprendere come funziona l'ambito delle variabili. I frammenti di espressione possono accedere alle variabili globali definite nel contenuto del messaggio, ma non possono ricevere variabili specifiche per il ciclo come parametri.

Schema supportato: utilizza variabili globali global-variables-in-loops

I frammenti di espressione possono fare riferimento a variabili globali definite all’esterno del frammento, anche quando il frammento viene chiamato dall’interno di un loop. Questo è l’approccio consigliato quando devi utilizzare frammenti in contesti iterativi.

Esempio: utilizzo di un frammento con variabili globali all'interno di un loop

Nel contenuto del messaggio, definisci una variabile globale e utilizza un frammento che vi faccia riferimento:

{% let globalDiscount = 15 %}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{fragment id='ajo:fragment123/variant456' mode='inline'}}
  </div>
{{/each}}

Nel frammento di espressione (fragment123), è possibile fare riferimento alla variabile globalDiscount:

<p class="discount-info">Save {{globalDiscount}}% on all items!</p>

Questo modello funziona perché la variabile globale è accessibile in tutto il messaggio, inclusi i frammenti, indipendentemente dal contesto del loop.

Non supportato: passaggio delle variabili di loop come parametri di frammento loop-variables-limitations

Impossibile passare l'elemento di iterazione corrente (ad esempio product nell'esempio precedente) come parametro a un frammento di espressione. Il frammento non può accedere direttamente alle variabili con ambito di loop dal blocco {{#each}} circostante.

Esempio: cosa NON funziona

{{#each context.journey.actions.GetProducts.items as |product|}}
  <!-- This will NOT work as expected -->
  {{fragment id='ajo:fragment123/variant456' mode='inline' currentProduct=product}}
{{/each}}

Il frammento non può ricevere product come parametro e utilizzarlo internamente perché il passaggio del parametro per variabili specifiche del ciclo non è supportato nell'implementazione corrente.

Soluzioni consigliate fragments-in-loops-workarounds

Quando devi utilizzare frammenti di espressione con dati provenienti da un ciclo, considera questi approcci:

Personalizza campi modificabili customize-fields

Se alcune parti di un frammento di espressione sono state rese modificabili utilizzando le variabili, è possibile sovrascrivere i relativi valori predefiniti utilizzando una sintassi specifica. Scopri come rendere personalizzabili i tuoi frammenti

Per personalizzare i campi, effettua le seguenti operazioni:

Un esempio che mostra come aggiungere campi modificabili in un frammento di espressione e ignorarne i valori durante la creazione di un messaggio e-mail è disponibile in questa sezione.

Interrompi ereditarietà break-inheritance

Quando si aggiunge un ID frammento all’editor di personalizzazione, le modifiche apportate al frammento di espressione originale vengono sincronizzate.

Tuttavia, puoi anche incollare il contenuto di un frammento di espressione nell’editor. Dal menu contestuale, seleziona Incolla frammento per inserire tale contenuto.

In tal caso, l’ereditarietà dal frammento originale è interrotta. Il contenuto del frammento viene copiato nell’editor e le modifiche non vengono più sincronizzate.

Diventa un elemento autonomo non più collegato al frammento originale; puoi modificarlo come qualsiasi altro elemento nel codice.