Business Management APIs

Chia sẻ Đối tượng tùy chỉnh giữa các Trình quản lý kinh doanh

Tài liệu liên quan

API Trình quản lý kinh doanh thiết lập vai trò và trách nhiệm rõ ràng khi truy cập đối tượng thuộc một doanh nghiệp khác.

Khi Đối tượng tùy chỉnh được chia sẻ giữa các bên, trước tiên, phải thiết lập mối quan hệ đối tác giữa các Trình quản lý kinh doanh. Các bên có thể thực hiện thao tác này ở phần Partners của Business Settings trong Trình quản lý kinh doanh. Bên chia sẻ đối tượng cũng phải xác nhận việc họ tuân thủ các điều khoản dịch vụ về Đối tượng tùy chỉnh có trong Trình quản lý kinh doanh. Hãy xem Facebook, Điều khoản về đối tượng tùy chỉnh.

Sau khi được thiết lập, mối quan hệ chia sẻ sẽ cho phép doanh nghiệp chia sẻ đối tượng với Trình quản lý kinh doanh khác. Tuy nhiên, doanh nghiệp chỉ có thể chia sẻ đối tượng theo một chiều. Tức là Doanh nghiệp 1 chia sẻ đối tượng với Doanh nghiệp 2. Doanh nghiệp 2 sẽ không thể chia sẻ lại đối tượng với Doanh nghiệp 1, trừ khi Doanh nghiệp 2 đã thiết lập riêng một mối quan hệ chia sẻ với Doanh nghiệp 1.

Kể từ năm 2018, để chia sẻ Đối tượng tùy chỉnh giữa các Trình quản lý kinh doanh, những doanh nghiệp đó cần phải thiết lập mối quan hệ chia sẻ đối tượng như sau. Bạn cần có quyền quản trị viên của Trình quản lý kinh doanh để yêu cầu thiết lập mối quan hệ nhằm chia sẻ đối tượng. Nếu 2 Trình quản lý kinh doanh đã thiết lập mối quan hệ, nhà quảng cáo có thể chia sẻ thẳng đối tượng với doanh nghiệp còn lại. Hãy xem thêm Tài liệu tham khảo, Đối tượng tùy chỉnh và Tài liệu tham khảo, Thông tin tài khoản đã chia sẻ đối tượng tùy chỉnh.

Để tạo mối quan hệ, hãy thực hiện lệnh gọi sau đây đến custom_audience_id cụ thể:

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

Chúng tôi xử lý yêu cầu dựa trên trạng thái của mối quan hệ với doanh nghiệp kia:

  • Đối với tài khoản quảng cáo đã có mối quan hệ được phê duyệt, chúng tôi sẽ chia sẻ thẳng đối tượng với tài khoản đó.
  • Đối với tài khoản quảng cáo có mối quan hệ đang chờ xử lý, chúng tôi sẽ thêm ID đối tượng vào yêu cầu để chia sẻ đối tượng sau khi doanh nghiệp của người nhận phê duyệt yêu cầu này.
  • Đối với tài khoản quảng cáo không có mối quan hệ nào, chúng tôi sẽ tạo thỏa thuận chia sẻ có đính kèm ID đối tượng để có thể chia sẻ đối tượng sau khi doanh nghiệp của người nhận phê duyệt yêu cầu này.

Facebook trả về đối tượng sharing_data cho từng tài khoản quảng cáo được chuyển vào yêu cầu. Ví dụ:

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

Tùy chọn và thông số cho yêu cầu này bao gồm:

Cấp độ Mô tả

adaccounts

loại: list:numericstring

ID của các tài khoản quảng cáo mà bạn muốn chia sẻ đối tượng.

relationship_type

loại: list:string

Bắt buộc.

Biểu thị mối quan hệ giữa doanh nghiệp sở hữu đối tượng và doanh nghiệp của người nhận sẽ được chia sẻ đối tượng. Mảng gồm tất cả giá trị sẽ áp dụng.


Giá trị có thể sử dụng: Audience Info Provider, Information Manager, Ad Optimizer, Agency

Ví dụ

Nếu không có quyền quản trị viên cho Trình quản lý kinh doanh và cố chia sẻ đối tượng, bạn sẽ gặp lỗi tương tự như sau:

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

Sau khi bạn gửi yêu cầu, doanh nghiệp sở hữu tài khoản quảng cáo của người nhận có thể nhận được một yêu cầu xác nhận quan hệ với đối tượng được chia sẻ ở trạng thái đang chờ nếu họ chưa thiết lập mối quan hệ với bạn. Họ có thể nhìn thấy trạng thái này trên Trình quản lý kinh doanh. Vào thời điểm doanh nghiệp có thể phê duyệt hoặc từ chối yêu cầu xác nhận quan hệ:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

Khi thành công, doanh nghiệp sẽ nhận được phản hồi sau đây:

{  
    success: bool
}

Tùy chọn bao gồm:

Tên Mô tả

request_response

loại: string

Liệu doanh nghiệp nhận được yêu cầu xác nhận quan hệ sẽ phê duyệt hay từ chối yêu cầu đó.


Giá trị có thể sử dụng: approve, decline

Sau khi doanh nghiệp phê duyệt yêu cầu xác nhận quan hệ đã nhận được, bạn có thể chia sẻ đối tượng với họ. Khi bạn gửi yêu cầu, sharing_data sẽ có dạng như sau:

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

Nếu bạn là quản trị viên của Trình quản lý kinh doanh và chia sẻ đối tượng với yêu cầu xác nhận quan hệ ở trạng thái đang chờ, Facebook sẽ thêm ID đối tượng vào mối quan hệ hiện có:

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

Vì bạn có thể chỉ định nhiều tài khoản quảng cáo trong yêu cầu chia sẻ đối tượng nên kết quả cho từng tài khoản sẽ xuất hiện trong phản hồi:

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

Cách xem yêu cầu chia sẻ đối tượng mà doanh nghiệp của bạn nhận được:

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

Phản hồi có dạng như sau:

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

Cách xem yêu cầu chia sẻ đối tượng với người khác mà doanh nghiệp bạn đã gửi:

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

Phản hồi có dạng như sau:

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