資產管理總覽

商家可以存取多項資產。您的商家擁有這些資產,或您的商家是以代理商身分存取這些資產。請使用 Facebook 的商家管理資產 API 來新增、移除或查詢商家與其資產之間的關係,以及管理商家資產和對資產的存取權限。

代理商是一種商家實體類型,可管理或存取其他商家所擁有的資產。這項關係允許代理商代表客戶執行特定任務或操作,例如管理廣告帳號、粉絲專頁或其他數位資產。

商家資產群組

商家資產群組可協助大型廣告商或代理商有效管理其商家中的用戶和資產。您應該以對應現實世界運作的方式來組織資產和用戶。例如,商家可以根據品牌、地區、客戶或自選的組織原則來建構其資產和用戶。

商家資產群組可以包含廣告帳號、粉絲專頁、Facebook 像素、離線事件組合、應用程式、目錄、自訂轉換和 Instagram 帳號。這些資產可以由商家擁有,也可以分享以提供存取權限給代理商。

您可以使用此 API 將用戶新增至商家資產群組。新增後,即可將商家資產群組中的資產權限授予用戶。這有助於您一次授予多項資產的存取權限,而不需要在商家層級建立太多管理員。

使用此 API,您可以管理某人透過企業管理平台建立的商家資產群組,或是管理商家資產群組內的資產。您可以:

  • 取得與商家相關聯的商家資產群組清單
  • 刪除或重新命名商家資產群組
  • 查看商家資產群組中的所有資產
  • 取得、新增、編輯和刪除用戶對商家資產群組中之資產的權限
  • 指派用戶至商家資產群組
  • 從商家資產群組取得、新增和刪除資產

權限

若要使用商家資產群組 API,您的應用程式需要適當的行銷 API 存取層級

  • 對於所有新增和刪除端點:存取權杖的用戶必須是商家的管理員,否則會被拒絕存取。
  • 對於所有 API 端點,您的應用程式都需要 business_management 權限。

對於以下端點,您需要額外的權限:

商家資產群組端點 必要權限

取得廣告帳號清單

ads_management

取得商品目錄清單、新增商品目錄或刪除商品目錄

ads_management

取得 Instagram 帳號清單、新增 Instagram 帳號或移除 Instagram 帳號

ads_management。如果您是使用行銷 API 第 4.0 版,還需要 instagram_basic

取得像素清單

ads_read

取得離線事件組合清單

ads_management

取得自訂轉換清單

ads_read

新增自訂轉換

ads_management

限制

如果您嘗試透過以下 API 進行呼叫,針對商家資產群組內含的資產減少或移除權限,您會看到錯誤:

若要減少或移除權限,請依照下列步驟操作:

  1. 發出呼叫以取得與商家相關聯的資產群組清單。尋找 contained_asset_id 等於 {page_id}{ad_account_id} 的資產群組。
  2. 針對每個傳回的商家資產群組編號發出 API 呼叫,以從該群組中移除用戶。
  3. 然後,呼叫上述的 DELETEPOST 要求,移除該用戶對粉絲專頁或廣告帳號的權限。

如果您在應用程式中為其他商家提供權限管理功能,則應使用此 API,以防止 API 與企業管理平台之間出現不一致和錯誤。

您無法透過商家資產群組來設定對應用程式、目錄、Instagram 帳號和自訂轉換的權限。反之,您應該在資產層級權限權限。

例如,如果您在 Jasper 的企業管理平台中,將 Roger 新增至商家資產群組,則 Roger 可以取得該商家資產群組中任何粉絲專頁、廣告帳號、像素等的權限。然而,若要移除或編輯 Roger 對 Jasper 商家資產群組中任何資產的權限,則必須在商家資產群組本身執行此操作。

您可以使用資產 API,在資產層級新增用戶權限,例如將某人從專頁版主變更為管理員。請參閱粉絲專頁廣告帳號的範例。

商家資產群組已於 2019 年 10 月 13 日取代專案 API。您應將專案 API 上的所有應用程式移轉到商家資產群組。

允許的角色

將用戶加到商家後,下列兩種角色其中一個可透過企業管理平台用戶 API 進行指派:

API 常數 名稱 說明

ADMIN

企業管理平台管理員

可管理所有層面的企業管理平台設定,包括修改或刪除帳號,以及新增或移除用戶。

EMPLOYEE

商家員工

可查看企業管理平台設定中的所有資訊,但無法進行任何變更,但可將其擔任管理員的粉絲專頁或廣告帳號新增至商家。

目錄

使用目錄 API,針對此商家可存取的目錄,可將下列角色指派給商家的任何用戶(管理員或員工):

API 常數名稱說明

['MANAGE', 'ADVERTISE']

目錄管理員

可使用完整的讀取和寫入存取權限,管理目錄的所有面向,包括建立/更新/刪除項目、管理摘要、將目錄附加到像素和應用程式、建立商品組合、利用目錄來刊登高效速成+ 目錄廣告、變更目錄設定等等。

['ADVERTISE']

目錄廣告商

可建立商品組合,並可利用目錄來刊登高效速成+ 目錄廣告。無法編輯其產品、摘要或目錄設定。

廣告帳號

使用廣告帳號 API,針對此商家可存取的廣告帳號,可將下列任務指派給商家的任何用戶:

API 常數 名稱 說明

['MANAGE', 'ADVERTISE', 'ANALYZE']

廣告帳號管理員

可管理行銷活動、分析報告、帳單和帳號權限的所有層面,並可設定廣告帳號花費上限。廣告帳號管理員也可連結商家付款方式。

['ADVERTISE', 'ANALYZE']

廣告帳號的廣告商

可查看和編輯廣告,以及使用與廣告帳號連結的付款方式來設定廣告。

['ANALYZE']

廣告帳號分析師

可查看廣告成效。

粉絲專頁

使用粉絲專頁 API,針對此商家可存取的粉絲專頁,可將下列任務指派給商家的任何用戶:

API 常數 名稱 說明

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

粉絲專頁管理員

可管理粉絲專頁角色、以粉絲專頁身分傳送訊息和貼文、建立廣告,以及查看洞察報告。

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

粉絲專頁編輯

可編輯粉絲專頁、以粉絲專頁身分傳送訊息和貼文、建立廣告,以及查看洞察報告。

['MODERATE', 'ADVERTISE', 'ANALYZE']

專頁版主

可回覆和刪除粉絲專頁上的留言、以粉絲專頁身分傳送訊息、建立廣告,以及查看洞察報告。無法以粉絲專頁身分發佈貼文。

['ADVERTISE', 'ANALYZE']

粉絲專頁廣告主

可為粉絲專頁建立廣告及查看洞察報告。無法以粉絲專頁身分發佈貼文。

['ANALYZE']

粉絲專頁分析師

可查看洞察報告。無法以粉絲專頁身分發佈貼文。

應用程式

企業管理平台中的應用程式沒有角色或任務管理 API。

Instagram 帳號

企業管理平台中沒有 Instagram 帳號的角色管理功能。如果用戶可以存取與 Instagram 帳號連結的廣告帳號,就能為這些 Instagram 帳號刊登廣告。