مواصفات التنفيذ

تحدد execution_spec للقاعدة الإجراء الذي ينطبق على جميع الكائنات التي تجتاز التقييم يدعم الجدول والقواعد القائمة على التشغيل إجراءات مختلفة. يتم إدراج الإجراءات ضمن execution_type.

نوع التنفيذ	الوصف
`NOTIFICATION`	يتم إرسال إشعار يتضمن عناصر jewel إلى منشئ القاعدة هذا أو قائمة المستخدمين المحددة في `user_ids`، إذا كان هذا الخيار متوفرًا. أنواع التقييم المدعومة:`SCHEDULE` و`TRIGGER`
`PAUSE`	تعمل على إيقاف الكائنات مؤقتًا. أنواع التقييم المدعومة:`SCHEDULE` و`TRIGGER`
`UNPAUSE`	تعمل على إلغاء إيقاف الكائنات مؤقتًا. أنواع التقييم المدعومة:`SCHEDULE` و`TRIGGER`
`CHANGE_BUDGET`	يتم تغيير الميزانيات استنادًا إلى `change_spec` محدد. ينطبق ذلك على المجموعات الإعلانية فقط. أنواع التقييم المدعومة:`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	يتم تغيير الميزانيات استنادًا إلى `change_spec` محدد. ينطبق ذلك على الحملات الإعلانية فقط. أنواع التقييم المدعومة:`SCHEDULE`
`CHANGE_BID`	يتم تغيير عروض الأسعار استنادًا إلى `change_spec` محدد. ينطبق ذلك على المجموعات الإعلانية فقط. أنواع التقييمات المدعومة:`SCHEDULE`
`ROTATE`	يتم إيقاف الإعلان النشط حاليًا مؤقتًا، وتنشيط الإعلان التالي حسب المعرف في المجموعة الإعلانية. يتطلب فلتر `id` للمجموعات الإعلانية، وفلتر `entity_type` لإعلان. أنواع التقييمات المدعومة:`SCHEDULE`
`REBALANCE_BUDGET`	يتم إيقاف الكائنات التي تطابق معايير التقييم مؤقتًا وإعادة ضبط الميزانيات نحو ما تبقى استنادًا إلى `rebalance_spec` محدد. ينطبق ذلك على المجموعات الإعلانية فقط. أنواع التقييمات المدعومة:`SCHEDULE`
`PING_ENDPOINT`	يتم إرسال إشارة ping إلى اشتراك التطبيق عبر أحداث Webhooks. راجع القواعد القائمة على التشغيل لمزيد من التفاصيل حول الإعداد. أنواع التقييمات المدعومة:`TRIGGER`

`execution_options`

قد تحتاج إلى توفير معلومات إضافية لتنفيذ بعض من هذه الإجراءات. يوفر execution_spec مصفوفة execution_options اختيارية لتحديد هذه المعلمات الإضافية. تحتوي المصفوفة على قائمة بكائنات execution_option، وهي قواميس تتضمن مفاتيح field وvalue وoperator تمامًا مثل كائنات filter لمواصفات التقييم.

لا تتطلب القواعد القائمة على التشغيل أي خيارات تنفيذ.

راجع أدناه خيارات التنفيذ المدعومة وقيم execution_type التي تدعمها وكيفية هيكلتها. المشغل المدعوم الوحيد حاليًا لكل الخيارات هو EQUAL.

حقل خيار التنفيذ	الوصف
`user_ids`*	مستلمي الإشعارات التي تتضمن عناصر jewel لـ `NOTIFICATION` أو مستلمي رسائل البريد الإلكتروني الملخصة للقواعد القائمة على الجدول لكل `execution_type`. أنواع التنفيذ المدعومة: كل `execution_type` مدعومة بواسطة القواعد القائمة على الجدول القيمة (مثال):`array ([123, 456])`
`change_spec`	تحدد `amount` و`limit` و`unit` و`target_field`. مطلوبة كقاموس لكل الأنواع المدعومة. في حالة وجود `target_field`، يعتمد مقياس عرض الأسعار أو الميزانية على الفرق بين القيمة الحالية للحقل المستهدف والقيمة المستهدفة المحددة في `amount`. يجب أن يكون `target_field` فلتر رؤى صالح. أنواع التنفيذ المدعومة:`CHANGE_BUDGET` و`CHANGE_BID` القيمة (مثال):أمثلة على مواصفات تغيير قواعد الإعلان
`rebalance_spec`	يدعم خيارات مختلفة تحدد كيفية إعادة ضبط الميزانيات. راجع المثال لمزيد من التفاصيل. أنواع التنفيذ المدعومة:`REBALANCE_BUDGET` القيمة (مثال):إعادة ضبط ميزانية قواعد الإعلانات
`execution_count_limit`	يحدد الحد الأقصى لعدد مرات اتخاذ إجراء تغيير الميزانية/عرض الأسعار لكل كائن إعلاني فردي في القاعدة. إذا لم يتم التحديد، فسيتم إعداده افتراضيًا بدون تقييد. أنواع التنفيذ المدعومة:`CHANGE_BUDGET` و`CHANGE_BID` القيمة (مثال): int (123)
`action_frequency`	يحدد الحد الأدنى من الدقائق حتى يمكن اتخاذ الإجراء ذاته في كائن من بواسطة القاعدة. على سبيل المثال، إذا كانت القيمة `10080` لقاعدة `CHANGE_BUDGET`، وتمت زيادة الميزانية بواسطة تلك القاعدة للكائن أ. فإن هذه القاعدة لا تزيد ميزانية الكائن أ لمدة أسبوع على الأقل، حتى إذا اجتاز الكائن أ تقييم القاعدة أثناء ذلك الأسبوع. أنواع التنفيذ المدعومة:`CHANGE_BUDGET` و`CHANGE_BID` القيمة (مثال): int (123)

`user_ids`

إذا تم توفير user_idsللقواعد القائمة على الجدول:

فسننشئ رسالة بريد إلكتروني يومية لتلخيص الإجراءات التي نفذتها القاعدة خلال أخر 24 ساعة
فسنرسل المعلومات إلى قائمة المستخدمين المحددة ضمن user_ids
فسيتم إرسال رسالة البريد الإلكتروني في الساعة 12:30 صباحًا، باستخدام المنطقة الزمنية للحساب الإعلاني

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