Usando 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 de Visual Experience Composer (VEC), ou uma interface não visual, a variável Experience Composer baseado em formulário, para criar, ativar e entregar suas atividades e experiências de personalização.

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

• Testes A/B
• Relatórios de impressão e conversão do A4T
• Atividades do Automated Personalization
• Atividades de Direcionamento de experiência
• Testes multivariados (MVT)
• Atividades do Recommendations
• Relatório de impressão e conversão do Target nativo
• Suporte ao VEC

Platform Web SDK diagrama do sistema

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

Habilitar Adobe Target

Para ativar Target, faça o seguinte:

1. Habilitar Target em seu datastream com o código de cliente apropriado.
2. Adicione o renderDecisions aos seus 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 um Platform Web SDK implementação, instalar e ativar a variável Firefox ou Cromo Extensão do VEC Helper.

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 Renderização do conteúdo de personalização para obter mais informações.

Públicos-alvo no XDM

Ao definir públicos para Target atividades fornecidas por meio da variável Platform Web SDK, XDM deve ser definida e usada. Após definir esquemas, classes e grupos de campos de esquema XDM, você pode criar um Target regra de público-alvo definida pelos dados XDM para direcionamento. Within Target, os dados XDM são exibidos na variável Construtor de público-alvo como parâmetro personalizado. O XDM é serializado usando a notação de pontos (por exemplo, web.webPageDetails.name).

Se tiver Target atividades com públicos-alvo predefinidos que usam parâmetros personalizados ou um perfil de usuário, elas não sã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 com o suporte do Platform Web SDK que não exigem XDM. Esses campos estão disponíveis na variável Target Interface do usuário 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 meta no campo 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 alloy.sendEvent promessa, repita propositions
e extrair os detalhes de items -> meta. Cada proposition tem um renderAttempted campo booleano indicando 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 é ativada, a matriz de propostas contém:

No carregamento da página:

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

Atualização de perfil único

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

Para atualizar uma Target , certifique-se de que os dados do perfil sejam transmitidos com o seguinte:

• Em “data {“
• Em “__adobe.target”
• Prefixo “profile.” por exemplo, como abaixo

Típica Platform 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 e se cada um é compatível com o Platform Web SDK:

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 depuração.

Terminologia

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

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

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

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