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 aceitam 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 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. 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. Um script pode ativar todas as palavras-chave com weekend_keywords na sexta-feira à noite e pausar 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 30 minutos, depois será possível criar um rótulo processed em seu e aplicá-lo à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 for executado no rótulo e percebe que já aumentou o lance anteriormente, ela aumentaria 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 informar periodicamente 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 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, você pode 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 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

Você pode criar e aplicar rótulos a campanhas, grupos de anúncios e anúncios e palavras-chave. 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 rótulos de recursos para filtrar entidades durante a execução 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 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.