Versione API Graph
Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 11 set
Aggiornamento Italiano: 26 ott 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.

Lettura

Get metrics for Pages or Page posts.

Nuova esperienza della Pagina

This endpoint is supported for Nuova esperienza della Pagina.

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
}];
Se desideri scoprire come usare l'API Graph, leggi la nostra Guida per l'utilizzo dell'API Graph.

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
}];
Se desideri scoprire come usare l'API Graph, leggi la nostra Guida per l'utilizzo dell'API Graph.

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

Il numero di utenti che hanno effettuato l'accesso a Facebook e hanno visto le tab sulla tua Pagina. (See possible types)

day, week

page_tab_views_login_top

Il numero di volte in cui gli utenti connessi a Facebook hanno visto le tab sulla tua Pagina. (See possible types)

day, week

page_tab_views_logout_top

Il numero di volte in cui gli utenti che non hanno effettuato l'accesso a Facebook hanno visto le tab sulla tua Pagina. (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

Il numero di clic sulle informazioni di contatto della tua Pagina e sul pulsante di call to action.

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*

Il numero di volte in cui le persone hanno interagito con i tuoi post tramite reazioni, commenti, condivisioni e altro.

day, week, days_28

page_fan_adds_by_paid_non_paid_unique

Il numero di account del Centro gestione account che hanno messo "Mi piace" alla tua Pagina per la prima volta, suddivisi in base al fatto che il "Mi piace" sulla Pagina sia attributo ai contenuti organici o a pagamento. Questa metrica è una stima.

day

page_lifetime_engaged_followers_unique*

Qualcuno che segue la tua Pagina e che, negli ultimi 14 giorni, ha guardato almeno una delle tue dirette o dei tuoi video registrati in precedenza per almeno 1 minuto e/o ha interagito con i tuoi contenuti video almeno una volta tramite commento, condivisione, reazione o "Mi piace".

page_daily_follows*

Il numero di volte in cui qualcuno ha iniziato a seguire la tua Pagina o il tuo profilo Facebook nel periodo di tempo selezionato.

day

page_daily_follows_unique*

Il numero di account del Centro gestione account che hanno iniziato a seguire la tua Pagina nel periodo di tempo selezionato. Questa metrica è una stima.

day, week, days_28

page_daily_unfollows_unique*

Il numero di account del Centro gestione account che hanno smesso di seguire la tua Pagina nel periodo di tempo selezionato. Questa metrica è una stima.

day, week, days_28

page_follows*

Il numero di follower della tua Pagina o del tuo profilo Facebook. La metrica è calcolata come il numero di follower meno il numero di persone che hanno smesso di seguire la tua Pagina o il tuo profilo Facebook dalla data di creazione.

day

Page Impressions

Metric Name Description Values for `period`
page_impressions*

Il numero di volte in cui un contenuto della tua Pagina o relativo alla tua Pagina è stato visualizzato sullo schermo di una persona. Sono inclusi i post, le storie, le inserzioni e altri contenuti o informazioni presenti sulla tua Pagina.

day, week, days_28

page_impressions_unique*

Il numero di persone a cui è apparso nello schermo un contenuto della tua Pagina o relativo ad essa. Sono inclusi i post, le registrazioni, le inserzioni, le informazioni social delle persone che interagiscono con la tua Pagina e altro. Questa metrica è una stima.

day, week, days_28

page_impressions_paid*

Il numero di volte in cui un contenuto di un post o di una storia della tua Pagina o relativo a essa è apparso nello schermo di una persona tramite la distribuzione a pagamento, ad esempio tramite un'inserzione.

day, week, days_28

page_impressions_paid_unique*

Il numero di account del Centro gestione account che hanno visto le tue inserzioni almeno una volta. La copertura è diversa dalle impression, che potrebbero includere più visualizzazioni delle tue inserzioni da parte degli stessi account del Centro gestione account. Questa metrica è una stima.

day, week, days_28

page_impressions_viral*

Il numero di volte in cui un contenuto della tua Pagina o relativo a essa è apparso nello schermo di una persona con informazioni social. Le informazioni social mostrano quando un amico di una persona ha interagito con la tua Pagina, il tuo post o la tua storia. Queste interazioni comprendono quando un amico di una persona mette "Mi piace" alla tua Pagina o la segue, interagisce con un post, condivide una foto della tua Pagina e si registra nella Pagina. Questa metrica è in fase di sviluppo.

day, week, days_28

page_impressions_viral_unique*

Questa metrica conteggia la copertura della distribuzione organica o a pagamento dei contenuti della tua Pagina Facebook e della tua Pagina quando sono stati mostrati con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. La copertura viene conteggiata una sola volta se è generata sia dalla distribuzione organica che da quella a pagamento. Questa metrica è una stima e in fase di sviluppo.

day, week, days_28

page_impressions_nonviral*

Il numero di volte in cui i contenuti della tua Pagina Facebook e della tua Pagina sono stati visualizzati sullo schermo, escluso quando sono stati mostrati con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. Questa metrica è in fase di sviluppo.

day, week, days_28

page_impressions_nonviral_unique*

Questa metrica conteggia la copertura della distribuzione organica o a pagamento dei contenuti della tua Pagina Facebook e della tua Pagina, escluso quando sono stati mostrati con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. Questa metrica è una stima e in fase di sviluppo.

day, week, days_28

Page Posts

Metric Name Description Values for `period`
page_posts_impressions*

Il numero di volte in cui i post della tua Pagina sono apparsi nello schermo di una persona. I post includono stati, foto, link, video e altro.

day, week, days_28

page_posts_impressions_unique*

Il numero di persone a cui è apparso nello schermo un post della tua Pagina. I post includono stati, foto, link, video e altro.

day, week, days_28

page_posts_impressions_paid*

Il numero di volte in cui i contenuti della tua Pagina Facebook e della tua Pagina sono stati visualizzati sullo schermo, attribuite alle tue inserzioni.

day, week, days_28

page_posts_impressions_paid_unique*

Il numero di account del Centro gestione account che hanno visto uno dei post della tua Pagina almeno una volta, attribuiti alle tue inserzioni.

day, week, days_28

page_posts_impressions_organic_unique*

Il numero di persone a cui è apparso nello schermo un post della tua Pagina tramite la distribuzione non a pagamento.

day, week, days_28

page_posts_served_impressions_organic_unique

Il numero di persone nel cui feed sono stati posizionati i post della tua Pagina, indipendentemente dal fatto che li abbiano visualizzati sul proprio schermo o meno. I post includono stati, foto, link, video e altro.

day, week, days_28

page_posts_impressions_viral*

Il numero di volte in cui i post della tua Pagina sono apparsi nello schermo di una persona con informazioni social. Le informazioni social mostrano quando un amico di una persona ha interagito con la tua Pagina o il tuo post. Queste interazioni comprendono quando un amico di una persona mette "Mi piace" alla tua Pagina o la segue, interagisce con un post, condivide una foto della tua Pagina e si registra nella Pagina.

day, week, days_28

page_posts_impressions_viral_unique*

Il numero di persone a cui è apparso nello schermo un post della tua Pagina con informazioni social. Come forma di distribuzione organica, le informazioni social mostrano quando un amico di una persona ha interagito con la tua Pagina o un tuo post. Queste interazioni comprendono quando un amico di una persona mette "Mi piace" alla tua Pagina o la segue, interagisce con un post, condivide una foto della tua Pagina e si registra nella Pagina.

day, week, days_28

page_posts_impressions_nonviral*

Il numero di volte in cui i post della tua Pagina sono apparsi nello schermo di una persona. Non sono inclusi i contenuti creati sulla tua Pagina con informazioni social. Le informazioni social mostrano quando un amico di una persona ha interagito con la tua Pagina o il tuo post. Queste interazioni comprendono quando un amico di una persona mette "Mi piace" alla tua Pagina o la segue, interagisce con un post, condivide una foto della tua Pagina e si registra nella Pagina.

day, week, days_28

page_posts_impressions_nonviral_unique*

Il numero di persone a cui è apparso nello schermo un post della tua Pagina. Non sono inclusi i contenuti creati sulla tua Pagina con informazioni social. Come forma di distribuzione organica, le informazioni social mostrano quando un amico di una persona ha interagito con la tua Pagina o il tuo post. Queste interazioni comprendono quando un amico di una persona mette "Mi piace" alla tua Pagina o la segue, interagisce con un post, condivide una foto della tua Pagina e si registra nella Pagina.

day, week, days_28

Page Post Engagement

Metric Name Description Values for `period`
post_clicks*

Il numero di volte in cui le persone hanno cliccato in un punto qualsiasi dei tuoi post senza generare una notizia.

lifetime

post_clicks_by_type*

Il numero di volte in cui le persone hanno cliccato in un punto qualsiasi dei tuoi post senza generare una notizia, per tipo di 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*

Il numero di volte in cui il post della tua Pagina è apparso nello schermo di una persona. I post includono stati, foto, link, video e altro.

lifetime

post_impressions_unique*

Il numero di persone a cui è apparso nello schermo il post della tua Pagina. I post includono stati, foto, link, video e altro. Questa metrica è una stima.

lifetime

post_impressions_paid*

Il numero di volte in cui i contenuti della tua Pagina sono stati visualizzati sullo schermo, attribuite alle tue inserzioni.

lifetime

post_impressions_paid_unique*

Il numero di account del Centro gestione account che hanno visto il tuo post almeno una volta, attribuiti alle tue inserzioni. Questa metrica è una stima.

lifetime

post_impressions_fan*

Il numero di volte in cui i contenuti della tua Pagina sono stati visualizzati sullo schermo per gli account che hanno iniziato a seguire la tua Pagina o che hanno messo "Mi piace".

lifetime

post_impressions_fan_unique*

Il numero di account del Centro gestione account che hanno iniziato a seguire la tua Pagina o che hanno messo "Mi piace". Questa metrica è una stima.

lifetime

post_impressions_organic*

Il numero di volte in cui il tuo post è stato visualizzato sullo schermo tramite distribuzione organica.

lifetime

post_impressions_organic_unique*

Questa metrica conteggia la copertura della distribuzione organica dei tuoi contenuti di Facebook, inclusi post, storie e inserzioni. La copertura delle condivisioni viene conteggiata solo per i contenuti organici. Sono compresi i casi in cui i tuoi contenuti vengono condivisi come storia o repost. Questa metrica è una stima.

lifetime

post_impressions_viral*

Il numero di volte in cui i contenuti della tua Pagina sono stati visualizzati sullo schermo con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. Questa metrica è in fase di sviluppo.

lifetime

post_impressions_viral_unique*

Questa metrica conteggia la copertura quando i tuoi contenuti di Facebook sono stati condivisi come repost o storia. La copertura delle condivisioni viene conteggiata solo per la distribuzione organica. Questa metrica è una stima e in fase di sviluppo.

lifetime

post_impressions_nonviral*

Il numero di volte in cui i contenuti della tua Pagina sono stati visualizzati sullo schermo, escluso quando i tuoi contenuti sono stati mostrati con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. Questa metrica è in fase di sviluppo.

lifetime

post_impressions_nonviral_unique*

Questa metrica conteggia la copertura della distribuzione organica o a pagamento dei contenuti della tua Pagina, escluso quando sono stati mostrati con informazioni social allegate. Le informazioni social vengono mostrate nel feed dopo che qualcuno interagisce con la tua Pagina, il tuo post o la tua storia. La copertura viene conteggiata una sola volta se è generata sia dalla distribuzione organica che da quella a pagamento. Questa metrica è una stima e in fase di sviluppo.

lifetime

Page Post Reactions

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

Metric Name Description Values for `period`
post_reactions_like_total

Numero totale di "Mi piace" di un post.

lifetime

post_reactions_love_total

Numero totale di reazioni "Love" di un post.

lifetime

post_reactions_wow_total

Numero totale di reazioni "Wow" di un post.

lifetime

post_reactions_haha_total

Numero totale di reazioni "Ahah" di un post.

lifetime

post_reactions_sorry_total

Numero totale di reazioni "Sigh" di un post.

lifetime

post_reactions_anger_total

Numero totale di reazioni "Argh" di un post.

lifetime

post_reactions_by_type_total

Totale delle reazioni ai post per 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*

Il numero totale giornaliero di reazioni "Mi piace" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_love_total*

Il numero totale giornaliero di reazioni "Love" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_wow_total*

Il numero totale giornaliero di reazioni "Wow" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_haha_total*

Il numero totale giornaliero di reazioni "Ahah" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_sorry_total*

Numero totale giornaliero di reazioni "Sigh" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_anger_total*

Numero totale giornaliero di reazioni "Grrr" a un post di una Pagina.

day, week, days_28

page_actions_post_reactions_total

Il numero totale giornaliero di reazioni a un post di una Pagina, per tipo.

day

Page User Demographics

Metric Name Description Values for `period`
page_fans

Il numero totale di persone a cui piace la tua Pagina.

day

page_fans_locale

Dati aggregati sulla lingua relativi alle persone a cui piace la tua Pagina e basati sull'impostazione predefinita della lingua selezionata quando effettui l'accesso a Facebook.

day

page_fans_city

Dati aggregati di localizzazione su Facebook, ordinati per città e relativi alle persone a cui piace la tua Pagina.

day

page_fans_country

Il numero di persone, aggregate in base al Paese, a cui piace la tua Pagina. Sono inclusi solo i 45 Paesi con il maggior numero di persone a cui piace la tua Pagina.

day

page_fan_adds

Il numero di nuove persone a cui piace la tua Pagina.

day

page_fan_adds_unique

Il numero di account del Centro gestione account che hanno messo "Mi piace" alla tua Pagina per la prima volta. Questa metrica è una stima.

day, week, days_28

page_fan_removes

I "Non mi piace più" sulla tua Pagina.

day

page_fan_removes_unique*

I "Non mi piace più" sulla tua Pagina.

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

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_by_uploaded_hosted*

Visualizzazioni del video giornaliere a livello di Pagina suddivise per tutte le varianti caricate e tutte le varianti ospitate della Pagina.

day, week, days_28

page_video_views_paid

Il numero di volte in cui i video promossi della tua Pagina sono stati riprodotti per almeno 3 secondi o per quasi tutta la loro durata se inferiore a 3 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_organic

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_by_paid_non_paid*

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, suddivisi per totali, a pagamento e non a pagamento. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_autoplayed

Il numero di volte in cui i video della tua Pagina sono stati riprodotti automaticamente per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_click_to_play

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_unique

Il numero di persone che hanno visualizzato i video della tua Pagina per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_repeat_views

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi.

day, week, days_28

page_video_complete_views_30s

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_paid

Il numero di volte in cui i video promossi della tua Pagina sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_organic

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_autoplayed

Il numero di volte in cui i video della tua Pagina sono stati riprodotti automaticamente per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_click_to_play

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_unique

Il numero di persone che hanno visualizzato i video della tua Pagina per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_complete_views_30s_repeat_views

Il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi.

day, week, days_28

post_video_complete_views_30s_autoplayed

Il numero di volte in cui i tuoi video sono stati riprodotti automaticamente per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Durante una singola riproduzione di un video, escluderemo il tempo impiegato a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_30s_clicked_to_play

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_30s_organic

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_30s_paid

Il numero di volte in cui i tuoi video promossi sono stati riprodotti per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_30s_unique

Il numero di persone che hanno visualizzato i tuoi video per almeno 30 secondi, o per quasi tutta la loro durata se inferiore a 30 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

page_video_views_10s

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video della tua pagina sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_paid

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video promossi della tua Pagina sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_organic

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_autoplayed

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video della tua Pagina sono stati riprodotti automaticamente per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_click_to_play

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video della tua Pagina sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_unique

Obsoleta a partire dalla v18 dell'API Graph: il numero di persone che hanno visualizzato i video della tua Pagina per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, week, days_28

page_video_views_10s_repeat

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i video della tua Pagina sono stati riprodotti ripetutamente per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi.

day, week, days_28

page_video_view_time

Il tempo totale, in millisecondi, trascorso dalle persone a visualizzare il video della tua Pagina.

day

page_uploaded_3s_to_15s_views_rate*

Tasso di visualizzazioni comprese tra 3 e 15 secondi. Si misura su tutte le risorse video caricate. Include tutte le attività sui post/cross-posting o le relative condivisioni.

page_uploaded_views_15s_count*

Numero totale di visualizzazioni del video da parte di persone che hanno guardato almeno 15 secondi del video della tua Pagina.

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*

Il numero di volte in cui il profilo di una Pagina è stato visualizzato da persone che avevano effettuato l'accesso e da persone che non lo avevano effettuato.

day, week, days_28

Page Video Posts

Metric Name Description Values for `period`
post_video_avg_time_watched

Il tempo medio, in millisecondi, trascorso dalle persone a visualizzare i tuoi video. Disponibile solo per i video creati dopo il 25 agosto 2016. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_organic

Il numero di volte in cui i tuoi video sono stati riprodotti dall'inizio al 97%, o più, della loro durata, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_organic_unique

Il numero di persone che hanno visualizzato i tuoi video dall'inizio al 97%, o più, della loro durata, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_paid

Il numero di volte in cui i tuoi video promossi sono stati riprodotti dall'inizio al 97%, o più, della loro durata. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video. Il valore dei video ricondivisi è 0.

lifetime

post_video_complete_views_paid_unique

Il numero di persone che hanno visualizzato i tuoi video promossi dall'inizio al 97%, o più, della loro durata. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_retention_graph*

Il numero di volte in cui i tuoi video sono stati riprodotti a ogni intervallo come percentuale di tutte le visualizzazioni. I video sono suddivisi in 40 intervalli uguali. Questa metrica non calcola le impression ottenute mentre il video era in diretta. I grafici relativi al mantenimento potrebbero mostrare più impression più avanti nel video rispetto alla parte iniziale. Le persone potrebbero avviare il video nel mezzo, andare avanti, salvarlo e guardarlo nuovamente da quel punto o avere altri comportamenti simili.

lifetime

post_video_retention_graph_clicked_to_play

Il numero di volte in cui i tuoi video sono stati riprodotti a ogni intervallo come percentuale di tutte le visualizzazioni, dopo che le persone hanno cliccato per riprodurre. I video sono suddivisi in 40 intervalli uguali. Questa metrica non calcola le impression ottenute mentre il video era in diretta. I grafici sul mantenimento potrebbero mostrare più impression più avanti nel video rispetto all'inizio. Le persone potrebbero avviare il video nel mezzo, andare avanti, salvarlo e guardarlo nuovamente da quel punto o avere altri comportamenti simili.

lifetime

post_video_retention_graph_autoplayed

Il numero di volte in cui i tuoi video sono stati riprodotti automaticamente a ogni intervallo come percentuale di tutte le visualizzazioni automatiche. I video sono suddivisi in 40 intervalli uguali. Questa metrica non calcola le impression ottenute mentre il video era in diretta. I grafici relativi al mantenimento potrebbero mostrare più impression più avanti nel video rispetto alla parte iniziale. Le persone potrebbero avviare il video nel mezzo, andare avanti, salvarlo e guardarlo nuovamente da quel punto o avere altri comportamenti simili.

lifetime

post_video_views_organic

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime, day

post_video_views_organic_unique

Il numero di persone che hanno visualizzato i tuoi video per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_paid

Il numero di volte in cui i tuoi video promossi sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

lifetime, day

post_video_views_paid_unique

Il numero di persone che hanno visualizzato i tuoi video promossi per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_length

La durata, in millisecondi, di un post con video.

lifetime

post_video_views

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video. Sono incluse le visualizzazioni in diretta.

lifetime, day

post_video_views_unique

Il numero di persone che hanno visualizzato i tuoi video per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

day, lifetime

post_video_views_autoplayed

Il numero di volte in cui i tuoi video sono stati riprodotti automaticamente per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_clicked_to_play

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_15s*

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 15 secondi, o per quasi tutta la loro durata se inferiore a 15 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_60s_excludes_shorter*

Il numero di volte in cui i tuoi video sono stati riprodotti per almeno 60 secondi. Questa metrica viene calcolata solo per i video di durata pari o superiore a 60 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime, day

post_video_views_10s

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime, day

post_video_views_10s_unique

Obsoleta a partire dalla v18 dell'API Graph: il numero di persone che hanno visualizzato i tuoi video per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_10s_autoplayed

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video sono stati riprodotti automaticamente per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_10s_clicked_to_play

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi, dopo che le persone hanno cliccato per riprodurli. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_10s_organic

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi, tramite copertura organica. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_10s_paid

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video promossi sono stati riprodotti per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Per ogni impression di un video, calcoleremo le visualizzazioni del video separatamente ed escluderemo il tempo trascorso a riguardare il video.

lifetime, day

post_video_views_10s_sound_on

Obsoleta a partire dalla v18 dell'API Graph: il numero di volte in cui i tuoi video sono stati riprodotti con l'audio attivo per almeno 10 secondi, o per quasi tutta la loro durata se inferiore a 10 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_views_sound_on

Il numero di volte in cui i tuoi video sono stati riprodotti con l'audio attivato per almeno 3 secondi, o per quasi tutta la loro durata se inferiore a 3 secondi. Durante una singola riproduzione di un video, escluderemo il tempo trascorso a riguardare il video.

lifetime

post_video_view_time

Il tempo totale, in millisecondi, in cui i tuoi video sono stati riprodotti, compresi i video riprodotti per meno di 3 secondi. Il valore dei video ricondivisi è 0.

lifetime, day

post_video_view_time_organic

Il tempo totale, in millisecondi, in cui i tuoi video sono stati riprodotti, tramite copertura organica. Il valore dei video ricondivisi è 0.

lifetime, day

post_video_view_time_by_age_bucket_and_gender

Il tempo totale, in millisecondi, in cui i tuoi video sono stati riprodotti per il tuo pubblico principale, per età e genere.

lifetime

post_video_view_time_by_region_id

Il tempo totale, in millisecondi, in cui i tuoi video sono stati riprodotti per i tuoi 45 luoghi principali, area - Paese.

lifetime, day

post_video_views_by_distribution_type

Il numero di volte in cui i tuoi video sono stati riprodotti per tipo di distribuzione: page_owned e shared.

lifetime

post_video_view_time_by_distribution_type

Il tempo totale, in millisecondi, in cui i tuoi video sono stati riprodotti per tipo di distribuzione: page_owned e shared.

lifetime

post_video_view_time_by_country_id

Il numero totale di minuti in cui i tuoi video sono stati riprodotti per i tuoi 45 luoghi principali; Paese.

lifetime

post_video_views_live*

Totale: il numero di persone che hanno visualizzato il tuo video per più di 3 secondi durante lo streaming in diretta.

lifetime

post_video_social_actions_count_unique*

Il numero unico di azioni social (reazioni, commenti, condivisioni) su un post con video.

lifetime, day

post_video_live_current_viewers*

Il numero di spettatori che stanno guardando un video in diretta al momento. Questa metrica viene fornita solo per i post in diretta. Per i post di dirette precedenti, questo valore è pari a 0.

post_video_15s_to_60s_excludes_shorter_views_rate*

Tasso di visualizzazioni comprese tra 15 e 60 secondi per un video. Questa metrica viene calcolata solo per i video di durata pari o superiore a 60 secondi.

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*

Il numero di notizie create su un post della tua Pagina, per tipo di azione.

lifetime

post_activity_by_action_type_unique*

Il numero di persone che hanno creato una notizia sul post della tua Pagina, per tipo di azione.

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

Parametri

ParametroDescrizione
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
Valore predefinito: 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

Campi

La lettura da questo segmento fornirà un risultato formattato JSON:

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

data

Una lista di nodi InsightsResult.

paging

Per ulteriori dettagli sulla paginazione, consulta la Guida su API Graph.

Error Codes

ErroreDescrizione
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

Creazione

Non puoi eseguire questa operazione in questo endpoint.

Aggiornamento

Non puoi eseguire questa operazione in questo endpoint.

Eliminazione

Non puoi eseguire questa operazione in questo endpoint.

See Also