اسم أداة التخصيص، ويجب أن يكون فريدًا (غير حساس لحالة الأحرف). بما أنّ عدد أدوات التخصيص محدود بـ 40 أداة، قد تحتاج إلى إعادة استخدام أدوات التخصيص في موارد مختلفة، لذا احرص على اختيار اسم يمثّل فئة واسعة من أنواع التخصيصات التي سيتم استخدامها فيها.
بغض النظر عن المستوى الذي تريده والخدمة المقابلة التي تستخدمها، يجب تقديم المعلومات نفسها:
customizer_attribute
اسم المورد لسمة أداة التخصيص التي أنشأتها في الخطوة السابقة
value
القيمة التي تريد إدراجها في إعلاناتك عند الإشارة إلى سمة أداة التخصيص هذه يتم تحديد هذا الحقل من خلال
CustomizerValue.
يجب تحديد type وstring_value لإنشاء CustomizerValue. يجب أن تكون قيمة type هي نفسها سمة أداة التخصيص التي تربطها، وأن تكون string_value هي القيمة التي تريد أن تستخدمها Google Ads API.
اسم المرجع الخاص بالمرجع الذي تريد ربط سمة أداة التخصيص به
بعد الانتهاء من هذه الخطوة، ستكون جاهزًا لاستخدام أداة تخصيص الإعلانات في "الإعلانات على شبكة البحث المتجاوبة" المضمّنة في التسلسل الهرمي للموارد الذي ربطت به سمة أداة التخصيص. على سبيل المثال، إذا ربطت سمة أداة تخصيص الإعلانات بالحملة التي تحمل المعرّف A، يمكنك استخدام أداة تخصيص الإعلانات هذه في إعلان تم إنشاؤه ضمن أي مجموعات إعلانية داخل الحملة A. لا يمكنك استخدام أداة تخصيص الإعلانات في إعلان ضِمن مجموعات إعلانية داخل الحملة B.
أدوات تخصيص الإعلانات في الإعلانات المتجاوبة على شبكة البحث
لاستخدام أداة تخصيص الإعلانات في العناوين والأوصاف الخاصة بـ "الإعلانات المتجاوبة على شبكة البحث"، عليك إنشاء عنصر AdTextAsset
مع text يتضمّن الصيغة التالية:
يمكن أن يكون هناك رابط واحد فقط لكل مستوى، أي العميل أو الحملة أو المجموعة الإعلانية أو معيار المجموعة الإعلانية، وسيكون الرابط الأكثر تحديدًا هو الذي يحلّ محل الرابط الأكثر عموميةً. على سبيل المثال، إذا كانت سمة أداة التخصيص هذه محدّدة على مستوى الحملة وعلى مستوى المجموعة الإعلانية، ستستخدم الإعلانات ضمن المجموعة الإعلانية المرتبطة السمة على مستوى المجموعة الإعلانية، بينما ستستخدم الإعلانات من مجموعات إعلانية أخرى في تلك الحملة السمة على مستوى الحملة.
يمكنك تفعيل ما يصل إلى 40 عنصر CustomizerAttribute في حسابك. في حال بلوغ هذا الحدّ، عليك إزالة تلك التي لم تعُد تستخدمها قبل إنشاء رمز جديد.
تتوفّر قواعد لسمات أداة التخصيص التي تحمل النوع
PRICE:
يمكن أن تظهر رموز العملات ورموزها قبل الرقم أو بعده. على سبيل المثال، $100 و100$ وUSD100 و100USD كلها قيم صالحة.
يجب ألا تكون هناك مسافات بين الرقم ورموز العملة أو الرموز. على سبيل المثال، $ 100 غير صالح.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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)."]]
