متغيرات الإحالات الناجحة المخصّصة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك متغيّرات الإحالات الناجحة المخصّصة ربط معلومات إضافية، في شكل علامات، بإحالة ناجحة تستوردها باستخدام Google Ads API، مثل الإحالات الناجحة الناتجة عن النقرات أو المكالمات. باستخدام هذه المعلومات، يمكنك إنشاء تقارير مقسّمة تقدّم بيانات أكثر تفصيلاً عن إحالاتك الناجحة.
على سبيل المثال، عند استيراد إحالة ناجحة لشراء قبعة زرقاء جديدة، يمكنك أيضًا استيراد علامتَين مرتبطتَين: color وstatus مع القيمتَين blue وnew على التوالي. إليك الخطوات التي يمكنك اتّباعها:
يمكنك إنشاء أيّ عدد تريده من متغيّرات الإحالات الناجحة المخصّصة. يتوافق كل متغير مع علامة واحدة. لذلك، إذا كنت تريد علامتَين (color وstatus)، عليك إنشاء متغيّرَين مخصّصَين. في ما يلي الحقول المطلوبة لـ
ConversionCustomVariable:
-
name: يحدّد المتغيّر. يجب أن يكون الاسم فريدًا.
tag: في مثالنا،
العلامتان هما color وstatus. تُستخدَم العلامات في مقتطف الحدث عند إرسال إحالة ناجحة إلى "إعلانات Google" من خلال موقعك الإلكتروني. إذا كنت تستخدم Google Ads API، عليك تحديد اسم مصدر المتغيّرات المخصّصة عند استيراد الإحالات الناجحة، كما هو موضّح بالتفصيل في الخطوة التالية.
عند استيراد إحالة ناجحة، مثل
ClickConversion، اضبط
custom_variables على
قائمة جميع المتغيرات المخصّصة التي أنشأتها في الخطوة السابقة. عليك ضبط جميع حقول كل متغيّر مخصّص:
- استبدِل
conversion_custom_variable باسم المورد للمتغيّر المخصّص الذي أنشأته في الخطوة السابقة.
- استبدِل
value بالقيمة الخاصة بالعلامة التي تريد ربطها بالإحالة الناجحة. في مثالنا، هما blue وnew.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCustom conversion variables allow associating additional information, like tags, to conversions uploaded via the Google Ads API.\u003c/p\u003e\n"],["\u003cp\u003eTo use custom variables, first create them, defining a unique name and tag for each desired piece of information.\u003c/p\u003e\n"],["\u003cp\u003eWhen uploading a conversion, include the custom variables, specifying their resource name and the corresponding value for the tag.\u003c/p\u003e\n"],["\u003cp\u003eThis process lets you add details like 'color' or 'status' to conversions, enabling richer data analysis and reporting.\u003c/p\u003e\n"]]],[],null,["# Custom Conversion Variables\n\n[Custom conversion variables](//support.google.com/google-ads/answer/9964350)\nlet you associate additional information, in the form of tags, to a conversion\nthat you import using the Google Ads API, such as click or call conversions. With this\ninformation, you can create segmented reports that provide richer data about\nyour conversions.\n\nFor example, when importing a conversion for the purchase of a new blue hat,\nyou could also import two associated tags: `color` and `status` with the values\n`blue` and `new`, respectively. Here are the steps:\n\n1. Create as many custom conversion variables as you need. Each variable\n corresponds to one tag. Therefore, if you want two tags (`color` and\n `status`), you need to create two custom variables. The required fields for\n [`ConversionCustomVariable`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable) are as\n follows:\n\n | **Note:** See [`ConversionCustomVariable`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable) for limitations on its fields.\n - [`name`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable#name): Identifies the variable. The name must be unique.\n - [`tag`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable#tag): For our example, the tags are `color` and `status`. Tags are used in the [event\n snippet](//support.google.com/google-ads/answer/9962082#Add&zippy=%2Cconversion-tracking-using-tags-on-your-website) when a conversion is sent to Google Ads by your website. If you use the Google Ads API, you would need to specify the resource name of the custom variables when importing conversions, as detailed in the next step.\n2. When importing a conversion, such as\n [`ClickConversion`](/google-ads/api/reference/rpc/v21/ClickConversion), set\n [`custom_variables`](/google-ads/api/reference/rpc/v21/ClickConversion#custom_variables%5B%5D) to\n the list of all custom variables you created in the previous step. You need\n to set all the fields of each custom variable:\n\n - [`conversion_custom_variable`](/google-ads/api/reference/rpc/v21/CustomVariable#conversion_custom_variable): The resource name of the custom variable you created in the previous step.\n - [`value`](/google-ads/api/reference/rpc/v21/CustomVariable#conversion_custom_variable): The value for the tag you want to associate with the conversion. For our example: `blue` and `new`."]]
