IG 미디어 인사이트

IG 미디어 개체에 대한 소셜 인터랙션 지표를 나타냅니다.

만들기

지원되지 않는 작업입니다.

읽기

GET /{ig-media-id}/insights

IG 미디어 개체에 대한 인사이트 데이터를 가져옵니다.

제한 사항

• 인사이트 데이터는 사진첩 IG 미디어 내의 어떤 미디어에도 제공되지 않습니다.
• 스토리가 보관되거나 강조 표시되더라도 스토리 미디어 지표는 24시간 동안만 제공됩니다. 스토리가 만료되기 전에 최신 인사이트를 가져오려면 Instagram 주제에 대해 Webhooks를 설정하고 story_insights 필드를 구독합니다.
• 값이 5 미만인 스토리 미디어 지표는 (#10) Not enough viewers for the media to show insights 메시지와 함께 오류 코드 10을 반환합니다.
• 유럽과 일본의 사용자가 생성한 스토리의 경우 이제 replies 지표에서 0 값이 반환됩니다.
• 스토리의 경우 유럽과 일본의 사용자가 작성한 답글은 replies 계산에 포함되지 않습니다.
• 요청하는 인사이트 데이터가 존재하지 않거나 현재 사용할 수 없는 경우, API가 개별 지표에 대해 0 대신 빈 데이터 세트를 반환합니다.
• 지표를 계산하는 데 사용한 데이터는 최대 48시간 지연될 수 있습니다.

요구 사항

요청 구문

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

경로 매개변수

쿼리 문자열 매개변수

지표

사진첩 지표

사진 및 동영상 지표

사진첩 내의 미디어에 대한 지표는 지원되지 않습니다. 대신 사진첩에 대한 지표를 가져오세요.

릴스 지표

스토리 지표

요청 샘플

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

응답 샘플

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

새로운 지표

요청 구문

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

경로 매개변수

쿼리 문자열 매개변수

분석 데이터

또한 하나 이상의 분석 데이터를 지정할 수 있으며, 결과는 지정된 분석 데이터에 따라 더 작은 규모의 세트로 세분화됩니다. 다음 값을 사용할 수 있습니다.

• action_type — profile_activity 지표와만 호환됩니다. 앱 사용자의 프로필을 본 사용자가 탭하거나 클릭한 프로필 UI 구성 요소를 기준으로 결과를 분석합니다. 다음과 같은 응답 값을 얻을 수 있습니다.

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type — 사용자가 미디어를 본 후 취하는 탐색 행동을 기준으로 결과를 분석합니다.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

분석 데이터를 지원하는 지표와 해당 지표가 지원하는 분석 데이터를 확인하려면 지표 테이블을 참조하세요. 분석 데이터를 지원하지 않는 지표를 요청할 경우 API가 오류("An unknown error has occurred.")를 반환하므로 하나의 쿼리에서 여러 지표를 요청할 때는 유의하시기 바랍니다.

지표

게시물 지표

게시물로 게시된 이미지 및 동영상 IG 미디어에서 사용할 수 있는 지표는 다음과 같습니다. 사진첩 슬라이드와 IGTV는 지원되지 않습니다.

스토리 지표

스토리로 게시된 IG 미디어에서 사용할 수 있는 지표는 다음과 같습니다.

응답

쿼리 결과를 포함하는 JSON 개체입니다. 결과는 쿼리 사양을 기반으로 다음의 데이터를 포함할 수 있습니다.

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

응답 내용

게시물 지표 요청 샘플

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

게시물 지표 응답 샘플

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

스토리 지표 요청 샘플

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

스토리 지표 응답 샘플

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

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.