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

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

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

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

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

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

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

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

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

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

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

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

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