Rótulos

Os rótulos permitem que você categorize suas campanhas, grupos de anúncios, anúncios e palavras-chave, e use essas categorias para simplificar o fluxo de trabalho de várias maneiras.

Este guia explica os passos necessários para:

  • criar rótulos;
  • rotular suas campanhas;
  • recuperar e filtrar resultados de relatórios por rótulo, usando as solicitações CampaignService, get() e query().

O foco deste guia são as campanhas, mas é possível usar a mesma abordagem para os grupos de anúncios, anúncios e palavras-chave.

Casos de uso

Veja a seguir alguns cenários típicos para o uso de rótulos:

  • Sua conta tem campanhas que são ativadas somente durante determinadas épocas do ano, e você deseja incluir ou excluir essas campanhas dos relatórios de modo prático.
  • Você adicionou um novo conjunto de palavras-chave ao seu grupo de anúncios e deseja comparar as estatísticas delas com outras palavras-chave do grupo de anúncios.
  • Cada usuário da sua conta do Google AdWords gerencia um subconjunto de campanhas, e você gostaria de ter uma maneira fácil de identificar o conjunto de campanhas de cada usuário.
  • Seu aplicativo precisa marcar o status de determinados objetos como processados, auditados, em destaque etc.

Consulte o artigo da Central de Ajuda sobre como usar os rótulos para ver mais informações e um exemplo de como os rótulos funcionam no Google AdWords.

Criar rótulos

É possível criar rótulos usando um objeto TextLabel. Para criar um TextLabel:

  1. Crie um objeto TextLabel.
  2. Defina o nome dele.
  3. Envolva o TextLabel em um LabelOperation e envie-o para LabelService.mutate().

Como você precisará dos IDs dos novos rótulos nas próximas etapas, capture-os na resposta da chamada de modificação ou use os serviços LabelService.get() ou LabelService.query() para recuperar esses IDs.

Rotular campanhas, grupos de anúncios, critérios ou anúncios

Use a operação mutateLabels para atribuir rótulos. Por exemplo, para rotular uma campanha, use CampaignService.mutateLabels com um ou mais objetos CampaignLabel, que são compostos pelos seguintes parâmetros:

  • labelId – The ID of a label
  • campaignId: o ID de uma campanha

Crie um objeto CampaignLabel para cada par rótulo/campanha que você deseja adicionar, envolva-o em um CampaignLabelOperation com o operador ADD e envie-o para CampaignService.mutateLabels.

Recuperar objetos usando rótulos

Depois de rotular suas campanhas, você pode usar o campo Rótulos para recuperar objetos que tenham um ou mais rótulos específicos. Por exemplo, veja uma declaração de CampaignService.query AWQL que seleciona o ID, o nome e os rótulos das campanhas associadas a um dos três IDs de rótulo.

SELECT Id, Name, Labels
WHERE Labels CONTAINS_ANY [123456, 789012, 345678]

Quando você definir filtros com os rótulos, considere as dicas a seguir:

  1. Filtre pelo código do rótulo, não pelo nome dele.
  2. Os únicos operadores compatíveis são: CONTAINS_ALL, CONTAINS_ANY e CONTAINS_NONE.

Usar o campo "Rótulos" nos relatórios

Todos os relatórios a seguir têm os campos Labels e LabelIds:

Como ocorre com outros campos do tipo List, é possível filtrar os resultados de relatórios por LabelIds usando CONTAINS_ANY, CONTAINS_ALL ou CONTAINS_NONE.

O serviço de relatórios retorna uma lista de nomes de rótulos e códigos separados por ponto e vírgula nos campos Labels e LabelIds, por exemplo:

CAMPAIGN_PERFORMANCE_REPORT (Jul 1, 2014-Jul 7, 2014)
Campaign ID,Labels,Label IDs
1999999,Label 1; Label 2,456; 678
2999999,Label 2;678
Total, --, --

Exemplos de código

A pasta Gerenciamento de campanhas de cada biblioteca cliente contém exemplos de códigos para a adição de rótulos às campanhas e a recuperação de campanhas pelos rótulos:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.