Personalização de anúncios responsivos de pesquisa
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os personalizadores de anúncios são uma ferramenta muito eficiente que permite personalizar o conteúdo de texto dos seus anúncios responsivos de pesquisa usando marcadores de posição de texto dinâmico.
Personalizador de anúncios
Há duas 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 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.
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 reutilizá-los em diferentes recursos. Por isso, escolha um nome que represente uma categoria ampla de personalizações.
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 em títulos e descrição dos anúncios responsivos de pesquisa, crie um objeto AdTextAsset com text, incluindo a seguinte sintaxe:
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.
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 personalização definido no nível da campanha e do grupo de anúncios, os anúncios no grupo vinculado vão usar o atributo do grupo, mas os anúncios de outros grupos na mesma campanha vão usar o atributo 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.
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003eAd customizers allow dynamic text customization in responsive search ads using placeholders within ad titles and descriptions.\u003c/p\u003e\n"],["\u003cp\u003eCreating an ad customizer involves defining a customizer attribute (category) and linking it to a specific Google Ads resource (customer, campaign, ad group, or keyword ad group criterion) with desired values.\u003c/p\u003e\n"],["\u003cp\u003eAd customizers are implemented in responsive search ads by using a specific syntax within AdTextAsset objects to reference the customizer attribute and provide a default value.\u003c/p\u003e\n"],["\u003cp\u003eThere are limitations on the number of customizer attributes and how they are applied, with more specific links overriding broader ones.\u003c/p\u003e\n"]]],[],null,["# Responsive Search Ad Customization\n\nAd customizers are a very powerful tool that lets you customize the text content\nof your [responsive search ads](//support.google.com/google-ads/answer/7684791)\nusing dynamic text placeholders.\n| **Key Point:** Dynamic replacements can occur in ad titles and description lines, but not in display or final URLs.\n\nAd customizer\n-------------\n\nThere are two steps for creating an ad customizer for responsive search ads:\n\n1. **Create the customizer attribute.**\n\n The customizer attribute is a broad category that describes the kind of\n change you intend to link to this customizer---for example, \"product\n price\" or \"discount percent\".\n2. **Link the customizer attribute with a customer, campaign, ad group, or\n keyword ad group criterion.**\n\n Set the specific values you want to use for the specific resource.\n\n### Create a customizer attribute\n\nFirst, you need to create a new customizer attribute, represented by\n[`CustomizerAttribute`](/google-ads/api/reference/rpc/v21/CustomizerAttribute) using\n[`CustomizerAttributeService`](/google-ads/api/reference/rpc/v21/CustomizerAttributeService) with\ntwo required fields:\n\n[`name`](/google-ads/api/reference/rpc/v21/CustomizerAttribute#name)\n: The name of the customizer, which must be unique (case insensitive). Since\n there is a limit of 40 customizers, you might need to reuse customizers\n across different resources, so be sure to choose a name that represents a\n broad category of what kind of customizations this will be used for.\n\n[`type`](/google-ads/api/reference/rpc/v21/CustomizerAttribute#type)\n: The type of the customizer---text, number, price or percent---defined\n by\n [`CustomizerAttributeType`](/google-ads/api/reference/rpc/v21/CustomizerAttributeTypeEnum.CustomizerAttributeType).\n\nWhen you create a new customizer attribute, you get its resource name back,\nwhich is required in the next step.\n\n### Link the customizer attribute\n\nYou can link the previously created customizer attribute at many levels using\nthe following services:\n\n- [`CustomerCustomizerService`](/google-ads/api/reference/rpc/v21/CustomerCustomizerService) to\n create [`CustomerCustomizer`](/google-ads/api/reference/rpc/v21/CustomerCustomizer) for the\n customer level.\n\n- [`CampaignCustomizerService`](/google-ads/api/reference/rpc/v21/CampaignCustomizerService) to\n create [`CampaignCustomizer`](/google-ads/api/reference/rpc/v21/CampaignCustomizer) for the\n campaign level.\n\n- [`AdGroupCustomizerService`](/google-ads/api/reference/rpc/v21/AdGroupCustomizerService) to\n create [`AdGroupCustomizer`](/google-ads/api/reference/rpc/v21/AdGroupCustomizer) for the ad\n group level.\n\n- [`AdGroupCriterionCustomizerService`](/google-ads/api/reference/rpc/v21/AdGroupCriterionCustomizerService)\n to create\n [`AdGroupCriterionCustomizer`](/google-ads/api/reference/rpc/v21/AdGroupCriterionCustomizer) for\n the ad group criterion level. For this type, only keyword criteria are\n supported.\n\nRegardless of which level you want and which corresponding service you use, the\nsame pieces of information are required:\n\n`customizer_attribute`\n: The resource name of the customizer attribute that you created in the\n previous step.\n\n`value`\n\n: The value that you want to insert into your ads when you reference this\n customizer attribute. This field is defined by\n [`CustomizerValue`](/google-ads/api/reference/rpc/v21/CustomizerValue).\n\n You need to specify [`type`](/google-ads/api/reference/rpc/v21/CustomizerValue#type) and\n [`string_value`](/google-ads/api/reference/rpc/v21/CustomizerValue#string_value) to create\n `CustomizerValue`. The `type` value should be the same as the customizer\n attribute you're linking, and `string_value` is the value that you want the\n Google Ads API to use.\n\nResource name of the resource you want to link the customizer attribute to\n\n: The name varies based on the resource type. For instance, to create\n [`CampaignCustomizer`](/google-ads/api/reference/rpc/v21/CampaignCustomizer), specify the\n [`campaign`](/google-ads/api/reference/rpc/v21/CampaignCustomizer#campaign).\n\nOnce you finish this step, you're ready to use the ad customizer in responsive\nsearch ads that are included in the resource hierarchy you linked the\ncustomizer attribute to. For instance, if you link the customizer attribute to\nthe campaign with an ID `A`, you can use that ad customizer in an ad created\nunder any ad groups inside campaign `A`. You cannot use the ad customizer in an\nad under ad groups inside campaign `B`.\n\nAd customizers in responsive search ads\n---------------------------------------\n\nTo use the ad customizer in **headlines** and **description** of the responsive\nsearch ads, you need to create an [`AdTextAsset`](/google-ads/api/reference/rpc/v21/AdTextAsset)\nobject with `text` including the following syntax: \n\n```\n{CUSTOMIZER.CUSTOMIZER_ATTRIBUTE_NAME:DEFAULT_VALUE}\n```\n\n- `CUSTOMIZER_ATTRIBUTE_NAME` is the `name` of the customizer attribute that\n you set when you [created it](#create), **not the resource name of the\n customizer attribute nor its ID**.\n\n- `DEFAULT_VALUE` is the default value for the ad customizer.\n\nRefer to the [responsive search ads\nguide](/google-ads/api/docs/responsive-search-ads/overview) for more information about\nsetting up the ads.\n\nRules and limitations\n---------------------\n\n| **Note:** For general information about limits, see [About your Google Ads account limits](//support.google.com/google-ads/answer/6372658).\n\n- There can only be one link per level---customer, campaign, ad group, or ad\n group criterion---and the most specific one will override the more general\n one. For example, if you have this customizer attribute defined at the\n campaign level and the ad group level, then ads within the linked ad group\n will use the ad group one, but ads from other ad groups in that campaign will\n use the campaign one.\n\n- You can have up to **40** enabled `CustomizerAttribute` objects in your\n account. If you reach this limit, you need to remove the unused ones before\n creating a new one.\n\n- There are rules for customizer attributes with type\n [`PRICE`](/google-ads/api/reference/rpc/v21/CustomizerAttributeTypeEnum.CustomizerAttributeType#price):\n\n - Currency codes and symbols can appear before or after the number. For example, `$100`, `100$`, `USD100`, `100USD` are all valid values.\n - There should be no spaces between the number and the currency codes or symbols. For example, `$ 100` is invalid.\n - See the [currency codes and\n symbols](/google-ads/api/data/codes-formats#currency_codes) that can be used as part of the [specified\n value](/google-ads/api/reference/rpc/v21/CustomizerValue#string_value)."]]