Personalização de anúncios responsivos de pesquisa (RSA)

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:

  1. 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".

  2. 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.

Você pode vincular o atributo do personalizador criado anteriormente em vários níveis usando os seguintes serviços:

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.
value

O 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 type e string_value para criar CustomizerValue. O valor type precisa ser o mesmo que o atributo do personalizador que você está vinculando, e string_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 a campaign.

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 é o name do 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 CustomizerAttribute ativados 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$, USD100 e 100USD sã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.

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, como City, State ou Country. 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"]
  }
}