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

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

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

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

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

الخطوة الأولى لاستخدام قواعد قيمة الإحالة الناجحة هي إنشاء ConversionValueRule واحدة على الأقل، وتتألف من:

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

ملاحظة: إلى أن تتم إضافة ConversionValueRule إلى ConversionValueRuleSet، لن تتمكّن من الاطّلاع عليه في واجهة مستخدم "إعلانات Google".

على سبيل المثال، تنشئ حمولة JSON التالية لـ ConversionValueRuleService.MutateConversionValueRules قاعدة تضاعف قيم الإحالات الناجحة بمقدار 1.5 لمرات الظهور على الأجهزة الجوّالة:

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

شروط القاعدة

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

itinerary_condition

يتم تطبيق القاعدة على مرّات الظهور التي تتضمّن فيها عبارات البحث معلومات خاصة ببرنامج الرحلة، مثل فترة الحجز أو مدة الرحلة أو يوم بدء الرحلة. يمكنك مراجعة ValueRuleItineraryCondition لمزيد من التفاصيل حول الشروط المتاحة.

ملاحظة مهمة: لا تتوفّر قواعد قيمة الإحالات الناجحة حسب برنامج الرحلة إلا للحسابات المُضافة إلى القائمة المسموح بها. وإذا كنتم بحاجة إلى الوصول إليها، يُرجى التواصل مع ممثّل Google الذي تتعاملون معه.

يمكنك تحديد اثنتين على الأكثر من السمات audience_condition أو device_condition أو geo_location_condition أو itinerary_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.

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

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

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

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

attachment_type

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

campaign

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

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

• إذا كانت status لكل قاعدة PAUSED في conversion_value_rules، ستكون status لمجموعة قواعد قيمة الإحالة الناجحة PAUSED.
• في حال عدم توفّرها، سيتم ENABLED مجموعة قواعد قيمة الإحالة الناجحة "status".

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

• يجب أن يتضمّن ConversionValueRuleSet قاعدة واحدة على الأقل لقيمة الإحالة الناجحة، إما PAUSED أو ENABLED.

• ستتعذّر إزالة ConversionValueRule تمت الإشارة إليه في conversion_value_rules لـ PAUSED أو ENABLED ConversionValueRuleSet.

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

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

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

تستخدم "إعلانات Google" المنطق التالي لاختيار قاعدة واحدة كحدّ أقصى وتطبيقها على كلّ إحالة ناجحة. يمكنك الاطّلاع على مزيد من المعلومات عن هذه القواعد في مركز مساعدة "إعلانات Google":

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

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

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

4. في حال تطابُق عدة شروط للموقع الجغرافي، يتم تطبيق الموقع الجغرافي الأكثر دقة. على سبيل المثال، إذا كان ظهور الإعلان يتطابق مع شرطَي الولايات المتحدة وكاليفورنيا، سيتم تطبيق شرط كاليفورنيا لأنّه موقع جغرافي أكثر دقة.

5. بالنسبة إلى شروط الجمهور المتطابقة المتعدّدة، سيتم تطبيق التسلسل الهرمي الحالي لتحديد مصدر الجمهور. إذا كان هناك تعادل بين قاعدتَين في مجموعة، سيتم اختيار قاعدة "ضرب" بدلاً من قاعدة "إضافة". وإذا كان لا يزال هناك ربط (أي أكثر من قاعدة "ضرب" واحدة)، سيتم اختيار القاعدة التي لها أعلى تعديل ضرب.

6. لا يمكن أن تكون هناك شروط متعددة للأجهزة المطابقة، لأنّ فئات الأجهزة تستبعد بعضها البعض.

7. بالنسبة إلى شروط برامج الرحلات، يتم تطبيق قاعدة برنامج الرحلة الأكثر تحديدًا. وهذا يعني أنّه في حال تطابقت قواعد متعدّدة مع إحالة ناجحة معيّنة، تكون القاعدة المستخدَمة هي تلك التي تتضمّن أكبر عدد من خيارات برامج الرحلات المحدّدة، مثل "فترة الحجز المسبق" أو "مدة السفر".

المقاييس

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

NO_RULE_APPLIED

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

ORIGINAL

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

GEO_LOCATION أو DEVICE أو AUDIENCE أو NO_CONDITION

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