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 do seu interesse com rapidez. Os scripts do Google Ads são compatíveis com 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 marcadores 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. Depois, um script poderá inserir palavras-chave relacionadas a encanadores (por exemplo, "conserto de chuveiro de emergência") em todas as campanhas dessas contas.
  • Processar uma lista de entidades
    • Se você tiver um conjunto de palavras-chave que quer ativar apenas durante os fins de semana, aplique um rótulo weekend_keywords a elas. Um script pode ativar todas as palavras-chave com weekend_keywords na sexta-feira à noite e pausá-las 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. Programe o script para ser executado a cada hora e processe apenas as entidades que não têm o rótulo processed aplicado a elas.
  • Mudanças em duas etapas
    • Em vez de executar 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 marcador e percebe que já havia aumentado o lance antes, ele pode aumentar o lance em apenas 10%.
  • Acompanhamento do índice de qualidade
    • Um script pode rotular palavras-chave importantes com os respectivos Índices de qualidade e, depois, verificar e gerar relatórios periodicamente sobre palavras-chave cujo Índice de qualidade não corresponde mais ao rótulo.

Rótulos no nível da conta

Com os scripts do Google Ads, é possível criar e aplicar rótulos em contas de administrador e do Google Ads:

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

É possível aplicar o rótulo às contas que você quiser 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 dos rótulos de conta é processar um grupo de contas que compartilham o mesmo rótulo:

const labelName = 'High spending accounts';

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

Consulte nosso guia de scripts da conta 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 às campanhas, aos grupos de anúncios, aos anúncios e às 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, é 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 mais comumente usados 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ótulo para filtrar entidades ao executar relatórios de performance de 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. O nome de um 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 método getResourceName dele.

O snippet de código a seguir mostra como executar um relatório de campanha para todas as campanhas com 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);

Lembre-se de que só é possível usar os operadores CONTAINS_ALL, CONTAINS_ANY e CONTAINS_NONE para filtrar por nomes de recursos de rótulo.