Metriche sugli insight di instant article aggregati

Questo oggetto rappresenta l'insieme di metriche relative agli insight aggregate per tutti gli instant article pubblicati da una Pagina Facebook. Per maggiori informazioni su Instant Articles, leggi la nostra Documentazione per gli sviluppatori di Instant Articles.

Lettura

Questo endpoint è composto dall'ID della Pagina e dalla metrica cercata. Tutte le metriche disponibili sono elencate sotto.

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
}];

Autorizzazioni

• Un token d'accesso della Pagina con l'autorizzazione read_insights può recuperare le metriche per quella Pagina. Per maggiori informazioni sui token d'accesso della Pagina, consulta la nostra documentazione Token d'accesso della Pagina.

Parametri

Campi

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

{
  "data": []
}

data

Una lista di oggetti InsightsQueryResult. I seguenti campi saranno aggiunti ad ogni oggetto restituito:

Metriche disponibili

Di seguito sono riportati i periodi di aggregazione disponibili per diverse metriche. Le metriche sono raccolte sia da dispositivi iOS che Android.

Esempi

Visualizzazioni giornaliere degli articoli negli ultimi 7 giorni

Per interrogare i dettagli giornalieri del numero di visualizzazioni di tutti gli instant article della tua Pagina negli ultimi 7 giorni, invia la seguente richiesta GET:

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

Questa richiesta restituirà la seguente risposta:

{
   "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>"
}

Visualizzazioni giornaliere degli articoli negli ultimi 7 giorni con dettagli della piattaforma

Per interrogare i dettagli giornalieri del numero di visualizzazioni di tutti gli instant article della tua Pagina negli ultimi 7 giorni, ulteriormente suddivisi in base alla piattaforma su cui sono stati visualizzati, invia la seguente richiesta GET:

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

Questa richiesta restituirà la seguente risposta:

{
   "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>"
}

Profondità di scorrimento settimanale degli articoli negli ultimi 7 giorni

Per interrogare i dettagli settimanali delle profondità di scorrimento raggruppate di tutti gli instant article della tua Pagina negli ultimi 7 giorni, invia la seguente richiesta GET:

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

Questa richiesta restituirà la seguente risposta. Tieni presente che i dati restituiti in questa risposta sono raggruppati. I visitatori all'interno della finestra richiesta vengono restituiti tramite valore e percentuali di profondità di scorrimento in base al gruppo:

{
   "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>"
}