完成此步骤后,您就可以在自适应搜索广告中使用广告定制工具了,这些广告包含在您将定制工具属性关联到的资源层次结构中。例如,如果您将定制参数属性与 ID 为 A 的广告系列相关联,则可以在广告系列 A 内的任何广告组下创建的广告中使用该广告定制参数。您无法在广告系列 B 内的广告组中的广告中使用广告定制参数。
自适应搜索广告中的广告定制工具
如需在自适应搜索广告的标题和广告内容描述中使用广告定制器,您需要创建一个包含 text 的 AdTextAsset 对象,语法如下:
[null,null,["最后更新时间 (UTC):2025-08-27。"],[[["\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)."]]