تقسيمات واجهة API الرؤى

يمكنك تجميع نتائج واجهة API الرؤى في مجموعات مختلفة باستخدام التقسيمات.

يمكن أن تقوم واجهة API الرؤى بإرجاع العديد من أدوات القياس التقديرية أو أدوات القياس قيد التطوير أو كليهما. وتعتبر قيم تقسيم الرؤى أدوات قياس تقديرية. ولمزيد من المعلومات، يمكنك الرجوع إلى واجهة API الرؤى، أدوات القياس التقديرية وأدوات القياس التي تم إيقاف استخدامها.

التقييدات

الحقول غير المتوفرة

لا يمكن طلب الحقول التالية عند تحديد أي تقسيم:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

قيود أدوات قياس الإجراءات خارج Meta

لن تكون التقسيمات التالية متوفرة بعد الآن لأدوات قياس الإجراءات خارج Meta.

النوع 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone

النوع 2

• action_device
• action_destination
• action_target_id
• product_id
• action_carousel_card_id/action_carousel_card_name
• action_canvas_component_name

القواعد المتعلقة بالاستعلامات التي تحتوي على التقسيمات أعلاه:

• النوع 1 - لن ترجع API الرؤى أدوات القياس خارج الموقع غير المدعومة (مثل أداة قياس الإجراءات بالتقسيمات من النوع 1).
• النوع 2 - سيستمر إرجاع أدوات قياس الويب خارج الموقع من API، ومع ذلك، لن تحتوي على قيمة التقسيم. لن يتم إرجاع أدوات قياس الهاتف المحمول بعد الآن عند الاستعلام من خلال هذه التقسيمات.

ملاحظة: لا تزال التقسيمات المُدرجة أعلاه مدعومة لأدوات القياس في Meta، مثل مرات ظهور الإعلان والنقرات على الرابط وغير ذلك. لن تؤثر التغييرات على البيانات القديمة المتوفرة قبل 27 أبريل 2021؛ وستظل تقسيمات البيانات القديمة متوفرة.

أدوات قياس الإجراءات

لن تتوفر أدوات القياس في السيناريوهات التالية:

• عند وجود تجميع تمت محاولة تنفيذه عبر عدة إعدادات إسناد
• عند طلب التقسيمات المتأثرة (لا ينطبق هذا التقييد إلا على أنواع الإجراءات وإعادة التوجيه خارج Meta).

ملاحظة: ستتوفر أدوات القياس في حالة الاستعلام باستخدام action_attribution_windows=1d_click,7d_click,1d_view (لا يتضمن النافذة الافتراضية).

التقسيمات العامة

فيما يلي التقسيمات المتوفرة.

الملاحظات

• لا يتم دعم فلترة app_id وskan_conversion_id باستخدام الحقل filtering حاليًا.
• لا يتوفر تقسيم dma لأداة القياس estimated_ad_recall_rate أو أداة القياس video_thruplay_watched_actions.
• يستخدم التقسيم dma منهجية إنشاء العينات لحساب أدوات القياس الفريدة مثل الوصول. في بعض الحالات التي يكون فيها عدد كبير من مناطق التسويق المحددة (DMA) بأحجام منخفضة نسبيًا، قد لا يتم تمثيلها في العينة أو قد يتم زيادتها إلى مضاعفات رقم 2. لذلك، من المستحسن الاستعلام عن مرات ظهور الإعلان المقابلة أيضًا للحصول على دقة محسّنة.
• لا تُستخدم القيمة frequency_value إلا مع reach فقط. فعلى سبيل المثال، مدى تكرار ظهور الإعلان لمستخدم فريد.
• بناءً على التصميم، لا يتوفر التقسيمان image_asset وvideo_asset على مستوى الحساب الإعلاني للأصول المُستخدمة في التصميم الديناميكي.
• لا تدعم الإجراءات الإعلانيةvideo_p25_watched_actions وvideo_p50_watched_actions وvideo_p75_watched_actions وvideo_p95_watched_actions وvideo_p100_watched_actions التقسيم region.
• تدعم كل تقسيمات أصل التصميم الديناميكي فقط مجموعة محدودة فقط من أدوات القياس:

يقوم الاستدعاء التالي بتجميع النتائج حسب age وgender.

curl -G \
  -d "breakdowns=age,gender" \
  -d "fields=impressions" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

تقسيمات بالساعة

توفر الإحصائيات بالساعة الآن ضمن التقسيمات المتاحة باستخدام التقسيمات التالية:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

يمكنك الرجوع إلى دمج التقسيمات للتعرف على تقييدات عدد التقسيمات التي يمكنك طلبها من خلال التقسيم بالساعة. ولا تدعم التقسيمات بالساعة الحقول الفريدة وهي أي حقول مسبوقة بالبادئة unique_* أو reach أو frequency. وسيقوم الحقلان reach وfrequency بإرجاع القيمة 0 أثناء استخدام التقسيمات بالساعة.

curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

تقسيم الإجراءات

يمكنك تجميع النتائج في الحقل actions. ويمكنك استخدام التقسيمات التالية في action_breakdowns:

فيما يلي التقسيمات الممكنة التي يمكن إدخالها في الحقل action_breakdowns.

• action_device
• conversion_destination
• matched_persona_id
• matched_persona_name
• signal_source_bucket
• standard_event_content_type
• action_canvas_component_name
• action_carousel_card_id
• action_carousel_card_name
• action_destination
• action_reaction
• action_target_id
• action_type
• action_video_sound
• action_video_type

إذا لم يتم تحديد المعلمة action_breakdowns، فستتم إضافة النوع action_type ضمنيًا باعتباره action_breakdowns.

إجمالي العدد في actions

العدد الإجمالي (المجموع) لجميع القيم التي تم إرجاعها في نتائج المجموعة (actions).

total_actions - 33
    page_engagement - 10
        post_engagement - 10
            link_click - 2
            comment - 3
            post_reaction - 3
            like - 2
    mobile_app_install - 12
    app_custom_event - 11
        app_custom_event.fb_mobile_activate_app - 6
        app_custom_event.other - 5

في هذا المثال، post_engagement هو مجموع link_click وcomment وlike وpost_reaction، حيث يكون post_reaction هو عدد كل التفاعلات بما في ذلك تسجيلات الإعجاب. يمثل الحقل total_actions إجمالي أبرز الإجراءات لأحد الكائنات، مثل page_engagement وmobile_app_install وapp_custom_event.

دمج التقسيمات

بسبب قيود التخزين، لا يتوفر سوى عدد محدود من تباديل التقسيمات. ويمكن إضافة التباديل المميزة بعلامة النجمة (*) مع action_type وaction_target_id وaction_destination التي تشير إلى اسم action_target_id.

التقييدات

• لا يمكن طلب حقول video_* من خلال أي تقسيمات لإحصائيات بالساعة.
• لا يمكن طلب حقل video_avg_time_watched_actions من خلال تقسيم المنطقة.
• تتم إضافة النوع action_type باعتباره action_breakdowns عند عدم تحديد المعلمة action_breakdowns.