الانتقال إلى المحتوى الرئيسي
POST
عزّز منشورًا موجودًا على Facebook لإنشاء إعلان. تتيح لك نقطة النهاية هذه تحويل منشوراتك العضوية إلى إعلانات مدفوعة مع معلمات استهداف وميزانية وجدولة مخصصة.
  • يجب تحديد قيم الميزانية وعرض السعر بالدولار الأمريكي بحد أقصى منزلتين عشريتين.
  • يجب أن يعمل الإعلان لمدة 30 ساعة على الأقل لتلبية متطلبات Facebook.
  • يمكنك استخدام نقطة نهاية الاهتمامات للعثور على معرّفات الاهتمامات للاستهداف.
  • قد يستغرق Facebook حتى 24 ساعة لمراجعة المنشورات المُعزَّزة والموافقة عليها.
  • عند استخدام fbPostId مباشرةً (بدلاً من postId الخاص بـ Ayrshare)، تأكّد من أنه معرّف منشور Facebook صالح.

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

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

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

معلمات الجسم

accountId
string
مطلوب
معرّف حساب إعلانات Facebook لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من نقطة نهاية حسابات الإعلانات.
adName
string
مطلوب
اسم إعلانك (يظهر في Facebook Ad Manager) بالتنسيق {adName} - {postId or fbPostId} - {current date}.
bidAmount
number
مطلوب
الحد الأقصى لعرض السعر بالدولار الأمريكي. الحد الأدنى لعرض السعر هو 1.00 دولار.
budget
number
مطلوب
الميزانية اليومية بالدولار الأمريكي. الحد الأدنى للميزانية هو 1.00 دولار.
fbPostId
string
مطلوب
معرّف المنشور الاجتماعي على Facebook للمنشور المراد تعزيزه، مما يتيح لك إنشاء إعلان من منشور تم إنشاؤه مباشرة على Facebook. هذا هو معرّف المنشور على Facebook، وليس Ayrshare. مطلوب إذا لم يتم تعيين postId.
goal
string
افتراضي:"engagement"
مطلوب
هدف الإعلان. القيم: engagement, interactions, awareness_views, و awareness_audience. راجع تفاصيل أهداف الإعلان أعلاه لمزيد من المعلومات.
locations
object
مطلوب
استهدف مواقع الإعلان بكائن من المصفوفات: countries, regions, cities.
postId
string
مطلوب
معرّف منشور Ayrshare للمنشور المراد تعزيزه. مطلوب إذا لم يتم تعيين fbPostId.
status
string
افتراضي:"active"
مطلوب
حالة الإعلان. القيم: active وpaused.يمكنك لاحقًا تغيير حالة الإعلان باستخدام نقطة نهاية تحديث الإعلان.
adSetBudgetSharingEnabled
boolean
افتراضي:false
يتحكم في مشاركة ميزانية مجموعة الإعلانات على مستوى الحملة في Meta. تتطلب Meta الآن هذا الحقل على كل حملة يتم إنشاؤها بدون ميزانية على مستوى الحملة، لذا يرسله Ayrshare دائمًا — بشكل افتراضي false للحفاظ على التوافق مع الإصدارات السابقة.عيّنه على true للسماح لـ Meta بمشاركة ما يصل إلى ~20% من ميزانية مجموعة الإعلانات عبر مجموعات إعلانات أخرى في نفس الحملة لتحسين الأداء العام. راجع مرجع مجموعة حملات الإعلانات من Meta للحصول على التفاصيل.
tracking
object
تتبّع الإعلان باستخدام Facebook Pixel.
urlTags
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.
specialAdCategories
array
تطلب Meta من المعلنين في فئات الإعلانات الخاصة تعريف فئة حملتهم ذاتيًا.إذا كانت شركتك تندرج ضمن إحدى هذه الفئات، فيجب عليك تحديد الفئة المناسبة عند تعزيز منشورك.القيم التالية مدعومة:
  • housing: الإعلانات التي تروّج أو ترتبط مباشرة بفرصة إسكان أو خدمة ذات صلة، بما في ذلك على سبيل المثال لا الحصر قوائم بيع أو تأجير منزل أو شقة، وتأمين المنزل، وتأمين الرهن العقاري، وقروض الرهن العقاري، وإصلاحات الإسكان، وخدمات ملكية المنزل أو التقييم.
  • financial_product_services: الإعلانات التي تروّج أو ترتبط مباشرة بعرض منتجات وخدمات مالية، بما في ذلك الائتمان.
  • employment: الإعلانات التي تروّج أو ترتبط مباشرة بفرصة عمل، بما في ذلك على سبيل المثال لا الحصر الوظائف بدوام جزئي أو كامل، أو التدريبات، أو برامج الشهادات المهنية. الإعلانات ذات الصلة التي تندرج ضمن هذه الفئة تشمل ترويج لوحات الوظائف أو معارض العمل، وخدمات التجميع، أو الإعلانات التي تُفصّل مزايا الشركة قد تُقدّمها، بغض النظر عن عرض وظيفة محدد.
  • issues_elections_politics: الإعلانات المُقدَّمة من قِبل، أو نيابةً عن، أو حول مرشح لمنصب عام، أو شخصية سياسية، أو حزب سياسي، أو المطالبة بنتيجة انتخابات لمنصب عام. يشمل هذا أيضًا الإعلانات حول أي انتخابات أو استفتاء أو مبادرة اقتراع، بما في ذلك حملات “اخرج وصوّت”. الإعلانات المُنظَّمة كإعلانات سياسية أو حول القضايا الاجتماعية في أي مكان يتم فيه وضع الإعلان. عند اختيار القضايا أو الانتخابات أو السياسة، يجب عليك تحديد الدولة التي تريد تشغيل هذه الإعلانات فيها. يجب أن تكون مُخوَّلاً لتشغيل إعلانات حول القضايا الاجتماعية أو الانتخابات أو السياسة في الدولة المحددة.
تتطلب Meta من المعلنين تعريف فئة حملتهم ذاتيًا. تستخدم Meta المراجعين البشريين والتعلم الآلي لتحديد هذه الأنواع من الإعلانات. إذا أرسلت لنا specialAdCategory غير صحيح، فهناك خطر من إيقاف إعلاناتك مؤقتًا حتى يتم تعديل الحملة.
endDate
string
تاريخ ووقت الانتهاء بتنسيق ISO 8601 (يجب أن يكون على الأقل 30 ساعة بعد البداية)، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيعمل الإعلان إلى أجل غير مسمى وسيكون له تاريخ انتهاء ongoing.
excludedLocations
object
استبعد المواقع باستخدام كائن مع مصفوفات countries وregions وcities.
gender
string
افتراضي:"all"
جنس الجمهور. القيم: all وmale وfemale.
interests
array
الاهتمامات المستهدفة للإعلان كمصفوفة من معرّفات اهتمامات Facebook.
maxAge
number
افتراضي:65
الحد الأقصى للعمر لاستهداف الإعلان (الافتراضي: 65).
minAge
number
افتراضي:18
الحد الأدنى للعمر لاستهداف الإعلان (الافتراضي: 18).
startDate
string
تاريخ ووقت البدء بتنسيق ISO 8601، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيبدأ الإعلان فورًا.
dsaBeneficiary
string
المستفيد من الإعلان للامتثال لقانون الخدمات الرقمية (DSA) لدول الاتحاد الأوروبي. يجب تعيينه مع dsaPayor إذا تم تقديم أي منهما. يرجى الرجوع إلى دليل DSA لمزيد من المعلومات.
dsaPayor
string
الدافع مقابل الإعلان للامتثال لقانون الخدمات الرقمية (DSA) لدول الاتحاد الأوروبي. يجب تعيينه مع dsaBeneficiary إذا تم تقديم أي منهما.