Versão Graph API
Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 14 de mar
Atualização em Português (Brasil): 26 de out de 2018

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.

Leitura

Get metrics for Pages or Page posts.

New Page Experience

This endpoint is supported for New Page Experience.

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 v19.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
}];
Se quiser saber como usar a Graph API, leia nosso guia sobre Como usar a Graph API.

Multiple Metric Sample Request

Graph API Explorer
GET v19.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
}];
Se quiser saber como usar a Graph API, leia nosso guia sobre Como usar a 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

O número de usuários conectados no Facebook que viram abas na sua Página. (See possible types)

day, week

page_tab_views_login_top

O número de vezes que usuários conectados ao Facebook viram abas na sua Página. (See possible types)

day, week

page_tab_views_logout_top

O número de vezes que usuários não conectados no Facebook viram abas na sua Página. (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

O número de cliques nas informações de contato e no botão de chamada para ação da sua Página.

day, week, days_28

page_cta_clicks_logged_in_total

O número total de cliques no botão de chamada para ação da Página por pessoas conectadas no Facebook.

day, week, days_28

page_cta_clicks_logged_in_unique

Número de cliques únicos no botão de chamada para ação da Página por pessoas conectadas no Facebook.

day, week, days_28

page_call_phone_clicks_logged_in_unique

O número de pessoas que entraram no Facebook e clicaram no botão Ligar agora.

day, week, days_28

page_get_directions_clicks_logged_in_unique

O número de pessoas que entraram no Facebook e clicaram no botão "Como chegar".

day, week, days_28

page_website_clicks_logged_in_unique*

Número de pessoas que entraram no Facebook e clicaram no botão de chamada para ação "Ir para o site".

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*

O número de vezes que as pessoas engajaram com suas publicações por meio de reações, comentários, compartilhamentos e muito mais.

day, week, days_28

page_consumptions_unique*

O número de pessoas que clicaram em qualquer conteúdo seu.

day, week, days_28

page_consumptions_by_consumption_type

O número de vezes que as pessoas que clicaram em qualquer um dos seus conteúdos, por tipo. Os tipos incluem link_click, other_click, photo_view e video_view.

day, week, days_28

page_consumptions_by_consumption_type_unique

O número de pessoas que clicaram em qualquer conteúdo seu, por tipo.

day, week, days_28

page_places_checkin_total*

O número de vezes que as pessoas fizeram check-in em um local.

day, week, days_28

page_places_checkin_total_unique*

O número de pessoas que fizeram check-in em um local.

day, week, days_28

page_negative_feedback

O número de vezes que as pessoas executaram uma ação negativa (por exemplo, descurtiram ou ocultaram uma publicação).

day, week, days_28

page_negative_feedback_unique

O número de pessoas que executaram uma ação negativa (por exemplo, descurtiram ou ocultaram uma publicação).

day, week, days_28

page_negative_feedback_by_type

O número de vezes que as pessoas executaram uma ação negativa detalhado por tipo. (See possible types)

day, week, days_28

page_negative_feedback_by_type_unique

O número de pessoas que executaram uma ação negativa, detalhado por tipo. (See possible types)

day, week, days_28

page_fans_online

O número de fãs que viram publicações no Facebook em um determinado dia, detalhado pela hora do dia (horário PST/PDT).

day

page_fans_online_per_day

O número de fãs que viram qualquer publicação no Facebook em um determinado dia.

day

page_fan_adds_by_paid_non_paid_unique

O número de contas da Central de Contas que curtiram sua Página pela primeira vez, detalhadas por curtida na Página atribuída a conteúdo pago ou orgânico. Esta métrica é estimada.

day

page_lifetime_engaged_followers_unique*

Alguém que segue sua Página e que, nos últimos 14 dias, assistiu a um ou mais dos seus vídeos ao vivo ou vídeos gravados anteriormente por pelo menos um minuto e/ou interagiram com o seu conteúdo de vídeo pelo menos uma vez, por meio de um comentário, compartilhamento, reação ou curtida.

page_daily_follows*

O número de vezes que sua Página ou perfil do Facebook foi seguido no período selecionado.

day

page_daily_follows_unique*

O número de contas da Central de Contas que começaram a seguir sua Página no período selecionado. Esta métrica é estimada.

day, week, days_28

page_daily_unfollows_unique*

O número de contas da Central de Contas que deixaram de seguir sua Página no período selecionado. Esta métrica é estimada.

day, week, days_28

page_follows*

O número de seguidores da sua Página ou perfil do Facebook. Para o cálculo, o número de seguidores é subtraído do número de ex-seguidores ao longo da existência da sua Página ou perfil do Facebook.

day

Page Impressions

Metric Name Description Values for `period`
page_impressions*

O número de vezes que qualquer conteúdo da sua Página ou sobre ela apareceu na tela de uma pessoa. Isso inclui publicações, stories, anúncios, além de outros conteúdos ou informações da sua Página.

day, week, days_28

page_impressions_unique*

O número de pessoas em cujas telas foi exibido qualquer conteúdo da sua Página ou sobre ela. Inclui publicações, check-ins, anúncios, informações sociais de pessoas que interagem com a sua Página e muito mais. Esta métrica é estimada.

day, week, days_28

page_impressions_paid*

O número de vezes que um conteúdo de publicação ou story da sua Página ou sobre ela apareceu na tela de uma pessoa por meio de distribuição paga, como um anúncio.

day, week, days_28

page_impressions_paid_unique*

O número de contas da Central de Contas que viram seus anúncios pelo menos uma vez. O alcance é diferente das impressões, que podem incluir várias visualizações dos seus anúncios pelas mesmas contas da Central de Contas. Esta métrica é estimada.

day, week, days_28

page_impressions_organic_v2*

O número de vezes que sua Página do Facebook e o conteúdo da Página apareceram na tela por meio de distribuição orgânica.

day, week, days_28

page_impressions_organic_unique_v2*

Essa métrica calcula o alcance da distribuição orgânica da sua Página do Facebook e do conteúdo dela. Esta métrica é estimada.

day, week, days_28

page_impressions_viral*

O número de vezes que qualquer conteúdo da sua Página ou sobre ela apareceu na tela de uma pessoa com informações sociais associadas. As informações sociais mostram quando o amigo de uma pessoa interagiu com a sua Página, publicação ou story. Inclui quando o amigo de alguém curte ou segue a sua Página, se engaja com uma publicação, compartilha uma foto da sua Página e faz check-in na sua Página. Esta métrica é em desenvolvimento.

day, week, days_28

page_impressions_viral_unique*

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página quando apareceram com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada e em desenvolvimento.

day, week, days_28

page_impressions_nonviral*

O número de vezes que sua Página do Facebook e o conteúdo da Página apareceram na tela, excluindo as vezes que apareceram com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. Esta métrica é em desenvolvimento.

day, week, days_28

page_impressions_nonviral_unique*

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, excluindo as vezes que apareceram com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada e em desenvolvimento.

day, week, days_28

page_impressions_by_story_type

O número de vezes que sua Página do Facebook e o conteúdo da Página apareceram na tela, agrupadas por tipo de story da Página.

day, week, days_28

page_impressions_by_story_type_unique

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, agrupada por tipo de story da Página. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

day, week, days_28

page_impressions_by_city_unique

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, agrupada por cidade. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

day, week, days_28

page_impressions_by_country_unique

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, agrupada por país. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

day, week, days_28

page_impressions_by_locale_unique

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, agrupada por idioma. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

day, week, days_28

page_impressions_by_age_gender_unique

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página, agrupada por idade e gênero. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

day, week, days_28

page_impressions_viral_frequency_distribution

Essa métrica conta o alcance da distribuição orgânica ou paga da sua Página do Facebook e do conteúdo da Página quando apareceram com informações sociais associadas. A métrica também é agrupada pelo número de vezes que seu conteúdo apareceu na tela. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada e em desenvolvimento.

day, week, days_28

Page Posts

Metric Name Description Values for `period`
page_posts_impressions*

O número de vezes que as publicações da sua Página apareceram na tela de uma pessoa. As publicações incluem status, fotos, links, vídeos e muito mais.

day, week, days_28

page_posts_impressions_unique*

O número de pessoas em cujas telas foi exibida qualquer uma das publicações da sua Página. As publicações incluem status, fotos, links, vídeos e muito mais.

day, week, days_28

page_posts_impressions_paid*

O número de vezes que sua Página do Facebook e o conteúdo da Página apareceram na tela, atribuídas aos seus anúncios.

day, week, days_28

page_posts_impressions_paid_unique*

O número de contas da Central de Contas que viram qualquer publicação da sua Página pelo menos uma vez, atribuído aos seus anúncios. Esta métrica é estimada.

day, week, days_28

page_posts_impressions_organic*

O número de vezes que as publicações da sua Página foram exibidas na tela por meio de distribuição orgânica.

day, week, days_28

page_posts_impressions_organic_unique*

O número de pessoas em cujas telas foi exibida qualquer uma das publicações da sua Página por meio de distribuição não paga.

day, week, days_28

page_posts_served_impressions_organic_unique

O número de pessoas para as quais foram veiculadas publicações da sua Página no Feed delas, independentemente de terem ou não aparecido na tela. As publicações incluem status, fotos, links, vídeos e muito mais.

day, week, days_28

page_posts_impressions_viral*

O número de vezes que as publicações da sua Página apareceram na tela de uma pessoa com informações sociais associadas. As informações sociais mostram quando o amigo de uma pessoa interagiu com a sua Página ou publicação. Isso inclui quando o amigo de alguém curte ou segue a sua Página, se engaja com uma publicação, compartilha uma foto da sua Página e faz check-in na sua Página.

day, week, days_28

page_posts_impressions_viral_unique*

O número de pessoas em cujas telas foi exibida qualquer uma das publicações da sua Página com informações sociais associadas. Como forma de distribuição orgânica, as informações sociais mostram quando o amigo de uma pessoa interagiu com a sua Página ou publicação. Inclui quando o amigo de alguém curte ou segue a sua Página, se engaja com uma publicação, compartilha uma foto da sua Página e faz check-in na sua Página.

day, week, days_28

page_posts_impressions_nonviral*

O número de vezes que as publicações da sua Página apareceram na tela de uma pessoa. Não inclui conteúdo criado sobre a sua Página com informações sociais associadas. As informações sociais mostram quando o amigo de uma pessoa interagiu com a sua Página ou publicação. Isso inclui quando o amigo de alguém curte ou segue a sua Página, se engaja com uma publicação, compartilha uma foto da sua Página e faz check-in na sua Página.

day, week, days_28

page_posts_impressions_nonviral_unique*

O número de pessoas em cujas telas foi exibida qualquer publicação da sua Página. Não inclui conteúdo criado sobre a sua Página com informações sociais associadas. Como uma forma de distribuição orgânica, as informações sociais mostram quando o amigo de uma pessoa interagiu com a sua Página ou publicação. Isso inclui quando o amigo de alguém curte ou segue a sua Página, se engaja com uma publicação, compartilha uma foto da sua Página e faz check-in na sua Página.

day, week, days_28

Page Post Engagement

Metric Name Description Values for `period`
post_engaged_users*

O número de pessoas que clicaram em qualquer lugar nas suas publicações.

lifetime

post_negative_feedback*

O número de vezes que as pessoas executaram uma ação negativa na sua publicação (por exemplo, a ocultaram).

lifetime

post_negative_feedback_unique*

O número de pessoas que executaram uma ação negativa na sua publicação (por exemplo, a ocultaram).

lifetime

post_negative_feedback_by_type*

O número de vezes que as pessoas executaram uma ação negativa na sua publicação, detalhado por tipo.

lifetime

post_negative_feedback_by_type_unique*

O número de pessoas que executaram uma ação negativa na sua publicação, detalhado por tipo.

lifetime

post_engaged_fan

Pessoas que curtiram sua Página e se engajaram com a sua publicação.

lifetime

post_clicks*

O número de vezes que as pessoas clicaram em qualquer nas suas publicações sem gerar um story.

lifetime

post_clicks_unique*

O número de pessoas que clicaram em qualquer lugar na sua publicação sem gerar um story.

lifetime

post_clicks_by_type*

O número de vezes que as pessoas clicaram em qualquer lugar nas suas publicações sem gerar um story, por tipo de consumo.

lifetime

post_clicks_by_type_unique*

O número de pessoas que clicaram em qualquer lugar na sua publicação sem gerar um story, por tipo de consumo.

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*

O número de vezes que a publicação da sua Página foi exibida na tela de uma pessoa. As publicações incluem status, fotos, links, vídeos e muito mais.

lifetime

post_impressions_unique*

O número de pessoas em cujas telas foi exibida a publicação da sua Página. As publicações incluem status, fotos, links, vídeos e muito mais. Esta métrica é estimada.

lifetime

post_impressions_paid*

O número de vezes que o conteúdo da sua Página foi exibido na tela, atribuídas aos seus anúncios.

lifetime

post_impressions_paid_unique*

O número de contas da Central de Contas que viram sua publicação pelo menos uma vez, atribuído aos seus anúncios. Esta métrica é estimada.

lifetime

post_impressions_fan*

O número de vezes que o conteúdo da sua Página apareceu na tela para contas que começaram a seguir ou curtiram sua Página.

lifetime

post_impressions_fan_unique*

O número de contas da Central de Contas que começaram a seguir ou curtiram sua Página. Esta métrica é estimada.

lifetime

post_impressions_organic*

O número de vezes que sua publicação foi exibida na tela por meio de distribuição orgânica.

lifetime

post_impressions_organic_unique*

Essa métrica calcula o alcance da distribuição orgânica do seu conteúdo do Facebook, incluindo publicações, stories e anúncios. O alcance dos compartilhamentos é contabilizado apenas para conteúdo orgânico. São incluídos casos em que seu conteúdo é compartilhado como story ou republicação. Esta métrica é estimada.

lifetime

post_impressions_viral*

O número de vezes que o conteúdo da sua Página apareceu na tela com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. Esta métrica é em desenvolvimento.

lifetime

post_impressions_viral_unique*

Essa métrica contabiliza o alcance quando seu conteúdo do Facebook foi compartilhado como republicação ou story. O alcance de compartilhamentos é contabilizado apenas para a distribuição orgânica. Esta métrica é estimada e em desenvolvimento.

lifetime

post_impressions_nonviral*

O número de vezes que o conteúdo da sua Página apareceu na tela, excluindo as vezes que apareceu com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. Esta métrica é em desenvolvimento.

lifetime

post_impressions_nonviral_unique*

Essa métrica conta o alcance da distribuição orgânica ou paga do conteúdo da sua Página, excluindo as vezes que o conteúdo apareceu com informações sociais associadas. As informações sociais são mostradas no feed quando alguém interage com sua Página, publicação ou story. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada e em desenvolvimento.

lifetime

post_impressions_by_story_type*

O número de vezes que o conteúdo da sua Página apareceu na tela, agrupadas por tipo de story da Página.

lifetime

post_impressions_by_story_type_unique*

Essa métrica conta o alcance da distribuição orgânica ou paga do conteúdo da sua Página, agrupada por tipo de story da Página. O alcance será contado apenas uma vez se acontecer por meio de distribuição orgânica e paga. Esta métrica é estimada.

lifetime

post_impressions_by_paid_non_paid*

O número de vezes que o conteúdo da sua Página apareceu na tela, agrupadas por distribuição paga e orgânica.

lifetime

Page Post Reactions

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

Metric Name Description Values for `period`
post_reactions_like_total

Número de curtidas de uma publicação.

lifetime

post_reactions_love_total

Número de reações "Amei" de uma publicação.

lifetime

post_reactions_wow_total

Número de reações "Uau" de uma publicação.

lifetime

post_reactions_haha_total

Número de reações "Haha" de uma publicação.

lifetime

post_reactions_sorry_total

Número de reações "Triste" de uma publicação.

lifetime

post_reactions_anger_total

Número de reações "Grr" de uma publicação.

lifetime

post_reactions_by_type_total

Total de reações à publicação por tipo.

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*

Diário: total de curtidas nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_love_total*

Diário: total de reações "Amei" nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_wow_total*

Diário: total de reações "Uau" nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_haha_total*

Diário: total de reações "Haha" nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_sorry_total*

Diário: total de reações "Triste" nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_anger_total*

Diário: total de reações "Grr" nas publicações de uma Página.

day, week, days_28

page_actions_post_reactions_total

Diário: total de reações nas publicações de uma Página, por tipo.

day

Page User Demographics

Metric Name Description Values for `period`
page_fans

O número total de pessoas que curtiram a sua Página.

day

page_fans_locale

Dados de idioma agregados das pessoas que curtiram a sua Página, com base na configuração padrão de idioma selecionada ao acessar o Facebook.

day

page_fans_city

Dados de localização do Facebook agregados, classificados por cidade, sobre as pessoas que curtiram a sua Página.

day

page_fans_country

O número de pessoas, agregadas por país, que curtiram a sua Página. Apenas os 45 países com mais pessoas que curtiram a sua Página são incluídos.

day

page_fan_adds

O número de novas pessoas que curtiram a sua Página.

day

page_fan_adds_unique

O número de contas da Central de Contas que curtiram sua Página pela primeira vez. Esta métrica é estimada.

day, week, days_28

page_fan_removes

Descurtidas da sua Página.

day

page_fan_removes_unique*

Descurtidas da sua Página.

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

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_by_uploaded_hosted*

Daily video views on a page-level broken down by all variants of page-uploaded and page-hosted variants.

day, week, days_28

page_video_views_paid

O número de vezes que os vídeos promovidos da sua Página foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_organic

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_by_paid_non_paid*

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, detalhado por total, pago e não pago. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_autoplayed

O número de vezes que os vídeos da sua Página foram reproduzidos automaticamente por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_click_to_play

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_unique

O número de pessoas que visualizaram os vídeos da sua Página por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_repeat_views

O número de vezes que os vídeos da sua Página foram reproduzidos novamente por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos.

day, week, days_28

page_video_complete_views_30s

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_paid

O número de vezes que os vídeos promovidos da sua Página foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_organic

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_autoplayed

O número de vezes que os vídeos da sua Página foram reproduzidos automaticamente por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_click_to_play

O número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_unique

O número de pessoas que visualizaram os vídeos da sua Página por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_complete_views_30s_repeat_views

O número de vezes que os vídeos da sua Página foram reproduzidos novamente por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos.

day, week, days_28

post_video_complete_views_30s_autoplayed

O número de vezes que seus vídeos foram reproduzidos automaticamente por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_30s_clicked_to_play

O número de vezes que seus vídeos foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_30s_organic

O número de vezes que seus vídeos foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_30s_paid

O número de vezes que seus vídeos promovidos foram reproduzidos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_30s_unique

O número de pessoas que visualizaram seus vídeos por pelo menos 30 segundos ou por quase toda a duração deles caso tenham menos de 30 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

page_video_views_10s

Obsoleto acima da Graph API v18: o número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

day, week, days_28

page_video_views_10s_paid

Obsoleto acima da Graph API v18: o número de vezes que os vídeos promovidos da sua Página foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_10s_organic

Obsoleto acima da Graph API v18: o número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos, por alcance orgânico. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

day, week, days_28

page_video_views_10s_autoplayed

Obsoleto acima da Graph API v18: o número de vezes que os vídeos da sua Página foram reproduzidos automaticamente por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

day, week, days_28

page_video_views_10s_click_to_play

Obsoleto acima da Graph API v18: o número de vezes que os vídeos da sua Página foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_10s_unique

Obsoleto acima da Graph API v18: o número de pessoas que visualizaram os vídeos da sua Página por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, week, days_28

page_video_views_10s_repeat

Obsoleto acima da Graph API v18: o número de vezes que os vídeos da sua Página foram reproduzidos novamente por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos.

day, week, days_28

page_video_view_time

O tempo total, em milissegundos, que as pessoas visualizaram o vídeo da sua Página.

day

page_uploaded_video_play_count_by_paid_non_paid*

O número total de vezes que qualquer um dos vídeos na página começou a ser reproduzido, dividido por pago e não pago.

page_uploaded_3s_to_15s_views_rate*

Taxa de visualizações de 3 a 15 segundos. Mensurada entre todos os ativos de vídeo carregados. Inclui qualquer atividade em publicações/publicações cruzadas ou seus compartilhamentos.

page_uploaded_views_15s_count*

Número total de visualizações do vídeo para quem assistiu a no mínimo 15 segundos do vídeo da sua Página.

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*

O número de vezes que o perfil de uma Página foi visualizado por pessoas conectadas e desconectadas.

day, week, days_28

Page Video Posts

Metric Name Description Values for `period`
post_video_avg_time_watched

O tempo médio, em milissegundos, que as pessoas visualizaram os seus vídeos. Apenas disponível para vídeos criados após 25 de agosto de 2016. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_organic

O número de vezes que seus vídeos foram reproduzidos desde o início até 97% ou mais da duração deles, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_organic_unique

O número de pessoas que visualizaram seus vídeos desde o início até 97% ou mais da duração deles, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_paid

O número de vezes que seus vídeos promovidos foram reproduzidos desde o início até 97% ou mais da duração deles. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo. Retorna 0 para vídeos recompartilhados.

lifetime

post_video_complete_views_paid_unique

O número de pessoas que visualizaram seus vídeos promovidos desde o início até 97% ou mais da duração deles. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_retention_graph*

O número de vezes que seus vídeos foram reproduzidos em cada intervalo como uma porcentagem de todas as visualizações. Os vídeos são divididos em 40 intervalos iguais. Esta métrica não conta as impressões enquanto o vídeo estava sendo transmitido ao vivo. Os gráficos de retenção podem mostrar mais impressões mais tarde no vídeo do que no início. As pessoas podem iniciar o vídeo no meio, pular para frente, salvar e assisti-lo de novo desse ponto, ou apresentar outros comportamentos semelhantes.

lifetime

post_video_retention_graph_clicked_to_play

O número de vezes que seus vídeos foram reproduzidos em cada intervalo como uma porcentagem de todas as visualizações, após as pessoas clicarem em Reproduzir. Os vídeos são divididos em 40 intervalos iguais. Esta métrica não conta as impressões enquanto o vídeo estava sendo transmitido ao vivo. Os gráficos de retenção podem mostrar mais impressões mais tarde no vídeo do que no início. As pessoas podem iniciar o vídeo no meio, pular para frente, salvar e assistir novamente desse ponto, ou apresentar outros comportamentos semelhantes.

lifetime

post_video_retention_graph_autoplayed

O número de vezes que seus vídeos foram reproduzidos automaticamente em cada intervalo como uma porcentagem de todas as reproduções automáticas. Os vídeos são divididos em 40 intervalos iguais. Esta métrica não conta as impressões enquanto o vídeo estava sendo transmitido ao vivo. Os gráficos de retenção podem mostrar mais impressões mais tarde no vídeo do que no início. As pessoas podem iniciar o vídeo no meio, pular para frente, salvar e assisti-lo de novo desse ponto, ou apresentar outros comportamentos semelhantes.

lifetime

post_video_views_organic

O número de vezes que seus vídeos foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime, day

post_video_views_organic_unique

O número de pessoas que visualizaram seus vídeos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_paid

O número de vezes que seus vídeos promovidos foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime, day

post_video_views_paid_unique

O número de pessoas que visualizaram seus vídeos promovidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_length

A duração, em milissegundos, de uma publicação de vídeo.

lifetime

post_video_views

O número de vezes que seus vídeos foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo. Isso inclui as visualizações ao vivo.

lifetime, day

post_video_views_unique

O número de pessoas que visualizaram seus vídeos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

day, lifetime

post_video_views_autoplayed

O número de vezes que seus vídeos foram reproduzidos automaticamente por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_clicked_to_play

O número de vezes que seus vídeos foram reproduzidos por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_15s*

O número de vezes que seus vídeos foram reproduzidos por pelo menos 15 segundos, ou por quase toda a duração deles caso tenham menos de 15 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_60s_excludes_shorter*

O número de vezes que seus vídeos foram reproduzidos por pelo menos 60 segundos. Essa métrica é contabilizada apenas para vídeos com 60 segundos ou mais. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime, day

post_video_views_10s

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

lifetime, day

post_video_views_10s_unique

Obsoleto acima da Graph API v18: o número de pessoas que visualizaram seus vídeos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada impressão de um vídeo, contaremos as visualizações separadamente e excluiremos todo o tempo usado em repetições da reprodução dele.

lifetime

post_video_views_10s_autoplayed

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos foram reproduzidos automaticamente por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

lifetime

post_video_views_10s_clicked_to_play

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos, após as pessoas clicarem em Reproduzir. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_10s_organic

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos, por alcance orgânico. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_views_10s_paid

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos promovidos foram reproduzidos por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada impressão de vídeo, contaremos as visualizações de vídeo separadamente e excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime, day

post_video_views_10s_sound_on

Obsoleto acima da Graph API v18: o número de vezes que seus vídeos foram reproduzidos com som ativado por pelo menos 10 segundos ou por quase toda a duração deles caso tenham menos de 10 segundos. Para cada reprodução de um vídeo, excluiremos todo o tempo usado em repetições da reprodução dele.

lifetime

post_video_views_sound_on

O número de vezes que seus vídeos foram reproduzidos com som ativado por pelo menos 3 segundos ou por quase toda a duração deles caso tenham menos de 3 segundos. Para cada reprodução de vídeo, excluiremos todo o tempo usado em repetições da reprodução do vídeo.

lifetime

post_video_view_time

O tempo total, em milissegundos, que seus vídeos foram reproduzidos, incluindo vídeos reproduzidos por menos de 3 segundos e repetições da reprodução. Retorna 0 para vídeos recompartilhados.

lifetime, day

post_video_view_time_organic

O tempo total, em milissegundos, que seus vídeos foram reproduzidos por alcance orgânico. Retorna o valor 0 para vídeos recompartilhados.

lifetime, day

post_video_view_time_by_age_bucket_and_gender

O tempo total, em milissegundos, que seus vídeos foram reproduzidos para os seus Principais públicos (faixa etária e gênero).

lifetime

post_video_view_time_by_region_id

O tempo total, em milissegundos, que seus vídeos foram reproduzidos para as suas 45 Principais localizações (região e país).

lifetime, day

post_video_views_by_distribution_type

O número de vezes que seus vídeos foram reproduzidos, por tipo de distribuição; page_owned e compartilhados.

lifetime

post_video_view_time_by_distribution_type

O tempo total, em milissegundos, que seus vídeos foram reproduzidos, por tipo de distribuição; page_owned e compartilhados.

lifetime

post_video_view_time_by_country_id

O número total de minutos que seus vídeos foram reproduzidos para as suas 45 Principais localizações (país).

lifetime

post_video_views_live*

O número total de pessoas que visualizaram seu vídeo por mais de 3 segundos quando ele foi transmitido ao vivo.

lifetime

post_video_social_actions_count_unique*

O número único de ações sociais (reações, comentários, compartilhamentos) em uma publicação de vídeo.

lifetime, day

post_video_play_count*

O número de vezes que o vídeo foi reproduzido.

post_video_live_current_viewers*

O número de espectadores que estão assistindo a um vídeo ao vivo no momento. Essa métrica só retorna para as publicações ao vivo. Retorna 0 para as publicações de "fez uma transmissão ao vivo".

post_video_15s_to_60s_excludes_shorter_views_rate*

Taxa de visualizações para um vídeo de 15 a 60 s. Essa métrica de 60 segundos é contada apenas para vídeos de 60 segundos ou mais.

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*

O número de stories criados sobre a publicação da sua Página, por tipo de ação.

lifetime

post_activity_by_action_type_unique*

O número de pessoas que criaram um story sobre a publicação da sua Página, por tipo de ação.

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

Parâmetros

ParâmetroDescrição
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
Valor padrão: 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

Campos

A leitura desta borda retornará um resultado formatado em JSON:

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

data

Uma lista de nós InsightsResult.

paging

Para saber mais detalhes sobre paginação, consulte o Guia da Graph API.

Error Codes

ErroDescrição
100Invalid parameter
190Invalid OAuth 2.0 Access Token
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.
200Permissions error
3001Invalid query
104Incorrect signature

Criando

Não é possível executar esta operação neste ponto de extremidade.

Atualizando

Não é possível executar esta operação neste ponto de extremidade.

Excluindo

Não é possível executar esta operação neste ponto de extremidade.

See Also