إعداد مدير أعمال تابع جديد

تم تصميم حل مدير الأعمال المكوّن من طبقتين في الأصل بحيث يتمكن كل رمز وصول مستخدم فقط من إنشاء مدير أعمال تابع واحد. ومع ذلك، بإمكان المستخدم الآن إنشاء عدة مديري أعمال تابعين طالما أن الصفحة الأساسية يتم تعيينها لكل مدير أعمال تابع.

البدء

قبل البدء، نوصي بمراجعة هذه المتطلبات والمعلومات:

أذونات التطبيق

• business_management
• ads_management

المعرفات

• PARENT_BM_ID: معرف مدير أعمال الشريك الذي يمتلك التطبيق.
• CHILD_BM_ID: معرف مدير الأعمال الذي ينشئه مدير الأعمال الأصل للعميل.

رموز الوصول

• USER_Personal_Access_Token: رمز الوصول الخاص بالشخص الذي يوفر بيانات الاعتماد لإنشاء حساب مدير أعمال تابع.

  • يتم إنشاء هذا الرمز باستخدام تسجيل دخول فيسبوك.
  • يجب على الشريك أن يطلب نطاقات business_management عالمية في الأنشطة التجارية والصفحات لدى المستخدم بدلاً من النطاقات التفصيلية.
  • يجب أن تتوفر لدى هذا الشخص امتيازات المسؤول على الصفحة التي تتم مشاركتها في مدير الأعمال التابع.
  • إذا كانت الصفحة مملوكة لمدير أعمال آخر، فيجب أن يتوفر لدى هذا الشخص امتيازات المسؤول على حساب مدير الأعمال الذي يملك الصفحة.
  • يتم استخدام هذا الرمز للتصريح بإنشاء حساب مدير أعمال فرعي ومشاركة الصفحة في حساب مدير الأعمال الفرعي للإعلان.
• PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: رمز وصول مستخدم النظام المسؤول في مدير الأعمال الأصل.

  • يتم استخدام هذا الرمز لإنشاء حسابات مدير الأعمال التابعة وإدارتها.
• CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: رمز الوصول لمستخدم النظام المسؤول الذي تم إنشاؤه في مدير الأعمال الفرعي.

  • يتم استخدام هذا الرمز لإنشاء الحملات الإعلانية والأنشطة الأخرى وإدارتها في حساب مدير الأعمال التابع.

إنشاء مدير أعمال تابع

باستخدام USER_Personal_Access_Token، أنشئ حساب مدير أعمال تابعًا.

مثال - يتم إرجاع معرف مدير الأعمال التابع

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

الاستجابة:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

إنشاء عدة مديري أعمال تابعين لكل مستخدم

إذا أراد المستخدم إنشاء مديري أعمال تابعين متعددين باستخدام بيانات اعتماد المستخدم نفسها، فيجب تعيين primary_page إلى مديري الأعمال التابعين الحاليين الذين تم إنشاؤهم لهذا المستخدم. يمكنك إجراء استدعاء POST آخر لتعيين primary_page لمدير الأعمال التابع الموجود:

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

عند إنشاء مدير أعمال تابع آخر:

• يجب أن يتوفر لدى جميع مديري الأعمال التابعين الحاليين primary_page فريدة.
• يجب تعيين shared_page_id على مدير الأعمال التابع الجديد.
• إذا تم استخدام shared_page_id لإنشاء مدير أعمال تابع جديد، فلا يمكن أن يكون primary_page على أي من مديري الأعمال التابعين الحاليين.

إعداد طريقة الدفع

للدفع مقابل إعلانات مدير الأعمال التابع، ستحتاج إلى مشاركة حد الائتمان لديك مع كل مدير أعمال تابع.

الخطوة الأولى. فتح حد ائتمان. تواصل مع ممثل فيسبوك وافتح حد ائتمان (LOC) ضمن مدير الأعمال هذا إذا لم يكن هناك واحدًا بالفعل. سيتم عرض حد الائتمان كطريقة دفع في مدير الأعمال الأساسي.

الخطوة الثانية. قبول الشروط القانونية لحد الائتمان.

1. افتح مدير الأعمال > إعدادات مدير الأعمال > طرق الدفع.
2. انقر على إعدادات الائتمان وانقر على "الشروط القانونية". قم بقبول الشروط القانونية.

الخطوة الثالثة. الحصول على معرف حد الائتمان ومشاركته مع مدير الأعمال التابع

1. انتقل إلى مدير الأعمال الأصل وإعدادات مدير الأعمال > طرق الدفع. وانقر على طريقة الدفع. قم بتخزين PARENT_BM_Line_Of_Credit_ID من عنوان URL. يبدو عنوان URL كما يلي:

   https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>

2. استخدم معرف حد ائتمان مدير الأعمال الأصل هذا في استدعاء API أدناه لمشاركة معرف حد الائتمان من مدير الأعمال الأصل مع مدير الأعمال التابع. يُعد amount اختياريًا.

   curl \
     -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
     -F 'amount=<OPTIONAL_PARAMETER>' \  
     -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
     -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
     https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs

الحصول على رمز وصول مستخدم النظام التابع

ضمن مدير الأعمال التابع، استخدم استدعاء API هذا لإنشاء مستخدم نظام والحصول على رمز الوصول. يتم استخدام هذا الرمز لكل الاستدعاءات اللاحقة لمدير الأعمال التابع لإنشاء الإعلانات أو إدارتها لهذا المستخدم.

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

الحصول على معرف مستخدم النظام

بمجرد الحصول على رمز الوصول، يمكنك استخدامه للحصول على معرف المستخدم على مستوى التطبيق. من المهم الاحتفاظ به لاستخدامه لاحقًا.

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

الحصول على معرف مصدر التمويل (حد الائتمان)

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

curl -G \
  -d 'fields=id,max_balance' \
  -d 'access_token=<Child BM Admin System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits

بدلاً من ذلك، يمكنك الحصول على مصدر التمويل عن طريق الانتقال إلى مدير الأعمال التابع وتحديد عمليات الدفع > النقر على طريقة الدفع بحد الائتمان. يؤدي هذا إلى ملء عنوان URL بمعلمة الدفع كما يلي:

payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=

2. قم بتخزين معرف طريقة الدفع لاستخدامه لاحقًا.

إنشاء حساب إعلاني جديد بمصدر تمويل افتراضي

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

إضافة مستخدم النظام كمسؤول في الحساب الإعلاني الجديد

أضف مستخدم النظام كمسؤول إلى الحساب الإعلاني الجديد ضمن مدير الأعمال التابع:

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

تهانينا! هذه هي الخطوة الأخيرة في إعداد مدير أعمال تابع لإنشاء الحملات الإعلانية للعملاء وإدارتها.

العثور على مديري الأعمال التابعين

للعثور على كل معرفات مديري الأعمال التابعين، يمكنك تشغيل الأمر التالي للفلترة حسب معرف مستخدم على مستوى التطبيق:

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

الخطوات التالية

تتضمن الموضوعات التالية ميزات/إجراءات إضافية يمكنك استخدامها لتعزيز تجربة مدير الأعمال.

راجع أيضًا دلائل مشاركة الأصول للوصول إلى أصول العميل في حسابات مدير الأعمال التابعة:

• الوظائف بين الأنشطة التجارية
• مشاركة بيكسل النشاط التجاري