Rótulos

Os rótulos permitem organizar elementos na sua conta em grupos significativos para que você possa filtrar e gerar relatórios com os dados mais interessantes. Os scripts do Google Ads suportam rótulos nos níveis da conta, da campanha, 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 semelhantes. 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. Assim, um script pode enviar palavras-chave relacionadas a encanadores (por exemplo, "reparo de chuveiro de emergência") em todas as campanhas nessas contas.
  • Processe uma lista de entidades.
    • Se você tiver um conjunto de palavras-chave que quer ativar somente durante os fins de semana, poderá aplicar um rótulo weekend_keywords a elas. Assim, um script poderia ativar todas as palavras-chave com weekend_keywords na noite de sexta-feira e pausá-las na manhã de segunda-feira.
  • Processe 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 seu script e aplique-o às entidades que já foram processadas. Agende 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.
  • Alterações em duas etapas
    • Em vez de fazer com que o script execute uma alteração de lance em um grande número de palavras-chave, é possível 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, analisá-las e, se estiver satisfeito com o resultado, alterar 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 um lance de palavra-chave em 20%, ele pode marcar a conta com um rótulo, increased_20%. No dia seguinte, quando o script for executado no rótulo e perceber que já havia aumentado o lance anteriormente, ele poderá aumentar o lance em apenas 10%.
  • Acompanhamento do Índice de qualidade
    • Um script pode rotular palavras-chave importantes com seus índices de qualidade. Depois, 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

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

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

Use o método applyLabel para aplicar o rótulo às contas que você quiser:

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 do script.

Rótulos de uma conta

É possível criar e aplicar rótulos a campanhas, grupos de anúncios, anúncios e palavras-chave. 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 costumam ser 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

Você pode usar nomes de recursos de rótulos para filtrar entidades ao executar relatórios de desempenho de contas do Google Ads. Os nomes de recursos são um conceito da API Google Ads e às vezes são usados na geração de 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 de recurso de um rótulo usando o método getResourceName.

O snippet de código a seguir mostra como gerar 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 é possível usar apenas os operadores CONTAINS_ALL, CONTAINS_ANY e CONTAINS_NONE para filtrar por nomes de recursos de rótulos.