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

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

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

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

إنشاء قواعد

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

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

على سبيل المثال، يؤدي حمولة 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 لمزيد من التفاصيل حول الشروط المتاحة.

يمكنك تحديد سمتَين على الأكثر من 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، ولم يتم ضبط أي من حقول الشرط للقاعدة.

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 لكل قاعدة مشار إليها في conversion_value_rules هو 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" المنطق التالي لاختيار قاعدة واحدة على الأكثر وتطبيقها على كل إحالة ناجحة. يمكنك الاطّلاع على مزيد من المعلومات عن هذه القواعد في مركز مساعدة "إعلانات 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 لمجموعة القواعد.