인증

마케팅 API 엔드포인트에 액세스하려면 앱이 여러 단계의 그래프 API 인증을 통과해야 합니다.

레이어 1: 앱 유형

Facebook 앱을 만들 때 앱의 용도에 관한 질문을 받습니다. 선택한 항목에 따라 앱 유형이 비즈니스, 게임 또는 없음으로 결정됩니다. 앱 유형을 참조하세요.

마케팅 API 엔드포인트에 액세스하려면 비즈니스 앱을 만들어야 합니다. 비즈니스 앱에 사용 가능한 제품을 참조하세요.

앱을 등록하고 나면 개발자 계정이 있고 개발에 도움을 줄 모든 사람에게 역할을 할당할 수 있습니다.

레이어 2: 액세스 레벨, 권한 및 기능

비즈니스 앱에는 액세스 레벨이라고 하는 그래프 API 권한 부여 레이어가 추가적으로 적용됩니다. 앱 검수 중에 앱은 특정 권한과 기능도 요청해야 합니다.

액세스 레벨

액세스 레벨	설명
Standard Access	비즈니스 앱은 해당 비즈니스 앱 유형에서 이용 가능한 모든 권한 및 기능에 대하여 액세스 권한을 자동으로 승인받습니다. 처음 시작할 때는 이 옵션을 사용하세요. 처음부터 끝까지 워크플로를 빌드한 후 전체 권한을 요청할 수 있습니다. 액세스 가능한 광고 계정 수에는 제한이 없습니다. API 호출이 여러 계정에 속해 있거나 해당 계정을 프로그래밍 방식으로 확인할 수 없는 경우 Standard Access로 일부 API를 호출하지 못할 수 있습니다.
Advanced Access	Advanced Access는 앱 검수 절차를 통해 각 권한 또는 기능을 승인받아야 합니다. Advanced Access를 요청하려면 앱 대시보드에서 앱 검수 > 권한 및 기능을 클릭합니다. 액세스하려는 권한 또는 기능을 찾아서 작업 아래의 Advanced Access 요청을 클릭합니다. 하나 이상의 기능을 선택할 수 있습니다. 옵션을 선택하고 나서 요청 계속하기를 클릭하면 제출 절차를 안내하는 화면으로 이동합니다. 정보를 제출한 후 Facebook에서 신청을 승인하거나 거부하고, 앱에 Standard Access가 없는 경우 해당 정보를 제공합니다. Advanced Access에 대한 승인을 받은 후에는 상태를 유지하기 위해 다음을 완료해야 합니다. 최근 15일 동안 성공적으로 실행된 마케팅 API 호출 1,500회 이상 최근 15일 동안 실행된 마케팅 API 호출의 오류율 10% 미만

설명

Standard Access

비즈니스 앱은 해당 비즈니스 앱 유형에서 이용 가능한 모든 권한 및 기능에 대하여 액세스 권한을 자동으로 승인받습니다.

처음 시작할 때는 이 옵션을 사용하세요. 처음부터 끝까지 워크플로를 빌드한 후 전체 권한을 요청할 수 있습니다. 액세스 가능한 광고 계정 수에는 제한이 없습니다.

API 호출이 여러 계정에 속해 있거나 해당 계정을 프로그래밍 방식으로 확인할 수 없는 경우 Standard Access로 일부 API를 호출하지 못할 수 있습니다.

Advanced Access

Advanced Access는 앱 검수 절차를 통해 각 권한 또는 기능을 승인받아야 합니다.

Advanced Access를 요청하려면 앱 대시보드에서 앱 검수 > 권한 및 기능을 클릭합니다.

액세스하려는 권한 또는 기능을 찾아서 작업 아래의 Advanced Access 요청을 클릭합니다. 하나 이상의 기능을 선택할 수 있습니다. 옵션을 선택하고 나서 요청 계속하기를 클릭하면 제출 절차를 안내하는 화면으로 이동합니다.

정보를 제출한 후 Facebook에서 신청을 승인하거나 거부하고, 앱에 Standard Access가 없는 경우 해당 정보를 제공합니다.

Advanced Access에 대한 승인을 받은 후에는 상태를 유지하기 위해 다음을 완료해야 합니다.

최근 15일 동안 성공적으로 실행된 마케팅 API 호출 1,500회 이상
최근 15일 동안 실행된 마케팅 API 호출의 오류율 10% 미만

각 레벨에는 제한이 있습니다. 액세스 레벨과 기능을 참조하세요. 모든 개발자는 Facebook 플랫폼 약관 및 개발자 정책을 모두 준수해야 합니다. 액세스 레벨 중 어느 레벨에서 호출하든 프로덕션 데이터가 영향을 받습니다.

현재 액세스 레벨을 확인하려면 앱 대시보드 > 앱 검수 > 권한 및 기능으로 이동하세요.

권한 및 기능

액세스하고자 하는 API에 따라 요청해야 하는 권한이 달라집니다.

앱이 광고 계정만 관리할 경우 Standard Access와 ads_read 및 ads_management 권한으로 충분합니다. 앱이 다른 사용자의 광고 계정을 관리할 경우 Advanced Access ads_read 및/또는 ads_management 권한이 필요합니다. 비즈니스 앱에 사용 가능한 모든 권한을 참조하세요.

원하는 API 사용 방식에 따라 요청해야 하는 기능이 달라집니다. 광고를 관리할 경우 요청해야 할 공통적 기능은 Ads Management Standard Access입니다. 비즈니스 앱에 사용 가능한 모든 기능을 참조하세요.

Ads Management Standard Access에 대해 Advanced Access 권한을 얻으려면 앱이 다음과 같은 요구 사항을 충족해야 합니다.

최근 15일 동안 성공적으로 실행된 마케팅 API 호출 1,500회 이상
최근 15일 동안 실행된 마케팅 API 호출의 오류율 10% 미만

다른 사람의 광고를 관리할 경우 scope 매개변수를 사용하여 다른 사람에게 ads_management 또는 ads_read 권한을 요청합니다. 그 사람이 허용을 클릭하면 앱에 액세스 권한이 부여됩니다.

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

YOUR_URL 필드 입력 시 맨 끝에 /를 붙여야 합니다. 예: http://www.facebook.com/

예

사용 사례	요청할 권한 및 기능
자신이 소유하거나 광고 계정 소유자가 액세스 권한을 부여한 광고를 읽고 관리하고자 합니다.	권한: `ads_management` 기능: `Ads Management Standard Access`
자신이 소유하거나 광고 소유자가 액세스 권한을 부여한 광고 계정에 대한 광고 보고서를 읽고자 합니다.	권한: `ads_read` 기능: `Ads Management Standard Access`
클라이언트 세트에서 광고 보고서를 가져오고 다른 클라이언트 세트의 광고를 읽고 관리하고자 합니다.	권한: `ads_management` 및 `ads_read` 기능: `Ads Management Standard Access`

액세스 레벨 및 기능

아래의 표는 Standard Access 및 Advanced Access 레벨이 Ads Management Standard Access 기능에 어떤 영향이 있는지 보여줍니다.

	Standard Access	Advanced Access
계정 제한	관리할 광고 계정 수에 제한이 없습니다. 앱 관리자 또는 개발자는 광고 계정 관리자나 광고주를 대신하여 API를 호출할 수 있습니다.	광고 계정에서 `ads_read` 또는 `ads_management` 권한을 얻을 경우 관리할 광고 계정 수에 제한이 없습니다.
사용 제한	엄격한 광고 계정별 사용 제한. 개발 전용으로, 라이브 광고주를 위해 실행되는 프로덕션 앱용이 아닙니다.	낮은 수준의 광고 계정별 사용 제한입니다.
비즈니스 관리자	비즈니스 관리자 및 제품 카탈로그 API에 대한 액세스가 제한됩니다. 비즈니스 관리자에서 광고 계정, 사용자 권한 및 페이지를 관리할 수 있는 액세스 권한이 없습니다.	모든 비즈니스 관리자 및 제품 카탈로그 API에 액세스합니다.
시스템 사용자	시스템 사용자 1명과 관리자 시스템 사용자 1명을 만들 수 있습니다.	시스템 사용자 10명과 관리자 시스템 사용자 1명을 만들 수 있습니다.
페이지 만들기	API를 통해 페이지를 만들 수 없습니다.	API를 통해 페이지를 만들 수 없습니다.

액세스 레벨 vs. Ads Management Standard Access

앱의 권한과 기능에는 Standard Access와 Advanced Access라는 두 가지 액세스 레벨이 있습니다. 여기서 사용하는 ‘Standard Access’라는 용어는 Ads Management Standard Access 기능과는 무관합니다. Ads Management Standard Access에 대한 Advanced Access의 경우 앱에서 기능에 액세스하려면 여전히 검수 절차를 거쳐야 합니다.

레이어 3: 비즈니스 인증

비즈니스 인증은 비즈니스 사업체로서 신원을 인증할 수 있는 절차이며, 앱이 민감한 데이터에 액세스할 때 필요합니다. 비즈니스 인증 절차에 대해 자세히 알아보세요.