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

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

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

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

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

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

   ملاحظة: يمكنك الاطّلاع على ConversionCustomVariable لمعرفة القيود المفروضة على حقوله.

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

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

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

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

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

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