광고 인사이트 API

광고 인사이트 API는 Meta 광고에 대한 성과 데이터와 통계를 제공합니다. 유연한 보고 옵션을 통해 요청을 맞춤 설정하고 Meta 광고 관리자에서 제공하는 거의 모든 지표를 얻을 수 있습니다.

시작하기 전에

광고 인사이트 API에 액세스하려면 다음이 필요합니다.

앱. (자세한 내용은 Meta 앱 개발을 참조하세요.)
ads_read 권한. (자세한 내용은 권한 및 승인을 참조하세요.)

또한 관심 있는 행동을 추적하도록 광고를 설정해야 합니다. 이를 위해 전환 API 또는 Meta 픽셀과 같은 도구를 사용할 수 있습니다.

광고 인사이트 API 호출

광고 인사이트 API는 모든 광고 개체에서 에지로 사용할 수 있습니다. (Meta의 광고 계층에 대한 자세한 내용은 여기를 참조하세요.)

리소스	제공 대상
`/{ad-account-id}/insights`	광고 계정의 인사이트
`/{campaign-id}/insights`	광고 캠페인의 인사이트
`/{ad-set-id}/insights`	광고 세트의 인사이트
`/{ad-id}/insights`	광고에서 얻은 인사이트

기본적으로 GET 요청은 일반적으로 지난 30일 동안의 광고 개체에 대한 기본 지표를 반환합니다.

요청 예시

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

응답 예시:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

요청 맞춤 설정

요청에 세 가지 주요 구성 요소, 즉 매개변수(기간/기여 기간 등을 지정할 목적), 필드(지표), 분석 데이터를 활용하면 훨씬 더 구체적인 데이터를 얻을 수 있습니다. 예를 들어 캠페인의 지난 7일 동안 발생한 클릭수(전체)를 성별에 따라 확인하려면 다음 구성 요소를 포함할 수 있습니다.

매개변수: date_preset=last_7d
필드: clicks
분석 데이터: gender

요청 예시

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

응답 예시

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

더 알아보기

광고 인사이트 API는 강력한 강력한 기능을 제공합니다. 이 문서를 읽고 그 기능을 익히는 방법을 알아보세요.

매개변수 및 필드
지표
분석 데이터
비동기 요청
제한 및 모범 사례
전환 보고, 제품 수준 보고, 마케팅 믹스 모델링에 대한 특정 가이드

또한 개별 광고 개체의 인사이트 에지에 대해 자동 생성된 참고 자료 문서를 추가로 확인할 수 있습니다.

솔루션에 광고 인사이트 API의 데이터를 포함하려는 경우 Meta 플랫폼 약관과 마케팅 API 개발자 정책도 검토하세요.