Usar fragmentos dinâmicos dynamic-fragments

Nesta página: Saiba como usar a resolução de fragmento dinâmico no Adobe Journey Optimizer para selecionar qual fragmento publicado é inserido em uma mensagem no tempo de execução, com base em atributos de perfil, pesquisas de conjunto de dados ou dados de contexto passados no momento do envio.

Adobe Journey Optimizer dá suporte a resolução dinâmica de fragmento em tempo de execução, permitindo que você selecione qual fragmento publicado é inserido em uma mensagem com base em atributos de perfil, pesquisas de conjunto de dados ou dados de contexto passados no momento do envio. Isso permite conteúdo altamente personalizado sem duplicar a lógica de campanha ou jornada.

Visão geral overview

Fragmentos estáticos são inseridos em uma mensagem em tempo de design — o mesmo fragmento é usado para cada destinatário. Fragmentos dinâmicos resolvem a ID do fragmento em tempo de execução por destinatário, o que significa que perfis diferentes podem receber blocos de conteúdo totalmente diferentes na mesma campanha ou jornada.

As IDs de fragmento dinâmico podem vir de três fontes:

Pré-requisitos prerequisites

Antes de usar fragmentos dinâmicos, verifique se os seguintes itens estão em vigor:

Etapa 1: criar e publicar o fragmento create-fragment

Antes de fazer referência dinâmica a um fragmento, ele deve ser publicado em Journey Optimizer.

Etapa 2: criar a mensagem com uma referência de fragmento dinâmico author-message

No editor de personalização, insira o espaço reservado do fragmento dinâmico usando a seguinte sintaxe:

{{fragment id=dynamic_fragment_id}}

O identificador dynamic_fragment_id é um nome de variável. Seu valor deve ser resolvido antes que ocorra a pesquisa de fragmento. Você o resolve usando uma expressão de pesquisa do conjunto de dados, um atributo de perfil ou dados de contexto.

Resolver a partir de uma pesquisa de conjunto de dados resolve-from-dataset

Se a ID do fragmento for armazenada em um conjunto de dados do AEP (por exemplo, uma tabela de mapeamento de estilo para fragmento), use a função auxiliar datasetLookup para resolvê-la:

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

Neste exemplo, o conjunto de dados contém linhas com chave de um valor de estilo (como style1). Para um determinado perfil, a pesquisa recupera o valor da coluna fragmentId correspondente e o atribui a dynamic_fragment_id, que é usado para resolver o fragmento.

Resolver a partir dos dados de contexto resolve-from-context

Se a ID do fragmento for fornecida no momento do envio como parte do contexto de solicitação de API, referencie-a usando o namespace context:

{{fragment id=context.audiencePayload.fragmentId}}

O caminho context.audiencePayload é o prefixo necessário para todos os atributos originados de um arquivo de público-alvo CSV ou transmitidos pelo contexto de solicitação de API. O nome da coluna do CSV (por exemplo, fragmentId) segue o prefixo.

Resolver a partir de um atributo de perfil resolve-from-profile

Se a ID do fragmento for armazenada como um atributo de perfil no Adobe Experience Platform, faça referência a ela diretamente:

{{fragment id=profile.mi.fragmentId}}

Etapa 3: configurar seu conjunto de dados para a abordagem de pesquisa configure-dataset

Se você estiver usando a abordagem de pesquisa do conjunto de dados, atualize o esquema do conjunto de dados e os dados para carregar a ID do fragmento.

Exemplo de estrutura do conjunto de dados:

Etapa 4: Transmitir dados de contexto no momento do envio pass-context-data

Se você estiver resolvendo a ID do fragmento a partir dos dados de contexto (por exemplo, de um arquivo de recomendação de público-alvo CSV), transmita a ID do fragmento na solicitação de API sob o prefixo de contexto necessário.

Ao usar a API de prova de campanha, inclua a ID do fragmento no objeto context:

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

O prefixo context.audiencePayload é obrigatório. Atributos aninhados com esse mapa-chave diretamente para colunas no arquivo de público-alvo CSV ao executar a campanha em tempo real.

Etapa 5: comprovar e validar proof-validate

Antes de ativar a campanha, use a API de prova de campanha para verificar se o fragmento dinâmico é resolvido corretamente e se a saída de email renderizada é a esperada.

Para obter mais informações sobre a API de campanha, consulte a documentação sobre APIs do Journey Optimizer.

Medidas de proteção e limitações guardrails

As seguintes limitações se aplicam ao usar fragmentos dinâmicos:

Mais medidas de proteção aplicáveis aos fragmentos estão disponíveis em esta seção.

Tratamento de erros error-handling

Se um fragmento dinâmico não for resolvido no tempo de execução, um evento de exclusão será gerado para o perfil afetado. Atualmente, todas as falhas de renderização do fragmento são categorizadas como um único tipo de erro geral.

Para depurar falhas de resolução do fragmento: