Uso Adobe Target e Web SDK para personalização

Adobe Experience Platform Web SDK podem fornecer e renderizar experiências personalizadas gerenciadas no Adobe Target ao canal da web. Você pode usar um editor WYSIWYG, chamado de Visual Experience Composer (VEC), ou uma interface não visual, o Experience Composer baseado em formulário, para criar, ativar e entregar suas atividades e experiências de personalização.

IMPORTANT
Saiba como migrar sua implementação do Target para o SDK da Web da plataforma com o Migração do Target da at.js 2.x para o SDK da Web da plataforma tutorial.
Saiba como implementar o Target pela primeira vez com o Implementar o Adobe Experience Cloud com o SDK da Web tutorial. Para obter informações específicas do Target, consulte a seção tutorial intitulada Configurar o Target com o SDK da Web da plataforma.

Os seguintes recursos foram testados e são atualmente compatíveis com o Target:

Web SDK diagrama do sistema

O diagrama a seguir ajuda a entender o fluxo de trabalho do Target e Web SDK edge decisioning.

Diagrama da decisão de borda do Adobe Target com o SDK da Web da plataforma

Chama
Detalhes
1
O dispositivo carrega o Web SDK. A variável Web SDK O envia uma solicitação para a rede de borda com dados XDM, a ID de ambiente dos fluxos de dados, os parâmetros transmitidos e a ID do cliente (opcional). A página (ou containers) é pré-oculta.
2
A rede de borda envia a solicitação aos serviços de borda para enriquecê-la com a ID do visitante, o consentimento e outras informações de contexto do visitante, como geolocalização e nomes amigáveis ao dispositivo.
3
A rede de borda envia a solicitação de personalização enriquecida para o Target com a ID do visitante e os parâmetros transmitidos.
4
Os scripts de perfil executam e, em seguida, fazem o feed no Target armazenamento de perfil. O armazenamento de perfil busca segmentos do Biblioteca de público-alvo (por exemplo, segmentos compartilhados de Adobe Analytics, Adobe Audience Manager, o Adobe Experience Platform).
5
Com base nos parâmetros de solicitação de URL e dados de perfil, Target determina quais atividades e experiências exibir para o visitante na exibição de página atual e para exibições futuras previamente buscadas. Target em seguida, o envia de volta para a rede de borda.
6
a. A rede de borda envia a resposta de personalização de volta para a página, incluindo, opcionalmente, valores de perfil para personalização adicional. O conteúdo personalizado na página atual é revelado o mais rápido possível sem cintilação do conteúdo padrão.
b. O conteúdo personalizado de exibições que são mostradas como resultado das ações do usuário em um Aplicativo de página única (SPA) é armazenado em cache para que possa ser aplicado instantaneamente, sem uma chamada de servidor adicional, quando as exibições forem acionadas.
. A Rede de borda envia a ID do visitante e outros valores em cookies, como consentimento, ID da sessão, identidade, verificação de cookie e personalização.
7
A rede de borda encaminha Analytics for Target (A4T) detalhes (atividade, experiência e metadados de conversão) para o Analytics borda.

Ativando Adobe Target

Para habilitar Target, faça o seguinte:

  1. Ativar Target no seu sequência de dados com o código de cliente apropriado.
  2. Adicione o renderDecisions aos seus eventos.

Em seguida, opcionalmente, você também pode adicionar as seguintes opções:

  • decisionScopes: recupere atividades específicas (úteis para atividades criadas com o compositor baseado em formulário) adicionando essa opção aos seus eventos.
  • Pré-ocultação de trecho: ocultar apenas determinadas partes da página.

Uso do VEC do Adobe Target

Para usar o VEC com uma Web SDK implementação, instale e ative o Firefox ou Cromo Extensão do VEC Helper.

Para obter mais informações, consulte Extensão auxiliar do Visual Experience Composer no Guia do Adobe Target.

Renderização de conteúdo personalizado

Consulte Renderização do conteúdo de personalização para obter mais informações.

Públicos-alvo no XDM

Ao definir públicos-alvo para seus Target atividades que são entregues por meio do Web SDK, XDM devem ser definidas e usadas. Depois de definir esquemas XDM, classes e grupos de campos de esquema, você pode criar um Target regra de público-alvo definida pelos dados XDM para direcionamento. Dentro de Target, os dados XDM são exibidos no Audience Builder como um parâmetro personalizado. O XDM é serializado usando notação de pontos (por exemplo, web.webPageDetails.name).

Se você tiver Target atividades com públicos predefinidos que usam parâmetros personalizados ou um perfil de usuário não são entregues corretamente pelo SDK. Em vez de usar parâmetros personalizados ou o perfil do usuário, você deve usar o XDM. No entanto, há campos de direcionamento de público prontos para uso compatíveis por meio do Web SDK que não exigem XDM. Esses campos estão disponíveis no Target Interface do usuário que não requer XDM:

  • Biblioteca do Target
  • Geografia
  • Rede
  • Sistema operacional
  • Páginas do site
  • Navegador
  • Fontes de Tráfego
  • Intervalo de tempo

Para obter mais informações, consulte Categorias para públicos no Guia do Adobe Target.

Tokens de resposta

Os tokens de resposta são usados para enviar metadados a terceiros, como Google ou Facebook. Os tokens de resposta são retornados no meta campo dentro de propositions -> items. Aqui está uma amostra:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Para coletar os tokens de resposta, é necessário assinar o alloy.sendEvent promessa, iterar até propositionse extraia os detalhes de items -> meta.

A cada proposition tem um renderAttempted campo booleano que indica se a variável proposition foi renderizado ou não. Consulte a amostra abaixo:

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

Quando a renderização automática está ativada, a matriz de apresentações contém:

No carregamento da página:

  • Compositor baseado em formulário propositions com renderAttempted sinalizador definido como false
  • Proposições baseadas no Visual Experience Composer com renderAttempted sinalizador definido como true
  • Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com renderAttempted sinalizador definido como true

Em Exibição - alterar (para exibições em cache):

  • Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com renderAttempted sinalizador definido como true

Quando a renderização automática está desativada, a matriz de apresentações contém:

No carregamento da página:

  • Form-based Composerbaseado em propositions com renderAttempted sinalizador definido como false
  • Visual Experience Composerapresentações com base em renderAttempted sinalizador definido como false
  • Visual Experience Composerpropostas com base em para uma visualização de Aplicativo de página única com renderAttempted sinalizador definido como false

Em Exibição - alterar (para exibições em cache):

  • Proposições baseadas no Visual Experience Composer para uma exibição de aplicativo de página única com renderAttempted sinalizador definido como false

Atualização de perfil único

A variável Web SDK permite atualizar o perfil para a variável Target e para o Web SDK como um evento de experiência.

Para atualizar uma Target , verifique se os dados do perfil foram transmitidos com o seguinte:

  • Em "data {"
  • Em "__adobe.target"
  • Prefixo "profile."
Chave
Tipo
Descrição
renderDecisions
Booleano
Instrui o componente de personalização sobre se ele deve interpretar ações DOM
decisionScopes
Matriz <String>
Uma lista de escopos para os quais recuperar decisões
xdm
Objeto
Dados formatados no XDM que chega ao SDK da Web como um evento de experiência
data
Objeto
Pares de valor/chave arbitrários enviados para o Target soluções na classe target.

Típica Web SDK o código que usa esse comando é semelhante ao seguinte:

sendEventcom dados de perfil

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

Como enviar atributos de perfil para o Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Solicitar recomendações

A tabela a seguir lista Recommendations atributos e se cada um é compatível por meio da variável Web SDK:

Categoria
Atributo
Status do suporte
Recommendations - Atributos de entidade padrão
entity.id
Suportado
entity.name
Suportado
entity.categoryId
Suportado
entity.pageUrl
Suportado
entity.thumbnailUrl
Suportado
entity.message
Suportado
entity.value
Suportado
entity.inventory
Suportado
entity.brand
Suportado
entity.margin
Suportado
entity.event.detailsOnly
Suportado
Recommendations - Atributos de entidade personalizados
entity.yourCustomAttributeName
Suportado
Recommendations - Parâmetros de mbox/página reservados
excludedIds
Suportado
cartIds
Suportado
productPurchasedId
Suportado
Página ou categoria de item para afinidade de categorias
user.categoryId
Suportado

Como enviar atributos do Recommendations para o Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Depuração

mboxTrace e mboxDebug foram descontinuados. Use um método de Depuração do SDK da Web em vez disso.

Terminologia

Apresentações: Entrada Adobe Target, as apresentações se correlacionam com a experiência selecionada em uma Atividade.

Esquema: O schema de uma decisão é o tipo de oferta em Adobe Target.

Escopo: O escopo da decisão. Entrada Adobe Target, o escopo é a mBox. A mBox global é a __view__ âmbito de aplicação.

XDM: O XDM é serializado em notação de pontos e, em seguida, colocado em Adobe Target como parâmetros mBox.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636