On-device decisioning para at.js

A partir da versão 2.5.0, a at.js oferece on-device decisioning. O On-device decisioning permite que você armazene em cache suas atividades de Teste A/B e Direcionamento de experiência (XT) no navegador para executar a decisão na memória sem uma solicitação de rede de bloqueio para o Edge Network Adobe Target.

O Target também oferece a flexibilidade de fornecer a experiência mais relevante e atualizada de suas atividades de experimentação e personalização orientada por aprendizado de máquina (orientado por aprendizado de máquina) por meio de uma chamada de servidor em tempo real. Em outras palavras, quando o desempenho é mais importante, você pode optar por usar on-device decisioning. No entanto, quando a experiência mais relevante, atualizada e orientada por aprendizado de máquina for necessária, uma chamada de servidor poderá ser feita.

Quais são os benefícios do on-device decisioning?

Os benefícios do on-device decisioning incluem:

Recursos compatíveis

O SDK JS do Adobe Target oferece aos clientes flexibilidade para escolher entre desempenho e atualização de dados para decisões. Em outras palavras, se o fornecimento do conteúdo personalizado mais relevante e envolvente por meio do aprendizado de máquina for mais importante para você, uma chamada de servidor em tempo real deverá ser feita. Mas quando o desempenho é mais crítico, uma decisão no dispositivo e na memória deve ser tomada. Para que o on-device decisioning funcione, consulte a lista de recursos compatíveis:

Para obter mais informações, consulte Recursos com suporte para on-device decisioning.

Como o on-device decisioning funciona?

Quando você implanta e inicializa o at.js com o on-device decisioning ativado, um artefato de regra que inclui seu on-device decisioning para atividades, públicos-alvo e ativos de A/B e XT é baixado do Akamai CDN mais próximo do seu visitante e armazenado em cache localmente no navegador do visitante. Quando uma solicitação é feita pela at.js para recuperar uma experiência, a decisão sobre qual experiência retornar é tomada na memória, com base nos metadados codificados no artefato de regra em cache.

Método de decisão

Com on-device decisioning, Target introduz uma nova configuração chamada Método de Decisão. A configuração Método de decisão determina como a at.js fornece suas experiências. O Método de decisão tem três valores:

Somente no lado do servidor

Somente no lado do servidor é o método de decisão padrão definido imediatamente quando a at.js 2.5.0+ é implementada e implantada em suas propriedades da Web.

Usar somente no lado do servidor como configuração padrão significa que todas as decisões são tomadas na rede de borda Target, o que envolve uma chamada de servidor de bloqueio. Essa abordagem pode apresentar latência incremental, mas também oferece benefícios significativos, como a capacidade de aplicar os recursos de aprendizado de máquina do Target, que incluem as atividades de Recommendations, Automated Personalization (AP) e Direcionamento automático.

Além disso, aprimorar suas experiências personalizadas usando o perfil de usuário do Target, que é mantido em sessões e canais, pode trazer resultados significativos para sua empresa.

Por fim, somente no lado do servidor permite usar a Adobe Experience Cloud e refinar públicos-alvo que podem ser direcionados por meio de segmentos Audience Manager e Adobe Analytics.

O diagrama a seguir ilustra a interação entre seu visitante, o navegador, a at.js 2.5.0+ e a rede Edge Adobe Target. Este diagrama de fluxo captura novos visitantes e visitantes recorrentes.

(Clique na imagem para expandir até a largura total.)

A lista a seguir corresponde aos números no diagrama:

Somente no dispositivo

Somente no dispositivo é o método de decisão que deve ser definido na at.js 2.5.0+ quando on-device decisioning deve ser usado somente em suas páginas da Web.

O On-device decisioning pode entregar suas experiências e atividades de personalização em uma velocidade extremamente rápida, pois as decisões são tomadas a partir de um artefato de regras em cache que contém todas as suas atividades qualificadas para on-device decisioning.

Para saber mais sobre quais atividades se qualificam para on-device decisioning, consulte Recursos com suporte no on-device decisioning.

Esse método de decisão deve ser usado somente se o desempenho for altamente crítico em todas as páginas que exigem decisões do Target. Além disso, lembre-se de que, quando esse método de decisão é selecionado, as atividades do Target que não se qualificam para on-device decisioning não são entregues ou executadas. A biblioteca at.js 2.5.0+ está configurada para procurar somente pelo artefato de regras em cache para tomar decisões.

O diagrama a seguir ilustra a interação entre seu visitante, o navegador, a at.js 2.5.0+ e o Akamai CDN. O Akamai CDN armazena em cache o artefato de regras da primeira visita. Para a primeira visita de página de um novo visitante, o artefato de regras JSON deve ser baixado do Akamai CDN para ser armazenado em cache localmente no navegador do visitante. Após o download do artefato de regras JSON, a decisão é tomada imediatamente, sem uma chamada de rede de bloqueio. O diagrama de fluxo a seguir captura novos visitantes.

(Clique na imagem para expandir até a largura total.)

A lista a seguir corresponde aos números no diagrama:

O diagrama a seguir ilustra a interação entre seu visitante, o navegador, a at.js 2.5.0+ e o artefato de regra JSON em cache para a próxima ocorrência de página ou visita recorrente do visitante. Como o artefato de regras JSON já está armazenado em cache e disponível no navegador, a decisão é tomada imediatamente, sem uma chamada de rede de bloqueio. Este diagrama de fluxo captura a navegação de página subsequente ou os visitantes recorrentes.

(Clique na imagem para expandir até a largura total.)

A lista a seguir corresponde aos números no diagrama:

Híbrido

O método de decisão híbrido é o que deve ser definido na at.js 2.5.0+, quando on-device decisioning e as atividades que exigem uma chamada de rede para a rede Edge Adobe Target precisam ser executadas.

Ao gerenciar atividades do on-device decisioning e atividades do lado do servidor, você pode achar complicado e cansativo pensar em como implantar e provisionar o Target em suas páginas. Com o método de decisão híbrido, o Target sabe quando deve fazer uma chamada de servidor para a rede Edge Adobe Target, no caso de atividades que exigem execução no lado do servidor, e quando deve apenas executar decisões no dispositivo.

O artefato de regras JSON inclui metadados para informar à at.js se uma mbox tem uma atividade do lado do servidor em execução ou uma atividade on-device decisioning. Esse método de decisão garante que as atividades que você pretende entregar rapidamente sejam realizadas por meio do on-device decisioning e, para atividades que exigem personalização mais avançada orientada por aprendizado de máquina, essas atividades são realizadas por meio da rede Edge Adobe Target.

O diagrama a seguir ilustra a interação entre seu visitante, o navegador, a at.js 2.5.0+, o Akamai CDN e o Edge Network Adobe Target para um novo visitante que visita sua página pela primeira vez. O argumento deste diagrama é que o artefato de regras JSON é baixado de forma assíncrona enquanto as decisões são tomadas por meio da rede Edge Adobe Target.

Essa abordagem garante que o tamanho do artefato, que pode incluir muitas atividades, não influencie negativamente a latência da decisão. Baixar o artefato de regras JSON de forma síncrona e tomar a decisão posteriormente também pode ter efeitos adversos na latência e pode ser inconsistente. Portanto, o método de decisão híbrido é uma recomendação de prática recomendada para sempre fazer uma chamada do lado do servidor para a decisão de um novo visitante e, como o artefato de regras JSON, é armazenado em cache em paralelo. Para qualquer visita de página subsequente e visita de retorno, as decisões são tomadas a partir do cache e na memória por meio do artefato de regras JSON.

(Clique na imagem para expandir até a largura total.)

A lista a seguir corresponde aos números no diagrama:

O diagrama a seguir ilustra a interação entre seu visitante, o navegador, a at.js 2.5.0+ e o artefato de regras JSON em cache para uma navegação de página subsequente ou uma visita de retorno. Neste diagrama, concentre-se somente no caso de uso em que uma decisão no dispositivo é tomada para a navegação da página subsequente ou para a visita de retorno. Lembre-se de que, dependendo de quais atividades estão ativas para determinadas páginas, uma chamada do lado do servidor pode ser feita para executar decisões do lado do servidor.

(Clique na imagem para expandir até a largura total.)

A lista a seguir corresponde aos números no diagrama:

Como habilitar o on-device decisioning?

O On-device decisioning está disponível para todos os clientes do Target que usam o At.js 2.5.0+.

Para habilitar on-device decisioning:

Depois de habilitar a opção Decisão no Dispositivo, o Target começa a gerar e propagar artefatos de regras para o seu cliente.

Como configurar o at.js 2.5.0+ para usar o on-device decisioning?

Configurações globais

Você pode configurar um Método de decisão padrão para todas as Target decisões. Os vários métodos de decisão são somente no lado do servidor, somente no dispositivo e híbrido. O método de decisão selecionado na interface do usuário Target está configurado em window.targetGlobalSettings no campo decisioningMethod. Saiba mais sobre o decisioningMethod em targetGlobalSettings().

<head>
    <script type="text/javascript">

        window.targetGlobalSettings = {
            clientCode: "yourClientCodeHere",
            imsOrgId: "imsOrgId@AdobeOrg",
            decisioningMethod: "on-device"

        };
    </script>

    <script type="text/javascript" src="at.js"></script>
</head>

Configuração personalizada

Se você definir o decisioningMethod em window.targetGlobalSettings, mas quiser substituir o decisioningMethod para cada decisão do Adobe Target de acordo com o caso de uso, é possível fazer esse procedimento especificando decisioningMethod na chamada getOffers() da At.js2.5.0+.

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});

TTL de cache de artefato

O Target representa suas atividades qualificadas para on-device decisioning como um artefato que consiste em metadados, regras e condições. Esse artefato é armazenado em cache no Akamai CDN. Durante a primeira visita do usuário, o navegador do usuário baixa e armazena em cache o artefato que representa suas atividades do on-device decisioning.

Em visitas subsequentes ao site, o navegador verifica automaticamente se deve baixar uma versão mais recente do artefato. Essa verificação adiciona latência. O TTL de cache do artefato define o número de minutos que você não deseja que o navegador verifique se há um artefato atualizado desde o último download bem-sucedido. Quanto maior o período de tempo, melhor o desempenho. Quanto menor o período, melhor a atualização dos dados, mas à custa de latência adicional.

Como saber se uma atividade está qualificada para on-device decisioning?

Depois de criar uma atividade qualificada para on-device decisioning, um rótulo com a Elegibilidade para a Decisão no dispositivo ficará visível na página Visão geral.

Este rótulo não significa que a atividade sempre será entregue via on-device decisioning. Somente quando a at.js 2.5.0+ estiver configurada para usar on-device decisioning essa atividade será executada no dispositivo. Se a at.js 2.5.0+ não estiver configurada para usar no dispositivo, essa atividade ainda será entregue por uma chamada de servidor feita da at.js.

Você pode filtrar todas as atividades que são on-device decisioning qualificadas na página Atividades por meio do filtro Qualificado para Decisão no Dispositivo.

Resumo das etapas para garantir que minhas atividades on-device decisioning sejam entregues via At.js 2.5.0+?