Criar uma variável personalizada

Neste guia, mostramos como criar um modelo de variável personalizada. Essa variável usa uma matriz de valores e retorna como uma string separada por vírgulas.

Para começar seu primeiro modelo de variável, clique em "Modelos" na navegação à esquerda e no botão Novo na seção Modelos de variável.
Na guia Informações, defina o nome e a descrição da variável.

O nome será apresentado aos usuários quando eles implementarem essa variável em toda a interface do usuário do Gerenciador de tags.

A descrição é exatamente o que parece, uma breve descrição (200 caracteres ou menos) do que a variável faz.
Clique em Atualizar para visualizar seu modelo.

À direita dos campos de entrada, há uma janela Visualização do modelo. Sempre que acontece uma alteração no editor, o botão Atualizar é exibido. Clique nele para ver os resultados das suas mudanças na aparência da tag.
Clique em Campos para adicionar campos ao seu modelo de variável.

A guia Campos do Editor de modelos permite criar e editar campos no modelo de variável. Os campos são usados para inserir dados personalizados, como o ID de uma conta. Você pode adicionar os elementos de formulário padrão, como campos de texto, menus suspensos, botões de opção e caixas de seleção.
Clique em Adicionar campo e selecione Tabela simples. Substitua o nome padrão (como simpleTable1) por list. Em Visualização do modelo, clique em Atualizar.

Faça o mesmo em uma entrada de texto e chame-a de array. Além disso, nomeie duas caixas de seleção como use_array e sort, e uma entrada de texto como delimiter. Atribua ao delimiter um valor padrão de ",". Basta clicar no ícone de engrenagem, ativar Valor padrão e preencher o novo campo de entrada "Valor padrão".
Clique na guia Código e insira o JavaScript no modo sandbox no editor:
```
var input = data.array;

if (!data.use_array) {
  input = [];
  for (var i = 0; i < data.list.length; i++) {
    input.push(data.list[i].values);
  }
}

if (data.sort) {
  input.sort();
}

return input.join(data.delimiter || ',');
```
O código dessa variável é bastante simples, mas há pontos importantes para destacar:
- Campos data.
  
  Há alguns campos que estão sendo acessados fora do data global. O campo data inclui os valores que você configurou na etapa anterior. É por isso que podemos acessar data.use_array, data.sort, data.list e data.delimiter.
- delimiter é definido como um valor padrão de "," se data.delimiter não for fornecido. Recomendamos definir valores padrão para um campo, se for relevante. Isso facilita a utilização do modelo de variável, já que os usuários não precisam preencher todos os campos para usar a variável.
Clique em Salvar para registrar seu progresso. Com isso, as permissões detectadas serão carregadas no Editor de modelos.

Algumas APIs de modelo têm permissões associadas que determinam o que elas podem fazer. Quando você usa uma API de modelo (como sendPixel) no seu código, o Gerenciador de tags mostra as autorizações relevantes na guia Permissões.
Na guia Visualização do modelo, adicione alguns valores à entrada "values", clique em Executar código e confira o resultado da variável no console.

Se houver algum erro, ele vai aparecer na janela Console.
Clique em Salvar e feche o Editor de modelos.

O modelo de variável estará pronto para ser usado.