Aproveitar fragmentos de expressão use-expression-fragments

Ao usar o editor de personalização, você pode aproveitar todos os fragmentos de expressão criados ou salvos na sandbox atual.

Um fragmento é um componente reutilizável que pode ser referenciado em Journey Optimizer campanhas e jornadas. Essa funcionalidade permite pré-construir vários blocos de conteúdo personalizado que podem ser usados por usuários de marketing para reunir conteúdo rapidamente em um processo de design aprimorado. Saiba mais sobre fragmentos

➡️ Saiba como gerenciar, criar e usar fragmentos neste vídeo

Usar um fragmento de expressão use-expression-fragment

Para adicionar fragmentos de expressão ao seu conteúdo, siga as etapas abaixo.

Usar variáveis implícitas implicit-variables

As variáveis implícitas aprimoram a funcionalidade do fragmento existente para melhorar a eficiência da reutilização de conteúdo e dos casos de uso de script. Os fragmentos podem usar variáveis de entrada e criar variáveis de saída que podem ser usadas no conteúdo da campanha e da jornada.

Esse recurso pode, por exemplo, ser usado para inicializar parâmetros de rastreamento de seus emails, com base na campanha ou jornada atual, e usar esses parâmetros nos links personalizados adicionados ao conteúdo do email.

Os seguintes casos de uso são possíveis:

Usar fragmentos de expressão dentro de loops fragments-in-loops

Ao usar fragmentos de expressão em loops {{#each}}, é importante entender como funciona o escopo de variáveis. Os fragmentos de expressão podem acessar variáveis globais definidas no conteúdo da mensagem, mas não podem receber variáveis específicas de loop como parâmetros.

Padrão compatível: usar variáveis globais global-variables-in-loops

Os fragmentos de expressão podem fazer referência a variáveis globais definidas fora do fragmento, mesmo quando o fragmento é chamado de dentro de um loop. Essa é a abordagem recomendada quando você precisa usar fragmentos em contextos iterativos.

Exemplo: usando um fragmento com variáveis globais dentro de um loop

No conteúdo da mensagem, defina uma variável global e use um fragmento que faça referência a ela:

{% 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}}

No fragmento de expressão (fragment123), é possível fazer referência à variável globalDiscount:

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

Esse padrão funciona porque a variável global pode ser acessada em toda a mensagem, incluindo em fragmentos, independentemente do contexto do loop.

Não suportado: transmitir variáveis de loop como parâmetros de fragmento loop-variables-limitations

Você não pode passar o item de iteração atual (por exemplo, product no exemplo acima) como um parâmetro para um fragmento de expressão. O fragmento não pode acessar diretamente variáveis de escopo de loop do bloco {{#each}} ao redor.

Exemplo: o que NÃO funciona

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

O fragmento não pode receber product como parâmetro e usá-lo internamente porque a passagem de parâmetro para variáveis específicas de loop não tem suporte na implementação atual.

Soluções alternativas recomendadas fragments-in-loops-workarounds

Quando precisar usar fragmentos de expressão com dados de um loop, considere estas abordagens:

Personalizar campos editáveis customize-fields

Se determinadas partes de um fragmento de expressão se tornaram editáveis usando variáveis, é possível substituir os valores padrão usando uma sintaxe específica. Saiba como tornar seus fragmentos personalizáveis

Para personalizar os campos, siga estas etapas:

Um exemplo mostrando como adicionar campos editáveis em fragmentos de expressão e substituir seus valores ao criar um email está disponível em esta seção.

Interromper herança break-inheritance

Ao adicionar uma ID de fragmento ao editor de personalização, as alterações feitas no fragmento de expressão original são sincronizadas.

No entanto, também é possível colar o conteúdo de um fragmento de expressão no editor. No menu contextual, selecione Colar fragmento para inserir esse conteúdo.

Nesse caso, a herança do fragmento original é quebrada. O conteúdo do fragmento é copiado para o editor e as alterações não são mais sincronizadas.

Ele se torna um elemento independente que não está mais vinculado ao fragmento original; você pode editá-lo como qualquer outro elemento no seu código.