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

تتيح لك قواعد قيم الإحالات الناجحة تحديد الإجراءات التي ستُعدِّل قيمة الإحالة الناجحة استنادًا إلى فئة 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 فقط، ولا يتم ضبط أي من حقول الشروط للقاعدة.
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 لمجموعة القواعد.