在商务管理平台之间共享 Meta Pixel 像素代码
在许多情况下，商务管理平台（通常是代理商）可能需要出于管理广告、分析表现或上传事件等目的访问另一个商务管理平台的 Pixel 像素代码数据集。
以下是在 Pixel 像素代码和代理商商务管理平台之间建立关系所需的 API 集成。如果接收方（代理商）商务管理平台也为客户管理广告，并需要为广告账户使用该 Pixel 像素代码，请参见第 3 步。
前提条件：应用要求
应用应该有广告管理标准访问权限（高级访问权限）功能。应用还应拥有以下权限：
business_managementads_management或ads_read和manage_pages
第 1 步：开始与代理商商务管理平台分享 Pixel 像素代码
这需要拥有 Pixel 像素代码的商务管理平台管理员提供具备上述应用权限的用户访问口令。
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
用于此请求的选项和参数包括：
| 名称 | 描述 |
|---|---|
类型：数字 | 必要。 接收 Pixel 像素代码访问权限的代理商商务管理平台编号 |
类型：list:string | 必要。 示例：['ANALYZE', 'UPLOAD', 'ADVERTISE'] 允许代理商对 Pixel 像素代码执行的任务 可能的值： ANALYZE：查看、分析和发布广告。 UPLOAD：将网站转化数据上传到该数据集。 ADVERTISE：把广告账户绑定到该 Facebook 数据集。使用该数据集发布广告。 EDIT：管理数据集、编辑设置、分析和发布广告。（EDIT 权限目前受到限制，请联系 Meta 代表将您的应用添加到白名单） |
我们会根据与另一个商务管理平台的关系状况处理请求：
- 存在已批准关系的商务管理平台。我们直接与他们共享 Pixel 像素代码。
- 存在待确认关系的商务管理平台。我们将 Pixel 像素代码添加到请求中，以便当接收方商务管理平台批准这项请求时可以分享 Pixel 像素代码。
- 没有任何关系的商务管理平台。我们创建附加了 Pixel 像素代码的共享协议，以便当接收方商务管理平台批准这项请求时，将 Pixel 像素代码分享给该商务管理平台。
如果 Pixel 像素代码成功分享给商务管理平台，将返回以下回复：
{
success: true,
}
如果请求的共享协议正在等待接受，API 请求将使用 pending_request_id 返回以下响应。当接收方商务管理平台接受请求后，Pixel 像素代码将自动分享给接收方商务管理平台。请参阅第 2 步以接受/拒绝请求。
{
"success": true,
"pending_request_id": "{request_id}"
}
请注意，共享 Pixel 像素代码的商务管理平台数量存在上限。
第 2 步：接受待处理请求（如有需要）
发起 Pixel 像素代码共享请求后，如果代理商与拥有 Pixel 像素代码的商务管理平台尚未建立关系，代理商商务管理平台可能会收到待确认的共享协议请求。接收方的商务管理平台管理员可以在他们的商务管理平台上查看和接受这项请求。
要使用 API 批准或拒绝关系请求，请从第 1 步的错误响应中获取 request_id。
API 要求接收方商务管理平台管理员获得带有 business_mangement 或 ads_management 的应用用户访问口令。
POST <request_id>?request_status="approve"
成功时，API 返回此回复：
{
success: bool
}
用于此请求的选项和参数包括：
| 名称 | 描述 |
|---|---|
类型：字符串 | 必要。 收到 Pixel 像素代码共享请求的商务管理平台是批准还是拒绝了请求。 可能的值： |
第 3 步：与代理商商务管理平台广告账户共享 Pixel 像素代码
如果代理商正在为客户管理广告，并需要允许客户的专用广告账户使用 Pixel 像素代码数据集，请使用这个 API。
Pixel 像素代码共享到拥有广告/分析权限的商务管理平台后，商务管理平台可以允许平台中的广告账户使用 Pixel 像素代码数据集来发布广告。
API 要求商务管理平台管理员提供带有 business_management、ads_management 或 ads_read 权限的用户访问口令。
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| 名称 | 描述 |
|---|---|
类型：数字 | 必要。 管理广告并有权访问 Pixel 像素代码和广告账户的商务管理平台。访问口令被使用的用户应该拥有这个商务管理平台的管理员权限。 |
类型：数字 | 必要。 允许使用 Pixel 像素代码的广告账户。 |
第 4 步：删除 Pixel 像素代码共享连接
如果不再需要 Pixel 像素代码和代理商商务管理平台之间的连接，请使用以下 API 来删除连接。
Delete <adspixel>/agencies?business=<agency_business_id>
API 需要提供拥有 Pixel 像素代码的商务管理平台管理员用户的访问口令。
成功时，API 返回此回复：
{
success: true
}