Versione API Graph

Metriche di insight per instant article

Questo oggetto rappresenta l'insieme di metriche di insight per un singolo instant article, in base al suo URL canonico. Le metriche a livello di articolo possono essere interrogate, così come le metriche sulle singole risorse multimediali all'interno dell'articolo.

Per maggiori informazioni su Instant Articles, leggi la nostra Documentazione per gli sviluppatori di Instant Articles.

Insight sugli articoli

L'endpoint usato per interrogare gli insight a livello di articoli è determinato dall'URL canonico dell'articolo in esame e dalla metrica che viene ricercata. Tutte le metriche disponibili sono elencate di seguito.

Tool di esplorazione per 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
}];

Autorizzazioni

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

Parametri

Nome	Descrizione	Tipo	Obbligatorio
`id`	URL canonico dell'instant article.	`url`	`yes`
`metric`	Metrica richiesta.	Consulta le metriche disponibili sotto	`yes`
`period`	Periodo di tempo rispetto al quale la metrica è aggregata.	`enum{day, week, days_28, month, lifetime}`	`yes`
`since`	Limite inferiore dell'intervallo di tempo da considerare. Periodo predefinito: `2 weeks ago`	`datetime`	`no`
`until`	Limite superiore dell'intervallo di tempo da considerare. Valore predefinito: `Current time`	`datetime`	`no`
`breakdown`	Risultati separati in base alla piattaforma (iOS o Android) su cui si è verificata la metrica. Se non specificato, i risultati includono entrambe le piattaforme.	`enum{platform}`	`no`

Campi

La lettura da questo segmento restituirà un risultato in formato JSON:

{
  "data": []
}

data

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

Nome Descrizione Tipo

Nome	Descrizione	Tipo
time	L'inizio o l'ora di fine del periodo totale.	`datetime`
value	Conteggio, media, rapporto o percentuale della metrica nel periodo.	`numeric`
breakdowns	Il gruppo a cui appartiene il valore (ovvero quando `all_view_durations` viene usata la metrica o se il `breakdown(platform)` parametro è specificato in modo esplicito).	`map<string, string>`

time

L'inizio o l'ora di fine del periodo totale.

datetime

value

Conteggio, media, rapporto o percentuale della metrica nel periodo.

numeric

breakdowns

Il gruppo a cui appartiene il valore (ovvero quando

all_view_durations

viene usata la metrica o se il

breakdown(platform)

parametro è specificato in modo esplicito).

map<string, string>

Metriche disponibili

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

Nome	Descrizione	Valore per il periodo
`all_views`	Numero di visualizzazioni	`day`
`all_view_durations`	Durata della visualizzazione con i dettagli	`week`
`all_view_durations_average`	Durata media della visualizzazione	`week`
`all_scrolls`	Profondità di scorrimento con i dettagli	`week`
`all_scrolls_average`	Profondità di scorrimento media	`week`

Esempi

Visualizzazioni giornaliere degli articoli negli ultimi 7 giorni

Per interrogare i dettagli giornalieri del numero di visualizzazioni di uno dei tuoi instant article negli ultimi 7 giorni, invia la seguente richiesta 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

Questa richiesta restituirà la seguente risposta:

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

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

Per interrogare i dettagli giornalieri del numero di visualizzazioni di uno dei tuoi instant article negli ultimi 7 giorni, ulteriormente suddivisi in base alla piattaforma su cui sono stati visualizzati, invia la seguente richiesta 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

Questa richiesta restituirà la seguente risposta:

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

Durata delle visualizzazioni settimanali degli articoli negli ultimi 7 giorni

Per interrogare i dettagli settimanali della durata delle visualizzazioni raggruppate di uno dei tuoi instant article negli ultimi 7 giorni, invia la seguente richiesta 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

Questa richiesta restituirà la seguente risposta. Tieni presente che i dati restituiti in questa risposta sono raggruppati:

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