在商家之間分享 Meta 像素

對商家來說，在另一商家（通常是代理商）中存取商家的像素資料集可能有多種使用案例，例如管理廣告、分析成效或上傳事件。

以下是在像素和代理商商家之間建立關係所需的 API 整合。如果收件人（代理商）商家同時管理客戶的廣告，且需要將該像素用於廣告帳號，請參閱步驟 3。

先決條件：應用程式必備條件

應用程式應具備廣告管理一般存取權限（進階存取權限）功能，也應具備以下權限：

• business_management
• ads_management 或 ads_read 和 manage_pages

步驟 1：發起與代理商商家的像素分享

此動作需要用戶存取權杖，該權杖具備擁有該像素之商家管理員的上述應用程式權限。

POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]

此要求的選項和參數包括：

我們會根據與其他商家的關係狀態來處理要求：

• 具備現有已核准關係的商家。我們會直接與其分享像素。
• 具備現有進行中關係的商家。我們會在要求中加入像素，當收件人商家核准此要求時，我們便會分享像素。
• 不具任何關係的商家。我們會建立一個附加像素的分享協議，當收件人商家核准此要求時，便將該像素與商家分享。

如果成功與商家分享像素，系統會傳回以下回應：

{  
    success: true,
}
    

如果要求正在處理分享協議接受，API 要求將傳回以下包含 pending_request_id 的回應。當收件人商家接受要求時，系統會自動將像素與收件人商家分享。請參閱步驟 2 以接受／拒絕要求。

{
  "success": true,
  "pending_request_id": "{request_id}"
}
      

步驟 2：接受處理中的要求（如果需要）

發起像素分享要求後，如果代理商尚未與擁有像素的商家建立關係，代理商商家可能會收到處理中的分享協議要求。收件人商家管理員可以在其企業管理平台中查看並接受此要求。

若要使用 API 核准或拒絕關係要求，請從步驟 1 的錯誤回應中取得 request_id。

該 API 需要收件人商家管理員的用戶存取權杖，該權杖具備應用程式的 business_mangement 或 ads_management permission 權限。

POST <request_id>?request_status="approve"

成功後，API 將傳回以下回應：

{  
    success: bool
}

此要求的選項和參數包括：

步驟 3：與代理商商家廣告帳號分享像素

如果代理商正在管理客戶的廣告，且需要允許客戶的專屬廣告帳號使用像素資料集，請使用此 API。

當系統將像素分享至具備廣告／分析權限的商家後，該商家即可允許商家內的廣告帳號使用像素資料集進行廣告。

該 API 需要具備商家管理員的 business_management、ads_management 或 ads_read 權限的用戶存取權杖。

Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>

步驟 4：刪除像素分享連結

如果不再需要像素與代理商商家之間的連結，請使用以下 API 刪除連結。

Delete <adspixel>/agencies?business=<agency_business_id>

該 API 需要像素擁有商家的管理員用戶存取權杖。

成功後，API 將傳回以下回應：

{  
    success: true
}

瞭解詳情

• 瞭解全新的事件管理工具體驗（企業商家使用說明）
• 資料集概觀（企業商家使用說明）
• 如何將應用程式連結到資料集（企業商家使用說明）