Rótulos

Com os rótulos, você pode organizar os elementos na sua conta em grupos relevantes para filtrar e gerar relatórios sobre os dados mais interessantes de forma rápida. Os scripts do Google Ads suportam rótulos em conta, campanha, níveis do grupo de anúncios, do anúncio e da palavra-chave.

Casos de uso

Nas contas do Google Ads, os rótulos podem ser usados para associar dados arbitrários a entidades do Google Ads. Nas contas de administrador, os rótulos podem ser usados para agrupar contas filhas. Os rótulos ajudam em vários casos de uso:

  • Processar uma lista de contas
    • Se você é uma agência, pode aplicar um rótulo plumber_accounts a todas as contas de encanadores. Em seguida, um script pode enviar palavras-chave relacionadas a encanadores (por exemplo, "conserto de chuveiro de emergência") para todas as campanhas nessas contas.
  • Processar uma lista de entidades
    • Se você tiver um conjunto de palavras-chave que quer ativar apenas nos fins de semana, aplique um rótulo weekend_keywords a elas. Assim, um script poderia ativar todas as palavras-chave com weekend_keywords na sexta-feira. à noite e pause-os na segunda-feira de manhã.
  • Processar entidades em várias execuções
    • Se você tiver um grande número de entidades que não podem ser processadas em menos de 30 minutos, crie um rótulo processed no script e aplique-o às entidades que já foram processadas. Agende o script para ser executado a cada hora e, em seguida, processe somente as entidades que não têm o marcador processed aplicado a elas.
  • Mudanças em duas etapas
    • Em vez de fazer com que o script execute uma alteração de lance em um número grande de palavras-chave, você pode rotular as palavras-chave com increase_bid_by_10%, registrar na interface do Google Ads, filtre as palavras-chave que correspondem ao rótulo, revise-os e, se estiver satisfeito com o resultado, altere seus lances usando edições em massa.
  • Lances flexíveis
    • Um script pode usar rótulos para manter o histórico de alterações de lances. Por exemplo, quando um script aumenta o lance de uma palavra-chave em 20%, ele pode marcar a conta com um marcador, increased_20%. No dia seguinte, quando o script é executado no rótulo e percebe que já aumentou o lance anteriormente, ele pode aumentar o lance em apenas 10%.
  • Acompanhamento do Índice de qualidade
    • Um script poderia rotular palavras-chave importantes com seus índices de qualidade e, verificar e gerar relatórios periodicamente sobre as palavras-chave cujo Índice de qualidade deixou de corresponde ao rótulo.

Rótulos no nível da conta

Com os scripts do Google Ads, você pode criar rótulos em contas de administrador e aplicá-los a contas do Google Ads nessa conta de administrador:

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

É possível aplicar o rótulo às contas que você escolher usando o método applyLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

Da mesma forma, é possível remover um rótulo de uma conta usando o método removeLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

O uso mais comum de rótulos de conta é processar um grupo de contas que compartilham o mesmo rótulo da conta:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

Consulte nossos scripts da conta de administrador guia para saber mais sobre o processamento de várias contas em uma única execução do script.

Rótulos de uma conta

É possível criar e aplicar rótulos às campanhas, grupos de anúncios, anúncios e palavras-chave de uma conta. Saiba como aplicar um rótulo a uma campanha:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

Da mesma forma, é possível remover um rótulo usando o método removeLabel:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

Os rótulos são usados com mais frequência para processar um conjunto de entidades semelhantes agrupadas por um rótulo. O snippet de código a seguir mostra como pausar um grupo de campanhas que compartilham um rótulo comum:

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

Relatórios

É possível usar nomes de recursos de rótulos para filtrar entidades ao gerar relatórios de performance para contas do Google Ads. Os nomes de recursos são um conceito da API Google Ads e às vezes são usados ao gerar relatórios com o GAQL. Um recurso de rótulo nome está sempre no formato:

customers/[customer id]/labels/[label id]

É possível buscar o nome do recurso de um identificador usando o método getResourceName dele.

O snippet de código abaixo mostra como gerar um relatório de campanha para todas as campanhas com o rótulo "Promoções de Natal":

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

Só é possível usar os operadores CONTAINS_ALL, CONTAINS_ANY e CONTAINS_NONE para filtrar por nomes de recursos de rótulos.