廣告帳號

企業管理平台管理員可認領隸屬於商家的廣告帳號。這可讓您輕鬆將人員指派至需要存取的廣告帳號。您也可以將「共享加值來源」指派給廣告帳號。

認領帳號

如果您以管理員角色管理企業管理平台外的廣告帳號，便可於企業管理平台中認領這些廣告帳號。此程序只能進行一次。認領之後，您就只能在該企業管理平台管理這些廣告帳號。

廣告創意帳號無法認領。

若要為您的商家認領廣告帳號，請以 act_### 格式提供廣告帳號編號。傳送 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 會傳回 access_status，並設定為 CONFIRMED。

如果您是不具備該廣告帳號適當權限的用戶，我們會向廣告帳號管理員發出所有權要求。我們發出要求後，回應會包含 access_status，並設定為 PENDING。

若要接受所有權要求，您必須是廣告帳號管理員，並應登入廣告管理員來接受該要求。

要求帳號存取權限

大部分的行銷公司不需要認領客戶的廣告帳號。若要要求存取其他企業管理平台擁有的素材，請參閱企業對企業功能。

建立廣告帳號

若要使用此 API，您必須已設定有效的商家和粉絲專頁。如果您有任何不完整的廣告帳號或 Facebook 尚未發佈的粉絲專頁，便無法建立新的廣告帳號。

使用 API 建立廣告帳號時，僅限 5 個廣告帳號。若要建立超過 5 個廣告帳號，您必須手動執行。

可用的欄位如下：

若要為商家建立新的廣告帳號，請指定 name、currency、timezone_id、end_advertiser、media_agency 和 partner。請參閱下列條件：

• media_agency 和 partner 必須是 Facebook 粉絲專頁別名、Facebook 粉絲專頁編號或 Facebook 應用程式編號。
• end_advertiser 必須是商家編號。

如果您的廣告帳號沒有廣告商、媒體代理商或合作夥伴，請指定 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 — 廣告帳號編號，格式為 act_123
• user_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 — 廣告帳號編號，格式為 act_123
• user_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"