Usar identificadores complementares em jornadas supplemental-id

Em uma matriz de objetos com a ID complementar como bookingNum e um atributo no mesmo nível chamado bookingCountry, a jornada percorrerá o objeto de matriz com base no bookingNum e criará uma instância de jornada para cada objeto.

• A seguinte expressão na atividade de condição iterará por meio da matriz de objetos e verificará se o valor de bookingCountry é igual a “FR”:

  code language-none
  @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR"

• A seguinte expressão no editor de personalização de email iterará por meio da matriz de objetos, obterá o bookingCountry aplicável à instância atual do jornada e o exibirá no conteúdo:

  code language-none
  {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}}

• Exemplo do evento usado para acionar a jornada:

  code language-none
  "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]

Você deve habilitar expressActivation no público-alvo no momento da criação. Isso instrui o Journey Optimizer a ativar cada registro independentemente, sem desduplicação por ID de perfil. Esse sinalizador não pode ser alterado após a criação do público-alvo.

Use a seguinte chamada de API ao criar o público-alvo:

Ponto de extremidade:

POST https://platform.adobe.io/data/core/ais/external-audience

Cabeçalhos obrigatórios:

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
x-sandbox-name: {SANDBOX_NAME}

Corpo da solicitação (conjunto expressActivation: true):

{
  "name": "my_audience_name",
  "fields": [ ... ],
  "sourceSpec": { ... },
  "audienceType": "people",
  "namespace": "CustomerAudienceUpload",
  "expressActivation": true
}

Consulte a documentação da API de criação de público-alvo externo para obter a referência completa.

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: Esta página explica como usar identificadores complementares no Adobe Journey Optimizer jornada para permitir que um único perfil tenha várias instâncias simultâneas do jornada, cada uma com escopo para uma ID secundária distinta, como uma reserva, assinatura ou ID de política.

Intenções:

• Entenda quando e por que usar um identificador complementar em vez de depender exclusivamente de uma ID de perfil
• Configure um identificador complementar em uma jornada acionada por evento marcando um atributo como uma identidade no esquema de evento
• Configure um identificador complementar em uma jornada Ler público ativando a opção na atividade Ler público
• Atributos de identificador de referência complementares para personalização de mensagens e lógica condicional usando o editor de expressão
• Aplique a sintaxe de expressão correta para iterar sobre matrizes de objetos digitadas por uma ID complementar
• Identificar medidas de proteção e limitações antes de implementar identificadores complementares em uma jornada

Glossário:

• Identificador complementar: um identificador secundário (por exemplo, ID de pedido, ID de reserva, ID de assinatura) usado junto com a ID de perfil para definir o escopo de uma instância do jornada para um registro específico, habilitando várias instâncias simultâneas por perfil (específico do produto)
• ID de Perfil: o identificador principal usado por padrão para executar jornadas; um perfil ativo em uma jornada não pode inserir outra jornada novamente sem uma ID complementar
• Namespace de identificador que não seja de pessoa: um namespace de identidade que não representa uma pessoa (necessário para IDs suplementares); deve ser diferente do namespace de identidade principal
• namespace joai: não aplicável a esta página (consulte a solução de problemas de ações de entrada)
• DULE: Rotulagem e Imposição de Uso de Dados — a estrutura de validação da política de governança de dados no Adobe Experience Platform; as IDs complementares não estão sujeitas às verificações DULE

Medidas de Proteção:

• Os identificadores complementares são compatíveis somente com jornadas de público-alvo de leitura e acionadas por eventos; não há suporte para jornadas de qualificação de público-alvo
• Um perfil não pode ter mais de 10 instâncias simultâneas do jornada
• Cada instância do jornada conta para o limite de frequência, mesmo quando criada por meio de identificadores complementares
• O identificador complementar deve ser do tipo string; matrizes de cadeias de caracteres e mapas não têm suporte
• O atributo ID complementar não deve ser marcado como identidade Primária no esquema
• O namespace usado para a ID complementar deve ser um namespace de identificador que não seja de pessoa
• Depois de aplicar o namespace de identidade que não seja de pessoa a um esquema, um novo evento ou grupo de campos deve ser criado; as entidades existentes não podem ser atualizadas
• Para jornadas de leitura de público-alvo com IDs complementares: a taxa de leitura é limitada a 500 perfis por segundo por instância do jornada; somente os públicos-alvo do Serviço de perfil unificado são compatíveis; a ID complementar deve ser um campo de perfil (não um campo de evento/contexto)
• Eventos downstream na mesma jornada devem usar a mesma ID complementar e o mesmo namespace
• A ID complementar está desabilitada para jornadas Ler público que usam um evento comercial

Terminologia:

• Nome canônico: Identificador complementar — Acrônimo: none — variantes: ID complementar, identificador secundário
• Sinônimos: “identificador complementar” = “ID complementar” (usado alternadamente na interface e na documentação)
• Não confunda: “identificador suplementar” ≠ “identidade principal” — a ID suplementar nunca deve ser marcada como a identidade principal no schema

Perguntas frequentes:

• P: O que é um identificador complementar usado para? — permite que um único perfil entre e execute uma jornada várias vezes simultaneamente, com cada instância atribuída a um registro secundário diferente, como uma reserva, uma assinatura ou uma ID de política.
• P: Quais tipos de jornada oferecem suporte a identificadores complementares? — jornadas acionadas por eventos e jornadas Read audience. As jornadas de qualificação de público-alvo não oferecem suporte a identificadores complementares.
• P: Quantas instâncias simultâneas do jornada um perfil pode ter com identificadores complementares? — Um máximo de 10 instâncias simultâneas do jornada por perfil.
• P: Posso usar os atributos de ID complementares para a personalização da mensagem? — Sim. Faça referência a eles pelo menu Contextual attributes no editor de expressão ou no editor de personalização.
• P: A ID complementar precisa ser marcada como uma identidade principal no esquema? — Não. Deve ser marcado como uma identidade, mas não deve ser definido como a identidade principal.
• P: as políticas de governança DULE são aplicadas ao identificador complementar? — Não. As verificações de validação de DULE não são executadas na ID complementar.