광고 계정

비즈니스 관리자는 비즈니스에 속한 광고 계정의 소유권을 요청할 수 있습니다. 이렇게 하면 사용자가 액세스해야 하는 광고 계정에 간편하게 사용자를 할당할 수 있습니다. 광고 계정에 공유 결제 수단을 할당할 수도 있습니다.

계정 소유권 요청

비즈니스 관리자 밖에서 Admin 역할로 광고 계정을 관리 중인 경우 비즈니스를 위해 해당 계정의 소유권을 요청할 수 있습니다. 이 절차는 일회성입니다. 소유권을 요청한 후에는 해당 비즈니스 관리자에서만 광고 계정을 관리할 수 있습니다.

크리에이티브 계정은 소유권 요청이 불가능합니다.

비즈니스를 위해 광고 계정의 소유권을 요청하려면 act_### 형식의 광고 계정 ID를 제공합니다. POST 보내기: \요청자는 광고 계정의 소유권을 요청하는 비즈니스의 관리자여야 합니다.

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

사용자가 광고 계정의 관리자인 경우에는 이 소유권 요청이 즉시 승인됩니다. Facebook은 CONFIRMED로 설정된 access_status를 반환합니다.

광고 계정에 대한 적절한 권한이 없는 사용자인 경우, Facebook은 광고 계정 관리자에게 소유권 요청을 보냅니다. Facebook이 이 요청을 보내면 응답에 PENDING으로 설정된 access_status가 포함됩니다.

소유권 요청을 수락하기 위해서는 광고 계정 관리자여야 하며 광고 관리자에 로그인하여 요청을 수락해야 합니다.

계정 액세스 요청

대부분의 마케팅 회사는 고객에게 광고 계정의 소유권을 요청할 필요가 없습니다. 다른 비즈니스 관리자가 소유한 자산에 대해 액세스 권한을 요청하려면 B2B 기능을 참조하세요.

광고 계정 만들기

이 API를 사용하려면 비즈니스 및 페이지를 올바르게 설정해야 합니다. 완료되지 않은 광고 계정이나 Facebook에서 공개하지 않은 페이지가 있다면 새로운 광고 계정을 만들 수 없습니다.

API를 사용한 광고 계정 생성은 광고 계정 5개로 제한됩니다. 광고 계정을 6개 이상 생성하려면 수동으로 생성해야 합니다.

사용 가능한 필드는 다음과 같습니다.

비즈니스에 새 광고 계정을 만들려면 name, currency, timezone_id, end_advertiser, media_agency 및 partner를 지정합니다. 다음 조건을 참조하세요.

• media_agency 및 partner는 Facebook 페이지 별칭, Facebook 페이지 ID 또는 Facebook 앱 ID여야 합니다.
• end_advertiser는 비즈니스 ID여야 합니다.

광고 계정에 광고주, 미디어 대행사 또는 파트너가 없다면 NONE을 지정하세요. 광고 계정에 광고주, 미디어 대행사 또는 파트너가 있지만 Facebook에 해당 페이지 또는 앱이 없는 경우 UNFOUND를 지정하세요.

광고 계정을 만드는 방법은 다음과 같습니다.

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

이미 Facebook에 확장 크레딧 라인이 있으면 invoice를 true로 설정할 수 있습니다. 이렇게 하면 새 광고 계정이 확장 크레딧 라인과 연결됩니다.

응답은 다음과 같습니다.

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

소유 계정 조회

GET 호출을 사용하여 비즈니스에서 액세스할 수 있는 모든 광고 계정을 조회할 수 있습니다.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

그러면 비즈니스 소유의 모든 광고 계정이 반환됩니다. 일부 필드는 비즈니스와 광고 계정 관계에 따라 다릅니다.

• permitted_tasks는 해당 광고 계정에 할당할 수 있는 작업의 배열입니다.
• access_type은 비즈니스가 광고 계정의 OWNER 또는 AGENCY 역할을 하는지 정의합니다.

아직 액세스 권한이 대기 중인 광고 계정을 조회하려면 다음 GET 호출을 보내세요.

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

계정 삭제

OWNER이고 계정이 CONFIRMED인 경우 광고 계정을 비즈니스에서 삭제할 수 없습니다. PENDING 액세스 요청이 있거나 광고 계정에 대한 AGENCY 액세스 권한이 있으면 다음 DELETE 호출을 보낼 수 있습니다.

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

계정 액세스 권한 조회

다음 GET 호출을 사용하여 누군가가 권한을 보유한 광고 계정을 조회할 수 있습니다.

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

누군가가 광고 계정에 대해 가진 권한을 확인하려면 다음 GET 호출을 보내세요.

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

계정에 사용자 추가

비즈니스 관리자를 광고 계정과 연결하면 다른 비즈니스 사용자에게 작업을 할당할 수 있습니다. 가능한 작업은 다음과 같습니다.

다음 항목이 필요합니다.

• adaccount_id — 광고 계정 ID, act_123 형식
• user_id — 추가할 사용자 ID
• 할당할 작업

['MANAGE', 'ADVERTISE', 'ANALYZE'] 작업을 수행할 새로운 사용자를 추가하려면 다음 POST 호출을 보내세요.

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

계정의 권한 변경

새로운 사용자를 추가할 때와 동일한 POST 호출을 보내서 기존 사용자의 작업을 변경할 수 있습니다.

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

광고 계정에서 사용자 삭제

사용자를 광고 계정에서 삭제하려면 다음 항목이 필요합니다.

• adaccount_id — 광고 계정 ID, act_123 형식
• user_id — 삭제할 사용자 ID

DELETE 호출은 다음과 같습니다.

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"