DocumentaçãoGuia do desenvolvedor do Target

Executar testes de recursos com atributos

Última atualização: 21 de maio de 2026

Criado para:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Resumo das etapas

  1. Habilitar a decisão no dispositivo para sua organização
  2. Criar uma atividade Teste A/B
  3. Defina seus A e B
  4. Adicionar um público
  5. Definir alocação de tráfego
  6. Definir a distribuição do tráfego para variações
  7. Configurar relatórios
  8. Adicionar métricas para KPIs de rastreamento
  9. Implementar código para executar testes de recursos com atributos
  10. Implementar código para rastrear eventos de conversão
  11. Ative seus testes de recursos com atributos
NOTE
Suponha que você seja uma empresa de comércio eletrônico varejista. Você deseja aumentar a taxa de conversão quando os clientes navegarem e classificarem o catálogo de produtos. Você tem uma hipótese de que certos algoritmos de classificação e estratégias de paginação produzem resultados melhores do que outros. Para testar essa teoria, você decide executar um teste de recurso que envolve o redesign do widget de classificação usando diferentes opções de classificação para os usuários finais. Certifique-se de que esse teste de recurso seja executado com latência próxima de zero para que ele não afete negativamente as experiências do usuário e distorça os resultados.

​1. Habilitar a decisão no dispositivo para sua organização

A ativação da decisão no dispositivo garante que uma atividade A/B seja executada com latência próxima a zero. Para habilitar este recurso, navegue até Administração > Implementação > Detalhes da conta em Adobe Target e habilite a opção Decisão no Dispositivo.

alt imagem

NOTE
Você deve ter a função de usuário de Administrador ou Aprovador para habilitar ou desabilitar a Decisão no Dispositivo.

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

​2. Criar uma atividade Teste A/B

  1. Em Adobe Target, navegue até a página Atividades e selecione Criar atividade > Teste A/B.

    alt imagem

  2. No modal Criar Atividade de Teste A/B, deixe a opção padrão Web selecionada (1), selecione Formulário como compositor de experiência (2), selecione Workspace Padrão com Sem Restrições de Propriedade (3) e clique em Avançar (4).

    alt imagem

​3. Defina seus A e B

  1. Na etapa de criação da atividade Experiências, forneça um nome para a atividade (1) e adicione uma segunda experiência, Experiência B, clicando no botão Adicionar Experiência (2). Digite o nome do local (3) no aplicativo onde deseja executar o teste de recurso com atributos. No exemplo mostrado abaixo, product-results-page é o local definido para a Experiência A. (Também é o local definido para a Experiência B.)

    alt imagem

    A Experiência A conterá o JSON que sinaliza à sua lógica comercial o seguinte:

    • Iniciar o recurso de algoritmo de classificação por meio do sinalizador de recurso test_sorting
    • Executar o algoritmo de classificação recomendado definido no sorting_algorithm _**_attribute
    • Retorne 50 produtos por página, conforme definido pela estratégia de paginação definida no pagination_limit

  2. Na Experiência A, clique em para alterar o conteúdo de Conteúdo Padrão para JSON ao selecionar Criar Oferta JSON, conforme mostrado abaixo (1).

    alt imagem

  3. Defina o JSON com os sinalizadores e atributos test_sorting, sorting_algorithm e pagination_limit que serão usados para iniciar o algoritmo de classificação recomendado com um limite de paginação de 50 produtos.

    note
    NOTE
    Quando Adobe Target agrupa um usuário para ver a Experiência A, o JSON com os atributos definidos no exemplo serão retornados. Em seu código, será necessário verificar o valor do sinalizador de recurso test_sorting para ver se o recurso de classificação deve ser ativado. Em caso afirmativo, você usará o valor recomendado do atributo sorting_algorithm para mostrar os produtos recomendados na exibição da lista de produtos. O limite de produtos a ser exibido para seu aplicativo será 50, pois esse é o valor do atributo pagination_limit.

    alt imagem

    A Experiência B definirá o JSON que sinaliza à sua lógica comercial o seguinte:

    • Iniciar o recurso de algoritmo de classificação por meio do sinalizador de recurso test_sorting
    • Executar o algoritmo de classificação best_sellers definido em sorting_algorithm _**_attribute
    • Retorne 50 produtos por página, conforme definido pela estratégia de paginação definida no pagination_limit
    note
    NOTE
    Quando Adobe Target agrupa um usuário para ver a Experiência B, o JSON com os atributos definidos no exemplo serão retornados. Em seu código, será necessário verificar o valor do sinalizador de recurso test_sorting para ver se o recurso de classificação deve ser ativado. Em caso afirmativo, você usará o valor best_sellers do atributo sorting_algorithm para mostrar os produtos mais vendidos na exibição da lista de produtos. O limite de produtos a ser exibido para seu aplicativo será 50, pois esse é o valor do atributo pagination_limit.

    alt imagem

​4. Adicionar um público

Na etapa Direcionamento, mantenha o público-alvo de Todos os visitantes. Isso permitirá entender o impacto do recurso de classificação, bem como qual algoritmo e número de itens influenciam melhor os resultados.

alt imagem

​5. Definir alocação de tráfego

Defina a porcentagem de seus visitantes em relação à qual você deseja testar os algoritmos de classificação e a estratégia de paginação. Em outras palavras, para que porcentagem de seus usuários você deseja implantar esse teste? Neste exemplo, para implantar este teste para todos os usuários conectados, mantenha a alocação de tráfego em 100%.

alt imagem

​6. Definir a distribuição do tráfego para variações

Defina a porcentagem de seus visitantes que verão o algoritmo de classificação recomendado em comparação com os melhores vendedores, com um limite de 50 produtos por página. Neste exemplo, mantenha a distribuição do tráfego dividida em 50/50 entre as Experiências A e B.

alt imagem

​7. Configurar relatórios

Na etapa Metas e Configurações, escolha Adobe Target como a Source de Relatórios para exibir os resultados do teste A/B na interface do usuário do Adobe Target, ou escolha Adobe Analytics para exibi-los na interface do usuário do Adobe Analytics.

alt imagem

​8. Adicionar métricas para KPIs de rastreamento

Escolha uma Métrica de meta para medir o teste de recurso com atributos. Neste exemplo, o sucesso se baseia no fato de o usuário comprar um produto, dependendo do algoritmo de classificação e da estratégia de paginação mostrada.

​9. Implementar testes de recursos com atributos no aplicativo

Node.js
code language-js line-numbers 
const TargetClient = require("@adobe/target-nodejs-sdk");
const options = {
  client: "testClient",
  organizationId: "ABCDEF012345677890ABCDEF0@AdobeOrg",
  decisioningMethod: "on-device",
  events: {
    clientReady: targetClientReady
  }
};
const targetClient = TargetClient.create(options);

function targetClientReady() {
  return targetClient.getAttributes(["product-results-page"]).then(function(attributes) {
    const test_sorting = attributes.getValue("product-results-page", "test-sorting");
    const sorting_algorithm = attributes.getValue("product-results-page", "sorting_algorithm");
    const pagination_limit = attributes.getValue("product-results-page", "pagination_limit");
  });
}
Java
code language-java line-numbers 
import com.adobe.target.edge.client.ClientConfig;
import com.adobe.target.edge.client.TargetClient;
import com.adobe.target.delivery.v1.model.ChannelType;
import com.adobe.target.delivery.v1.model.Context;
import com.adobe.target.delivery.v1.model.ExecuteRequest;
import com.adobe.target.delivery.v1.model.MboxRequest;
import com.adobe.target.edge.client.entities.TargetDeliveryRequest;
import com.adobe.target.edge.client.model.TargetDeliveryResponse;

ClientConfig config = ClientConfig.builder()
    .client("testClient")
    .organizationId("ABCDEF012345677890ABCDEF0@AdobeOrg")
    .build();
TargetClient targetClient = TargetClient.create(config);
MboxRequest mbox = new MboxRequest().name("product-results-page").index(0);
TargetDeliveryRequest request = TargetDeliveryRequest.builder()
    .context(new Context().channel(ChannelType.WEB))
    .execute(new ExecuteRequest().mboxes(Arrays.asList(mbox)))
    .build();
Attributes attributes = targetClient.getAttributes(request, "product-results-page");
String testSorting = attributes.getString("product-results-page", "test-sorting");
String sortingAlgorithm = attributes.getString("product-results-page", "sorting_algorithm");
String paginationLimit = attributes.getString("product-results-page", "pagination_limit");

​10. Implementar código para rastrear eventos de conversão

Node.js
code language-js line-numbers 
//... Code removed for brevity

//When a conversion happens
TargetClient.sendNotifications({
    targetCookie,
    "request" : {
      "notifications" : [
        {
          type: "click",
          timestamp : Date.now(),
          id: "conversion",
          mbox : {
            name : "product-results-page"
          }
        }
      ]
    }
})
Java
code language-java line-numbers 
ClientConfig config = ClientConfig.builder()
  .client("acmeclient")
  .organizationId("1234567890@AdobeOrg")
  .build();
TargetClient targetClient = TargetClient.create(config);

Context context = new Context().channel(ChannelType.WEB);

ExecuteRequest executeRequest = new ExecuteRequest();

NotificationDeliveryService notificationDeliveryService = new NotificationDeliveryService();

Notification notification = new Notification();
notification.setId("conversion");
notification.setImpressionId(UUID.randomUUID().toString());
notification.setType(MetricType.CLICK);
notification.setTimestamp(System.currentTimeMillis());
notification.setTokens(
    Collections.singletonList(
        "IbG2Jz2xmHaqX7Ml/YRxRGqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="));

TargetDeliveryRequest targetDeliveryRequest =
    TargetDeliveryRequest.builder()
        .context(context)
        .execute(executeRequest)
        .notifications(Collections.singletonList(notification))
        .build();

TargetDeliveryResponse offers = targetClient.getOffers(request);
notificationDeliveryService.sendNotification(request);

Attributes attributes = targetClient.getAttributes(request, "product-results-page");
String testSorting = attributes.getString("product-results-page", "test-sorting");
String sortingAlgorithm = attributes.getString("product-results-page", "sorting_algorithm");
String paginationLimit = attributes.getString("product-results-page", "pagination_limit");

​11. Ative seus testes de recursos com atributos

alt imagem

recommendation-more-help
target-dev-help-dev