비즈니스가 다른 비즈니스(일반적으로 대행사)를 통해 특정 비즈니스의 픽셀 데이터 세트에 액세스해야 하는 사용 사례는 여러 가지가 있을 수 있습니다(예: 광고 관리, 성과 분석 또는 이벤트 업로드).
픽셀과 대행사 비즈니스 사이의 관계를 설정하는 데 필요한 API 통합은 다음과 같습니다. 수신자 비즈니스(대행사)가 고객을 대신하여 광고도 관리하며 해당 픽셀을 광고 계정에 사용해야 하는 경우, 3단계를 참조하세요.
앱에 광고 관리 표준 액세스(고급 액세스) 기능이 있어야 합니다. 앱에 다음과 같은 권한도 있어야 합니다.
business_management
ads_management
또는 ads_read
및 manage_pages
이를 위해서는 픽셀을 소유하는 비즈니스 관리자로부터 위의 앱 권한이 부여된 사용자 액세스 토큰이 필요합니다.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
이 요청의 옵션과 매개변수에는 다음 항목이 포함됩니다.
이름 | 설명 |
---|---|
유형: 숫자 | 필수 항목. 픽셀에 대한 액세스 권한을 받는 대행사 비즈니스 ID |
유형: 목록:문자열 | 필수 항목. 예: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] 픽셀에 대해 대행사에 허용된 작업 가능한 값: ANALYZE: 조회, 분석 및 광고합니다. UPLOAD: 웹사이트 전환 데이터를 이 데이터 세트로 업로드합니다. ADVERTISE: 광고 계정을 이 Facebook 데이터 세트에 연결합니다. 이 데이터 세트를 광고에 사용합니다. EDIT: 데이터 세트 관리, 설정 수정, 분석 및 광고. (현재 EDIT 액세스는 제한되어 있습니다. 앱을 허용 리스트에 등록하려면 Meta 담당자에게 문의하세요.) |
Facebook은 다음과 같이 상대 비즈니스와의 관계 상태를 기반으로 요청을 처리합니다.
픽셀이 비즈니스와 공유되면 다음과 같은 응답이 반환됩니다.
{ success: true, }
요청이 공유 계약 수락을 대기 중인 경우, API 요청에서 pending_request_id
를 포함한 다음 응답을 반환합니다. 수신자 비즈니스가 요청을 수락하면 픽셀이 수신자 비즈니스에 자동으로 공유됩니다. 요청을 수락/거부하려면 2단계를 참조하세요.
{ "success": true, "pending_request_id": "{request_id}" }
픽셀을 공유할 수 있는 비즈니스의 수에는 제한이 있습니다.
픽셀 공유 요청이 시작된 후에 대행사가 픽셀을 소유하는 비즈니스와 관계가 형성되어 있지 않은 경우 대행사 비즈니스는 대기 중인 공유 계약 요청을 수신할 수 있습니다. 수신자 비즈니스의 관리자는 자신의 비즈니스 관리자에서 이 요청을 확인하고 수락할 수 있습니다.
API를 사용하여 관계 요청을 승인하거나 거부하려면 1단계의 오류 응답에서 request_id
를 가져오세요.
이 API는 수신자 비즈니스 관리자로부터 앱에 대해 business_mangement
또는 ads_management permission
권한이 있는 사용자 액세스 토큰을 받아야 합니다.
POST <request_id>?request_status="approve"
요청이 성공하면 API가 다음 응답을 반환합니다.
{ success: bool }
이 요청의 옵션과 매개변수에는 다음 항목이 포함됩니다.
이름 | 설명 |
---|---|
유형: 문자열 | 필수 항목. 픽셀 공유 요청을 수신하는 비즈니스가 요청을 승인 또는 거부하는지 여부. 가능한 값: |
대행사가 고객을 대신하여 광고를 관리하고 있고 고객의 전용 광고 계정이 픽셀 데이터 세트를 사용하도록 허용하려면 이 API를 사용하세요.
픽셀이 광고/분석 권한이 있는 비즈니스에 공유되면 해당 비즈니스는 비즈니스 내의 광고 계정이 픽셀 데이터 세트를 광고에 사용하도록 허용할 수 있습니다.
이 API는 비즈니스 관리자로부터 business_management
, ads_management
또는 ads_read
권한이 있는 사용자 액세스 토큰을 받아야 합니다.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
이름 | 설명 |
---|---|
유형: 숫자 | 필수 항목. 광고를 관리하고 픽셀 및 광고 계정에 대한 액세스 권한이 있는 비즈니스. 액세스 토큰을 사용한 사용자는 이 비즈니스에 대한 관리자 권한이 있어야 합니다. |
유형: 숫자 | 필수 항목. 픽셀에서 허용할 광고 계정. |
픽셀과 대행사 비즈니스를 더 이상 연결할 필요가 없을 경우 다음 API를 사용하여 연결을 삭제하세요.
Delete <adspixel>/agencies?business=<agency_business_id>
이 API는 픽셀을 소유하는 비즈니스로부터 관리자 사용자 액세스 토큰을 받아야 합니다.
요청이 성공하면 API가 다음 응답을 반환합니다.
{ success: true }