Usar Adobe Target com o Platform Web SDK

Adobe Experience Platform Web SDK O pode entregar e renderizar experiências personalizadas gerenciadas no Adobe Target para o canal da Web. Você pode usar um editor WYSIWYG, chamado 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.

IMPORTANTE

A documentação do Adobe Target inclui tópicos contendo informações específicas para o SDK da Web da plataforma, pois se relaciona aos recursos e funcionalidades do Target.

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

Platform Web SDK diagrama do sistema

O diagrama a seguir ajuda você a entender o fluxo de trabalho das Target e Platform Web SDK decisões de borda.

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

Chame Detalhes
1 O dispositivo carrega o Platform Web SDK. O Platform Web SDK envia uma solicitação para a rede de borda com dados XDM, a ID do ambiente de datastreams, parâmetros transmitidos e a ID do cliente (opcional). A página (ou contêineres) é 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 localização geográfica e nomes amigáveis ao dispositivo.
3 A rede de borda envia a solicitação de personalização enriquecida para a borda Target com a ID do visitante e os parâmetros transmitidos.
4 Os scripts de perfil executam e, em seguida, fazem o feed no armazenamento de perfil Target. O armazenamento de perfil busca segmentos da Biblioteca de público-alvo (por exemplo, segmentos compartilhados de Adobe Analytics, Adobe Audience Manager, 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 serão exibidas para o visitante na exibição de página atual e para exibições futuras pré-buscadas. Target em seguida, envia isso 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 para 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.
c. 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, personalização e assim por diante.
7 A rede de borda encaminha os detalhes do Analytics for Target (A4T) (metadados de atividade, experiência e conversão) para a borda Analytics.

Ativar Adobe Target

Para ativar Target, faça o seguinte:

  1. Ative Target em seu datastream com o código de cliente apropriado.
  2. Adicione a opção renderDecisions aos eventos.

Em seguida, opcionalmente, também é possível 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 eventos.
  • Pré-ocultar trecho: Ocultar apenas determinadas partes da página.

Uso do VEC do Adobe Target

Para usar o VEC com uma implementação Platform Web SDK, instale e ative a extensão de ajuda do VEC do Firefox ou Chrome.

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

Renderização de conteúdo personalizado

Consulte Rendering personalization content para obter mais informações.

Públicos-alvo no XDM

Ao definir públicos para suas atividades Target que são entregues por meio do Platform Web SDK, XDM deve ser definido e usado. Depois de definir esquemas, classes e grupos de campos de esquema XDM, você pode criar uma regra de público-alvo Target definida pelos dados XDM para direcionamento. Em Target, os dados do 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-alvo predefinidos que usam parâmetros personalizados ou um perfil de usuário, elas não serão entregues corretamente por meio do 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-alvo prontos para uso compatíveis por meio do Platform Web SDK que não exigem XDM. Esses campos estão disponíveis na interface Target que não requer XDM:

  • Biblioteca do Target
  • Geografia
  • Rede
  • Operating System
  • 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 principalmente para enviar metadados a terceiros, como Google, Facebook etc. Os tokens de resposta são retornados
no campo meta dentro de propositions -> items. Esta é 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 a promessa alloy.sendEvent, repetir por meio de propositions
e extraia os detalhes de items -> meta. Cada proposition tem um campo booleano renderAttempted
indicando se o 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 é ativada, a matriz de propostas contém:

No carregamento da página:

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

Na Exibição - alteração (para exibições em cache):

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

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

No carregamento da página:

  • Composer baseado em formulário baseado propositions com sinalizador renderAttempted definido como false
  • Apresentações baseadas no Visual Experience Composer com sinalizador renderAttempted definido como false
  • Apresentações baseadas no Visual Experience Composer para uma visualização de Aplicativo de página única com sinalizador renderAttempted definido como false

Na Exibição - alteração (para exibições em cache):

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

Atualização de perfil único

O Platform Web SDK permite atualizar o perfil para o perfil Target e para o Platform Web SDK como um evento de experiência.

Para atualizar um perfil Target, verifique se os dados do perfil foram passados com o seguinte:

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

O código Platform Web SDK típico usando 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 é suportado por meio de Platform Web SDK:

Categoria Atributo Status de 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 do 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 descontinuadas. Use Platform Web SDK depurando.

Terminologia

Apresentações: No Target, as apresentações estão correlacionadas à experiência selecionada em uma Atividade.

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

Âmbito de aplicação: âmbito de aplicação da decisão. Em Target, o escopo é a mBox. A mBox global é o escopo __view__.

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

Nesta página