Usar Adobe Target e Web SDK para personalização

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

Os seguintes recursos foram testados e atualmente têm suporte no Target:

Diagrama do sistema Web SDK

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

Habilitando Adobe Target

Para habilitar Target, faça o seguinte:

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

Uso do VEC Adobe Target

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

Para obter mais informações, consulte a 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 para suas atividades do Target que são entregues por meio do Web SDK, o XDM deve ser definido e usado. Depois de definir esquemas XDM, classes e grupos de campos de esquema, você pode criar uma regra de público-alvo Target definida pelos dados XDM para direcionamento. No Target, os dados XDM são exibidos no Audience Builder como um parâmetro personalizado. O XDM é serializado usando a 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 da 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 com suporte pelo Web SDK que não exigem o XDM. Estes campos estão disponíveis na interface do usuário do Target e não exigem XDM:

Para obter mais informações, consulte Categorias para públicos-alvo 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 campo meta em 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, você deve assinar a promessa alloy.sendEvent, iterar por meio de propositions e extrair os detalhes de items -> meta.

Cada proposition tem um campo booleano renderAttempted indicando se 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:

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

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

No carregamento da página:

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

Atualização de perfil único

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

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

Atrasar o salvamento dos parâmetros de Perfil ou entidade até que o conteúdo seja exibido para o usuário final

Para atrasar a gravação de atributos no perfil até que o conteúdo seja exibido, defina data.adobe.target._save=false na sua solicitação.

Por exemplo, seu site contém três escopos de decisão correspondentes a três links de categoria no site (Homens, Mulheres e Crianças) e você deseja rastrear a categoria que o usuário eventualmente visitou. Envie essas solicitações com o sinalizador __save definido como false para evitar a persistência da categoria no momento em que o conteúdo é solicitado. Depois que o conteúdo for visualizado, envie a carga adequada (incluindo eventToken e stateToken) para os atributos correspondentes a serem registrados.

O exemplo abaixo envia uma mensagem de estilo trackEvent, executa scripts de perfil, salva atributos e registra imediatamente o evento.

alloy("sendEvent", {
    "renderDecisions": true,
    "xdm": { /* Experience Event XDM data */ },
    "data": {
        "__adobe": {
            "target": {
                " __save": true|false,
                //defaults to true if omitted
                "profile.gender": "female",
                "profile.age": 30,
                "entity.name": "T-shirt",
                "entity.id": "1234"
            }
        }
    }
})

Solicitar recomendações

A tabela a seguir lista os atributos Recommendations e se cada um deles é suportado por meio do Web SDK:

Como enviar atributos de Recomendações para Target:

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

Exibir métricas de conversão da mbox display-mbox-conversion-metrics

O exemplo abaixo mostra como você pode rastrear conversões de mbox de exibição e enviar parâmetros de perfil para Target, sem precisar se qualificar para qualquer conteúdo ou atividade.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

Depuração

mboxTrace e mboxDebug foram descontinuados. Em vez disso, use um método de depuração do Web SDK.

Terminologia

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

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

Escopo: o escopo da decisão. Em Target, o escopo é a mbox. A mbox global é o escopo __view__.

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