Insights-Kennzahlen von aggregierten Instant Articles

Dieses Objekt stellt die Menge der aggregierten Insights-Kennzahlen aller Instant Articles dar, die von einer Facebook-Seite veröffentlicht wurden. Weitere Informationen zu Instant Articles findest du in unserer Entwicklerdokumentation über Instant Articles.

Lesen

Dieser Endpunkt besteht aus der Seiten-ID und der abgerufenen Kennzahl. Alle verfügbaren Kennzahlen sind unten aufgeführt.

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

Berechtigungen

• Ein Seiten-Zugriffsschlüssel mit der read_insights-Berechtigung kann Kennzahlen für diese Seite abrufen. Weitere Informationen zu Seiten-Zugriffsschlüsseln findest du in unserer Dokumentation über Seiten-Zugriffsschlüssel.

Parameter

Felder

Das Lesen von dieser Edge gibt ein JSON-formatiertes Ergebnis zurück:

{
  "data": []
}

data

Eine Liste von InsightsQueryResultObjekten. Die folgenden Felder werden jedem zurückgegebenen Objekt hinzugefügt:

Verfügbare Kennzahlen

Im Folgenden sind die verfügbaren Aggregationszeiträume für die jeweiligen Kennzahlen aufgeführt. Die Kennzahlen werden sowohl von iOS als auch Android gesammelt.

Beispiele

Tägliche Artikelaufrufe der letzten sieben Tage

Um tägliche Aufschlüsselungen der Anzahl der Aufrufe von Instant Articles deiner Seite der letzten sieben Tage abzurufen, sende die folgende GET-Anfrage:

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

Diese Anfrage gibt die folgende Antwort zurück:

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

Tägliche Artikelaufrufe der letzten sieben Tage mit Plattform-Aufschlüsselung

Um tägliche Aufschlüsselungen der Anzahl der Aufrufe von Instant Articles deiner Seite der letzten sieben Tage abzurufen, die zusätzlich Aufschlüsselungen zu den Plattformen enthalten, von denen die Aufrufe getätigt wurden, sende die folgende GET-Anfrage:

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

Diese Anfrage gibt die folgende Antwort zurück:

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

Wöchentliche Artikel-Scroll-Tiefe der letzten sieben Tage

Um wöchentliche Aufschlüsselungen der in Buckets befindlichen Scroll-Tiefen der Instant Articles deiner Seite der letzten sieben Tage abzurufen, sende die folgende GET-Anfrage:

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

Diese Anfrage gibt die folgende Antwort zurück: Beachte, dass die zurückgegebenen Daten in dieser Antwort sich in Buckets befinden. Besucher innerhalb des angeforderten Zeitraums werden über „value“ und Scroll-Tiefe-Prozentsätze über „bucket“ zurückgegeben:

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