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

تتيح لك متغيّرات الإحالات الناجحة المخصّصة ربط معلومات إضافية، في شكل علامات، بإحالة ناجحة تستوردها باستخدام 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.