Insight Pengguna Instagram

Mewakili metrik interaksi sosial seorang Pengguna Instagram.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}/insights

Mengembalikan insight tentang Pengguna Instagram.

Batasan

• follower_count, online_followers, dan semua audience_* tidak tersedia pada Pengguna Instagram dengan pengikut kurang dari 100.
• Data insight untuk metrik online_followers hanya tersedia selama 30 hari terakhir.
• Jika data insight yang Anda minta tidak ada atau saat ini tidak tersedia, API akan memberikan set data kosong dan bukan 0 untuk metrik individu.
• Metrik demografi hanya menampilkan 45 pemain populer (misalnya: untuk audience_city, hingga 45 kota dengan jumlah pengikut tertinggi dapat ditampilkan).
• Hanya pemirsa yang data demografinya kami miliki yang digunakan dalam penghitungan metrik demografi.
• Menjumlahkan nilai metrik demografi dapat menghasilkan nilai yang kurang dari jumlah pengikut (lihat poin-poin sebelumnya).
• Metrikaudience_* tidak mendukung parameter rentangsince dan until.
• Data yang digunakan untuk menghitung metrik mungkin tertunda hingga 48 jam.

Persyaratan

Sintaksis Permintaan

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

Parameter Jalur

Parameter String Kueri

Metrik dan Periode

Metrik yang mendukung lifetime hasilnya akan diberikan dalam array periode 24 jam, dengan periode berakhir pada UTC−07:00. Metrik audience_* tidak mendukung parameter rentangsince dan until.

Rentang

Edge ini mendukung paginasi berbasis waktu, jadi Anda dapat menyertakan parameter since dan until dengan cap waktu Unix untuk menentukan rentang. Contoh: untuk mendapatkan tayangan selama 28 hari — setiap hari selama 10 hari terakhir — Anda dapat membuat cap waktu Unix untuk 10 hari yang lalu dan hari ini, tetapkan keduanya ke parameter since dan until, lalu sertakanlah di permintaan Anda:

metric=impressions&period=days_28&since=1501545600&until=1502493720

Parameter since dan until bersifat inklusif, jadi jika rentang Anda termasuk hari yang belum berakhir (yaitu, hari ini), kueri berikutnya sepanjang hari dapat memberikan nilai yang meningkat. Jika Anda tidak menyertakan parameter since dan until, API akan secara default menggunakan rentang 2 hari: kemarin sampai hari ini.

Contoh Permintaan

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

Contoh Tanggapan

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 4,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 66,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times this profile has been seen",
      "id": "17841400008460056/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 3,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 36,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen this profile",
      "id": "17841400008460056/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 0,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 2,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of unique accounts that have viewed this profile within the specified period",
      "id": "17841400008460056/insights/profile_views/day"
    }
  ]
}

Perhatikan bahwa contoh permintaan di atas tidak menyertakan parameter since dan until, sehingga API memberikan data untuk rentang default 2 hari. Setiap hari diidentifikasi oleh cap waktu UTC berformat ISO 8601 dengan offset nol, yang telah ditetapkan ke properti end_time.

Properti end_time menunjukkan batas waktu lihat-balik set data; data yang lebih lama dari nilai ini tidak dimasukkan dalam penghitungan set data.

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.

Metrik Baru

Sintaksis Permintaan

GET https://graph.facebook.com/{api-version}/{ig-user-id}/insights
  ?metric={metric}
  &period={period}
  &timeframe={timeframe}
  &metric_type={metric-type}
  &breakdown={breakdown}
  &since={since}
  &until={until}
  &access_token={access-token}

Parameter Jalur

Parameter String Kueri

Perincian

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

• contact_button_type — Memerinci hasil berdasarkan komponen UI profil yang diketuk atau diklik pemirsa. Nilai tanggapan dapat berupa:

  • BOOK_NOW
  • CALL
  • DIRECTION
  • EMAIL
  • INSTANT_EXPERIENCE
  • TEXT
  • UNDEFINED
• follow_type — Memerinci hasil berdasarkan pengikut atau bukan pengikut. Nilai tanggapan dapat berupa:

  • FOLLOWER
  • NON_FOLLOWER
  • UNKNOWN
• media_product_type — Memerinci hasil berdasarkan permukaan tempat pemirsa melihat atau berinteraksi dengan media pengguna aplikasi. Nilai tanggapan dapat berupa:

  • AD
  • FEED
  • REELS
  • STORY

Baca tabel Metrik untuk menentukan metrik mana yang kompatibel dengan perincian. 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.

Jika Anda meminta metric_type=time_series, perincian tidak akan disertakan dalam tanggapan.

Jenis Metrik

Anda dapat menentukan cara hasil diagregasi, baik berdasarkan periode waktu atau sebagai total biasa (dengan perincian, jika diminta). Nilai dapat berupa:

• time_series — Memberi tahu API untuk mengagregasikan hasil berdasarkan periode waktu. Lihat Periode.
• total_value — Memberi tahu API untuk menampilkan hasil sebagai total biasa. Jika perincian disertakan dalam permintaan, set hasil akan lebih lanjut diperinci berdasarkan perincian spesifik. Lihat Perincian.

Periode

Memberi tahu API jangka waktu mana yang akan digunakan untuk agregasi hasil. Hanya kompatibel dengan metrik terkait interaksi.

Jangka Waktu

Memberi tahu API seberapa jauh kilas balik data saat meminta metrik terkait demografi. Nilai ini menimpa parameter since dan until.

Rentang

Menetapkan UNIX ke parameter since dan until untuk mendefinisikan rentang. API hanya akan menyertakan data yang dibuat dalam rentang ini (termasuk). Jika Anda tidak menyertakan parameter ini, kilas balik API adalah 24 jam.

Untuk metrik terkait demografi, parameter timeframe mengesampingkan nilai-nilai ini. Lihat Jangka Waktu.

Metrik

Metrik Interaksi

Metrik Demografi

Tanggapan

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

{
  "data": [
    {
      "name": "{data}",
      "period": "{period}",
      "title": "{title}",
      "description": "{description}",
      "total_value": {
        "value": {value},
        "breakdowns": [
          {
            "dimension_keys": [
              "{key-1}",
              "{key-2",
              ...
            ],
            "results": [
              {
                "dimension_values": [
                  "{value-1}",
                  "{value-2}",
                  ...
                ],
                "value": {value},
                "end_time": "{end-time}"
              },
              ...
            ]
          }
        ]
      },
      "id": "{id}"
    }
  ],
  "paging": {
    "previous": "{previous}",
    "next": "{next}"
  }
}

Konten Tanggapan

Contoh Permintaan Metrik Interaksi

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=reach&period=day&breakdown=media_product_type&metric_type=total_value&since=1658991600&access_token=EAAOc..."

Contoh Tanggapan Metrik Interaksi

{
  "data": [
    {
      "name": "reach",
      "period": "day",
      "title": "Accounts reached",
      "description": "The number of unique accounts that have seen your content, at least once, including in ads. Content includes posts, stories, reels, videos and live videos. Reach is different from impressions, which may include multiple views of your content by the same accounts. This metric is estimated and in development.",
      "total_value": {
        "value": 224,
        "breakdowns": [
          {
            "dimension_keys": [
              "media_product_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "CAROUSEL_CONTAINER"
                ],
                "value": 100
              },
              {
                "dimension_values": [
                  "POST"
                ],
                "value": 124
              }
            ]
          }
        ]
      },
      "id": "17841405309211844/insights/reach/day"
    }
  ],
  "paging": {
    "previous": "https://graph.face...",
    "next": "https://graph.face..."
  }

Contoh Permintaan Metrik Demografi

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=engaged_audience_demographics&period=lifetime&timeframe=last_90_days&breakdowns=country&metric_type=total_value&access_token=EAAOc..."

Contoh Tanggapan Metrik Demografi

{
  "data": [
    {
      "name": "engaged_audience_demographics",
      "period": "lifetime",
      "title": "Engaged audience demographics",
      "description": "The demographic characteristics of the engaged audience, including countries, cities and gender distribution.",
      "total_value": {
        "breakdowns": [
          {
            "dimension_keys": [
              "timeframe",
              "country"
            ],
            "results": [
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "AR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "RU"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "LA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "IQ"
                ],
                "value": 2
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MX"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "FR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "ES"
                ],
                "value": 3
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "NL"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "TR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "US"
                ],
                "value": 7
              }
            ]
          }
        ]
      },
      "id": "17841401130346306/insights/engaged_audience_demographics/lifetime"
    }
  ]
}