متغيرات الإحالات الناجحة المخصصة

تتيح لك المتغيّرات المخصّصة للإحالات الناجحة ربط معلومات إضافية، في شكل علامات، بإحالة ناجحة تستوردها باستخدام Google Ads API، مثل الإحالات الناجحة للنقرات أو الإحالات الناجحة عبر الاتصال الهاتفي. باستخدام هذه المعلومات، يمكنك إنشاء تقارير مقسَّمة توفّر بيانات أكثر تفصيلاً عن إحالاتك الناجحة.

على سبيل المثال، عند استيراد إحالة ناجحة لشراء قبّعة زرقاء جديدة، يمكنك أيضًا استيراد علامتَين مرتبطتَين: color وstatus بالقيمتَين blue وnew على التوالي. إليك الخطوات التي يمكنك اتّباعها:

1. يمكنك إنشاء أيّ عدد تريده من المتغيّرات المخصّصة للإحالات الناجحة (بحدّ أقصى 50 متغيّرًا مخصّصًا للإحالات الناجحة لكلّ حساب عميل). يتوافق كلّ متغيّر مع علامة واحدة. لذلك، إذا كنت تريد علامتَين (color وstatus)، عليك إنشاء متغيّرَين مخصّصَين. في ما يلي الحقول المطلوبة لـ ConversionCustomVariable:

   • name: يحدّد المتغيّر. يجب أن يكون الاسم فريدًا على مستوى حساب العميل.

   • tag: بالنسبة إلى مثالنا، العلامتان هما color وstatus. يجب أن تكون tag فريدة على مستوى حساب العميل ولا يمكن أن تحتوي على مسافات. تُستخدَم العلامات في مقتطف الحدث عندما يتم إرسال إحالة ناجحة إلى "إعلانات Google" بواسطة موقعك الإلكتروني. إذا كنت تستخدم Google Ads API، عليك تحديد اسم مورد المتغيّرات المخصّصة عند استيراد الإحالات الناجحة، كما هو موضّح بالتفصيل في الخطوة التالية.

   لإدارة المتغيّرات المخصّصة للإحالات الناجحة، مثل إنشائها أو تعديلها، استخدِم ConversionCustomVariableService. على وجه التحديد، لإنشاء متغيّرات مخصّصة جديدة للإحالات الناجحة، استدعِ طريقة MutateConversionCustomVariables ضمن هذه الخدمة. يجب أن يتضمّن طلبك رسالة واحدة أو أكثر من رسائل ConversionCustomVariableOperation.

   لكلّ متغيّر تريد إنشاءه، أدرِج عملية مع ضبط create الحقل على كائن ConversionCustomVariable. كما ذكرنا، الحقلان المطلوبان للإنشاء هما name وtag.

   بعد الإنشاء بنجاح، ستكون هذه المتغيّرات في الحالة ENABLED أو ACTIVATION_NEEDED. استنادًا إلى الإعداد، تحقَّق من الحقل status في الردّ. يمكنك بعد ذلك استخدام أسماء الموارد عند تحميل الإحالات الناجحة.

   يُرجى الرجوع إلى ConversionCustomVariableService للاطّلاع على التفاصيل الكاملة عن جميع العمليات المتاحة.

2. عند استيراد إحالة ناجحة، مثل ClickConversion أو CallConversion، اضبط custom_variables على قائمة بجميع المتغيّرات المخصّصة التي أنشأتها في الخطوة السابقة. عليك ضبط جميع حقول كلّ متغيّر مخصّص:

   • conversion_custom_variable: اسم مورد المتغيّر المخصّص الذي أنشأته في الخطوة السابقة.
   • value: قيمة العلامة التي تريد ربطها بالإحالة الناجحة. بالنسبة إلى مثالنا: blue وnew.