IG-Medien-Insights

Stellt Kennzahlen zu sozialer Interaktion für ein IG-Medien-Objekt dar.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-media-id}/insights

Ruft Insights-Daten für ein IG-Medien-Objekt ab.

Einschränkungen

• Insights-Daten sind nicht für Medien in Album-IG Medien verfügbar.
• Kennzahlen zu Story-Medien sind nur 24 Stunden verfügbar, selbst wenn die Stories archiviert oder hervorgehoben werden. Um die aktuellsten Insights für eine Story abzurufen, bevor sie abläuft, richte einen Webhook für das Instagram-Thema ein und abonniere das story_insights-Feld.
• Für Kennzahlen zu Story-Medien mit Werten unter 5 wird der Fehlercode 10 mit der Meldung (#10) Not enough viewers for the media to show insights zurückgegeben.
• Für Stories, die von Nutzer*innen in Europa und Japan erstellt werden, gibt die replies-Kennzahl nun den Wert 0 zurück.
• Für Stories werden Antworten von Nutzer*innen in Europa und Japan nicht in die replies-Kalkulation einbezogen.
• Wenn von dir angeforderte Insights-Daten nicht existieren oder aktuell nicht verfügbar sind, gibt die API anstatt 0 für einzelne Kennzahlen einen leeren Datensatz zurück.
• Daten, die zur Berechnung von Kennzahlen verwendet werden, können sich um bis zu 48 Stunden verzögern.

Anforderungen

Anfragesyntax

GET https://graph.facebook.com/{api-version}/{ig-media-id}/insights
  ?metric={metric}
  &access_token={access-token}

Pfadparameter

Abfrage-String-Parameter

Kennzahlen

Albumkennzahlen

Foto- und Videokennzahlen

Kennzahlen zu Medien innerhalb eines Albums werden nicht unterstützt. Rufe stattdessen Kennzahlen für das Album ab.

Reel-Kennzahlen

Story-Kennzahlen

Beispielanfrage

curl -X GET \
  'https://graph.facebook.com/v19.0/17895695668004550/insights?metric=impressions,reach&access_token=IGQVJ...'

Beispielantwort

{
  "data": [
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 264
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "17855590849148465/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 103
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "17855590849148465/insights/reach/lifetime"
    }
  ]
}

Neue Kennzahlen

Anfragesyntax

GET https://graph.facebook.com/{api-version}/{ig-media-id}/insights
  ?metric={metric}
  &breakdown={breakdown}
  &access_token={access-token}

Pfadparameter

Abfrage-String-Parameter

Aufschlüsselung

Du kannst auch eine oder mehrere Aufschlüsselungen festlegen. Die Ergebnisse werden dann anhand der festgelegten Aufschlüsselung in kleinere Teile unterteilt. Zulässige Werte sind:

• action_type – Nur mit der Kennzahl „profile_activity“ kompatibel. Unterteile die Ergebnisse anhand der Profil-UI-Komponente, welche die Betrachter*innen nach dem Betrachten des Profils des*der App-Nutzer*in angetippt oder angeklickt haben. Zulässige Antwortwerte sind:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type – Unterteile die Ergebnisse anhand der Navigationshandlung, welche die*der Betrachter*in nach dem Ansehen der Medien ausgeführt hat.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Beachte die Kennzahlen-Tabelle, um festzustellen, welche Kennzahlen Aufschlüsselungen unterstützen und welche Aufschlüsselungen sie unterstützen. Wenn du eine Kennzahl anforderst, die keine Aufschlüsselungen unterstützt, gibt die API eine Fehlermeldung zurück („An unknown error has occurred.“). Sei also vorsichtig, wenn du mehrere Kennzahlen in einer einzigen Anfrage anforderst.

Kennzahlen

Beitragskennzahlen

Die folgenden Kennzahlen sind für als Beitrag veröffentlichte Bild- und Video-IG-Medien verfügbar. Album Carousels und IGTV werden nicht unterstützt.

Story-Kennzahlen

Die folgenden Kennzahlen sind für als Story veröffentlichte IG-Medien verfügbar.

Antwort

Ein JSON-Objekt, das die Ergebnisse deiner Anfrage enthält. Die Ergebnisse können je nach deiner Anfragespezifikation die folgenden Daten enthalten:

{
  "data": [
    {
      "name": "{name}",
      "period": "{period}",
      "values": [
        {
          "value": {value}
        }
      ],
      "title": "{title}",
      "description": "{description}",
      "total_value": {
        "value":{value},
        "breakdowns": [
          {
            "dimension_keys": [
              "{dimension-key-1}",
              "{dimension-key-2}"
              ...
            ],
            "results": [
              {
                "dimension_values": [
                  "dimension-value-1",
                  "dimension-value-2"
                  ...
                ],
                "value": {value}
              },
              ...
            ]
          }
        ]
      },
      "id": "{id}"
    }
  ]
}

Antwortinhalt

Beispielanfrage nach Beitragskennzahlen

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17932174733377207/insights?metric=profile_activity&breakdown=action_type&access_token=EAAOc..."

Beispielantwort mit Beitragskennzahlen

{
  "data": [
    {
      "name": "profile_activity",
      "period": "lifetime",
      "values": [
        {
          "value": 4
        }
      ],
      "title": "Profile activity",
      "description": "[IG Insights] This header is the name of a metric that appears on an educational info sheet for a particular post, story, video or promotion. This metric is the sum of all profile actions people take when they engage with this content.",
      "total_value": {
        "value": 4,
        "breakdowns": [
          {
            "dimension_keys": [
              "action_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "email"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "text"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "direction"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "bio_link_clicked"
                ],
                "value": 1
              }
            ]
          }
        ]
      },
      "id": "17932174733377207/insights/profile_activity/lifetime"
    }
  ]
}

Beispielanfrage nach Story-Kennzahlen

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17969782069736348/insights?metric=navigation&breakdown=story_navigation_action_type&access_token=EAAOc..."

Beispielantwort mit Story-Kennzahlen

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [
        {
          "value": 25
        }
      ],
      "title": "Navigation",
      "description": "This is the total number of actions taken from your story. These are made up of metrics like exited, forward, back and next story.",
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": [
              "story_navigation_action_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "tap_forward"
                ],
                "value": 19
              },
              {
                "dimension_values": [
                  "tap_back"
                ],
                "value": 4
              },
              {
                "dimension_values": [
                  "tap_exit"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "swipe_forward"
                ],
                "value": 1
              }
            ]
          }
        ]
      },
      "id": "17969782069736348/insights/navigation/lifetime"
    }
  ]
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.