개요

마케팅 API는 프로그래밍 방식으로 데이터를 쿼리하고, 광고를 제작 및 관리하고, 여러 가지 다른 작업을 실행하는 데 사용할 수 있는 HTTP 기반 API입니다. 이 섹션에서는 마케팅 API, 액세스, 버전 관리 등에 대한 일반 정보를 설명합니다.

API는 HTTP 기반이므로 거의 모든 최신 웹 브라우저와 cURL을 포함한 HTTP를 지원하는 모든 언어 또는 소프트웨어와 호환됩니다. 마케팅 API는 Meta의 그래프 API를 기반으로 하므로 거의 모든 요청을 graph.facebook.com 호스트 URL에 전달해야 합니다.

기본 개념

마케팅 API를 사용하기 위해 다음과 같은 개념을 이해해야 합니다.

광고 캠페인 구조

Meta는 캠페인, 광고 세트, 광고의 세 가지 수준으로 광고를 구성합니다. API에서 개발자는 크리에이티브라는 네 번째 수준에 액세스할 수 있습니다.

권한 부여

마케팅 API 엔드포인트에 액세스하려면 앱이 그래프 API 권한 부여의 여러 레이어를 통과해야 합니다.

인증

API 호출에 필요한 액세스 토큰을 가져와 저장하는 방법에 대해 알아보세요.

사용 제한

마케팅 API에는 자체 사용 제한 로직이 있으며 모든 그래프 API 사용 제한에서 제외됩니다.

버전 관리

Meta의 플랫폼에는 코어 및 확장 버전 관리 모델이 있습니다. 버전 관리 및 마이그레이션 시스템을 사용하여 예정된 변경 사항과 지원 중단에 대해 자세히 알아보세요. 버전 일정, 마이그레이션, 변경 사항을 참조하세요.

앱 검수

마케팅 API를 사용하려면 앱이 앱 검수를 거쳐야 합니다. 서버 측 API와 오프라인 전환의 경우 몇 가지 예외가 있습니다.

권한

두 가지 주요 광고 권한으로는 ads_management와 ads_read가 있습니다. 사용하는 앱에서 호출하려면 앱에 권한을 부여해야 합니다. 권한은 앱 검수 절차에서 요청할 수 있습니다. 비즈니스 앱에서 사용 가능한 권한 리스트를 참조하세요.

오류 코드

API를 사용하는 동안 오류 코드가 나타날 수도 있습니다. 이를 참고로 각 오류 코드에 대해 자세히 알아보세요.

후처리

Meta에서 요청을 수신한 이후의 후처리 단계에 관해 이해합니다.