Berbagi Pemirsa Khusus antara Pengelola Bisnis

Business Manager API menetapkan peran dan tanggung jawab yang jelas ketika mengakses pemirsa milik bisnis lain.

Jika Pemirsa Khusus dibagikan antarpihak, hubungan kemitraan antara Pengelola Bisnis harus dibuat terlebih dahulu. Hal ini dapat dilakukan di bagian Partners dari Business Settings di Pengelola Bisnis. Pihak yang membagikan pemirsa harus menegaskan kepatuhannya pada ketentuan layanan Pemirsa Khusus kami di Pengelola Bisnis, lihat Facebook, Ketentuan Pemirsa Khusus.

Setelah dibuat, hubungan berbagi memungkinkan sebuah bisnis untuk berbagi pemirsa dengan Pengelola Bisnis lain. Namun, pemirsa hanya dapat dibagikan secara satu arah. Hal ini berarti pemirsa dibagikan dari Bisnis #1 ke Bisnis #2. Bisnis #2 tidak dapat membagikan pemirsa kembali ke Bisnis #1, kecuali jika ada hubungan berbagi terpisah yang dibuat dari Bisnis #2 ke Bisnis #1.

Sejak 2018, untuk berbagi Pemirsa Khusus antara Pengelola Bisnis, kedua bisnis tersebut harus membuat hubungan berbagi pemirsa, sebagai berikut. Anda perlu izin admin Pengelola Bisnis untuk meminta hubungan berbagi pemirsa. Jika dua Pengelola Bisnis telah membuat hubungan, pengiklan dapat secara langsung membagikan pemirsa kepada bisnis satunya. Lihat juga Referensi, Pemirsa Khusus dan Referensi, Info Akun Berbagi Pemirsa Khusus.

Untuk membuat hubungan, buat panggilan ini, ke custom_audience_id tertentu:

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

Kami menangani permintaan berdasarkan status hubungan dengan bisnis satunya:

• Untuk akun iklan yang sudah memiliki hubungan disetujui, kami membagikan pemirsa secara langsung dengan mereka.
• Untuk akun iklan yang sudah memiliki hubungan yang sedang dalam proses, kami menambahkan ID pemirsa ke permintaannya, sehingga ketika bisnis penerima menyetujui permintaan ini, kami dapat berbagi pemirsa.
• Untuk akun iklan yang tidak memiliki hubungan apa pun, kami membuat perjanjian berbagi dengan melampirkan ID pemirsa, sehingga ketika bisnis penerima menyetujui permintaan ini, kami dapat berbagi pemirsa.

Facebook mengembalikan objek sharing_data untuk setiap akun iklan yang diteruskan dalam permintaan. Contoh:

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

Opsi dan parameter untuk permintaan ini mencakup:

Contoh

Jika tidak memiliki izin admin untuk Pengelola Bisnis dan Anda mencoba membagikan pemirsa, Anda akan mendapat pesan kesalahan yang mirip dengan ini:

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

Setelah Anda membuat permintaan, bisnis yang memiliki akun iklan penerima akan memperoleh permintaan hubungan berbagi pemirsa yang menunggu persetujuan, jika mereka tidak memiliki hubungan dengan Anda. Mereka dapat melihat status ini di Pengelola Bisnis mereka. Pada saat itu bisnis itu dapat menyetujui atau menolak permintaan hubungan itu:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

Jika berhasil, bisnis itu akan memperoleh tanggapan ini:

{  
    success: bool
}

Opsinya mencakup:

Setelah bisnis yang menerima permintaan hubungan itu menyetujuinya, Anda dapat berbagi pemirsa dengan bisnis tersebut. Ketika Anda membuat permintaan, sharing_data akan menjadi seperti ini:

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

Jika Anda admin Pengelola Bisnis dan membagikan pemirsa dengan permintaan hubungan yang menunggu persetujuan, Facebook akan menambahkan ID pemirsa ke hubungan yang sudah ada:

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

Karena Anda dapat menentukan beberapa akun iklan dalam permintaan Anda untuk berbagi pemirsa, hasil untuk setiap akun akan muncul dalam tanggapannya:

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

Untuk melihat permintaan berbagi pemirsa yang diterima oleh bisnis Anda:

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

Tanggapannya terlihat seperti ini:

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

Untuk melihat permintaan berbagi pemirsa yang dikirimkan oleh bisnis Anda:

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

Tanggapannya terlihat seperti ini:

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