‏‎Business Management APIs‎‏

مشاركة بيكسل Meta بين الأنشطة التجارية

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

فيما يلي عمليات دمج API اللازمة لإنشاء علاقة بين البيكسل والنشاط التجاري للوكالة. إذا كان النشاط التجاري (الوكالة) المستلم يدير أيضًا إعلانات للعميل ويحتاج إلى استخدام ذلك البيكسل للحسابات الإعلانية، فانظر الخطوة الثالثة.

المتطلبات الأساسية: متطلبات التطبيق

يجب أن تتوفر لدى التطبيقات ميزة الوصول القياسي لإدارة الإعلانات (الوصول المتقدم). يجب أن تتوفر لدى التطبيقات الأذونات التالية أيضًا:

  • business_management
  • ads_management أو ads_read وmanage_pages

الخطوة الأولى: بدء مشاركة البيكسل مع النشاط التجاري للوكالة

يتطلب هذا وجود رمز وصول المستخدم مع أذونات التطبيق المذكورة أعلاه من جانب مسؤول النشاط التجاري الذي يملك البيكسل.

POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]

تتضمن الخيارات والمعلمات لهذا الطلب ما يلي:

الاسم الوصف

business

النوع: numeric (قيمة رقمية)

مطلوب.

معرف النشاط التجاري للوكالة الذي يحصل على صلاحية الوصول إلى البيكسل

permitted_tasks

النوع: list:string (قائمة:سلسلة)

مطلوب.

مثال: ["ANALYZE"، "UPLOAD"، "ADVERTISE"]

المهام المسموح بها للوكالة في البيكسل

القيم الممكنة: ANALYZE، UPLOAD، ADVERTISE، EDIT

ANALYZE: العرض والتحليل والإعلان.

UPLOAD: تحميل بيانات التحويل على موقع الويب في مجموعة البيانات هذه.

ADVERTISE: ربط الحسابات الإعلانية بمجموعة بيانات فيسبوك هذه. استخدم مجموعة البيانات هذه للإعلان.

EDIT: إدارة مجموعة البيانات وتعديل الإعدادات والتحليل والإعلان. (تُعد إمكانية الوصول EDIT (للتعديل) مقيدة حاليًا، اتصل بممثل Meta لإدراج تطبيقك في قائمة السماح)

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

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

إذا تمت مشاركة البيكسل بنجاح مع النشاط التجاري، فسيتم إرجاع الاستجابة التالية:

{  
    success: true,
}

إذا كان الطلب معلقًا بانتظار قبول اتفاقية المشاركة، فإن طلب API سيرجع الاستجابة التالية مع pending_request_id. عندما يقبل النشاط التجاري المستلم الطلب، ستتم مشاركة البيكسل تلقائيًا مع النشاط التجاري المستلم. انظر الخطوة الثانية لقبول/رفض الطلب.


{
  "success": true,
  "pending_request_id": "{request_id}"
}

لاحظ أنه يوجد تقييد لعدد الأنشطة التجارية التي يمكن مشاركة البيكسل معها.

الخطوة الثانية: قبول الطلب المعلق (إذا لزم الأمر)

بعد بدء طلب مشاركة البيكسل، قد يستلم النشاط التجاري للوكالة طلب مشاركة اتفاقية معلق، إذا لم تكن الوكالة لديها بالفعل علاقة قائمة مع النشاط التجاري الذي يمتلك البيكسل. يمكن لمسؤولي الأعمال المستلمين عرض هذا الطلب وقبوله في مدير الأعمال لديهم.

للموافقة على طلب العلاقة أو رفضه باستخدام API، احصل على request_id من استجابة الخطأ في الخطوة الأولى.

تتطلب API وجود رمز وصول مستخدم من جانب مسؤول النشاط التجاري المستلم مع الإذن business_mangement أو ads_management permission للتطبيق.

POST <request_id>?request_status="approve"

عند نجاح العملية، تُرجع API هذه الاستجابة:

{  
    success: bool
}

تتضمن الخيارات والمعلمات لهذا الطلب ما يلي:

الاسم الوصف

request_status

النوع: string (سلسلة)

مطلوب.

ما إذا كان النشاط التجاري الذي يستلم طلب مشاركة البيكسل يوافق على الطلب أو يرفضه.


القيم الممكنة: APPROVE، DECLINE

الخطوة الثالثة: مشاركة البيكسل مع الحسابات الإعلانية للنشاط التجاري لدى الوكالة

إذا كانت هناك وكالة تدير الإعلانات لعميل ما وتحتاج إلى السماح للحسابات الإعلانية المخصصة للعميل باستخدام مجموعة بيانات البيكسل، فاستخدم API هذه.

بمجرد مشاركة البيكسل في نشاط تجاري لديه أذونات advertise/analyze (الإعلان/التحليل)، يمكن للنشاط التجاري السماح للحسابات الإعلانية الموجودة في النشاط التجاري باستخدام مجموعة بيانات البيكسل للإعلان.

تتطلب API رمز وصول المستخدم مع الأذونات business_management أو ads_management أو ads_read من جانب مسؤول النشاط التجاري.

Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
الاسم الوصف

business_id

النوع: numeric (قيمة رقمية)

مطلوب.

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

ad_account_id

النوع: numeric (قيمة رقمية)

مطلوب.

الحساب الإعلاني الذي سيتم السماح به في البيكسل.

الخطوة الرابعة: حذف اتصال مشاركة البيكسل

إذا لم يعد الاتصال بين البيكسل والنشاط التجاري للوكالة مطلوبًا، فاستخدم API التالية لحذف الاتصال.

Delete <adspixel>/agencies?business=<agency_business_id>

تتطلب API رمز وصول المستخدم المسؤول من جانب النشاط التجاري الذي يملك البيكسل.

عند نجاح العملية، تُرجع API هذه الاستجابة:

{  
    success: true
}

معرفة المزيد