Indicateurs relatifs aux statistiques des Instant Articles agrégés

Cet objet représente l’ensemble des indicateurs relatifs aux statistiques agrégés de la totalité des Instant Articles qui ont été publiés par une Page Facebook. Pour plus d’informations sur la fonctionnalité Instant Articles, consultez notre documentation développeur concernant Instant Articles.

Lecture

Ce point de terminaison se compose de l’ID de Page et de l’indicateur recherché. Tous les indicateurs disponibles sont répertoriés ci-après.

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(metric-name) 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(
    '/{page-id}?fields=instant_articles_insights.metric(metric-name)',
    '{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(
    "/{page-id}?fields=instant_articles_insights.metric(metric-name)",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}?fields=instant_articles_insights.metric(metric-name)",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}?fields=instant_articles_insights.metric(metric-name)"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Autorisations

• Un token d’accès de Page doté de l’autorisation read_insights peut récupérer les indicateurs concernant cette Page. Pour plus d’informations sur les tokens d’accès de Page, consultez notre documentation relative aux Tokens d’accès de Page.

Paramètres

Champs

La lecture à partir de cette arête renverra un résultat au format JSON :

{
  "data": []
}

data

Liste des objets InsightsQueryResult. Les champs suivants seront ajoutés à chaque objet renvoyé :

Indicateurs disponibles

Le tableau ci-après présente les périodes d’agrégation disponibles pour les différents indicateurs. Les indicateurs sont collectés à partir des appareils iOS et Android.

Exemples

Vues quotidiennes des articles sur les 7 derniers jours

Pour demander les répartitions quotidiennes du nombre de vues de tous les Instant Articles à partir de votre Page au cours des 7 derniers jours, exécutez la requête GET suivante :

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_views).period(day).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Cette requête renverra la réponse suivante :

{
   "instant_articles_insights": {
      "data": [
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "224067"
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "467846"
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "849467"
        },
        {
          "time": "2015-12-03T08:00:00+0000",
          "value": "188502"
        },
        {
          "time": "2015-12-04T08:00:00+0000",
          "value": "321942"
        },
        {
          "time": "2015-12-05T08:00:00+0000",
          "value": "622841"
        },
        {
          "time": "2015-12-06T08:00:00+0000",
          "value": "198124"
        }
      ]
   },
   "id": "<page-id>"
}

Vues quotidiennes des articles sur les 7 derniers jours avec répartition par plateforme

Pour demander les répartitions quotidiennes du nombre de vues de tous les Instant Articles à partir de votre Page au cours des 7 derniers jours, ainsi que leur répartition par plateforme de consultation, exécutez la requête GET suivante :

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_views).breakdown(platform).period(day).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Cette requête renverra la réponse suivante :

{
   "instant_articles_insights": {
      "data": [
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "112033",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "112034",
          "breakdowns": {
            "platform": "IOS"
          }
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "233923",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "233923",
          "breakdowns": {
            "platform": "IOS"
          }
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "424733",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "424734",
          "breakdowns": {
            "platform": "IOS"
          }
        }
      ]
   },
   "id": "<page-id>"
}

Profondeurs de défilement hebdomadaires des articles sur les 7 derniers jours

Pour demander les répartitions hebdomadaires des profondeurs de défilement décomposées de tous les Instant Articles à partir de votre Page au cours des 7 derniers jours, exécutez la requête GET suivante :

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_scrolls).period(week).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Cette requête renverra la réponse suivante. Notez que les données renvoyées dans cette réponse sont décomposées. Le nombre de visiteurs au cours de la période demandée est indiqué par l’objet « value », tandis que les pourcentages de profondeur de défilement sont renvoyés par l’objet « bucket » :

{
   "instant_articles_insights": {
    "data": [
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "334606",
        "breakdowns": {
          "bucket": "100"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "27339",
        "breakdowns": {
          "bucket": "94"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26746",
        "breakdowns": {
          "bucket": "95"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26727",
        "breakdowns": {
          "bucket": "93"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26512",
        "breakdowns": {
          "bucket": "96"
        }
      }
     ]
   }, 
   "id": "<page-id>"
}