‏‎Graph API‎‏
إصدار ‏‎Graph API‎‏
عودة إلى اللغة ‏العربية‏
تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏١١ سبتمبر‏
تاريخ تحديث اللغة ‏العربية‏: ‏٢٦‏/١٠‏/٢٠١٨‏

Page Insights

Represents insights for Facebook Pages and Page posts. Refer to our Pages API documentation.

On March 14, 2024, a number of the Page Insights metrics were deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics. Read our blog to learn more.

قراءة

Get metrics for Pages or Page posts.

تجربة الصفحات الجديدة

نقطة النهاية هذه مدعومة في ‏تجربة الصفحات الجديدة‏.

Limitations

  • Page Insights data is only available on Pages with 100 or more likes.
  • Most metrics will update once every 24 hours.
  • Only the last two years of insights data is available.
  • The values for period are calculated from the initial collection of the data point.
  • "Period" in the tables below only refers to the time frame for which the metric can be accessed in an aggregated form.
  • The value "lifetime" means the time period for which the insights data is available. By default, this time period is 2 years or shorter.
  • Only 90 days of insights can be viewed at one time when using the since and until parameters.
  • When using since and until, the since date data will be included in the first value returned.
  • Unique impression insights values are calculated independently.
    • Total page reach may not always be exactly equal to the sum of paid and non-paid unique values.
    • Total page reach may not always be exactly equal to the sum of viral_unique and organic_unique.
  • When an organic post is boosted, metrics for paid post impressions will include both organic and paid reach.
  • Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
  • Breakdown metrics for Page post and Page view insights will only return non-zero values.
  • Several video related metrics only return accurate values if the person requesting the metric is the Page video post creator.
  • If you reshare a video post of another Page and retrieve its insights, the metrics return a value of 0. Metrics that return 0 for resharers are denoted with "Returns 0 for reshared videos" in their description.
  • If you neglect to indicate a specific metric or metrics for the endpoint, you will receive an error response with code 3001, with subcode 1504028 and an error message that states: "No metric was specified to be fetched. Please specify one or more metrics to be fetched and try again."
  • Interactions on Reels are not included.

Requirements

TypeDescription

Access Tokens

A Page access token requested by a person who can perform the ANALYZE task on the Page.

Features

Not applicable.

Permissions

read_insights, pages_read_engagement

Page Tasks

ANALYZE

Example

Single Metric Sample Request

Graph API Explorer
GET v21.0/{object-id}/insights/{metric} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights/{metric}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "{object-id}/insights/{metric}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights/{metric}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights/{metric}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
إذا كنت تريد التعرف على كيفية استخدام واجهة Graph API، يرجى قراءة ‏دليل استخدام واجهة Graph API‏.

Multiple Metric Sample Request

NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.

Graph API Explorer
GET v21.0/{object-id}/insights?metric={metric-1},{metric-2},{metric-3},... HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},..."
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
إذا كنت تريد التعرف على كيفية استخدام واجهة Graph API، يرجى قراءة ‏دليل استخدام واجهة Graph API‏.

Metrics

Metric names indicate whether a metric is for a Page or a Page post.

SuffixDescription

_unique

Indicates that the metric shows the number of unique users who performed a specific action, for example page_impressions_unique. Metrics generated with the _unique suffix are approximate and may not be 100% accurate.

_login

Indicates whether a person was logged into Facebook, for example, page_tab_views_login_top.

_logout

Indicates whether a person is logged out of Facebook, for example page_views_logout.

_source

Indicates that the metric will be broken down into a list of referral sources, for example page_fans_by_like_source. External referrals are broken down by domain. Internal referrals are broken down by Facebook-specific features such as Profile, Search, Requests, Suggestions, Stream, etc. In these cases the value returned will be an object containing a series of key-value pairs where the key is the source name and the value is the metric for that source.

*

Indicates that a metric is refreshed several times during the day, for example page_impressions_unique*.

Page Content

Most of the metrics below can be retrieved using post_activity_by_action_type, post_clicks_by_type, and page_consumptions_by_consumption_type.

Metric Name Description Values for `period`
page_tab_views_login_top_unique

‏عدد المستخدمين الذين سجلوا الدخول إلى فيسبوك وشاهدوا علامات التبويب على صفحتك.‏ ‏‏ (See possible types)

day, week

page_tab_views_login_top

‏عدد مرات مشاهدة المستخدمين الذين قاموا بتسجيل الدخول إلى فيسبوك لعلامات التبويب على صفحتك.‏ ‏‏ (See possible types)

day, week

page_tab_views_logout_top

‏عدد مرات تسجيل الأشخاص للدخول إلى فيسبوك ومشاهدة علامات التبويب على صفحتك.‏ ‏‏ (See possible types)

day

Tab Types

Tab types for Page content metrics.

Name Description
allactivity

Administrative tab

app

Custom created tab

info

About tab view

insights

Insights tab

likes

Likes tab

locations

Map tab

photos

Photos tab

photos_albums

Photos tab

photos_stream

Photos tab

profile

Pages timeline

profile_info

Info tab

profile_likes

Likes tab

profile_photos

Photos tab

timeline

Pages timeline

events

Events tab

videos

Videos tab

wall

Timeline

Page CTA Clicks

Metric Name Description Values for `period`
page_total_actions

‏عدد النقرات على معلومات اتصال الصفحة وزر الدعوة لاتخاذ إجراء.‏ ‏‏

day, week, days_28

Page Engagement

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
page_post_engagements*

‏عدد مرات تفاعل الأشخاص مع منشوراتك من خلال التفاعلات والتعليقات والمشاركات وغير ذلك الكثير.‏ ‏‏

day, week, days_28

page_fan_adds_by_paid_non_paid_unique

‏عدد ‏حسابات مركز الحسابات‏ التي سجلت إعجابها بصفحتك لأول مرة، مقسمةً استنادًا إلى ما إذا كان تسجيل الإعجاب بالصفحة يستند إلى محتوى مدفوع أو عادي.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

day

page_lifetime_engaged_followers_unique*

‏شخص ما يتابع صفحتك وقام، في آخر 14 يومًا، بمشاهدة واحد أو أكثر من مقاطع فيديو البث المباشر أو مقاطع الفيديو المسجّلة مسبقًا لمدة دقيقة واحدة على الأقل و/أو تفاعل مع محتوى الفيديو الذي قدمته مرة واحدة على الأقل، من خلال تعليق أو مشاركة أو تفاعل أو تسجيل إعجاب.‏ ‏‏

page_daily_follows*

‏عدد المرات التي تمت خلالها متابعة صفحتك أو ملفك الشخصي على فيسبوك خلال الفترة الزمنية المحددة.‏ ‏‏

day

page_daily_follows_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي تابعت صفحتك خلال الفترة الزمنية المحددة.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

day, week, days_28

page_daily_unfollows_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي ألغت متابعة صفحتك خلال الفترة الزمنية المحددة.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

day, week, days_28

page_follows*

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

day

Page Impressions

Metric Name Description Values for `period`
page_impressions*

‏عدد مرات ظهور أي محتوى من صفحتك أو عن صفحتك على شاشة شخص ما. ويتضمن هذا المنشورات والقصص والإعلانات وأي محتوى أو معلومات أخرى على صفحتك.‏ ‏‏

day, week, days_28

page_impressions_unique*

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

day, week, days_28

page_impressions_paid*

‏عدد مرات ظهور أي محتوى قصة أو منشور من صفحتك أو عن صفحتك على شاشة شخص ما عبر توزيع مدفوع مثل إعلان.‏ ‏‏

day, week, days_28

page_impressions_paid_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي شاهدت إعلاناتك مرة واحدة على الأقل. ويختلف الوصول عن عدد مرات الظهور، الذي قد يتضمن عدة مشاهدات لإعلاناتك من نفس حسابات مركز الحسابات.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

day, week, days_28

page_impressions_viral*

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

day, week, days_28

page_impressions_viral_unique*

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

day, week, days_28

page_impressions_nonviral*

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

day, week, days_28

page_impressions_nonviral_unique*

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

day, week, days_28

Page Posts

Metric Name Description Values for `period`
page_posts_impressions*

‏عدد مرات ظهور منشورات الصفحة على شاشة شخص ما. وتتضمن المنشورات الحالات والصور والروابط ومقاطع الفيديو وغير ذلك الكثير.‏ ‏‏

day, week, days_28

page_posts_impressions_unique*

‏عدد الأشخاص الذين شاهدوا أيًا من منشورات صفحتك على الشاشة. وتتضمن المنشورات الحالات والصور والروابط ومقاطع الفيديو وغير ذلك الكثير.‏ ‏‏

day, week, days_28

page_posts_impressions_paid*

‏عدد مرات ظهور صفحة فيسبوك الخاصة بك ومحتوى الصفحة على الشاشة، نتيجة لإعلاناتك.‏ ‏‏

day, week, days_28

page_posts_impressions_paid_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي شاهدت أي منشورات من صفحتك مرة واحدة على الأقل، والتي تم إسنادها إلى إعلاناتك.‏ ‏‏

day, week, days_28

page_posts_impressions_organic_unique*

‏عدد الأشخاص الذين شاهدوا أيًا من منشورات صفحتك على الشاشة عبر توزيع غير مدفوع.‏ ‏‏

day, week, days_28

page_posts_served_impressions_organic_unique

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

day, week, days_28

page_posts_impressions_viral*

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

day, week, days_28

page_posts_impressions_viral_unique*

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

day, week, days_28

page_posts_impressions_nonviral*

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

day, week, days_28

page_posts_impressions_nonviral_unique*

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

day, week, days_28

Page Post Engagement

Metric Name Description Values for `period`
post_clicks*

‏عدد مرات نقر الأشخاص في أي مكان في منشوراتك دون إنشاء قصة.‏ ‏‏

lifetime

post_clicks_by_type*

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

lifetime

Negative Feedback Types

Negative feedback types for page_negative_feedback_by_type metrics.

Name Description
hide_clicks

Hide this story

hide_all_clicks

Hide all posts from this page

report_spam_clicks

Report an object as a spam

unlike_page_clicks

Unlike a page

Page Post Impressions

Metric Name Description Values for `period`
post_impressions*

‏عدد مرات ظهور منشور الصفحة على شاشة شخص ما. وتتضمن المنشورات كلاً من الحالات والصور والروابط ومقاطع الفيديو وغير ذلك الكثير.‏ ‏‏

lifetime

post_impressions_unique*

‏عدد الأشخاص الذين شاهدوا منشور صفحتك على الشاشة. وتتضمن المنشورات الحالات والصور والروابط ومقاطع الفيديو وغير ذلك الكثير.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

lifetime

post_impressions_paid*

‏عدد مرات ظهور محتوى صفحتك على الشاشة، نتيجة لإعلاناتك.‏ ‏‏

lifetime

post_impressions_paid_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي شاهدت منشورك مرة واحدة على الأقل، والتي تم إسنادها إلى إعلاناتك.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

lifetime

post_impressions_fan*

‏عدد مرات ظهور محتوى صفحتك على الشاشة للحسابات التي تتابع صفحتك أو قامت بتسجيل الإعجاب بها.‏ ‏‏

lifetime

post_impressions_fan_unique*

‏عدد ‏حسابات مركز الحسابات‏ التي تتابع صفحتك أو قامت بتسجيل الإعجاب بها.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

lifetime

post_impressions_organic*

‏عدد مرات ظهور منشورك على الشاشة من خلال التوزيع العادي.‏ ‏‏

lifetime

post_impressions_organic_unique*

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

lifetime

post_impressions_viral*

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

lifetime

post_impressions_viral_unique*

‏تحتسب أداة القياس هذه معدل الوصول عند مشاركة المحتوى الذي تنشره على فيسبوك كإعادة نشر أو قصة. يتم احتساب الوصول من المشاركات فقط ضمن التوزيع العادي.‏ ‏أداة القياس هذه ‏‏تقديرية‏ و‏قيد التطوير‏‏.‏

lifetime

post_impressions_nonviral*

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

lifetime

post_impressions_nonviral_unique*

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

lifetime

Page Post Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
post_reactions_like_total

‏إجمالي التفاعلات مع المنشور باستخدام "أعجبني".‏ ‏‏

lifetime

post_reactions_love_total

‏إجمالي التفاعلات مع المنشور باستخدام "أحببته".‏ ‏‏

lifetime

post_reactions_wow_total

‏إجمالي التفاعلات مع المنشور باستخدام "واااو".‏ ‏‏

lifetime

post_reactions_haha_total

‏إجمالي التفاعلات مع المنشور باستخدام "هاهاها".‏ ‏‏

lifetime

post_reactions_sorry_total

‏إجمالي التفاعلات مع المنشور باستخدام "أحزنني".‏ ‏‏

lifetime

post_reactions_anger_total

‏إجمالي التفاعلات مع المنشور باستخدام "أغضبني".‏ ‏‏

lifetime

post_reactions_by_type_total

‏إجمالي التفاعلات مع المنشور حسب النوع.‏ ‏‏

lifetime

Page Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
page_actions_post_reactions_like_total*

‏إجمالي التفاعلات اليومية مع المنشور بالتعبير "أعجبني" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_love_total*

‏إجمالي التفاعلات اليومية مع المنشور بالتعبير "أحببته" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_wow_total*

‏إجمالي التفاعلات اليومية مع المنشور باستخدام التعبير "واااو" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_haha_total*

‏إجمالي التفاعلات اليومية مع المنشور باستخدام "هاهاها" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_sorry_total*

‏إجمالي التفاعلات اليومية مع المنشورات باستخدام "أحزنني" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_anger_total*

‏إجمالي التفاعلات اليومية مع المنشور باستخدام "أغضبني" على الصفحة.‏ ‏‏

day, week, days_28

page_actions_post_reactions_total

‏إجمالي التفاعلات اليومية مع المنشور على الصفحة حسب النوع.‏ ‏‏

day

Page User Demographics

Metric Name Description Values for `period`
page_fans

‏إجمالي عدد الأشخاص الذين سجلوا إعجابهم بصفحتك.‏ ‏‏

day

page_fans_locale

‏إجمالي بيانات اللغة حول الأشخاص المعجبين بصفحتك استناداً إلى إعداد اللغة المحددة أثناء الدخول إلى فيسبوك.‏ ‏‏

day

page_fans_city

‏إجمالي بيانات موقع فيسبوك، مفروزة بحسب المدينة، حول الأشخاص المعجبين بصفحتك.‏ ‏‏

day

page_fans_country

‏عدد الأشخاص، مجمعين حسب البلد، الذين يسجلون الإعجاب بصفحتك. يتم تضمين 45 بلدًا فقط التي يتحدث فيها معظم الأشخاص عن صفحتك.‏ ‏‏

day

page_fan_adds

‏عدد الأشخاص الجدد الذين قاموا بتسجيل إعجابهم بصفحتك.‏ ‏‏

day

page_fan_adds_unique

‏عدد ‏حسابات مركز الحسابات‏ التي سجلت الإعجاب بصفحتك للمرة الأولى.‏ ‏أداة القياس هذه ‏تقديرية‏.‏

day, week, days_28

page_fan_removes

‏حالات إلغاء الإعجاب بصفحتك.‏ ‏‏

day

page_fan_removes_unique*

‏حالات إلغاء الإعجاب بصفحتك.‏ ‏‏

day, week, days_28

Page Like Sources

Source types for page_fans_by_like_source and page_fans_by_like_source_unique metrics.

Name Description
Ads

Page likes that came from people who saw your Page or post in an ad.

News Feed

Page likes that came from people who saw content posted by your Page or about your Page in News Feed.

Page Suggestions

Page likes that came from people saw your Page in a list of suggested Pages.

Restored Likes from Reactivated Accounts

Page likes that came from people who reactivated their Facebook profile.

Search

Page likes that came from people who saw you Page or post in search.

Your Page

Page likes that came from people who visited your Page.

Page Video Views

Metric Name Description Values for `period`
page_video_views

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_by_uploaded_hosted*

‏مشاهدات الفيديو اليومية على مستوى الصفحة مقسمة حسب كل مقاطع الفيديو التي يتم تحميلها على الصفحة ومقاطع الفيديو التي تتم استضافتها على الصفحة.‏ ‏‏

day, week, days_28

page_video_views_paid

‏عدد مرات تشغيل مقاطع فيديو صفحتك التي يتم ترويجها لمدة 3 ثوانٍ على الأقل، أو مدتها بالكامل تقريبًا إذا كانت أقل من 3 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_organic

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_by_paid_non_paid*

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ، مُقسمة حسب الإجمالي والمدفوع وغير المدفوع. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_autoplayed

‏عدد مرات تشغيل مقاطع فيديو صفحتك تلقائيًا لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_click_to_play

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_repeat_views

‏عدد مرات إعادة تشغيل مقاطع فيديو صفحتك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت أقل من 3 ثوانٍ.‏ ‏‏

day, week, days_28

page_video_complete_views_30s

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_complete_views_30s_paid

‏عدد مرات تشغيل مقاطع فيديو صفحتك التي يتم ترويجها لمدة 30 ثانية على الأقل، أو مدتها بالكامل تقريبًا إذا كانت أقل من 30 ثانية. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_complete_views_30s_organic

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_complete_views_30s_autoplayed

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

day, week, days_28

page_video_complete_views_30s_click_to_play

‏عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_complete_views_30s_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع فيديو صفحتك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_complete_views_30s_repeat_views

‏عدد مرات إعادة تشغيل مقاطع فيديو صفحتك التي يتم ترويجها لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت أقل من 30 ثانية.‏ ‏‏

day, week, days_28

post_video_complete_views_30s_autoplayed

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك تلقائيًا لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_30s_clicked_to_play

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_30s_organic

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_30s_paid

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك التي يتم ترويجها لمدة 30 ثانية على الأقل، أو مدتها بالكامل تقريبًا إذا كانت أقل من 30 ثانية. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_30s_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك لمدة 30 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 30 ثانية. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

page_video_views_10s

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_paid

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك التي يتم ترويجها لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_organic

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_autoplayed

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك تلقائيًا لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_click_to_play

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_unique

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد الأشخاص الذين شاهدوا مقاطع فيديو صفحتك لمدة 10 ثوانٍ على الأقل، أو شاهدوها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, week, days_28

page_video_views_10s_repeat

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع فيديو صفحتك التي يتم ترويجها لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ.‏ ‏‏

day, week, days_28

page_video_view_time

‏إجمالي الوقت، بالميللي ثانية، الذي قضاه الأشخاص في مشاهدة فيديو صفحتك.‏ ‏‏

day

page_uploaded_3s_to_15s_views_rate*

‏معدل المشاهدات من 3 ثوانٍ إلى 15 ثانية. ويتم قياسه عبر كل أصول الفيديو التي تم تحميلها. ويشتمل هذا على أي نشاط يتم على المنشورات/عمليات النشر في منشورات متعددة أو مشاركاتها.‏ ‏‏

page_uploaded_views_15s_count*

‏إجمالي عدد مشاهدات الفيديو لهؤلاء الذين شاهدوا 15 ثانية على الأقل من فيديو صفحتك.‏ ‏‏

page_uploaded_views_60s_excludes_shorter_unique_count_by_is_60s_returning_viewer*

‏‎‎Daily video 60-second unique views on a page for uploaded videos by 60-second returning viewers. This metric counts only for videos that are 60 seconds or longer. 60-second returning viewers are the users who had 60-second view last week and a 60-second view this week.‎‎‏ ‏‏

Page Views

Metric Name Description Values for `period`
page_views_total*

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

day, week, days_28

Page Video Posts

Metric Name Description Values for `period`
post_video_avg_time_watched

‏متوسط المدة الزمنية، بالمللي ثانية، التي قضاها الأشخاص في مشاهدة مقاطع الفيديو الخاصة بك. تتوفر هذه القيمة لمقاطع الفيديو التي تم إنشاؤها بعد 25 أغسطس 2016 فقط. يتم عرض 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_organic

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك من البداية إلى 97%، أو أكثر، من مدتها، حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_organic_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك من البداية إلى 97%، أو أكثر، من مدتها، حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_paid

‏عدد مرات تشغيل مقاطع الفيديو التي يتم ترويجها من البداية إلى 97%، أو أكثر، من مدتها. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتم عرض القيمة 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime

post_video_complete_views_paid_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك التي يتم ترويجها من البداية إلى 97%، أو أكثر، من مدتها. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_retention_graph*

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

lifetime

post_video_retention_graph_clicked_to_play

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

lifetime

post_video_retention_graph_autoplayed

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

lifetime

post_video_views_organic

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime, day

post_video_views_organic_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_paid

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك التي يتم ترويجها لمدة 3 ثوانٍ على الأقل، أو مدتها بالكامل تقريبًا إذا كانت أقل من 3 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime, day

post_video_views_paid_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك التي يتم ترويجها لمدة 3 ثوانٍ على الأقل، أو مدتها بالكامل تقريبًا إذا كانت أقل من 3 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_length

‏مدة منشور الفيديو، بالمللي ثانية.‏ ‏‏

lifetime

post_video_views

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو. ويتضمن هذا مشاهدات البث المباشر.‏ ‏‏

lifetime, day

post_video_views_unique

‏عدد الأشخاص الذين قاموا بمشاهدة مقاطع الفيديو الخاصة بك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

day, lifetime

post_video_views_autoplayed

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك تلقائيًا لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_clicked_to_play

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_15s*

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 15 ثانية على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 15 ثانية. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_60s_excludes_shorter*

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

lifetime, day

post_video_views_10s

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime, day

post_video_views_10s_unique

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد الأشخاص الذين شاهدوا مقاطع الفيديو الخاصة بك لمدة 10 ثوانٍ على الأقل، أو شاهدوها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_10s_autoplayed

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك تلقائيًا لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_10s_clicked_to_play

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ، بعد نقر الأشخاص على زر التشغيل. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_10s_organic

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ، حسب الوصول العادي. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_10s_paid

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك التي يتم ترويجها لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة ظهور للفيديو، سنقوم باحتساب مشاهدات الفيديو بشكل منفصل واستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime, day

post_video_views_10s_sound_on

‏تم إيقاف استخدامها في الإصدارات الأحدث من Graph API v18: عدد مرات تشغيل مقاطع الفيديو الخاصة بك بصوت لمدة 10 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 10 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_views_sound_on

‏عدد مرات تشغيل مقاطع الفيديو الخاصة بك بصوت لمدة 3 ثوانٍ على الأقل، أو تشغيلها بالكامل تقريبًا إذا كانت مدتها أقل من 3 ثوانٍ. ومع كل مرة تشغيل للفيديو، سنقوم باستبعاد أي وقت تم قضاؤه في إعادة تشغيل الفيديو.‏ ‏‏

lifetime

post_video_view_time

‏إجمالي الفترة الزمنية، بالمللي ثانية، لتشغيل مقاطع الفيديو الخاصة بك لأقل من 3 ثوانٍ ومرات إعادة التشغيل. يتم عرض 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime, day

post_video_view_time_organic

‏إجمالي الفترة الزمنية، بالمللي ثانية، لتشغيل مقاطع الفيديو الخاصة بك حسب الوصول العادي. يتم عرض 0 لمقاطع الفيديو التي تمت إعادة مشاركتها.‏ ‏‏

lifetime, day

post_video_view_time_by_age_bucket_and_gender

‏إجمالي الفترة الزمنية، بالمللي ثانية، لتشغيل مقاطع الفيديو الخاصة بك حسب أبرز الجماهير والعمر والجنس.‏ ‏‏

lifetime

post_video_view_time_by_region_id

‏إجمالي الفترة الزمنية، بالمللي ثانية، لتشغيل مقاطع الفيديو الخاصة بك حسب أبرز 45 موقعًا، منطقة - بلدًا.‏ ‏‏

lifetime, day

post_video_views_by_distribution_type

‏عدد مرات مشاهدة الفيديو حسب نوع التوزيع؛ page_owned وshared.‏ ‏‏

lifetime

post_video_view_time_by_distribution_type

‏إجمالي وقت مشاهدة الفيديو (بالميللي ثانية) حسب نوع التوزيع؛ page_owned وshared.‏ ‏‏

lifetime

post_video_view_time_by_country_id

‏إجمالي عدد دقائق تشغيل مقاطع الفيديو الخاصة بك لأبرز 45 موقعًا؛ بلدًا.‏ ‏‏

lifetime

post_video_views_live*

‏إجمالي عدد الأشخاص الذين شاهدوا الفيديو لأكثر من 3 ثوانٍ أو عند بثه بشكل مباشر.‏ ‏‏

lifetime

post_video_social_actions_count_unique*

‏العدد الفريد لإجراءات التواصل الاجتماعي (التفاعلات، التعليقات، المشاركات) لمنشور فيديو.‏ ‏‏

lifetime, day

post_video_live_current_viewers*

‏عدد المشاهدين الذين يشاهدون فيديو بث مباشر حاليًا. يتم إرجاع أداة القياس هذه فقط لمنشورات البث المباشر. ويتم إرجاع القيمة 0 للمنشورات التي كانت تعرض بثًا مباشرًا.‏ ‏‏

post_video_15s_to_60s_excludes_shorter_views_rate*

‏معدل مشاهدات الفيديو من 15 ثانية إلى 60 ثانية. يتم احتساب أداة القياس لمدة 60 ثانية هذه فقط لمقاطع الفيديو التي مدتها 60 ثانية أو أكثر.‏ ‏‏

post_video_views_by_live_status*

‏‎‎Lifetime 3S Video Views broken down by live status: live or VOD‎‎‏ ‏‏

Stories

Page and Post Stories and "People talking about this".

Metric Name Description Values for `period`
post_activity_by_action_type*

‏عدد الأحداث التي تم إنشاؤها حول منشور الصفحة، حسب نوع الإجراء.‏ ‏‏

lifetime

post_activity_by_action_type_unique*

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

lifetime

Page Story Types

Name Description
checkin

Page checkins

coupon

Offer claims

event

RSVPing to event

fan

Page likes

mention

Page mentions

page post

Posts by a Page

question

Question answers

user post

Posts by people on a Page

other

Other types

Video Ad Breaks

Metric Name Description Values for period

page_daily_video_ad_break_ad_impressions_by_crosspost_status

The total number of times an ad was shown during ad breaks in crossposted videos.

day

page_daily_video_ad_break_cpm_by_crosspost_status

The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook.

day

page_daily_video_ad_break_earnings_by_crosspost_status

An estimate of the amount you earned from ad breaks in a crossposted videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.

day

post_video_ad_break_ad_impressions

The total number of times an ad was shown during ad breaks in your videos.

day, lifetime

post_video_ad_break_earnings

An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.

day, lifetime

post_video_ad_break_ad_cpm

The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook.

day, lifetime

creator_monetization_qualified_views

The number of views of your videos that will receive a payout. To qualify for payout, your Page or profile must generate ad revenue in the current earning period. You must also be following the Partner Monetization Policies and Content Monetization Policies. There are additional factors which may disqualify a view for payout.

day,lifetime

المعلمات

معلمةالوصف
breakdown
list<A valid breakdown for an insights endpoint>

breakdown for marketing messages metrics. This is currently in development.

date_preset
enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}

Preset a date range, like lastweek, yesterday. If since or until presents, it does not work.

metric
list<A valid metric for an insights endpoint>

The list of metrics that needs to be fetched

period
enum {day, week, days_28, month, lifetime, total_over_range}

The aggregation period

show_description_from_api_doc
boolean
القيمة الافتراضية: ‏‎false‎‏

If set to true, then an additional description of the metric, retrieved from the API doc(https://developers.facebook.com/docs/graph-api/reference/insights) will be included in the returned data

since
datetime

Lower bound of the time range to consider

until
datetime

Upper bound of the time range to consider

الحقول

ستؤدي القراءة من عنصر الربط هذا إلى نتيجة بتنسيق JSON:

{
    "data": [],
    "paging": {}
}

data

قائمة عُقد ‏‎InsightsResult‎‏.

paging

لمزيد من التفاصيل عن تقسيم الصفحات، يرجى الاطلاع على ‏دليل Graph API‏.

‎Error Codes‎

خطأالوصف
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
3001Invalid query
104Incorrect signature
368The action attempted has been deemed abusive or is otherwise disallowed

إنشاء

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ التحديث

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ الحذف

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

See Also