비즈니스 관리자 간 맞춤 타겟 공유

비즈니스 관리자 API는 다른 비즈니스에 속한 타겟에 액세스할 때 명확한 역할과 책임을 설정합니다.

맞춤 타겟을 사용자 간에 공유할 경우 먼저 비즈니스 관리자 사이에 파트너십 관계가 성립해야 합니다. 이 내용은 비즈니스 관리자의 비즈니스 설정에 있는 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은 다음과 같이 상대 비즈니스와의 관계 상태를 기반으로 요청을 처리합니다.

• 기존에 승인된 관계가 있는 광고 계정의 경우, Facebook이 직접 타겟을 공유합니다.
• 기존에 현재 진행 중인 관계가 있는 광고 계정의 경우, Facebook이 요청에 타겟 ID를 추가하고 요청을 수신한 비즈니스가 요청을 승인한 다음에 타겟을 공유합니다.
• 아무 관계가 없는 광고 계정의 경우, Facebook이 요청에 포함된 타겟 ID로 공유 계약을 만들고 요청을 수신한 비즈니스가 요청을 승인한 다음에 타겟을 공유합니다.

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이 다음과 같이 기존 관계와 타겟 ID를 덧붙입니다.

[   
    {         
       "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>"
        }
    }
}