API Graph versión

Métricas de estadísticas de artículos instantáneos

Este objeto representa el conjunto de métricas de estadísticas de un solo artículo instantáneo, en función de su URL canónica. Se pueden consultar métricas a nivel del artículo y métricas de recursos multimedia individuales dentro del artículo.

Para obtener más información sobre los artículos instantáneos, lee nuestra Documentación para desarrolladores sobre artículos instantáneos.

Estadísticas de artículos

El punto de conexión que se utiliza para consultar métricas a nivel del artículo se determina según la URL canónica del artículo que se consulta y la métrica que se busca. A continuación, se enumeran todas las métricas disponibles.

Explorador de la API Graph

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

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

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

Permisos

Un token de acceso a la página con el permiso read_insights puede recuperar métricas de esa página. Para obtener más información sobre los tokens de acceso a la página, consulta el documento Tokens de acceso a la página.

Parámetros

Nombre	Descripción	Tipo	Obligatorio
`id`	La URL canónica del artículo instantáneo.	`url`	`yes`
`metric`	La métrica que se solicita.	Consulta las métricas disponibles, a continuación	`yes`
`period`	Período durante el cual se agrega la métrica.	`enum{day, week, days_28, month, lifetime}`	`yes`
`since`	Límite inferior del intervalo por considerar. Valor predeterminado: `2 weeks ago`	`datetime`	`no`
`until`	Límite superior del intervalo por considerar. Valor predeterminado: `Current time`	`datetime`	`no`
`breakdown`	Resultados separados según en qué plataforma (iOS o Android) se encontró la métrica. Si no se especifica, se incluyen resultados de ambas plataformas.	`enum{platform}`	`no`

Campos

La lectura desde este perímetro devuelve un resultado con formato JSON:

{
  "data": []
}

data

Una lista de objetos InsightsQueryResult. Los siguientes campos se agregarán a cada objeto que se devuelva:

Nombre Descripción Tipo

Nombre	Descripción	Tipo
time	El comienzo del período o la hora de finalización del período total.	`datetime`
value	El recuento, promedio, relación o porcentaje de la métrica en el período.	`numeric`
breakdowns	El grupo al que el valor pertenece (es decir, cuándo se usa la métrica `all_view_durations` o si el parámetro `breakdown(platform)` se especifica explícitamente).	`map<string, string>`

time

El comienzo del período o la hora de finalización del período total.

datetime

value

El recuento, promedio, relación o porcentaje de la métrica en el período.

numeric

breakdowns

El grupo al que el valor pertenece (es decir, cuándo se usa la métrica

all_view_durations

o si el parámetro

breakdown(platform)

se especifica explícitamente).

map<string, string>

Métricas disponibles

A continuación, se muestran los períodos de agregación disponibles según las diferentes métricas. Las métricas se recopilan desde dispositivos iOS y Android.

Nombre	Descripción	Valor del período
`all_views`	Cantidad de visualizaciones	`day`
`all_view_durations`	Duración de la visualización con desglose	`week`
`all_view_durations_average`	Duración promedio de la visualización	`week`
`all_scrolls`	Profundidad de desplazamiento con desgloses	`week`
`all_scrolls_average`	Profundidad de desplazamiento promedio	`week`

Ejemplos

Visualizaciones de artículos diarias en los últimos 7 días

Para realizar una consulta de los desgloses diarios de la cantidad de visualizaciones de uno de tus artículos instantáneos en los últimos 7 días, envía la siguiente solicitud GET:

GET /v21.0/?fields=instant_article{insights.metric(all_views).period(day).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Esta solicitud devolverá la siguiente respuesta:

{
   "instant_article": {
      "insights": {
         "data": [
            {
               "time": "2015-10-28T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-30T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-31T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-11-01T08:00:00+0000",
               "value": "2"
            },
            {
               "time": "2015-11-02T08:00:00+0000",
               "value": "6"
            },
            {
               "time": "2015-11-03T08:00:00+0000",
               "value": "4"
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}

Visualizaciones de artículos diarias en los últimos 7 días, con desglose por plataforma

Para realizar una consulta de los desgloses diarios de la cantidad de visualizaciones de uno de tus artículos instantáneos en los últimos 7 días, y desglosarla también según la plataforma que se utilizó, envía la siguiente solicitud GET:

GET /v21.0/?fields=instant_article{insights.metric(all_views).breakdown(platform).period(day).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Esta solicitud devolverá la siguiente respuesta:

{
   "instant_article": {
      "insights": {
         "data": [
            {
              "time": "2015-10-28T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-28T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            },
            {
              "time": "2015-10-29T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-29T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            },
            {
              "time": "2015-10-30T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-30T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}

Duración de las visualizaciones de artículos semanales en los últimos 7 días

Para realizar una consulta de los desgloses semanales de la duración de las visualizaciones de uno de tus artículos instantáneos en los últimos 7 días, envía la siguiente solicitud GET:

GET /v21.0/?fields=instant_article{insights.metric(all_view_durations).period(week).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

Esta solicitud devolverá la siguiente respuesta. Ten en cuenta que, en esta respuesta, los datos se devuelven en grupos:

{
   "instant_article": {
      "insights": {
         "data": [
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "8",
               "breakdowns": {
                  "bucket": "15"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "2",
               "breakdowns": {
                  "bucket": "225"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "2",
               "breakdowns": {
                  "bucket": "90"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "360"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "240"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "165"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "120"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "75"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "60"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "45"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "30"
               }
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}