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

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

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

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

إنشاء قواعد

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

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

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

شروط القاعدة

حدِّد شروط 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 لمجموعة القواعد يكون للقراءة فقط ويتم استخراجه من قواعدها على النحو التالي:

• إذا كانت كل قاعدة مشار إليها بواسطة 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، واختيار القاعدة الأولى التي تتضمّن شروطًا تطابق مرّة الظهور

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 لقواعد الإحالات الناجحة.