Com os rótulos, você pode organizar os elementos da sua conta em grupos significativos para filtrar e gerar relatórios rapidamente sobre os dados mais interessantes para você. 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 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 secundárias 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_accountsa todas as contas de encanadores. Depois, um script pode enviar palavras-chave relacionadas a encanadores (por exemplo, "conserto de chuveiro de emergência") para todas as campanhas nessas contas.
- Se você é uma agência, pode aplicar um rótulo
- 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_keywordsa elas. Um script poderia ativar todas as palavras-chave comweekend_keywordsna sexta-feira à noite e pausá-las na segunda-feira de manhã.
- Se você tiver um conjunto de palavras-chave que quer ativar apenas nos fins de semana, aplique um rótulo
- 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
processedno seu script e aplique-o às entidades que já foram processadas. Programe o script para ser executado de hora em hora e processe apenas as entidades que não têm o rótuloprocessedaplicado.
- Se você tiver um grande número de entidades que não podem ser processadas em menos de 30 minutos, crie um rótulo
- Mudanças em duas etapas
- Em vez de fazer o script 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, analisá-las e, se estiver satisfeito com o resultado, mudar os lances delas usando edições em massa.
- Em vez de fazer o script executar uma mudança de lance em um grande número de palavras-chave, você pode rotular as palavras-chave com
- 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 o lance já foi aumentado, ele poderá aumentar o lance em apenas 10%.
- 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,
- Acompanhamento do Índice de Qualidade
- Um script pode rotular palavras-chave importantes com os respectivos Índices de qualidade 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 às contas do Google Ads que estão sob essa conta de administrador:
const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);
É possível aplicar o rótulo às contas que 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 da 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 como processar 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, é 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 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ótulo 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 a 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.
O snippet de código a seguir mostra como gerar um relatório de campanha para todas as campanhas que têm 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);
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.