이 단계를 완료하면 맞춤설정 도구 속성을 연결한 리소스 계층 구조에 포함된 반응형 검색 광고에서 광고 맞춤설정 도구를 사용할 수 있습니다. 예를 들어 맞춤설정 도구 속성을 ID가 A인 캠페인에 연결하면 캠페인 A 내의 모든 광고 그룹에서 생성된 광고에 해당 광고 맞춤설정 도구를 사용할 수 있습니다. 캠페인 B 내 광고 그룹의 광고에서는 광고 맞춤설정 도구를 사용할 수 없습니다.
반응형 검색 광고의 광고 맞춤설정 도구
반응형 검색 광고의 광고 제목과 내용 입력란에서 광고 맞춤설정을 사용하려면 다음 구문이 포함된 text로 AdTextAsset 객체를 만들어야 합니다.
수준(고객, 캠페인, 광고 그룹 또는 광고 그룹 기준)당 하나의 링크만 있을 수 있으며 가장 구체적인 링크가 더 일반적인 링크를 재정의합니다. 예를 들어 캠페인 수준과 광고 그룹 수준에서 이 맞춤설정 도구 속성을 정의한 경우 연결된 광고 그룹 내 광고는 광고 그룹 속성을 사용하지만 해당 캠페인의 다른 광고 그룹의 광고는 캠페인 속성을 사용합니다.
계정에서 사용 설정된 CustomizerAttribute 객체는 최대 40개까지 사용할 수 있습니다. 이 한도에 도달하면 사용하지 않는 용어집을 삭제한 후 새 용어집을 만들어야 합니다.
[null,null,["최종 업데이트: 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)."]]
