فلاتر مواصفات التقييم

في القواعد المستندة إلى الجدولة، من الممكن استخدام أنواع أكثر تقدمًا من حقول الفلاتر.

حقول الرؤى المسبوقة ببادئة

يمكنك تعيين أنواع محددة من البادئات لفلاتر الرؤى. يشبه هذا البادئات التي تم تعيينها لفلاتر البيانات التعريفية لإجراء فلترة متعددة المستويات.

يمكنك تعيين بادئة على مستوى الكائن في فلتر للاستفادة من الفلترة متعددة المستويات للرؤى. على سبيل المثال، يمكن فلترة قاعدة الإعلانات حسب المجموعة الإعلانية أو أداء الحملة الإعلانية. يمكنك أيضًا تحديد بادئات فترة الإسناد والوقت المحددة مسبقًا في أحد الفلاتر. يتم استخدام هذا لتجاوز التعيين المسبق للوقت وفترة الإسناد في هذا الفلتر المحدد.

الاستخدام

تُعد البادئات اختيارية. يمكن أن يحتوي الحقل على ما يلي:

  • بادئة مستوى الكائن
  • بادئة فترة الإسناد
  • بادئة التعيين المسبق للوقت

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

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

فيما يلي أمثلة على حقول الرؤى الصحيحة وغير الصحيحة المسبوقة ببادئة. نوفر أيضًا أمثلة على حقول البيانات التعريفية الصحيحة وغير الصحيحة، لإظهار فلاتر البيانات التعريفية التي ندعمها.

أمثلة على حقل الرؤى spent
أمثلة جيدة

adset.yesterday_spent - إجمالي المبلغ الذي تم إنفاقه على مستوى المجموعة الإعلانية أمس

adset.spent - إجمالي المبلغ الذي تم إنفاقه على مستوى المجموعة الإعلانية

yesterday_spent - إجمالي المبلغ الذي تم إنفاقه أمس

campaign.28d_view_1d_click:lifetime_results - إجمالي النتائج على مستوى المجموعة الإعلانية طوال فترة عرضها، مع فترة إسناد تبلغ 28 يومًا بعد المشاهدة ويوم واحد بعد النقر

campaign.lifetime_spent - إجمالي المبلغ الذي تم إنفاقه على مستوى الحملة الإعلانية طوال فترة عرضها

أمثلة غير سليمة

lifetime_campaign.spent - لا يمكن أن تأتي بادئات التعيين المسبق للوقت قبل بادئات مستوى الكائن

lifetime_today_spent - لا يمكن أن يكون هناك بادئتان للتحديد المسبق لوقت

ad.adset.spent - لا يمكن أن يكون هناك بادئتان لمستوى الكائن

yesterday.adset_spent - محدد غير صالح


أمثلة على حقل البيانات التعريفية daily_budget
أمثلة جيدة

adset.daily_budget - الميزانية اليومية للمجموعة الإعلانية

daily_budget - الميزانية اليومية

أمثلة غير سليمة

yesterday_daily_budget - يتعذر استخدام بادئات التعيين المسبق للوقت في حقول بيانات التعريف

ad.daily_budget - لا يكون للإعلانات ميزانية يومية

بادئات مستوى الكائن

البادئةنوع الكائنصالحة لأنواع الكائنات

ad.

إعلان

إعلان

adset.

مجموعة إعلانية

إعلان، مجموعة إعلانية

campaign.

حملة إعلانية

إعلان، مجموعة إعلانية، حملة إعلانية

بائدات فترة الإسناد

بادئة فترة الإسناد الوصف

account_default:

استخدام إعدادات فترة الإسناد على مستوى الحساب

default:

فترة الإسناد الافتراضية في فيسبوك هي المشاهدات ليوم واحد وعدد النقرات خلال 28 يومًا

inline:

الإسناد المُضمن فقط (المشاهدات لمدة 0 يوم، والنقرات خلال 0 يوم)

1d_view:

المشاهدات لمدة يوم واحد، والنقرات خلال 0 يوم

7d_view:

المشاهدات لمدة 7 أيام، والنقرات خلال 0 يوم

28d_view:

المشاهدات لمدة 28 يومًا، والنقرات خلال 0 يوم

1d_click:

المشاهدات لمدة 0 يوم، والنقرات خلال يوم واحد

7d_click:

المشاهدات لمدة 0 يوم، والنقرات خلال 7 أيام

28d_click:

المشاهدات لمدة 0 يوم، والنقرات خلال 28 يومًا

1d_view_1d_click:

المشاهدات لمدة يوم واحد، والنقرات خلال يوم واحد

7d_view_1d_click:

المشاهدات لمدة 7 أيام، والنقرات خلال يوم واحد

28d_view_1d_click:

المشاهدات لمدة 28 يومًا، والنقرات خلال يوم واحد

1d_view_7d_click:

المشاهدات لمدة يوم واحد، والنقرات خلال 7 أيام

7d_view_7d_click:

المشاهدات لمدة 7 أيام، والنقرات خلال 7 أيام

28d_view_7d_click:

المشاهدات لمدة 28 يومًا، والنقرات خلال 7 أيام

7d_view_28d_click:

المشاهدات لمدة 7 أيام، والنقرات خلال 28 يومًا

28d_view_28d_click:

المشاهدات لمدة 28 يومًا، والنقرات خلال 28 يومًا

بادئات التعيين المسبق للوقت

هذه القائمة هي قائمة قيم التعيين المسبق للوقت الصالحة نفسها، لكنها بأحرف صغيرة ومرفقة مع محدد.

البادئة الوصف

lifetime_

فترة صلاحية الكائن

today_

اليوم الحالي ابتداءً من منتصف الليل في المنطقة الزمنية للحساب الإعلاني

last_2_days_

YESTERDAY وTODAY

last_3_days_

آخر يومين كاملين وTODAY

last_7_days_

آخر 6 أيام كاملة وTODAY

last_14_days_

آخر 13 يومًا كاملاً وTODAY

last_28_days_

آخر 27 يومًا كاملاً وTODAY

last_30_days_

آخر 29 يومًا كاملاً وTODAY

this_month_

هذا الشهر، بما في ذلك TODAY

this_week_mon_today_

هذا الأسبوع باستخدام يوم الاثنين كأول أيام الأسبوع، بما في ذلك TODAY

this_week_sun_today

هذا الأسبوع باستخدام يوم الأحد كأول أيام الأسبوع، بما في ذلك TODAY

yesterday_

اليوم السابق كاملاً، باستثناء TODAY

last_2d_

آخر يومين كاملين، باستثناء TODAY

last_3d_

آخر 3 أيام كاملة، باستثناء TODAY

last_7d_

آخر 7 أيام كاملة، باستثناء TODAY

last_14d_

آخر 14 يومًا كاملاً، باستثناء TODAY

last_28d_

آخر 28 يومًا كاملاً، باستثناء TODAY

last_30d_

آخر 30 يومًا كاملاً، باستثناء TODAY

last_nd_14_8_

آخر 14 يومًا إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_30_8_

آخر 30 يومًا إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_60_8_

آخر 60 يومًا إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_120_8_

آخر 120 يومًا إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_180_8_

آخر 180 يومًا إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_lifetime_8_

فترة الصلاحية الكاملة إلى آخر 7 أيام، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_60_29_

آخر 60 يومًا إلى آخر 28 يومًا، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_120_20_

آخر 120 يومًا إلى آخر 28 يومًا، لـعائد الإنفاق الإعلاني (ROAS)

last_nd_180_29_

آخر 180 يومًا إلى آخر 28 يومًا، لـ عائد الإنفاق الإعلاني (ROAS)

last_nd_lifetime_29_

العمر الكلي إلى آخر 28 يومًا، لـ عائد الإنفاق الإعلاني (ROAS)

التجميع

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

بينما يتم احتساب بعض أدوات القياس مثل clicks من خلال عملية جمع بسيطة، يتم احتساب أدوات قياس أخرى مثل reach بطريقة مختلفة. ونظرًا إلى أن reach يستند إلى مرات ظهور الإعلان الفريدة، تتم إزالة المستخدمين المتكررين في التجميع عبر الكائنات الإعلانية المتعددة.

الاستخدام

يكون تنسيق الحقل المجمّع كما يلي aggregate({ field }). يمكن أن يحتوي field على فترة إسناد وبادئات التعيين المسبق للوقت. يتم تحديد مجموعة الكائنات الإعلانية المطلوب تجميعها عن طريق حقل فلترة آخر مطلوب aggregation_id.

مثال على الحقول المجمّعة

أمثلة جيدة

aggregate(reach)

aggregate(lifetime_reach)

أمثلة غير سليمة

aggregate(daily_budget)

aggregate(adset.reach)

فلتر معرف التجميع

يحدد فلتر aggregation_id الكائنات الإعلانية التي يجب تجميعها. ولا يدعم سوى المشغل IN وقائمة معرفات كقيمة. يمكن أن تكون المعرفات من إعلانات أو مجموعات إعلانية أو حملات إعلانية، ولكن يجب أن تكون كلها من مستوى الكائن ذاته.

مثال على فلتر aggregation_id

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

الحقول المدعومة

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

حقول الصيغة

يمكنك تعيين تعبيرات حسابية بسيطة كحقل. على سبيل المثال، يمكن استخدام ذلك للعثور على نسبة بين حقلين رقميين.

يعمل ذلك في حقول الرؤى وفي مجموعة فرعية من حقول البيانات التعريفية الرقمية. تتوفر القائمة الكاملة المدعومة أدناه.

الاستخدام

يتكون حقل الصيغة من حقول أو ثوابت ومشغلات صحيحة نحويًا مفصولة بمسافات. يدعم المشغلات + و- و* و/. يمكنك إضافة ثوابت، على سبيل المثال لتحديد مساحة حقول محددة أو للعمل كإزاحة.

يمكن أن تكون الحقول في هذه الحالة مسبوقة ببادئة بالكامل، ويمكنك إضافة بادئات صالحة لمستوى الكائن والتعيين المسبق للوقت.

في الوقت الحالي نسمح بحد أقصى 6 من الحقول التي لا تتضمن قيمًا ثابتة في الصيغة. يمكنك الحصول على أي عدد من القيم الثابتة التي تريد.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

مثال على الصيغ

أمثلة جيدة

today_spent / adset.daily_budget - نسبة الإنفاق اليومي

clicks / adset.clicks - نسبة عدد النقرات مقارنةً بعدد نقرات المجموعة الإعلانية

today_impressions / yesterday_impressions - نسبة عدد مرات ظهور الإعلان اليوم مقارنةً بعدد مرات ظهور الإعلان أمس

today_impressions / aggregate(today_impressions) - نسبة عدد مرات ظهور الإعلان اليوم مقارنةً بعدد مرات ظهور الإعلان المجمّع

(adset.spent - spent) - علامات الأقواس مقبولة، عند تلقي الصيغ في استجابات API، ستكون بين أقواس

أمثلة غير سليمة

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per - لا يمكن استخدام أكثر من 6 حقول

today_impressions/yesterday_impressions - يجب فصل الشروط بمسافات

حقول البيانات التعريفية الرقمية الصالحة

الحقلصالحة لأنواع الكائنات

bid_amount

إعلان، مجموعة إعلانية

daily_budget

مجموعة إعلانية

lifetime_budget

مجموعة إعلانية

spend_cap

حملة إعلانية