Usar funções, atributos de inventário e colunas de fórmula em modelos de inventário

Para gerar configurações exclusivas de texto do anúncio, palavras-chave, campanhas e grupos de anúncios, adicione funções do DoubleClick Search, atributos de inventário ou colunas de fórmula aos seus modelos de inventário. Quando você quiser usar o mesmo valor para todos os anúncios, palavras-chave ou outros itens, insira texto ou números estáticos, dependendo do tipo de dados da configuração.

Por exemplo, no modelo de anúncio abaixo:

• o título 1 gera o texto estático: "Liquidação de tênis de corrida";
• o título 2 contém a seguinte fórmula para gerar a mensagem "Frete grátis" referente aos produtos com preço acima de US$ 25:
  Frete [if(max(Item_price) < 25, "rápido", "grátis")].
  
  Para gerar o resultado, o "título 2" combina duas funções (if e max), texto e números estáticos e o atributo de inventário Item_price.

Sintaxe para modelos de inventário

A sintaxe para inserir configurações de campanha, grupo de anúncios, anúncio e palavra-chave (entre outras) em um modelo de inventário é a seguinte: 

• É possível inserir texto e números estáticos diretamente em um modelo.
• As datas sempre precisam ser inseridas em uma função, como date.
• Todas as funções, atributos de inventário e colunas de fórmula precisam estar entre [ ] (colchetes) 
  Para incluir os caracteres [ ] no texto do anúncio, faça o escape deles da seguinte maneira:
  \[ \]

Exemplo: \[*EngineAccountType*\]): faz o escape de uma macro. 

Disponibilidade de funções depende do contexto

O DS oferece uma grande coleção de funções, mas algumas delas só podem ser usadas em fórmulas ou colunas de fórmula que tenham dados de inventário. Por exemplo, max(ATRIBUTE) calcula o valor máximo de um atributo de inventário entre todos os itens de um grupo de anúncios. Por isso, a função só pode ser aplicada a dados de inventário.

Outras funções só podem ser usadas em colunas de fórmula com métricas de mecanismo ou de conversão. Por exemplo, for_date_range(data) só pode ser usada com métricas: Clicks.for_date_range(last_7_days())

Quando você cria modelos de inventário, o DS mostra somente as funções válidas para o contexto atual. 

Tratamento de valores inválidos

Como não podemos antecipar todas as variações de dados possíveis, verifique se as funções conseguem lidar com erros em potencial. Quando a função retorna um valor vazio ou inválido, o DS não gera campanhas. É possível usar uma das abordagens a seguir (ou todas elas) para lidar com os erros:

• Coloque as funções em if_error(function, alternate) ou if(is_error(function), alternate1, alternate2). Se function retornar um erro ou estiver vazia, alternate será retornada.
• Use a função if(condition, true, else) para filtrar ou alterar os resultados indesejados.
• Use wrappers para os atributos de inventário, como min(ATTRIBUTE), max(ATTRIBUTE) ou any(ATTRIBUTE), a menos que você tenha certeza de que cada grupo de anúncios só terá um valor referente ao atributo.
  Por exemplo, especifique max(Item_price) se um grupo de anúncios puder ter produtos com preços diferentes.
• Crie substitutos para cada campo nos modelos de anúncios caso o resultado do modelo seja muito longo. 

Criar colunas de fórmulas para uso em modelos de inventário

Se você usar frequentemente os mesmos atributos de inventário, funções e texto estático nos seus modelos, poderá definir a lógica em uma coluna de fórmula para uso, em vez de repetir a lógica em cada um dos modelos.

A sintaxe das colunas de fórmula é diferente da sintaxe dos modelos de inventário. Por exemplo, você pode inserir texto estático diretamente em um modelo de inventário, mas as colunas de fórmula exigem que o texto estático fique entre aspas.

Por exemplo, caso você use com frequência o caractere $ como prefixo do preço de um produto e gere o preço com duas casas decimais, siga estas etapas:

1. Crie uma coluna de fórmula que tenha esta fórmula:
   "$" & to_string(Item_price, 2)
2. Dê um nome descritivo à coluna, como preço_com_moeda.
3. Quando necessário, inclua a coluna no modelo. Por exemplo, inclua a linha a seguir na descrição de um modelo de anúncio:
   Preços a partir de [c:"preço_com_moeda"​].

Para criar colunas de fórmulas que podem ser usadas em modelos de inventário:

1. Navegue até um anunciante.

2. No painel de navegação à esquerda, clique em Gerenciamento de inventário.

3. Clique na guia Itens de inventário.

4. Clique no botão Colunas na barra de ferramentas acima do gráfico do resumo de desempenho.
   A ferramenta de seleção de coluna será exibida.

5. Clique em Colunas de fórmula no cabeçalho Colunas disponíveis.
   É exibida uma lista de colunas de fórmula que já foram criadas no anunciante.

6. Clique em Criar uma nova coluna.
   O pop-up com as configurações de sua nova coluna será exibido.

7. Dê um nome à coluna.
   Ele será exibido na criação dos modelos de inventário. Por isso, é importante definir um nome que todos os usuários envolvidos reconheçam com facilidade.

8. Na caixa Inserir equação, crie uma nova fórmula.
   Use o campo de pesquisa para encontrar os nomes dos atributos ou das funções de inventário que você pode usar. Não se esqueça de usar a sintaxe para colunas de fórmula, que é diferente da sintaxe dos modelos de inventário.

9. Clique em Salvar.
   • Se ocorrer um erro, clique em Selecionar erro para que ele fique destacado, corrija-o e clique em Salvar novamente.
   • Assim que os erros forem corrigidos, a coluna aparecerá automaticamente na lista de colunas selecionadas.