Aproveitar fragmentos em políticas de decisão fragments

Os itens de decisão são compatíveis com dois tipos de conteúdo de fragmento que podem ser aproveitados ao criar mensagens em uma política de decisão:

Fragmentos de conteúdo do Journey Optimizer ajo-fragments

Se a política de decisão contiver itens de decisão, incluindo fragmentos de conteúdo do AJO, você poderá aproveitar esses fragmentos ao criar uma mensagem na política de decisão em todos os canais nos quais a Decisão está disponível (experiência baseada em código, email, push, SMS e jornadas).

Por exemplo, digamos que você queira exibir conteúdos diferentes para vários modelos de dispositivos móveis. Adicione os fragmentos especificados, cada um pertencente a um modelo de telefone diferente, ao item de decisão que você está usando na política de decisão. Saiba como adicionar fragmentos a um item de decisão.

Seção de fragmentos de um item de decisão mostrando referências de fragmento e chaves de posicionamento. {width="70%"}

Depois de concluído, você pode usar um dos seguintes métodos:

Inserir o código diretamente

Basta copiar e colar o bloco de código abaixo no código de política de decisão. Substitua variable pela ID do fragmento e placement pela chave de referência do fragmento:

code language-handlebars
{% let variable =  get(item._experience.decisioning.offeritem.contentReferencesMap, "placement").id %}
{{fragment id = variable required=false}}
Siga as etapas detalhadas
  1. Navegue até as funções auxiliares e adicione a função Let {% let variable = expression %} {{variable}} ao painel de código, onde você pode declarar a variável para o fragmento.

    Editor de código de política de decisão mostrando a função Let helper adicionada ao painel de código.

  2. Use a função {%= get(map, string) %} de Mapa > Obter para criar sua expressão. O mapa é o fragmento referenciado no item de decisão. A cadeia de caracteres pode ser o modelo de dispositivo inserido no item de decisão como a Chave de referência do fragmento.

    As funções Map e Get são usadas para fazer referência ao mapa de fragmentos e à chave de referência do fragmento.

  3. Você também pode usar um atributo contextual que contenha essa ID de modelo de dispositivo.

    Atributo contextual selecionado para o identificador de modelo de dispositivo.

  4. Adicione a variável escolhida para o fragmento como a ID do fragmento.

    Variável de ID de fragmento definida a partir do item de decisão no código de política de decisão.

A ID do fragmento e a chave de referência serão selecionadas na seção Fragmentos do item de decisão.

WARNING
Se a chave do fragmento estiver incorreta ou se o conteúdo do fragmento não for válido, a renderização poderá falhar e causar um erro na chamada do Edge.
Para evitar falhas quando um fragmento estiver temporariamente indisponível, o sinalizador required=false é usado para que o fragmento seja ignorado. Saiba mais sobre fragmentos temporariamente indisponíveis

Uso e medidas de proteção fragments-guardrails

As seguintes medidas de proteção se aplicam especificamente aos fragmentos de conteúdo do AJO usados em itens de decisão.

Simular fragmentos de conteúdo e expressão em emails
Para o canal de Email, os fragmentos de expressão associados a um item de decisão são exibidos corretamente quando você Envia prova ou quando a campanha é ativada. No entanto, Simular conteúdo não exibe o fragmento de expressão do item de decisão.
Fragmentos visuais e itens de decisão em emails
Você não pode atribuir um Fragmento visual a um item de decisão. Somente fragmentos de expressão são suportados neste contexto.
Atributos de item de decisão e contexto

Atributos de item de decisão e atributos contextuais não são suportados por padrão em fragmentos Journey Optimizer. No entanto, você pode usar variáveis globais, conforme descrito abaixo.

Digamos que você queira usar a variável sport no fragmento.

  1. Faça referência a essa variável no fragmento, por exemplo:

    code language-text
    Elevate your practice with new {{sport}} gear!
    
  2. Defina a variável com a função Let no bloco de política de decisão. No exemplo abaixo, sport é definido com o atributo de item de decisão:

    code language-handlebars
    {#each decisionPolicy.13e1d23d-b8a7-4f71-a32e-d833c51361e0.items as |item|}}
    {% let sport = item._cjmstage.value %}
    {{fragment id = get(item._experience.decisioning.offeritem.contentReferencesMap, "placement1").id }}
    {{/each}}
    
Validação do conteúdo do fragmento do item de decisão
  • Devido à natureza dinâmica desses fragmentos, quando usados em uma campanha, a validação da mensagem durante a criação do conteúdo da campanha é ignorada para fragmentos referenciados em itens de decisão.

  • A validação do conteúdo do fragmento ocorre somente durante a criação e a publicação do fragmento.

  • Para fragmentos de expressão do tipo JSON, o conteúdo é validado sintaticamente ao salvar o fragmento. Os erros de validação são exibidos como alertas.

No tempo de execução, o conteúdo da campanha (incluindo o conteúdo de fragmentos de itens de decisão) é validado. No caso de uma falha de validação, a campanha não será renderizada.

Fragmentos indisponíveis temporariamente são ignorados {#temporary-unavailable-fragments}

Quando jornadas ou campanhas fazem referência a fragmentos anexados a itens de decisão, pode haver pequenos atrasos de sincronização antes que os fragmentos atualizados estejam disponíveis no Edge.

Para evitar falhas quando um fragmento estiver temporariamente indisponível, os fragmentos agora têm o sinalizador required definido como false por padrão, para que sejam ignorados em vez de causar falha na jornada ou na campanha.

Isso significa que, se o fragmento estiver temporariamente indisponível no Edge, ele será simplesmente ignorado. Se o fragmento estiver disponível, ele será renderizado normalmente.

Exemplo

Se sua política de decisão se qualificar para duas ofertas e cada uma tiver um fragmento — por exemplo, “20% de desconto” e “30% de desconto” — e o segundo fragmento estiver temporariamente indisponível, com required=false o sistema renderiza a oferta disponível (20% de desconto) e ignora o outro fragmento (30% de desconto) em vez de falhar na jornada ou campanha. Isso aumenta a confiabilidade quando o conteúdo ainda está sincronizando.

NOTE
Você ainda pode marcar um fragmento como obrigatório definindo o sinalizador required como true. No entanto, se um fragmento estiver temporariamente ausente, isso poderá causar falha na renderização da jornada ou da campanha.

Fragmentos de conteúdo do AEM aem-fragments-decisioning

AVAILABILITY
Esse recurso está disponível em Disponibilidade limitada para canais de saída com suporte à Decisão. Para solicitar acesso, entre em contato com o representante da Adobe.

Antes de aproveitar os fragmentos de conteúdo do AEM em uma política de decisão, verifique se você tem:

No editor de personalização, todos os Fragmentos de conteúdo do AEM associados aos itens de decisão selecionados pela política estão disponíveis. Uma pasta é exibida por nome de chave do fragmento.

Neste exemplo, a política de decisão inclui dois itens de decisão que têm fragmentos de AEM vinculados a eles por meio de seu nome de referência.

  1. Clique no botão + para adicionar o fragmento desejado à expressão.

    Como um único nome de referência pode ter vários fragmentos vinculados a ele em diferentes itens de oferta, o Decisioning determina o melhor a ser entregue a cada cliente com base nos critérios de classificação da política de decisão.

  2. Depois que o fragmento for selecionado, você poderá aproveitar seus atributos, como URLs de imagem, campos de texto ou outro conteúdo, e usar o Decisioning para exibir o conteúdo correto ao cliente certo na hora certa.

  3. Antes de ativar sua campanha ou jornada, você pode usar Simular conteúdo para visualizar como os valores de campo do Fragmento de conteúdo do AEM serão renderizados para um perfil de teste específico. Saiba mais sobre como simular conteúdo

recommendation-more-help
journey-optimizer-help