Insight Media Instagram

Mewakili metrik interaksi sosial di objek Media Instagram.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-media-id}/insights

Mendapatkan data insight di objek Media Instagram.

Batasan

• Data insight tidak tersedia untuk media dalam Media Instagram album.
• Metrik media cerita hanya tersedia selama 24 jam, bahkan jika cerita diarsipkan atau disorot. Jika Anda ingin mendapatkan insight terbaru untuk suatu cerita sebelum kedaluwarsa, siapkan Webhooks untuk topik Instagram dan berlanggananlah ke kolom story_insights.
• Cerita dengan nilai kurang dari 5 akan menampilkan kode kesalahan 10 dengan pesan (#10) Not enough viewers for the media to show insights.
• Untuk Cerita yang dibuat oleh pengguna di Eropa dan Jepang, metrik replies sekarang akan menampilkan nilai 0.
• Untuk Cerita, balasan yang dibuat oleh pengguna di Eropa dan Jepang tidak disertakan dalam kalkulasi replies.
• Jika data insight yang Anda minta tidak ada atau saat ini tidak tersedia, API akan memberikan set data kosong, bukan 0 untuk metrik individu.
• Data yang digunakan untuk menghitung metrik mungkin tertunda hingga 48 jam.

Persyaratan

Sintaksis Permintaan

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

Parameter Jalur

Parameter String Kueri

Metrik

Metrik Album

Metrik Foto dan Video

Metrik pada media dalam album tidak didukung. Dapatkan metrik pada album sebagai gantinya.

Metrik Reels

Metrik Cerita

Contoh Permintaan

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

Contoh Tanggapan

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

Metrik Baru

Sintaksis Permintaan

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

Parameter Jalur

Parameter String Kueri

Perincian

Anda juga dapat menentukan satu atau beberapa perincian, dan hasilnya akan dipecah menjadi set yang lebih kecil berdasarkan perincian yang ditentukan. Nilai dapat berupa:

• action_type—Hanya kompatibel dengan metrik profile_activity. Memecah hasil berdasarkan komponen UI profil yang diketuk atau diklik pemirsa setelah melihat profil pengguna aplikasi. Nilai tanggapan dapat berupa:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type—Memerinci hasil berdasarkan tindakan navigasi yang diambil oleh penonton saat melihat media.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Baca tabel Metrik untuk menentukan metrik mana yang mendukung perincian, dan perincian mana yang didukung. Jika Anda meminta metrik yang tidak mendukung perincian, API akan menampilkan kesalahan ("An unknown error has occurred."), jadi berhati-hatilah jika meminta beberapa metrik dalam satu kueri.

Metrik

Metrik Postingan

Metrik berikut tersedia pada Media Instagram gambar dan video yang diterbitkan sebagai Postingan. Carousel album dan IGTV tidak didukung.

Metrik Cerita

Metrik berikut tersedia pada Media Instagram yang diterbitkan sebagai Cerita.

Tanggapan

Objek JSON yang berisi hasil kueri Anda. Hasil dapat mencakup data berikut, berdasarkan spesifikasi kueri Anda:

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

Konten Tanggapan

Contoh Permintaan Metrik Postingan

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

Contoh Tanggapan Metrik Postingan

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

Contoh Permintaan Metrik Cerita

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

Contoh Tanggapan Metrik Cerita

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

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.