Criando Modelos

As campanhas Dynamic Yield são construídas a partir de experiências, que contêm as variações servidas aos seus visitantes. A maioria das variações é criada com base em um modelo. Modelos permitem que você aplique alterações a várias variações de uma vez, em vez de alterar o código de cada uma individualmente.

Dynamic Yield oferece uma variedade de modelos para suportar casos de uso comuns que estão disponíveis apenas ao criar variações. Você pode ver a lista de modelos ao criar uma variação ou no nosso website. (eles não são visíveis na área de Ativos Modelos). Enquanto testamos esses modelos em uma variedade de casos de uso, você pode precisar ajustá-los para funcionar corretamente em seu ambiente. 

Um desenvolvedor também pode projetar e criar um modelo personalizado, que pode ser selecionado posteriormente ao criar uma variação. Assim como nas variações, um modelo pode conter variáveis no código, tornando parte do código acessível aos profissionais de marketing. As variáveis também permitem alterar o conteúdo de diferentes variações baseadas no mesmo modelo.

Ao basear sua variação em um dos modelos da Dynamic Yield, você pode editar o código da variação sem afetar outras experiências que usam o mesmo modelo. No entanto, se você editar um modelo personalizado, isso afeta todas as experiências que usam esse modelo. 

Criando um modelo

1. Acesse Assets › Templates e clique em Add New (Adicionar Novo). 
2. Insira um nome e notas e rótulos (opcional).
3. No menu suspenso Template type, escolha o tipo de campanha para a qual o modelo é projetado (por exemplo, Conteúdo Dinâmico, Overlay) que usará este modelo. Uma vez selecionado, isso não pode ser alterado. 
4. Em More Options (Mais Opções), você pode fazer upload de uma miniatura personalizada que será exibida na interface do usuário da Dynamic Yield ao criar uma nova variação (tamanho máximo do arquivo: 2 MB).
5. Escreva o código que definirá o modelo. Use as abas para selecionar o idioma, como HTML ou JavaScript.
6. Em alguns tipos de modelos, você pode adicionar folhas de estilo externas e código nas abas CSS e JS especificando uma URL onde os recursos estão localizados. 
   
7. Visualize como seu modelo será exibido em diferentes tipos ou tamanhos de dispositivos. Em sobreposições e notificações, você também pode escolher a posição na tela.
   
8. Após escrever o código, crie variáveis com base nos casos de uso do modelo. Quaisquer elementos que possam precisar ser modificados ao usar o modelo devem ser transformados em variáveis, destacando uma string e clicando em Convert to Variable (Converter em Variável). Exemplos comuns incluem texto do título, cor de fundo, texto do botão, etc. Quando o modelo é usado para criar variações, os usuários poderão especificar valores para cada variável em um formulário simples. Para mais detalhes, consulte as Variáveis abaixo.
9. Salve o modelo.
10. O modelo será listado na tabela principal de Modelos, assim como no fluxo de criação de variações do tipo de campanha relevante (Conteúdo Dinâmico, Recomendações, etc.).

Nota: Nota: Qualquer alteração feita no modelo afetará as variações que estão conectadas a ele, permitindo que você aplique alterações a todas as variações de uma vez. Se você adicionar uma nova variável, todas as variações conectadas receberão o valor inserido no modelo.

Variáveis do Modelo

Variáveis podem ser usadas em seus modelos para permitir que os usuários modifiquem aspectos do modelo sem alterar o próprio modelo. Por exemplo, se você definiu um botão com texto em um modelo, pode transformar o texto em uma variável de modelo para permitir que os usuários mudem facilmente o texto toda vez que o modelo for usado. 

Variáveis também podem ser usadas para modificar seus modelos com base em dados, como a localização do usuário, uma propriedade de um produto do seu feed ou até mesmo os cookies no navegador de um usuário.

1. Para transformar uma string em seu código em uma variável, destaque uma seção de texto em um modelo e clique em "Converter em Variável" ou escreva manualmente ${variable_name}.
   
2. Defina o tipo e o valor da variável. Para detalhes, consulte Tipos de Variáveis abaixo. 

3. Para melhorar a usabilidade de suas variáveis, você pode definir dicas de ferramentas para cada variável, bem como um texto de espaço reservado para alguns tipos de variáveis. O texto de espaço reservado é exibido em cinza no campo do seletor antes que o usuário insira seu valor, normalmente usado para incluir um valor de exemplo ou uma descrição do que deve ser inserido (por exemplo, "Digite o texto do botão aqui"). 
   

4. Na guia Variáveis na visualização de autoria da web, aparecerá um novo campo para cada variável em seu código, permitindo que você reutilize o código e escolha um valor diferente para cada uma das variações diferentes em suas variações de campanha.
   

Tipos de variáveis

Diferentes tipos de variáveis podem ajudar a construir um "formulário" melhor e mais inteligente para este modelo, para que o valor substitua a variável no código:

• Texto: Permite que os usuários insiram um texto.
• Imagem: Permite que o usuário faça upload de uma imagem diferente (até 2 MB).
• Seletor de Cor: Permite que o usuário escolha uma cor de uma paleta de cores.
• Número
• Dropdown: Permite que o usuário escolha de uma lista de valores determinados antecipadamente pelo desenvolvedor.
• Seletor CSS 
• Desempenho do Produto: Esta variável renderizará dinamicamente o número de visualizações ou compradores de um produto em um determinado período de tempo.
• Localização do Usuário: Substitui dinamicamente a variável pela localização do visitante como seu valor (Cidade, Estado dos EUA ou País), e pode ser acompanhada por um texto antes e depois do nome da localização. O usuário pode inserir um texto de fallback no caso de a localização do visitante não poder ser determinada.
• Cookie: Substitui dinamicamente a variável pelo valor do cookie do visitante (o nome do cookie é determinado pelo desenvolvedor). O usuário pode inserir um valor de fallback no caso de o cookie não existir.
• Avaliador: Substitui dinamicamente a variável pelo valor do Avaliador (o avaliador é escolhido pelo desenvolvedor). O usuário pode inserir um valor de fallback no caso de o avaliador não retornar nenhum valor.
• Parâmetro de URL: Renderiza dinamicamente para cada visitante o valor do parâmetro de URL que cada visitante recebe para o parâmetro definido; um fallback é necessário no caso de o visitante chegar sem o parâmetro de URL ou sem seu valor.
• Chave Única: Permite que o usuário gere uma chave aleatória. A geração de chave é feita apenas ao criar a variação - a mesma chave selecionada será usada para todos os visitantes que visualizam a variação.
• Título de Estratégia: Exibe o título da sua estratégia de recomendação.
• ID Externo:  (apenas para e-mails acionados) O ID usado para identificar usuários em vez de um endereço de e-mail. 
• E-mail Hashed: (apenas para e-mails acionados) O endereço de e-mail do usuário em formato hash. 
• Mensagem Criptografada (HMAC): (apenas para e-mails acionados)
• E-mail em Texto Puro: (apenas para e-mails acionados)
• Estratégia de Seleção de Produto: (apenas para notificações push)
• Composta: (apenas para notificações push) 

Existem variáveis adicionais que permitem renderizar dinamicamente informações sobre a campanha Dynamic Yield, como o nome da campanha e o nome da variação:

• ${dyTagName} – renderiza o nome da campanha
• ${dyTagId} – renderiza o ID da campanha
• ${dyExperienceName} – renderiza o nome da experiência
• ${dyExperienceId} – renderiza o ID da experiência
• ${dyVariationName} – renderiza o nome da variação
• ${dyVariationId} – renderiza o ID da variação  

Visualizando a atividade do modelo (histórico de alterações)

Você pode visualizar o histórico de alterações feitas no código de seus modelos. Isso pode ser usado para rastrear a origem de um problema (solução de problemas) ou recuperar uma versão anterior do seu código. 

Você pode ver o Histórico do Modelo de cada modelo clicando em mais próximo de cada modelo na lista de modelos e clicando em Activity (Atividade). 

Você também pode ver a atividade do modelo ao editar um modelo clicando no ícone de atividade:

Na página de atividade do modelo, você pode baixar um log detalhado em formato CSV:

O arquivo CSV contém uma linha para cada alteração em uma propriedade no modelo. As colunas incluídas são:

• Data: A data e hora em que a alteração foi salva.
• Usuário: O usuário do Dynamic Yield que fez a alteração.
• Propriedade: A área do modelo que foi alterada. 
• De: O valor original da propriedade.
• Para: O valor alterado da propriedade. 

Nota: Este registro está disponível apenas para modelos que foram editados ou criados após julho de 2019. ]

Visualizando quais experiências usam cada modelo

Na lista de modelos, você pode usar a coluna de experiência para ver quantas experiências estão usando cada modelo.

Clique no número para ver mais detalhes. Se desejar arquivar ou excluir o modelo, você pode usar esta janela para desvincular todas (unlink all) as experiências rapidamente. As experiências manterão sua aparência, mas não estarão mais vinculadas a um modelo.  

Excluindo e arquivando modelos

Você pode excluir ou arquivar um modelo a qualquer momento clicando no ícone mais próximo de qualquer modelo na lista e selecionando Delete ou Archive. Ao excluir um modelo, ele é removido permanentemente. Ao arquivar um modelo, ele pode ser desarquivado a qualquer momento.

Em ambos os casos, se o modelo estava sendo usado por uma ou mais experiências, elas manterão o código do modelo, mas não estarão mais vinculadas a um modelo.

Copiando modelos para um site diferente

Você pode copiar um modelo para um ou mais sites diferentes na mesma conta da Dynamic Yield. Para fazer isso, passe o mouse sobre um modelo e clique em Copy à direita. Selecione os sites de destino e uma cópia do modelo será criada nesses sites. Se um modelo já existir com o mesmo nome, você será perguntado se deseja substituir o modelo ou cancelar a operação de cópia.

As cópias não estão vinculadas, portanto, alterações futuras no modelo original ou nas novas cópias não afetarão umas às outras. Lembre-se também de que a cópia não está vinculada a campanhas, então, para usá-la, selecione-a na tela de Modelo ao editar uma variação.

Modelos nativos para dispositivos móveis

Os modelos para dispositivos móveis são construídos usando HTML, CSS e JavaScript que usam WebView rpara renderizar a experiência. Também existe um Modelo nativo da Dynamic Yield para sobreposições que não usam WebView e, portanto, carrega mais rapidamente.