在企業管理平台之間分享自訂廣告受眾

企業管理平台 API 在存取屬於其他企業的廣告受眾時，會建立明確的角色和職責。

在不同企業之間分享自訂廣告受眾時，必須先在企業管理平台之間建立合作夥伴關係。此功能位於企業管理平台上，Business Settings 的 Partners 區塊中。分享廣告受眾的一方，也必須確認自己遵守我們在企業管理平台中提供的自訂廣告受眾服務條款，請參閱 Facebook 的自訂廣告受眾條款。

分享關係建立之後，就能讓企業與其他企業管理平台分享廣告受眾。不過，廣告受眾只能單向分享。這表示廣告受眾是由企業 #1 分享給企業 #2。除非另外建立從企業 #2 分享給企業 #1 的分享關係，否則企業 #2 無法將廣告受眾分享回企業 #1。

自 2018 年起，為了在企業管理平台之間分享自訂廣告受眾，這些企業應建立廣告受眾分享關係，如下所示。您需要有企業管理平台管理員權限，才能要求分享廣告受眾的關係。如果兩個企業管理平台已建立關係，廣告主就可以直接與其他企業分享廣告受眾。另請參閱參考資料：自訂廣告受眾和參考資料：自訂廣告受眾分享帳號資訊。

若要建立關係，請向特定 custom_audience_id 發出下列呼叫：

POST {custom_audience_id}/adaccounts?adaccounts=[<ad_account_id>]&relationship_type=[<relationship_type>] 

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

• 如果廣告帳號之間有已經核准的關係，我們會直接將廣告受眾與這些廣告帳號分享。
• 如果廣告帳號之間有等待核准中的關係，我們會在要求中加入廣告受眾編號，如此，當收到要求的企業核准此要求時，我們就會分享廣告受眾。
• 如果廣告帳號之間沒有任何關係，我們會與附加的廣告受眾編號建立分享協議，如此，當收到要求的企業核准此要求時，我們就可以分享廣告受眾。

Facebook 會針對傳入要求的每個廣告帳號，傳回 sharing_data 物件。舉例來說：

{  
    success: true,
    sharing_data : [
     {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
     },
     ...
    ]
}

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

範例

如果您沒有企業管理平台的管理員權限，而嘗試分享廣告受眾，會出現類似如下的錯誤訊息：

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

在您發出要求之後，如果擁有被要求之廣告帳號的企業未與您建立關係，則該企業可能會收到待回覆的分享廣告受眾關係確認要求。該企業可以在自己的企業管理平台上看到此狀態。這時候，該企業可以核准或拒絕關係確認要求：

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

成功時，該企業會收到下列回應：

{  
    success: bool
}

選項包括：

收到關係確認要求的企業核准要求之後，您就可以和該企業分享廣告受眾。當您發出要求時，sharing_data 如下：

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
...
]

如果您是企業管理平台的管理員，並且透過待回覆關係確認要求來分享廣告受眾，Facebook 會將現有的關係附加至廣告受眾編號：

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
...
]

由於您可以在要求中指定多個廣告帳號來分享廣告受眾，因此在回應中會顯示每個帳號的結果：

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

若要檢視您的企業所收到的分享廣告受眾要求：

GET <BUSINESS_ID>/received_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

回應如下所示：

{
    "data": [   
        {         
           "initiator": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name1"         
            }, 
            "recipient": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]     
         }
         ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}

若要檢視您的企業所傳送的與其他企業分享廣告受眾要求：

GET <BUSINESS_ID>/initiated_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

回應如下所示：

{
    "data": [
        {         
            "initiator": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name1"         
            }, 
            "recipient": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",         
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]    
        }
        ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}