[Premium]{class="badge positive" title="Consulte o que está incluído no Target Premium."}

Criar um design

Última atualização: 29 de setembro de 2026

Tópicos:
Atividades e testes

Um design define como as recomendações são exibidas em uma página.

Você pode criar um design de recomendações usando um design padrão ou criando um design personalizado. A tela Recomendações > Designs exibe cartões de design padrão e qualquer design que tenha sido criado em sua conta.

Lembre-se das seguintes informações ao trabalhar com designs:

Você pode criar um design de recomendações usando um design padrão ou criar um design personalizado.
Não é possível editar ou excluir um design padrão.
É possível editar, copiar ou excluir um design personalizado.
Para criar um design com base em um design padrão, primeiro copie o design e edite a cópia.

Esta ilustração mostra o design padrão 1 x 4:

1 x 4 design padrão

Esta ilustração mostra um design personalizado:

Design personalizado

Você pode criar um design durante o processo de criação da atividade no Visual Experience Composer (VEC) ou na biblioteca de design fora da criação da atividade. As seções a seguir pressupõem que você esteja criando designs da biblioteca, mas as etapas são semelhantes.

Criar designs

Você pode criar um design com base em um design padrão ou criar um design personalizado.

Criar um design com base em um design padrão

Clique em Recomendações > Designs para exibir a biblioteca Designs.
Clique no ícone Mais Ações ( ) do design que você deseja criar e clique em Copiar.

A caixa de diálogo Criar Design é exibida.
Digite um Nome e uma imagem de visualização opcional para exibir no cartão de design.

Quando você usa um design padrão, o nome do design e “Cópia” aparecem no campo Nome do Conteúdo. Você pode editar o nome. Você também pode selecionar uma imagem para exibir no cartão de design.

(Condicional) Edite o design Code, conforme desejado.

Os designs de recomendação usam o idioma de design da Velocity de fonte aberta. É possível encontrar informações sobre o Velocity em https://velocity.apache.org e em Personalizar um design usando o Velocity.

Um design pode ser HTML ou não-HTML. Por padrão, os designs do HTML são envolvidos com uma tag <div> para permitir o rastreamento de cliques em um ambiente da Web. Designs não-HTML são para ambientes que não sejam da Web onde click-tracking não é possível. Deslize o botão HTML Design para a posição “desligado” para usar código que não seja HTML.

note
NOTE
A quantidade máxima de entidades que podem ser referenciadas em um design, seja em código rígido ou em loops, é de 99.

Clique em Criar.

Criar um design personalizado

Clique em Recomendações > Designs para exibir a biblioteca Designs.
Clique em Criar design.

Para basear seu novo design personalizado em um design existente, clique no ícone Mais Ações ( ) do design que deseja criar e clique em Copiar. Em seguida, você pode editar a cópia para criar um novo design personalizado.
Adicione um Name e uma imagem de visualização opcional.
(Condicional) Edite o design Code, conforme desejado.

Consulte as informações na Etapa 4 acima para obter mais informações.
Clique em Criar.

Editar, copiar ou excluir um design

Lembre-se de que não é possível editar ou copiar um design padrão; você só pode copiar designs padrão.

Clique no ícone Mais Ações ( ) do design que você deseja editar ou excluir e clique no ícone apropriado: Editar, Copiar ou Excluir.

É possível copiar um design existente para criar um design duplicado que você pode modificar. Esse processo permite criar um design semelhante com menos esforço.

Esteja ciente de que os designs estão disponíveis em toda a conta. Considere o uso entre contas antes de excluir um design. Os designs excluídos não podem ser recuperados.

Exemplo de JSON section_75BFB2537CFF4FBD9B560F59EB32C8DD

O exemplo a seguir mostra como as respostas JSON podem ser retornadas ao configurar uma atividade por meio do editor baseado em formulário.

Crie um design dentro da Biblioteca de design ou dentro do fluxo de trabalho baseado em formulário. Se você tentar criar um design dentro do fluxo de trabalho do Visual Experience Composer (VEC), não será possível criar nada além de um design de HTML, que está envolvido com um <div> para fins de rastreamento de cliques.
Verifique se a opção “HTML Design” está desativada:

O código a seguir é um exemplo do que você pode colar no design:

code language-javascript

    #*
    * "Return a simple list of recommended entity ids"
    *#

    {
      "notes":{
      "purpose": "Return a simple list of recommended entity ids",
      "use-case": "Use this approach if you prefer to do a real-time lookup of entity attribute details (such as inventory, price, rating) from another system (such as a CMS, PIM or ecommerce platform)",
      "version": "01"
      },
      "recommendedItems": {
        "key": "$key.id",
        "slot-01": "$entity1.id",
        "slot-02": "$entity2.id",
        "slot-03": "$entity3.id",
        "slot-04": "$entity4.id",
        "slot-05": "$entity5.id",
        "slot-06": "$entity6.id",
        "slot-07": "$entity7.id",
        "slot-08": "$entity8.id",
        "slot-09": "$entity9.id",
        "slot-10": "$entity10.id"
      }
    }

Configure uma atividade Recommendations baseada em formulário que use este design.
1. Navegue até a página Atividades.
2. Clique em Criar atividade > Recomendações.
3. Em Escolher Experience Composer, selecione Formulário e clique em Avançar.
4. Em localização, digite o texto: “Sample_Recs_Response”
5. Em Conteúdo padrão, clique na seta para baixo e depois clique em Adicionara recomendação.
6. Selecione um tipo de página. Isso determina a filtragem inicial da próxima tela.
7. Selecione um cartão de Critérios e depois clique em Próximo.
8. Selecione o design criado na etapa anterior e clique em Avançar.
9. Complete o processo de configuração.
10. Clique na seta à direita próximo a Inativo e depois selecione Ativar.

Depois que sua atividade estiver configurada e ativada, você pode configurar uma solicitação de amostra para recuperar a resposta limpa do JSON.

A partir do momento em que você salva sua atividade, Target precisa criar um modelo para dar suporte à configuração de critérios selecionados. Dependendo de vários fatores, esse processo pode levar algum tempo. Os resultados aparecem quando o modelo tiver sido criado.

Por exemplo:

code language-none

https://[YOUR_CLIENT_CODE].tt.omtrdc.net/m2/YOUR_CLIENT_CODE/ubox/raw?mbox=[YOUR_MBOX_NAME]&mboxContentType=text/html&mboxXDomain=disabled&entity.id=[ENTITY_ID]&mboxHost=rawbox_sample&at_property=[AT_PROPERTY_TOKEN]&mboxNoRedirect=true&mboxPC=1234-4321&mboxSession=9876-7000

onde

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parâmetro	Valor
`[YOUR_CLIENT_CODE]`	Código do cliente do Target (disponível em /help/target/products.html#recsSettings > Token de API do Recommendations > Código do cliente).
`[YOUR_MBOX_NAME]`	O nome selecionado na seção “locais” do Recommendations baseado em formulário, neste caso Sample_Recs_Response.
`[ENTITY_ID`	O `entity.id` de um item em seu catálogo.
`[AT_PROPERTY_TOKEN]`	(Opcional) Adicionar se você selecionou uma Propriedade (parte das Permissões da empresa) durante a configuração de sua atividade.

Depois que seu algoritmo for executado e você obter os resultados, sua resposta deve ser:

imagemderecomendaçãojson {width="575px"}

Dicas e truques adicionais sobre objetos JSON section_C305673C68944749969DB239E3221DC2

Você também pode enviar de volta uma lista de itens delimitada por vírgulas simples configurando um design com a seguinte sintaxe:

entity1.id, $entity2.id, $entity3.id, $entity4.id, $entity5.id,

Como alternativa, você pode enviar informações adicionais na resposta. O seguinte arquivo de código é um exemplo mais complexo que retorna muito mais do que as IDs de entidade com seus slots associados (ordem). Este exemplo de design também retorna detalhes da atividade, detalhes do Perfil de Destino (conforme aplicável) e outros entity.attributes associados aos itens retornados.

    {
     "adobeRecommendations": {
      "notes": {
       "purpose": "Return a list of entity ids with their associated entity.attributes",
       "use-case": "Use this approach to avoid looking up attribute details after receiving a response from Target",
       "version": "01"
      },
      "recommendedItems": {
       "slot-01": "$entity1.id",
       "slot-02": "$entity2.id",
       "slot-03": "$entity3.id",
       "slot-04": "$entity4.id",
       "slot-05": "$entity5.id",
       "slot-06": "$entity6.id",
       "slot-07": "$entity7.id",
       "slot-08": "$entity8.id",
       "slot-09": "$entity9.id",
       "slot-10": "$entity10.id"
      },
      "activityDetails": {
       "mbox.name": "email-mbox",
       "campaign.name": "\${campaign.name}",
       "campaign.id": "\${campaign.id}",
       "campaign.recipe.name": "\${campaign.recipe.name}",
       "campaign.recipe.id": "\${campaign.recipe.id}",
       "offer.name": "\${offer.name}",
       "offer.id": "\${offer.id}",
       "criteria.title": "$criteria.title",
       "algorithm.name": "$algorithm.name",
       "algorithm.dayCount": "$algorithm.dayCount"
      },
      "visitorProfile": {
       "profile.favorite-category": "\${profile.favorite-category}",
       "profile.test": "\${profile.test}",
       "user.endpoint.lastPurchasedEntity": "\${user.endpoint.lastPurchasedEntity}",
       "user.endpoint.lastViewedEntity": "\${user.endpoint.lastViewedEntity}",
       "user.endpoint.mostViewedEntity": "\${user.endpoint.mostViewedEntity}",
       "user.endpoint.categoryAffinity": "\${user.endpoint.categoryAffinity}",
       "profile.geolocation.city": "\${profile.geolocation.city}",
       "profile.geolocation.dma": "\${profile.geolocation.dma}",
       "profile.geolocation.state": "\${profile.geolocation.state}",
       "profile.geolocation.country": "\${profile.geolocation.country}",
       "profile.sessionCount": "\${profile.sessionCount}",
       "profile.averageDaysBetweenVisits": "\${profile.averageDaysBetweenVisits}",
       "profile.browserTime": "\${profile.browserTime}",
       "user.activeActivities": "\${user.activeActivities}",
       "user.pcId": "\${user.pcId}",
       "user.isFirstSession": "\${user.isFirstSession}",
       "user.isNewSession": "\${user.isNewSession}",
       "user.header": "\${user.header}",
       "user.parameter": "\${user.parameter}"
      },
      "recKey": {
       "recKeyDetails": {
        "id": "$key.id",
        "name": "$key.name",
        "category": "$key.category",
        "pageUrl": "$key.pageUrl",
        "thumbnailUrl": "$key.thumbnailUrl"
       }
      },
      "recDetailedResults": {
       "recEntity1Details": {
        "id": "$entity1.id",
        "name": "$entity1.name",
        "category": "$entity1.category",
        "pageUrl": "$entity1.pageUrl",
        "thumbnailUrl": "$entity1.thumbnailUrl"
       },
       "recEntity2Details": {
        "id": "$entity2.id",
        "name": "$entity2.name",
        "category": "$entity2.category",
        "pageUrl": "$entity2.pageUrl",
        "thumbnailUrl": "$entity2.thumbnailUrl"
       },
       "recEntity3Details": {
        "id": "$entity3.id",
        "name": "$entity3.name",
        "category": "$entity3.category",
        "pageUrl": "$entity3.pageUrl",
        "thumbnailUrl": "$entity3.thumbnailUrl"
       },
       "recEntity4Details": {
        "id": "$entity4.id",
        "name": "$entity4.name",
        "category": "$entity4.category",
        "pageUrl": "$entity4.pageUrl",
        "thumbnailUrl": "$entity4.thumbnailUrl"
       },
       "recEntity5Details": {
        "id": "$entity5.id",
        "name": "$entity5.name",
        "category": "$entity5.category",
        "pageUrl": "$entity5.pageUrl",
        "thumbnailUrl": "$entity5.thumbnailUrl"
       },
       "recEntity6Details": {
        "id": "$entity6.id",
        "name": "$entity6.name",
        "category": "$entity6.category",
        "pageUrl": "$entity6.pageUrl",
        "thumbnailUrl": "$entity6.thumbnailUrl"
       },
       "recEntity7Details": {
        "id": "$entity7.id",
        "name": "$entity7.name",
        "category": "$entity7.category",
        "pageUrl": "$entity7.pageUrl",
        "thumbnailUrl": "$entity7.thumbnailUrl"
       },
       "recEntity8Details": {
        "id": "$entity8.id",
        "name": "$entity8.name",
        "category": "$entity8.category",
        "pageUrl": "$entity8.pageUrl",
        "thumbnailUrl": "$entity8.thumbnailUrl"
       },
       "recEntity9Details": {
        "id": "$entity9.id",
        "name": "$entity9.name",
        "category": "$entity9.category",
        "pageUrl": "$entity9.pageUrl",
        "thumbnailUrl": "$entity9.thumbnailUrl"
       },
       "recEntity10Details": {
        "id": "$entity10.id",
        "name": "$entity10.name",
        "category": "$entity10.category",
        "pageUrl": "$entity10.pageUrl",
        "thumbnailUrl": "$entity10.thumbnailUrl"
       }
      }
     }
    }

Vídeo de treinamento: criar designs personalizados no Recommendations (3:20)

Este vídeo contém as seguintes informações:

Criar um design personalizado
Saiba como fazer referência às variáveis de exibição em seus designs

https://video.tv.adobe.com/v/35373?captions=por_br&learn=on

recommendation-more-help

target-help-main