مشاركة الجماهير المخصصة بين حسابات مديري الأعمال

تحدد API مدير الأعمال أدوارًا ومسؤوليات واضحة عند الوصول إلى جمهور ينتمي إلى نشاط تجاري آخر.

عند مشاركة جمهور مخصص بين الأطراف، يجب أولاً إنشاء علاقة شراكة بين حسابات مدير الأعمال. يوجد هذا في قسم Partners من Business Settings في مدير الأعمال. يجب أيضًا على الطرف الذي يشارك الجمهور تأكيد امتثاله لشروط خدمة الجمهور المخصص المتوفرة في مدير الأعمال، راجع فيسبوك، شروط الجمهور المخصص.

بمجرد إنشائها، تمكن علاقة المشاركة النشاط التجاري من مشاركة الجماهير مع حساب مدير أعمال آخر. ومع ذلك، لا يمكن مشاركة الجماهير إلا في اتجاه واحد. هذا يعني أنه تتم مشاركة الجمهور من النشاط التجاري رقم 1 إلى النشاط التجاري رقم 2. لن يتمكن النشاط التجاري رقم 2 من مشاركة الجماهير مرة أخرى إلى النشاط التجاري رقم 1 ما لم يتم إنشاء علاقة مشاركة منفصلة من النشاط التجاري رقم 2 إلى رقم 1.

منذ عام 2018، من أجل مشاركة جمهور مخصص بين حسابات مدير الأعمال، أصبح يتعين على هذه الأنشطة التجارية إنشاء علاقة لمشاركة الجمهور على النحو التالي. تحتاج إلى إذن مسؤول مدير الأعمال لطلب علاقة مشاركة الجمهور. إذا تم إنشاء علاقة بالفعل بواسطة اثنين من حسابات مديري الأعمال، فيمكن للمعلن مشاركة الجمهور مباشرةً مع النشاط التجاري الآخر. راجع أيضًا المرجع، الجمهور المخصص والمرجع، معلومات الحساب المشترك للجمهور المخصص.

لإنشاء علاقة، أرسل هذا الاستدعاء إلى custom_audience_id محدد:

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

نتعامل مع الطلب بناءً على حالة العلاقة مع النشاط التجاري الآخر:

• بالنسبة للحسابات الإعلانية التي لها علاقة معتمدة حالية، فإننا نشارك الجمهور مباشرةً معها.
• بالنسبة للحسابات الإعلانية التي لها علاقة قيد التقدم، فإننا نضيف معرف الجمهور إلى الطلب بحيث عندما يوافق النشاط التجاري المستلم على هذا الطلب، تتم مشاركة الجمهور بعد ذلك.
• بالنسبة للحسابات الإعلانية غير محددة العلاقة، فإننا نقوم بإنشاء اتفاقية مشاركة مع معرف الجمهور المرفق بها بحيث عندما يوافق النشاط التجاري المستلم على هذا الطلب، يمكننا بعد ذلك مشاركة الجمهور.

يرجع فيسبوك كائن 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" : []
    }
...
]

إذا كان يتوفر لديك دور المسؤول في حساب مدير الأعمال وكنت تشارك جمهورًا من خلال طلب علاقة معلق، فسيقوم فيسبوك بإلحاق معرف الجمهور بالعلاقة الحالية:

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