التصريح
تتحقق عملية التصريح من المستخدمين والتطبيقات التي ستتمكن من الوصول إلى API تسويق وتمنحهم أذونات.
أدوار التطبيقات
في لوحة معلومات التطبيق، يمكنك تعيين الأدوار لنفسك أو لأعضاء الفريق حسب الضرورة: المسؤول، المطوّر، المُختبر.
ملاحظة: اعتمادًا على حالة الاستخدام المقصودة لديك، قد تحتاج إلى إرسال تطبيقك للمراجعة للحصول على صلاحية الوصول إلى أذونات محددة تتعلق بإدارة الإعلانات.
مستويات الوصول والأذونات والميزات
تخضع تطبيقات الأنشطة التجارية إلى طبقة إضافية من طبقات تصريح Graph API تُعرف باسم مستويات الوصول. وأثناء عملية مراجعة التطبيقات، يجب أيضًا على تطبيقك طلب أذونات وميزات محددة.
يتم فرض تقييدات على كل مستوى، يمكنك الرجوع إلى مستويات الوصول والميزات لمزيد من المعلومات. يجب أيضًا على كل المطوّرين اتباع كل شروط المنصة وسياسات المطوّرين في Meta. ويتم إجراء الاستدعاءات على أي مستوى وصول مقابل بيانات الإنتاج.
مستويات الوصول للميزات
| مستوى الوصول للميزة | الوصف |
|---|---|
يتم الموافقة على تطبيقات الأنشطة التجارية تلقائيًا للحصول على وصول قياسي بالنسبة لكل الأذونات والميزات المتوفرة لنوع تطبيق الأعمال. يمكنك استخدام هذا الخيار إذا كنت تبدأ في الاستخدام. بإمكانك إنشاء تدفقات عمل شاملة قبل طلب الأذونات الكاملة، كما يمكنك الوصول إلى عدد غير محدود من الحسابات الإعلانية. قد لا تتوفر بعض استدعاءات API باستخدام الوصول القياسي نظرًا إلى أنها قد تنتمي إلى عدة حسابات أو لأنه لا يمكن تحديد الحساب المتأثر بطريقة برمجية. | |
يجب الموافقة على الوصول المتقدم من خلال عملية مراجعة التطبيقات على أساس إذن وميزة فرديين.
بعد إرسال معلوماتك، ستستجيب Meta للطلب إما بالقبول أو الرفض مع توفير المعلومات إذا كان تطبيقك غير مؤهل للوصول القياسي. وإذا تمت الموافقة على منحك الوصول المتقدم، فستحتاج إلى إكمال ما يلي للاحتفاظ بحالة الوصول:
|
للتحقق من مستوى الوصول الحالي، انتقل إلى لوحة معلومات التطبيق > مراجعة التطبيقات > الأذونات والميزات.
تعيين الوصول إلى API التسويق مقابل الوصول القياسي إلى إدارة الإعلانات
| الوصول إلى API التسويق | الوصول القياسي لإدارة الإعلانات | الإجراء |
|---|---|---|
الوصول للتطوير | الوصول القياسي | افتراضيًا |
الوصول القياسي | الوصول المتقدم | التقديم في لوحة معلومات التطبيق |
الأذونات والميزات
تتغير الأذونات التي يجب عليك طلبها بناءً على API التي تريد الوصول إليها.
إذا كان تطبيقك يدير حسابك الإعلاني فقط، فسيكون توفير الوصول القياسي والإذنين ads_read وads_management كافيًا. وإذا كان تطبيقك يدير الحسابات الإعلانية لأشخاص آخرين، فستحتاج إلى توفير الوصول المتقدم والإذنين ads_read و/أو ads_management. يمكنك الرجوع إلى كل الأذونات المتوفرة لتطبيقات الأعمال.
تتغير الميزات التي يجب عليك طلبها بناءً على الطريقة التي تريد اتباعها عند استخدام واجهات API لدينا. إذا كنت تدير إعلانات، فإن الميزة المشتركة التي يمكنك طلبها هي الوصول القياسي لإدارة الإعلانات. يمكنك الرجوع إلى كل الميزات المتوفرة لتطبيقات الأعمال.
للحصول على صلاحية الوصول المتقدم للوصول القياسي لإدارة الإعلانات، يحتاج تطبيقك إلى استيفاء المتطلبات التالية:
- إجراء ما لا يقل عن 1500 عملية استدعاء لواجهة API التسويق خلال آخر 15 يومًا بنجاح.
- إجراء عمليات استدعاء لواجهة API التسويق بمعدل خطأ أقل من 10% خلال آخر 15 يومًا.
إذا كنت تدير إعلانات أحد الأشخاص، فيمكنك استخدام المعلمة scope لمطالبته بالحصول على الأذونات ads_management أو ads_read. ويحصل تطبيقك على الوصول عندما الشخص على السماح.
https://www.facebook.com/v21.0/dialog/oauth?
client_id=<YOUR_APP_ID>
&redirect_uri=<YOUR_URL>
&scope=ads_management
ملاحظة: عند إدخال حقل YOUR_URL، ضع / في النهاية (على سبيل المثال، http://www.facebook.com/).
أمثلة
| حالة الاستخدام | الطلب |
|---|---|
عندما تريد قراءة الإعلانات الخاصة بالحسابات الإعلانية التي تملكها أو التي تم منحك إمكانية الوصول إليها من قبل مالكي هذه الحسابات الإعلانية أو إداراتها. |
|
عندما تريد قراءة تقارير الإعلانات الخاصة بالحسابات الإعلانية التي تملكها أو التي تم منحك إمكانية الوصول إليها من قبل مالكي هذه الحسابات الإعلانية. |
|
عندما تريد سحب تقارير الإعلانات من مجموعة من العملاء وقراءة الإعلانات وإدارتها من مجموعة أخرى من العملاء. |
|
الميزات ومستويات الوصول
يعرض الجدول أدناه مدى تأثير مستويات الوصول القياسي والمتقدم على ميزة الوصول القياسي لإدارة الإعلانات.
| الوصول القياسي | الوصول المتقدم | |
|---|---|---|
تقييدات الحساب | يمكنك إدارة عدد غير محدود من الحسابات الإعلانية. يقوم مسؤولو التطبيق أو المعلنون بإجراء استدعاءات API نيابة عن مسؤولي الحساب الإعلاني أو المعلنين. | يمكنك إدارة عدد غير محدود من الحسابات الإعلانية بافتراض أنك حصلت على الإذن |
تقييدات معدلات الاستدعاء | تقييد شديد لمعدلات الاستدعاء لكل حساب إعلاني. لمستوى التطوير فقط. أن يكون غير مخصص لتطبيقات الإنتاج التي تكون قيد التشغيل للمعلنين أثناء البث المباشر. | تقييد بسيط لمعدلات الاستدعاء لكل حساب إعلاني. |
مدير الأعمال | وصول محدود إلى واجهات API مدير الأعمال والكتالوج. لا يتوفر وصول إلى مدير الأعمال لإدارة الحسابات الإعلانية وأذونات المستخدم والصفحات. | وصول كامل إلى كل واجهات API مدير الأعمال والكتالوج. |
مستخدم النظام | يمكن إنشاء مستخدم نظام واحد ومستخدم نظام مسؤول واحد. | يمكن إنشاء 10 من مستخدمي النظام ومستخدم نظام مسؤول واحد. |
إنشاء الصفحات | لا يمكن إنشاء الصفحات من خلال API. | لا يمكن إنشاء الصفحات من خلال API. |
مستويات الوصول مقابل الوصول القياسي لإدارة الإعلانات
تحتوي أذونات وميزات التطبيقات على مستويين مختلفين من مستويات الوصول وهما: الوصول القياسي والوصول المتقدم. يُرجى ملاحظة أن استخدام مصطلح "الوصول القياسي" هنا لا يرتبط بميزة الوصول القياسي لإدارة الإعلانات. ولا تزال صلاحية الوصول المتقدم للوصول القياسي لإدارة الإعلانات تتطلب أن يخضع التطبيق لعملية المراجعة للحصول على صلاحية الوصول إلى الميزة.
التحقق من النشاط التجاري
التحقق من صحة النشاط التجاري هو عملية تتيح لنا التحقق من صحة هويتك باعتبارك كيانًا لنشاط تجاري حيث نطالب بإجراء هذا التحقق إذا كان تطبيقك سيصل إلى بيانات حساسة. تعرف على المزيد حول عملية التحقق من النشاط التجاري.