Rótulos

Os rótulos permitem organizar os elementos da sua conta em grupos relevantes para filtrar e gerar relatórios sobre os dados do seu interesse com rapidez. Os scripts do Google Ads oferecem suporte a rótulos nos níveis de conta, campanha, grupo de anúncios, anúncio e 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 semelhantes. Os rótulos ajudam em vários casos de uso:

  • Processar uma lista de contas
    • Se você for uma agência, poderá 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, "reparo de chuveiro de emergência") para todas as campanhas dessas contas.
  • Processar uma lista de entidades
    • Se você tiver um conjunto de palavras-chave que só quer ativar nos fins de semana, aplique um rótulo weekend_keywords a elas. Um script pode ativar todas as palavras-chave com weekend_keywords na noite de sexta-feira e pausá-las na manhã de segunda-feira.
  • 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. Programe o script para ser executado a cada hora e processe apenas as entidades que não têm o rótulo processed aplicado.
  • Mudanças em duas etapas
    • Em vez de fazer com que o script execute uma mudança de lance em um grande número de palavras-chave, você pode rotular as palavras-chave com increase_bid_by_10%, fazer login na interface do Google Ads, filtrar as palavras-chave que correspondem ao rótulo, revisá-las e, se estiver satisfeito com o resultado, mudar os 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 um lance de palavra-chave em 20%, ele pode marcar a conta com um rótulo, 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 pode rotular palavras-chave importantes com os Índices de Qualidade delas e, em seguida, verificar e gerar relatórios periodicamente sobre as palavras-chave cujo Índice de Qualidade não corresponde mais ao rótulo.

Rótulos no nível da conta

Os scripts do Google Ads permitem criar rótulos em contas de administrador, bem como aplicar rótulos a contas do Google Ads nessa conta de administrador:

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

Você pode aplicar o rótulo às contas de sua escolha usando o applyLabel método:

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, você pode remover um rótulo de uma conta usando o removeLabel método:

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 contas é 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 nosso guia de scripts de contas de administrador para saber mais sobre o processamento de várias contas em uma única execução de script.

Rótulos de uma conta

É possível criar e aplicar rótulos a campanhas, grupos de anúncios, anúncios e palavras-chave de uma conta. Veja 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, você pode 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 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 executar 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 executar relatórios com GAQL. Um nome de recurso de rótulo está sempre no formato:

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

É possível buscar o nome do recurso de um rótulo usando o getResourceName método.

O snippet de código a seguir mostra como executar um relatório de campanha para todas as campanhas que têm um 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.