قواعد قيمة الإحالة الناجحة

تتيح لك قواعد قيم الإحالات الناجحة تحديد الإجراءات التي ستعدِّل قيمة الإحالة الناجحة استنادًا إلى فئة ConversionAction والسمات التالية لمرة الظهور:

• عضوية الجمهور
• الموقع الفعلي أو الموقع الجغرافي موضع الاهتمام
• الجهاز

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

إنشاء القواعد

تتمثّل الخطوة الأولى لاستخدام قواعد قيم الإحالات الناجحة في إنشاء رمز ConversionValueRule واحد على الأقل، والذي يتكوّن مما يلي:

• الشروط التي تحدِّد وقت تطبيق القاعدة
• الإجراء الذي سيتم اتخاذه عند تطبيق القاعدة

شروط القاعدة

حدِّد شروط ConversionValueRule باستخدام الحقول التالية:

audience_condition

يطبِّق القاعدة على مرات الظهور المرتبطة بشريحة جمهور واحدة أو أكثر. حدِّد أسماء الموارد لكل قائمة مستخدمين أو اهتمام مستخدم باستخدام الحقلين user_lists أو user_interests. لاسترداد أسماء الموارد لقوائم المستخدمين المتاحة أو اهتمامات المستخدمين، يمكنك إصدار طلب searchStream أو search بالسمة GoogleAdsService حيث تكون عبارة FROM في طلب البحث user_list أو user_interest، على التوالي.

إذا كانت السمة audience_condition تتضمّن عدّة قوائم أو اهتمامات للمستخدمين، ستتطابق مرة الظهور مع القاعدة إذا كانت مرة الظهور مرتبطة بأي من قوائم المستخدمين أو اهتمامات المستخدمين.

device_condition

يتيح لك هذا الخيار تطبيق القاعدة إذا كان الجهاز المرتبط بمرّة الظهور يتطابق مع أي من علامات device_types المحدّدة. يُسمح فقط بأنواع الأجهزة في ValueRuleDeviceType.

geo_location_condition

يطبِّق هذا الخيار القاعدة على مرات الظهور التي تتطابق فيها معلومات الموقع الجغرافي مع أي من geo_target_constants المحدّدة للسمة geo_match_type، ولا تتطابق مع أي من excluded_geo_target_constants للسمةexcluded_geo_match_type. راجِع دليل الموقع الجغرافي المستهدف لمعرفة كيفية استرداد أسماء موارد المواقع الجغرافية.

يمكنك تحديد اثنين من audience_condition أو device_condition أو geo_location_condition كحد أقصى في كل ConversionValueRule.

قاعدة لا تتضمن أي شروط وتنطبق على مرات الظهور التي لا تفي بشروط قاعدة أكثر تحديدًا في مجموعة القواعد نفسها.

إجراء القاعدة

يجب أن تتضمّن القاعدة action واحدًا يتكوّن من operation وvalue. يحدد الإجراء كيفية تعديل قيمة الإحالة الناجحة لإحالة ناجحة تلبّي شروط القاعدة. في ما يلي العمليات المتاحة.

ADD

إضافة value إلى القيمة الأصلية للإحالة الناجحة يجب أن تكون قيمة value أكبر من 0.

MULTIPLY

ضرب القيمة الأصلية للإحالة الناجحة في قيمة value المحدّدة. يجب أن تكون قيمة value أكبر من أو تساوي 0.5 وأقل من أو تساوي 10.

SET

لضبط قيمة الإحالة الناجحة على value المحدّدة. يجب أن تكون قيمة value أكبر من 0.

لا يمكنك استخدام قاعدة مع الإجراء SET إلا في مجموعة قواعد تستوفي الشروط الموضّحة في إنشاء مجموعة قواعد أدناه.

السمات الأخرى للقواعد

بالإضافة إلى الشروط والإجراء، سمة ConversionValueRule لها السمات التالية.

owner_customer

اسم مورد Customer الذي يمتلك القاعدة. ويمكنك استخدامها لتحديد ما إذا تم تحديد قاعدة ضمن الحساب أو أحد حساباته الإدارية.

status

حالة القاعدة. يمكنك إيقاف قاعدة مؤقتًا من خلال ضبط هذا الحقل على PAUSED، وتفعيل قاعدة متوقّفة مؤقّتًا من خلال ضبط هذا الحقل على ENABLED.

إنشاء مجموعة قواعد

وبعد توفُّر ConversionValueRule واحد على الأقل، يمكنك إنشاء ConversionValueRuleSet، والتي تتألف مما يلي:

conversion_action_categories

قائمة بفئات إجراءات الإحالات الناجحة التي تنطبق عليها مجموعة القواعد هذه. وإذا كانت القائمة فارغة، ستنطبق مجموعة القواعد على جميع الفئات. إذا لم تكن القائمة فارغة، يجب أن تحتوي على إدخال واحد إما STORE_VISIT أو STORE_SALE.

يمكنك فقط إعداد قائمة فئات إجراءات الإحالة الناجحة عند إنشاء مجموعة القواعد.

conversion_value_rules

أسماء موارد القواعد المراد تضمينها في المجموعة.

لا يمكن أن تحتوي هذه القائمة على قاعدة تستخدم إجراء SET إلا في حال استيفاء أي من هذين الشرطين:

• حسابك مُدرَج في القائمة المسموح بها، والسمة conversion_action_categories لمجموعة القواعد فارغة.
• تتضمّن conversion_action_categories للمجموعة إدخالاً واحدًا فقط للسمة STORE_VISIT أو STORE_SALE، بينما تتضمّن dimensions للمجموعة على إدخال NO_CONDITION فقط، ولا تتضمّن أي من حقول الشروط للقاعدة.

ملاحظة مهمة: يمكنك فقط تضمين كل قاعدة قيمة إحالة ناجحة في مجموعة قواعد قيمة إحالة ناجحة واحدة فقط. إذا كانت conversion_value_rules تحتوي على اسم المورد لقاعدة موجودة في conversion_value_rules من قاعدة أخرى تم إعدادها باستخدام status من ENABLED أو PAUSED، سيتعذّر إتمام العملية مع ظهور خطأ DATA_CONSTRAINT_VIOLATION.

dimensions

قائمة بقيم التعداد ValueRuleSetDimension التي تشير إلى الشروط التي يمكن أن تستخدمها القواعد في المجموعة. على سبيل المثال، إذا كانت السمة dimensions تحتوي على GEO_LOCATION وDEVICE، يمكنك إضافة القواعد التي تتضمّن geo_location_condition أو device_condition إلى المجموعة، ولكن لا يمكنك إضافة قاعدة باستخدام audience_condition.

لا يمكن أن تكون هذه القائمة فارغة، ويمكن أن تحتوي على إدخالين كحد أقصى.

إذا كانت هذه القائمة تحتوي على إدخال لـ NO_CONDITION، فحينئذٍ:

• يجب أن يكون NO_CONDITION هو الإدخال الوحيد في القائمة.
• يجب أن تتضمن قائمة conversion_action_categories بالمجموعات فقط على إدخال واحد من STORE_VISIT أو STORE_SALE.
• لا يمكن أن تحتوي قائمة conversion_value_rules على أي قاعدة يتم فيها ضبط audience_condition أو device_condition أو geo_location_condition.

يُحدِّد الإدخال الأول في هذه القائمة القيمة التي تظهر لـ segments.conversion_value_rule_primary_dimension في التقارير.

attachment_type

اضبط هذه القيمة على CUSTOMER لإنشاء مجموعة قواعد تنطبق على الحساب بالكامل، أو CAMPAIGN لإنشاء مجموعة قواعد لحملة معيّنة.

campaign

إذا كانت قيمة attachment_type لمجموعة القواعد هي CAMPAIGN، اضبط ذلك على اسم المورد الذي تنطبق عليه مجموعة القواعد.

على غرار القواعد، تحتوي مجموعة القواعد أيضًا على owner_customer وstatus. في المقابل، تكون قيمة status لمجموعة القواعد للقراءة فقط ويتم اشتقاقها من قواعدها على النحو التالي:

• إذا كانت كل قاعدة مُشار إليها من خلال conversion_value_rules تحتوي على status PAUSED، ستكون مجموعة قواعد قيمة الإحالة الناجحة status هي PAUSED.
• وبخلاف ذلك، ستكون مجموعة قواعد قيمة الإحالة الناجحة status هي ENABLED.

إزالة القواعد ومجموعات القواعد

• يجب أن تكون لميزة ConversionValueRuleSet قاعدة واحدة على الأقل لقيمة الإحالة الناجحة وهي PAUSED أو ENABLED.

• لن تنجح إزالة ConversionValueRule المُشار إليها في conversion_value_rules من PAUSED أو ENABLED ConversionValueRuleSet.

• لا تؤدي إزالة ConversionValueRuleSet إلى تغيير status لكل ConversionValueRule مُشار إليه في المجموعة.

• بعد إزالة ConversionValueRuleSet، لن تعرض الطلبات search وsearchStream للمورد conversion_value_rule_set المجموعة التي تمت إزالتها.

أولوية القواعد ومجموعات القواعد

تستخدم "إعلانات Google" المنطق التالي لاختيار قاعدة واحدة على الأكثر وتطبيقها على كل إحالة ناجحة:

1. تحديد attachment_type لمجموعات القواعد التي يجب أخذها في الاعتبار في حال ضبط أي مجموعات قواعد مع attachment_type = CAMPAIGN وcampaign على الحملة المرتبطة بمرة الظهور، يجب عندها استخدام مجموعات القواعد على مستوى الحملة فقط. وبخلاف ذلك، يمكنك استخدام مجموعات القواعد على مستوى العميل فقط.

2. من بين مجموعات القواعد التي يجب أخذها في الاعتبار، اختَر مجموعة القواعد التي لا تكون فيها conversion_action_categories فارغة وتحتوي على فئة إجراء الإحالة الناجحة، في حال توفّر مجموعة قواعد مثل هذه. في الحالات الأخرى، يُرجى اختيار مجموعة القواعد التي تكون فيها السمة conversion_action_categories فارغة.

3. قيِّم القواعد في مجموعة القواعد المختارة بالترتيب الذي تظهر به في conversion_value_rules، واختَر القاعدة الأولى بشروط تتطابق مع مرّة الظهور.

إعداد التقارير

يعكس الحقلان metrics.conversions_value وmetrics.all_conversions_value، بالإضافة إلى الحقول المستمدة من هذين المقياسَين، التعديلات التي أجرتها مجموعات قواعد قيمة الإحالة الناجحة. بالإضافة إلى ذلك، يمكنك تضمين "segments.conversion_value_rule_primary_dimension" في استعلامك للحصول على مزيد من المعلومات حول كيفية تطبيق القواعد. القيم المحتملة لهذه الشريحة هي كما يلي:

NO_RULE_APPLIED

قيم الإحالات الناجحة التي لم يتم تطبيق أي قاعدة فيها

ORIGINAL

القيمة الأصلية للإحالات الناجحة التي تم فيها تطبيق قاعدة.

GEO_LOCATION أو DEVICE أو AUDIENCE أو NO_CONDITION

قيمة الإحالات الناجحة بعد تطبيق قاعدة، مجمّعة حسب الإدخال الأول في مجموعة dimensions الخاصة بمجموعة القواعد.