Skip to main content
POST
عزّز منشورًا موجودًا على Facebook لإنشاء إعلان. تتيح لك نقطة النهاية هذه تحويل منشوراتك العضوية إلى إعلانات مدفوعة مع معلمات استهداف وميزانية وجدولة مخصصة.
  • يجب تحديد قيم الميزانية وعرض السعر بالدولار الأمريكي بحد أقصى منزلتين عشريتين.
  • يجب أن يعمل الإعلان لمدة 30 ساعة على الأقل لتلبية متطلبات Facebook.
  • يمكنك استخدام نقطة نهاية الاهتمامات للعثور على معرّفات الاهتمامات للاستهداف.
  • قد يستغرق Facebook حتى 24 ساعة لمراجعة المنشورات المُعزَّزة والموافقة عليها.
  • عند استخدام fbPostId مباشرةً (بدلاً من postId الخاص بـ Ayrshare)، تأكّد من أنه معرّف منشور Facebook صالح.
  • إذا فشل التعزيز بعد أن أنشأ Facebook حملته (في خطوة التصميم الإعلاني أو مجموعة الإعلانات أو الإعلان)، فإننا نحاول حذف تلك الحملة. وإذا فشل الحذف أيضًا، تبقى الحملة الفارغة في حسابك الإعلاني. يمكنك العثور عليها وحذفها في Ads Manager.
ترفض Meta الإعلان حتى يتوفر الشرطان التاليان:
  • طريقة دفع في الحساب الإعلاني. أضف طريقة دفع في الفوترة والمدفوعات لدى Meta واربطها بالحساب الإعلاني الذي ترسله في accountId. لا تكفي طريقة دفع محفوظة في حافظة الأعمال فقط.
  • تفعيل الإعلانات المخصّصة (الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية وسويسرا). إذا اختار مالك حساب Facebook أو Instagram المرتبط بصفحة Facebook الخاصة بك عرض إعلانات أقل تخصيصًا، أو اشترك لاستخدام Meta بدون إعلانات، فلن تسمح Meta لذلك الحساب ولا للصفحة بعرض الإعلانات. يمكن للمالك العودة إلى الإعلانات المخصّصة، أو إلغاء الاشتراك، من مركز الحسابات ← تفضيلات الإعلانات ← تجربة الإعلانات. اعرف المزيد.

أهداف الإعلان

يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.
  • engagement: يسعى هذا الهدف إلى زيادة التفاعل مع ضمان أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين الفريدين. يوازن بين الوضوح والتفاعل، ويعرض الإعلان لأكبر عدد ممكن من الأشخاص المختلفين الذين قد يتفاعلون معه.
  • interactions: مصمم لزيادة التفاعلات، مثل الإعجابات والتعليقات والمشاركات، على الإعلان. يعطي Facebook الأولوية لعرض الإعلان للمستخدمين الأكثر احتمالاً للتفاعل معه.
  • awareness_views: يركّز على زيادة الوعي بالعلامة التجارية من خلال تعظيم عدد المرات التي يُعرض فيها الإعلان. يعطي الأولوية لعرض الإعلان لأكبر عدد ممكن من المرات ضمن الميزانية، بغض النظر عن الوصول الفريد.
  • awareness_audience: يهدف إلى تعزيز الوعي بالعلامة التجارية من خلال تعظيم عدد الأشخاص الفريدين الذين يرون الإعلان. يضمن أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين المختلفين ويعظّم حجم الجمهور الفريد بدلاً من عرضه عدة مرات لنفس الجمهور.
  • traffic: يرسل الأشخاص خارج Facebook إلى وجهة تختارها، مثل موقعك الإلكتروني أو صفحة هبوط أو إعلان وظيفة. يُحسّن Facebook للنقرات على الرابط بدلاً من التفاعل داخل المنصة. هذا هو الهدف الوحيد الذي يدعم زر callToAction.
اعرف المزيد عن دمج Facebook Marketing API مع Ayrshare في دليل تكامل Facebook Marketing API.

معلمات الترويسة

معلمات الجسم

string
مطلوب
معرّف حساب إعلانات Facebook لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من نقطة نهاية حسابات الإعلانات.
string
مطلوب
اسم إعلانك (يظهر في Facebook Ad Manager) بالتنسيق {adName} - {postId or fbPostId} - {current date}.
number
مطلوب
الحد الأقصى لعرض السعر بالدولار الأمريكي. الحد الأدنى لعرض السعر هو 1.00 دولار.
number
مطلوب
الميزانية اليومية بالدولار الأمريكي. الحد الأدنى للميزانية هو 1.00 دولار.
string
مطلوب
معرّف المنشور الاجتماعي على Facebook للمنشور المراد تعزيزه، مما يتيح لك إنشاء إعلان من منشور تم إنشاؤه مباشرة على Facebook. هذا هو معرّف المنشور على Facebook، وليس Ayrshare. مطلوب إذا لم يتم تعيين postId.
string
افتراضي:"engagement"
مطلوب
هدف الإعلان. القيم: engagement, interactions, awareness_views, awareness_audience, وtraffic. راجع تفاصيل أهداف الإعلان أعلاه لمزيد من المعلومات.
object
استهدف مواقع الإعلان بكائن من المصفوفات: countries, regions, cities. يُرفض الكائن الذي لا يحدد أي دولة أو منطقة أو مدينة، مثل {}، مع الرمز 101؛ احذف locations لاستهداف الولايات المتحدة.
string
مطلوب
معرّف منشور Ayrshare للمنشور المراد تعزيزه. مطلوب إذا لم يتم تعيين fbPostId.
string
افتراضي:"active"
مطلوب
حالة الإعلان. القيم: active وpaused.يمكنك لاحقًا تغيير حالة الإعلان باستخدام نقطة نهاية تحديث الإعلان.
boolean
افتراضي:false
يتحكم في مشاركة ميزانية مجموعة الإعلانات على مستوى الحملة في Meta. تتطلب Meta الآن هذا الحقل على كل حملة يتم إنشاؤها بدون ميزانية على مستوى الحملة، لذا يرسله Ayrshare دائمًا — بشكل افتراضي false للحفاظ على التوافق مع الإصدارات السابقة.عيّنه على true للسماح لـ Meta بمشاركة ما يصل إلى ~20% من ميزانية مجموعة الإعلانات عبر مجموعات إعلانات أخرى في نفس الحملة لتحسين الأداء العام. راجع مرجع مجموعة حملات الإعلانات من Meta للحصول على التفاصيل.
object
أضف زر دعوة إلى الإجراء، مثل Apply Now أو Shop Now، إلى المنشور المُعزَّز. يفتح الزر عنوان URL الذي تقدّمه في link، أو، مع destination، محادثة على Messenger أو WhatsApp أو Instagram Direct بدلًا من ذلك (راجع فتح محادثة بدلًا من رابط).
callToAction الذي يفتح رابطًا مدعوم فقط مع هدف الإعلان traffic. أما الزر الذي يحتوي على destination فيستخدم engagement أو interactions بدلًا من ذلك، كما هو موضح في فتح محادثة بدلًا من رابط. إرسال زر رابط مع engagement أو interactions أو awareness_views أو awareness_audience يعيد 400 مع code: 101 تُسمّي الأهداف المتوافقة. في السابق كانت القيمة تُقبل مع أي هدف ثم تُتجاهل بصمت، مما ينتج إعلانًا بلا زر.
يوفّر callToAction.link عنوان URL للوجهة. عندما تعرض Meta الدعوة إلى الإجراء كزر على المنشور الموجود، تُلحق urlTags برابط ذلك الزر. يُسمح بإرسال goal: "traffic" دون callToAction، وينشئ ذلك إعلان زيارات بلا زر.يُعاد callToAction الذي ترسله في استجابة التعزيز مع type بأحرف كبيرة — راجع مثال Post Boosted with a Call to Action — كما يُعاد لاحقًا على الإعلان من نقطة نهاية الإعلانات المُعزَّزة.لفتح محادثة على Messenger أو WhatsApp أو Instagram Direct بدلًا من رابط، راجع فتح محادثة بدلًا من رابط.
object
تتبّع الإعلان باستخدام Facebook Pixel.
array
أضف علامات UTM إلى عنوان URL الخاص بالإعلان.
على سبيل المثال، إذا كان عنوان URL للربط هو https://www.mysite.com/my-post وعلامات URL المُضافة هي:utm_source=ayrshare، وutm_medium=social، وutm_campaign=ayrshare-social.سيكون عنوان URL للإعلان: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
array
تطلب Meta من المعلنين في فئات الإعلانات الخاصة تعريف فئة حملتهم ذاتيًا.إذا كانت شركتك تندرج ضمن إحدى هذه الفئات، فيجب عليك تحديد الفئة المناسبة عند تعزيز منشورك.القيم التالية مدعومة:
  • housing: الإعلانات التي تروّج أو ترتبط مباشرة بفرصة إسكان أو خدمة ذات صلة، بما في ذلك على سبيل المثال لا الحصر قوائم بيع أو تأجير منزل أو شقة، وتأمين المنزل، وتأمين الرهن العقاري، وقروض الرهن العقاري، وإصلاحات الإسكان، وخدمات ملكية المنزل أو التقييم.
  • financial_product_services: الإعلانات التي تروّج أو ترتبط مباشرة بعرض منتجات وخدمات مالية، بما في ذلك الائتمان. تُقبل financial_products_services كتهجئة مكافئة، كما تُقبل credit بوصفها اسم Meta السابق لهذه الفئة — تصل القيم الثلاث جميعها إلى Meta كفئة واحدة نفسها، لذا أرسل أيًّا منها لديك بالفعل.
  • employment: الإعلانات التي تروّج أو ترتبط مباشرة بفرصة عمل، بما في ذلك على سبيل المثال لا الحصر الوظائف بدوام جزئي أو كامل، أو التدريبات، أو برامج الشهادات المهنية. الإعلانات ذات الصلة التي تندرج ضمن هذه الفئة تشمل ترويج لوحات الوظائف أو معارض العمل، وخدمات التجميع، أو الإعلانات التي تُفصّل مزايا الشركة قد تُقدّمها، بغض النظر عن عرض وظيفة محدد.
  • none: القيمة الافتراضية. تُصرّح بأن الحملة لا تندرج ضمن أي فئة إعلانات خاصة. إرسالها صراحةً يعادل حذف specialAdCategories تمامًا، وهي مقبولة حتى يتمكّن المستدعي الذي يرسل الحقل دائمًا من التصريح بـ “لا فئة” دون معالجته كحالة خاصة.
  • issues_elections_politics: الإعلانات المُقدَّمة من قِبل، أو نيابةً عن، أو حول مرشح لمنصب عام، أو شخصية سياسية، أو حزب سياسي، أو المطالبة بنتيجة انتخابات لمنصب عام. يشمل هذا أيضًا الإعلانات حول أي انتخابات أو استفتاء أو مبادرة اقتراع، بما في ذلك حملات “اخرج وصوّت”. الإعلانات المُنظَّمة كإعلانات سياسية أو حول القضايا الاجتماعية في أي مكان يتم فيه وضع الإعلان. عند اختيار القضايا أو الانتخابات أو السياسة، يجب عليك تحديد الدولة التي تريد تشغيل هذه الإعلانات فيها. يجب أن تكون مُخوَّلاً لتشغيل إعلانات حول القضايا الاجتماعية أو الانتخابات أو السياسة في الدولة المحددة.
القيم غير حساسة لحالة الأحرف. تُرفض القيمة غير المتعارف عليها بـ 400 وcode: 101 مع سرد القيم المقبولة. في السابق كانت القيمة غير المتعارف عليها تُسقط بصمت وتُنشأ الحملة دون تصنيف، فكان خطأ إملائي يترك إعلانًا خاضعًا للتنظيم يعمل دون التصريح بأي فئة.قائمة القيم المقبولة في رسالة الخطأ تلك مكتوبة بصيغة Meta ذات الأحرف الكبيرة وتذكر أيضًا التهجئات البديلة المذكورة أعلاه، فتظهر كالتالي: NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT. وهي الفئات الخمس نفسها المذكورة هنا — فـ FINANCIAL_PRODUCT_SERVICES وCREDIT مكافئتان لـ financial_product_services، وليستا فئتين إضافيتين. وتُعيد نقطة نهاية الاهتمامات الرسالة المطابقة.تكرار فئة، أو إرسال تهجئتين للفئة نفسها مثل ["credit", "financial_product_services"]، مقبول ويُدمج في فئة واحدة قبل وصوله إلى Meta. تُرفض القيمة الفارغة بـ 400 وcode: 101.للعثور على معرّفات الاهتمامات التي تسمح بها Meta لإحدى هذه الفئات، مرّر القيمة نفسها إلى نقطة نهاية الاهتمامات.تحتاج Meta أيضًا إلى معرفة الدول التي يُعرض فيها إعلان الفئة الخاصة. تأخذ Ayrshare هذه الدول من locations: الدول التي تحددها، بالإضافة إلى دولة كل منطقة ومدينة. لذا فإن تعزيز housing الذي يستهدف مدينة في المملكة المتحدة يُعدّ للمملكة المتحدة دون أي إضافة في طلبك. وبدون locations يُعرض الإعلان في الولايات المتحدة، وتُعدّ الحملة للولايات المتحدة.تحدد Meta أيضًا نصف قطر أدنى حول كل مدينة لهذه الفئات. فقد رُفضت مدينة في المملكة المتحدة بنصف قطر 17 كيلومترًا مع #2909039، الذي يتطلب 25 كيلومترًا (15 ميلًا) على الأقل، لذا استخدم 25 كيلومترًا أو أكثر.
تتطلب Meta من المعلنين تعريف فئة حملتهم ذاتيًا. تستخدم Meta المراجعين البشريين والتعلم الآلي لتحديد هذه الأنواع من الإعلانات. إذا أرسلت لنا specialAdCategory غير صحيح، فهناك خطر من إيقاف إعلاناتك مؤقتًا حتى يتم تعديل الحملة.
string
تاريخ ووقت الانتهاء بتنسيق ISO 8601 (يجب أن يكون على الأقل 30 ساعة بعد البداية)، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيعمل الإعلان إلى أجل غير مسمى وسيكون له تاريخ انتهاء ongoing.
object
استبعد المواقع باستخدام كائن مع مصفوفات countries وregions وcities.
string
افتراضي:"all"
جنس الجمهور. القيم: all وmale وfemale.
array
الاهتمامات المستهدفة للإعلان كمصفوفة من معرّفات اهتمامات Facebook.
number
افتراضي:65
الحد الأقصى للعمر لاستهداف الإعلان (الافتراضي: 65).
number
افتراضي:18
الحد الأدنى للعمر لاستهداف الإعلان (الافتراضي: 18).
string
تاريخ ووقت البدء بتنسيق ISO 8601، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيبدأ الإعلان فورًا.
string
المستفيد من الإعلان للامتثال لقانون الخدمات الرقمية (DSA) لدول الاتحاد الأوروبي. يجب تعيينه مع dsaPayor إذا تم تقديم أي منهما. يرجى الرجوع إلى دليل DSA لمزيد من المعلومات.
string
الدافع مقابل الإعلان للامتثال لقانون الخدمات الرقمية (DSA) لدول الاتحاد الأوروبي. يجب تعيينه مع dsaBeneficiary إذا تم تقديم أي منهما.

الميزانيات على مستوى الحملة

للاحتفاظ بالميزانية على الحملة بدلًا من مجموعة الإعلانات، أرسل budget.level: "campaign" في الصيغة المتداخلة لجسم طلب التعزيز. عندئذٍ لا تكون لمجموعة الإعلانات ميزانية خاصة بها. يعمل ذلك مع الميزانيات اليومية والإجمالية.
  • budget.level: adSet (الافتراضي) أو campaign. لا يمكن الجمع بين الميزانية على مستوى الحملة وadSetBudgetSharingEnabled. يُرفض إرسال كليهما مع 400 وcode: 101.
  • تضيف الاستجابة budgetLevel: "campaign" للميزانية على مستوى الحملة. لا تُرجع ميزانية مجموعة الإعلانات budgetLevel، لذا تعامل مع غياب الحقل على أنه adSet.
  • في السجل، يعرض budgetDaily الميزانية اليومية للحملة بالنسبة إلى الإعلان ذي الميزانية اليومية على مستوى الحملة. إذا تشاركت عدة إعلانات ميزانية حملة واحدة، يعرض كل منها ميزانية الحملة بالكامل، لا حصته منها. لا يعرض السجل الميزانيات الإجمالية، سواء على الحملة أو على مجموعة الإعلانات. بمجرد إنفاق ميزانية الحملة الإجمالية، يعرض كل إعلان في تلك الحملة deliveryStatus: "COMPLETED" بعد التحديث الليلي التالي، بما في ذلك الإعلان المجدول أو قيد المراجعة. يظل الإعلان المرفوض REJECTED.

التعزيز ضمن حملة أو مجموعة إعلانات موجودة

افتراضيًا، يُنشئ كل تعزيز حملته ومجموعة إعلاناته وإعلانه الخاصة. لإضافة التعزيز إلى حملة أو مجموعة إعلانات تديرها بالفعل في Meta، أرسل الصيغة المتداخلة مع attachTo.
  • attachTo.campaignId: يُنشئ التعزيز مجموعة إعلانات وإعلانًا جديدين داخل تلك الحملة. أرسل budget وtargeting وbidAmount كالمعتاد: فهي تُطبَّق على مجموعة الإعلانات الجديدة.
  • attachTo.adSetId: يُنشئ التعزيز الإعلان فقط، داخل مجموعة الإعلانات تلك. أرسل أيضًا attachTo.campaignId، وهي الحملة التي تنتمي إليها مجموعة الإعلانات. أغفل budget وtargeting وplatformOptions.facebook.bidAmount: إذ تحتفظ مجموعة الإعلانات بإعداداتها الخاصة. يؤدي إرسال أي منها إلى إرجاع 400 مع code: 101.
  • يجب أن تكون الحملة أو مجموعة الإعلانات ضمن الحساب الإعلاني المحدد بواسطة accountId، وألا تنتمي إلى تعزيزات مستخدم آخر. وإلا يُرجع الطلب 400. كذلك لا يمكن لتعزيز Facebook الارتباط بحملة أنشأها تعزيز Instagram، والعكس صحيح.
  • لا يمكن الجمع بين attachTo وbudget.level: "campaign" أو specialAdCategories أو adSetBudgetSharingEnabled، إذ تُضبط هذه على حملة جديدة. يؤدي إرسالها إلى إرجاع code: 101.
  • لا يُغيّر إيقاف التعزيز مؤقتًا أو تنشيطه إلا ما أنشأه التعزيز: الإعلان، ومجموعة الإعلانات إذا كان التعزيز هو من أنشأها. تحتفظ الحملة أو مجموعة الإعلانات التي حددتها في attachTo بحالتها الخاصة. لا يعمل الإعلان إلا عندما تكون الحملة ومجموعة الإعلانات اللتان تعلوانه نشطتين. ينطبق هذا أيضًا عندما توقف Ayrshare إعلاناتك مؤقتًا، على سبيل المثال عند حذف ملف شخصي.
  • إذا فشل التعزيز، فلا تُحذف أبدًا الحملة أو مجموعة الإعلانات المحددة في attachTo.
  • إذا كانت مجموعة الإعلانات التي ترتبط بها ضمن حملة تحمل الميزانية (ميزانية على مستوى الحملة)، فإن السجل يعرض التعزيز مثل أي إعلان بميزانية على مستوى الحملة: يعرض budgetDaily ميزانية الحملة بالكامل، لا حصة التعزيز منها، وبمجرد إنفاق ميزانية الحملة الإجمالية، يعرض كل إعلان تتتبعه Ayrshare في تلك الحملة deliveryStatus: "COMPLETED" بعد التحديث الليلي التالي، بما في ذلك الإعلان المجدول أو قيد المراجعة. يظل الإعلان المرفوض REJECTED.

فتح محادثة بدلًا من رابط

يمكن لزر التعزيز أن يفتح محادثة مع نشاطك التجاري بدلًا من صفحة ويب. أرسل الصيغة المتداخلة مع callToAction.destination، وأغفل callToAction.link.
  • استخدم هدف الإعلان engagement أو interactions. يُحسَّن الإعلان حينئذٍ للمحادثات: إذ تعرضه Meta على الأشخاص الذين يُرجَّح أن يبدؤوا محادثة. تُرجع الأهداف الأخرى 400 مع code: 101.
  • يجب أن يطابق callToAction.type الوجهة، كما في الجدول. تُقبل أي حالة أحرف.
  • لا يمكن إرسال callToAction.link وcallToAction.linkTitle مع destination، لأن الزر يفتح محادثة لا صفحة. بدون destination، يظل link مطلوبًا.
  • يراسل الأشخاص الحساب المرتبط بملفك الشخصي. بالنسبة إلى whatsapp، يجب أن تكون Facebook Page الخاصة به مرتبطة برقم WhatsApp Business في Meta.
  • لا يمكن الجمع بين destination وattachTo.adSetId: إذ تحتفظ مجموعة الإعلانات الموجودة بالوجهة التي لديها بالفعل. مع attachTo.campaignId، يجب أن يكون للحملة هدف Meta OUTCOME_ENGAGEMENT؛ وإلا يُرجع الطلب 400 مع code: 101.
  • تُرجع الاستجابة، ونقطة نهاية الإعلانات المُعزَّزة، callToAction مع destination الخاص به.