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 posição de texto dinâmico.

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:

  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 cliente, uma campanha, um grupo de anúncios ou um critério de grupo de anúncios de palavra-chave.

    Defina os valores específicos que você quer usar para o recurso.

Criar um atributo de personalizador

Primeiro, crie um atributo de 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 recursos diferentes. Por isso, escolha um nome que represente uma categoria ampla de personalizações.
type
O tipo de personalizador (texto, número, preço ou porcentagem) definido por CustomizerAttributeType.

Ao criar um atributo de personalizador, você recebe o nome do recurso dele, que é necessário na próxima etapa.

É possível vincular o atributo de personalização criado anteriormente em vários níveis usando os seguintes serviços:

Independente do nível que você quer e do serviço correspondente que usa, as mesmas informações são necessárias:

customizer_attribute
O nome do recurso do atributo de personalização que você criou na etapa anterior.
value

O valor que você quer inserir nos seus anúncios ao fazer referência a esse atributo de personalização. Esse campo é definido por CustomizerValue.

É necessário especificar type e string_value para criar CustomizerValue. O valor type precisa ser igual ao atributo personalizador que você está vinculando, e string_value é o valor que você quer que a API Google Ads use.

Nome do recurso que você quer vincular ao atributo do personalizador

O nome varia de acordo com o tipo de recurso. Por exemplo, para criar CampaignCustomizer, especifique o 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 o atributo do personalizador está vinculado. 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 de grupos de anúncios na campanha B.

Personalizadores de anúncios responsivos de pesquisa

Para usar o personalizador de anúncios nos títulos e na descrição dos anúncios responsivos de pesquisa, crie um objeto AdTextAsset com text, incluindo a seguinte sintaxe:

{CUSTOMIZER.CUSTOMIZER_ATTRIBUTE_NAME:DEFAULT_VALUE}

  • CUSTOMIZER_ATTRIBUTE_NAME é o name do atributo de personalização que você definiu ao criar, não o nome do recurso do atributo de personalização 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 a configuração dos 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 de personalizador definido no nível da campanha e do grupo de anúncios, os anúncios no grupo vinculado vão usar o do grupo, mas os anúncios de outros grupos na mesma 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 de 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 valores válidos.
    • Não pode haver espaços entre o número e os códigos ou símbolos da moeda. Por exemplo, $ 100 é inválido.
    • Consulte 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 nas descrições dos seus anúncios responsivos de pesquisa (RSA). Com elas, é possível 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 acionou a veiculação dele. 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 não for possível inserir a palavra-chave, o "Texto padrão" ("Chocolate", neste caso) será usado.

Consulte Sobre a inserção de palavra-chave.

Inserção de local

Adapte o texto do anúncio com base na localização dos 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: "Entrega de pizza em {LOCATION(City):Your Area}"

Se um usuário estiver em Nova York, ele poderá ver: "Entrega de pizza em Nova York" Usuários fora de uma área específica vão ver: "Entrega de pizza na sua região"

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 uma promoção específica.

Sintaxe

  • {COUNTDOWN(yyyy-MM-dd HH:mm:ss,daysBefore)}: faz uma contagem regressiva até um horário específico no fuso horário da conta do anunciante.
  • {GLOBAL_COUNTDOWN(yyyy-MM-dd HH:mm:ss,daysBefore)}: faz uma contagem regressiva até 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 26 de janeiro de 2026, às 23h59min59s, 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 da RSA ao fazer mutações em 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"]
  }
}
Anterior
Mudar anúncios
Avançar
Recuperar anúncios