Os personalizadores de anúncios são uma ferramenta poderosa que permite personalizar o conteúdo de texto dos seus anúncios responsivos de pesquisa usando marcadores de texto dinâmicos.
Você pode criar e usar um personalizador de anúncios ou usar um personalizador de anúncios integrado.
Criar e usar um personalizador de anúncios
Siga estas etapas para criar um personalizador de anúncios responsivos de pesquisa:
Crie o atributo do personalizador.
O atributo do personalizador é uma categoria ampla que descreve o tipo de mudança que você pretende vincular a esse personalizador, por exemplo, "preço do produto" ou "porcentagem de desconto".
Vincule o atributo do personalizador a um critério de grupo de anúncios de cliente, campanha, grupo de anúncios ou palavra-chave.
Defina os valores específicos que você quer usar para o recurso específico.
Criar um atributo do personalizador
Primeiro, você precisa criar um novo atributo do personalizador, representado por
CustomizerAttribute usando
CustomizerAttributeService com
dois campos obrigatórios:
name- O nome do personalizador, que precisa ser exclusivo (sem distinção entre maiúsculas e minúsculas). Como há um limite de 40 personalizadores, talvez seja necessário reutilizar personalizadores em diferentes recursos. Por isso, escolha um nome que represente uma categoria ampla de para que tipo de personalizações ele será usado.
type- O tipo de personalizador (texto, número, preço ou porcentagem) definido
por
CustomizerAttributeType.
Ao criar um novo atributo do personalizador, você recebe o nome do recurso, que é obrigatório na próxima etapa.
Vincular o atributo do personalizador
Você pode vincular o atributo do personalizador criado anteriormente em vários níveis usando os seguintes serviços:
CustomerCustomizerServicepara criarCustomerCustomizerpara o nível do cliente.CampaignCustomizerServicepara criarCampaignCustomizerpara o nível da campanha.AdGroupCustomizerServicepara criarAdGroupCustomizerpara o nível do grupo de anúncios.AdGroupCriterionCustomizerServicepara criarAdGroupCriterionCustomizerpara o nível do critério do grupo de anúncios. Para esse tipo, apenas os critérios de palavra-chave são aceitos.
Independentemente do nível e do serviço correspondente que você usar, as mesmas informações são necessárias:
customizer_attribute- O nome do recurso do atributo do personalizador que você criou na etapa anterior.
valueO valor que você quer inserir nos seus anúncios ao fazer referência a esse atributo do personalizador. Esse campo é definido por
CustomizerValue.Você precisa especificar
typeestring_valuepara criarCustomizerValue. O valortypeprecisa ser o mesmo que o atributo do personalizador que você está vinculando, estring_valueé o valor que você quer que a API Google Ads use.- Nome do recurso ao qual você quer vincular o atributo do personalizador
O nome varia de acordo com o tipo de recurso. Por exemplo, para criar
CampaignCustomizer, especifique acampaign.
Depois de concluir essa etapa, você poderá usar o personalizador de anúncios em anúncios responsivos de pesquisa incluídos na hierarquia de recursos a que você vinculou o atributo do personalizador. Por exemplo, se você vincular o atributo do personalizador à campanha com um ID A, poderá usar esse personalizador de anúncios em um anúncio criado em qualquer grupo de anúncios dentro da campanha A. Não é possível usar o personalizador de anúncios em um anúncio em grupos de anúncios dentro da campanha B.
Personalizadores de anúncios em anúncios responsivos de pesquisa
Para usar o personalizador de anúncios em títulos e descrições dos anúncios responsivos de pesquisa, você precisa criar um objeto AdTextAsset
com text incluindo a seguinte sintaxe:
{CUSTOMIZER.CUSTOMIZER_ATTRIBUTE_NAME:DEFAULT_VALUE}
CUSTOMIZER_ATTRIBUTE_NAMEé onamedo atributo do personalizador que você definiu ao criá-lo, não o nome do recurso do atributo do personalizador nem o ID dele.DEFAULT_VALUEé o valor padrão do personalizador de anúncios.
Consulte o guia de anúncios responsivos de pesquisa para mais informações sobre como configurar os anúncios.
Regras e limitações
Só pode haver um link por nível (cliente, campanha, grupo de anúncios ou critério de grupo de anúncios), e o mais específico vai substituir o mais geral. Por exemplo, se você tiver esse atributo do personalizador definido no nível da campanha e do grupo de anúncios, os anúncios no grupo de anúncios vinculado vão usar o do grupo de anúncios, mas os anúncios de outros grupos de anúncios nessa campanha vão usar o da campanha.
É possível ter até 40 objetos
CustomizerAttributeativados na sua conta. Se você atingir esse limite, remova os não utilizados antes de criar um novo.Há regras para atributos do personalizador com o tipo
PRICE:- Os códigos e símbolos de moeda podem aparecer antes ou depois do número. Por exemplo,
$100,100$,USD100e100USDsão todos valores válidos. - Não pode haver espaços entre o número e os códigos ou símbolos de moeda. Por exemplo,
$ 100é inválido. - Confira os códigos e símbolos de moeda que podem ser usados como parte do valor especificado.
- Os códigos e símbolos de moeda podem aparecer antes ou depois do número. Por exemplo,
Usar personalizadores de anúncios integrados
Você pode usar tags de personalizador integradas diretamente nos títulos e descrições dos seus anúncios responsivos de pesquisa (RSA, na sigla em inglês). Essas tags permitem inserir dinamicamente palavras-chave, locais e contagens regressivas no texto do anúncio.
Inserção de palavra-chave
A inserção de palavra-chave atualiza dinamicamente o texto do anúncio para incluir a palavra-chave que fez com que ele fosse exibido. Isso pode tornar seus anúncios mais relevantes para as pesquisas dos usuários.
Consulte Configurar a inserção de palavra-chave para o texto do seu anúncio.
Sintaxe: {Keyword:Default text}
Inclua essa tag nos campos de título ou descrição ao criar ou atualizar um AdGroupAd com um tipo ResponsiveSearchAd usando a API.
Exemplo
Suponha que você tenha um título como "Compre {Keyword:Chocolate} on-line".
Se o usuário pesquisar "chocolate amargo", o título poderá aparecer como: "Compre chocolate amargo on-line". Se a palavra-chave não puder ser inserida, o "Texto padrão" ("Chocolate", nesse caso) será usado.
Consulte Sobre a inserção de palavra-chave.
Inserção de local
Adapte o texto do anúncio com base no local dos seus clientes ou nos locais em que eles demonstram interesse.
Sintaxe: {LOCATION(Level):Default text}
Level: especifique o nível geográfico, comoCity,StateouCountry. Se omitido, o padrão será o nível mais específico disponível.
Exemplo
Título: "Delivery de pizza em {LOCATION(City):Your Area}"
Se um usuário estiver na cidade de Nova York, ele poderá ver: "Delivery de pizza na cidade de Nova York". Os usuários fora de uma área específica verão: "Delivery de pizza na sua área".
Consulte Sobre a inserção de local em anúncios responsivos de pesquisa.
Funções de contagem regressiva
Crie um senso de urgência mostrando uma contagem regressiva em tempo real para um evento ou promoção específica.
Sintaxe
{COUNTDOWN(yyyy-MM-dd HH:mm:ss,daysBefore)}- Contagem regressiva para um horário específico no fuso horário da conta do anunciante.{GLOBAL_COUNTDOWN(yyyy-MM-dd HH:mm:ss,daysBefore)}- Contagem regressiva para um horário específico no fuso horário do usuário.daysBefore: quantos dias antes da data de término a contagem regressiva deve começar a aparecer.
Exemplo
Título: "A promoção termina em {COUNTDOWN(2026-01-31 23:59:59,5)}"
Esse anúncio vai mostrar uma contagem regressiva a partir de 5 dias antes de 31 de janeiro de 2026, 23:59:59 no fuso horário do anunciante.
Consulte Dar destaque a eventos futuros usando a contagem regressiva.
Implementação usando a API
Para usar esses personalizadores integrados, inclua a sintaxe da tag nos campos text dos objetos AdTextAsset para os headlines e descriptions do seu RSA ao modificar um recurso AdGroupAd.
Exemplo de snippet (JSON conceitual)
{
"ad": {
"responsiveSearchAd": {
"headlines": [
{ "text": "Great Deals on {Keyword:Shoes}" },
{ "text": "Free Shipping in {LOCATION(City):Your City}" },
{ "text": "Offer Ends: {COUNTDOWN(2026-01-31 23:59:59,5)}" }
],
"descriptions": [
{ "text": "Find the best {Keyword:footwear} for your needs." },
{ "text": "Limited time offer, don't miss out!" }
]
},
"finalUrls": ["https://www.example.com"]
}
}