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

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

يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.
  • engagement: يسعى هذا الهدف إلى زيادة التفاعل مع ضمان أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين الفريدين. يوازن بين الوضوح والتفاعل، ويعرض الإعلان لأكبر عدد ممكن من الأشخاص المختلفين الذين قد يتفاعلون معه.
  • interactions: مصمم لزيادة التفاعلات، مثل الإعجابات والتعليقات والمشاركات، على الإعلان. يعطي Instagram الأولوية لعرض الإعلان للمستخدمين الأكثر احتمالاً للتفاعل معه.
  • awareness_views: يركّز على زيادة الوعي بالعلامة التجارية من خلال تعظيم عدد المرات التي يُعرض فيها الإعلان. يعطي الأولوية لعرض الإعلان لأكبر عدد ممكن من المرات ضمن الميزانية، بغض النظر عن الوصول الفريد.
  • awareness_audience: يهدف إلى تعزيز الوعي بالعلامة التجارية من خلال تعظيم عدد الأشخاص الفريدين الذين يرون الإعلان. يضمن أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين المختلفين ويعظّم حجم الجمهور الفريد بدلاً من عرضه عدة مرات لنفس الجمهور.
تتطلب إعلانات Instagram حساب Instagram Business مرتبطًا عبر Facebook، وصفحة Facebook مقترنة به، وصلاحية ads_management. أعد الربط عبر Facebook لمنح هذه الصلاحية. لا يمكن للحسابات المرتبطة عبر Instagram Login استخدام نقاط نهاية الإعلانات هذه. يُستخرج معرّف الوسائط ومعرّف حساب Instagram من حسابك المرتبط؛ فلا تُرسل instagram_user_id.
يقبل مُحدِّد socialPostId أيضًا الاسم البديل الخاص بـ Instagram وهو igPostId. أما fbPostId فينطبق على Facebook فقط. تتضمن الاستجابات الناجحة platform: "instagram" وsocialPostId وigPostId.

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

معلمات الجسم

string
مفتاح فريد وغير فارغ لطلب التعزيز هذا. أعد إرسال الحمولة نفسها بالمفتاح نفسه لتجنّب إنشاء إعلان مكرر. إعادة استخدام المفتاح مع حمولة أو منصة مختلفة تعيد HTTP 409. والطلب الذي لا يزال قيد التنفيذ يعيد 409 أيضًا؛ أما الحجز غير المتاح فيعيد 503 دون إنشاء إعلان.
boolean
افتراضي:false
السماح لـ Meta بمشاركة الميزانية بين مجموعات الإعلانات في الحملة.
string
مطلوب
معرّف حساب إعلانات Instagram لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من نقطة نهاية حسابات الإعلانات.
string
مطلوب
اسم إعلانك (يظهر في Instagram Ad Manager) بالتنسيق {adName} - {postId or socialPostId} - {current date}.
number
مطلوب
الحد الأقصى لعرض السعر بالدولار الأمريكي، كقيمة موجبة بحد أقصى منزلتين عشريتين.
number
مطلوب
الميزانية اليومية بالدولار الأمريكي. استخدم قيمة موجبة بحد أقصى منزلتين عشريتين. قد تفرض Meta حدودًا دنيا إضافية بحسب حسابك وهدفك.
string
معرّف المنشور الاجتماعي على Instagram للمنشور المراد تعزيزه، مما يتيح لك إنشاء إعلان من منشور تم إنشاؤه مباشرة على Instagram. هذا هو معرّف المنشور على Instagram، وليس Ayrshare. مطلوب إذا لم يتم تعيين postId.
string
افتراضي:"engagement"
هدف الإعلان. القيم: engagement, interactions, awareness_views, وawareness_audience. راجع تفاصيل أهداف الإعلان أعلاه لمزيد من المعلومات.
object
استهدف الدول باستخدام {"countries": ["US", "CA"]} مع رموز الدول. يمكنك أيضًا تقديم مصفوفتي regions وcities؛ راجع المناطق والمدن.
string
معرّف منشور Ayrshare للمنشور المراد تعزيزه. مطلوب إذا لم يتم تعيين socialPostId.
string
افتراضي:"active"
حالة الإعلان. القيم: active وpaused.يمكنك لاحقًا تغيير حالة الإعلان باستخدام نقطة نهاية تحديث الإعلان.
object
تتبّع الإعلان باستخدام Meta 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: الإعلانات التي تروّج أو ترتبط مباشرة بعرض منتجات وخدمات مالية، بما في ذلك الائتمان.
  • employment: الإعلانات التي تروّج أو ترتبط مباشرة بفرصة عمل، بما في ذلك على سبيل المثال لا الحصر الوظائف بدوام جزئي أو كامل، أو التدريبات، أو برامج الشهادات المهنية. الإعلانات ذات الصلة التي تندرج ضمن هذه الفئة تشمل ترويج لوحات الوظائف أو معارض العمل، وخدمات التجميع، أو الإعلانات التي تُفصّل مزايا الشركة قد تُقدّمها، بغض النظر عن عرض وظيفة محدد.
  • issues_elections_politics: الإعلانات المُقدَّمة من قِبل، أو نيابةً عن، أو حول مرشح لمنصب عام، أو شخصية سياسية، أو حزب سياسي، أو المطالبة بنتيجة انتخابات لمنصب عام. يشمل هذا أيضًا الإعلانات حول أي انتخابات أو استفتاء أو مبادرة اقتراع، بما في ذلك حملات “اخرج وصوّت”. الإعلانات المُنظَّمة كإعلانات سياسية أو حول القضايا الاجتماعية في أي مكان يتم فيه وضع الإعلان. عند اختيار القضايا أو الانتخابات أو السياسة، يجب عليك تحديد الدولة التي تريد تشغيل هذه الإعلانات فيها. يجب أن تكون مُخوَّلاً لتشغيل إعلانات حول القضايا الاجتماعية أو الانتخابات أو السياسة في الدولة المحددة.
تتطلب Meta من المعلنين تحديد فئة حملتهم بشكل صحيح. تستخدم Meta المراجعين البشريين والتعلم الآلي لتحديد هذه الأنواع من الإعلانات. إذا أرسلت لنا specialAdCategories غير صحيحة، فهناك خطر من إيقاف إعلاناتك مؤقتًا حتى يتم تعديل الحملة.
string
الشخص أو الجهة المستفيدة من الإعلان. يُعيَّن مع dsaPayor. استخدم نقطة نهاية توصيات DSA للحصول على اقتراحات.
string
الشخص أو الجهة التي تدفع مقابل الإعلان. يُعيَّن مع dsaBeneficiary.
string
تاريخ ووقت الانتهاء بتنسيق ISO 8601 (يجب أن يكون على الأقل 30 ساعة بعد البداية)، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيعمل الإعلان إلى أجل غير مسمى وسيكون له تاريخ انتهاء ongoing.
object
استبعد المواقع باستخدام بنية countries وregions وcities نفسها المستخدمة في locations.
string
افتراضي:"all"
جنس الجمهور. القيم: all وmale وfemale.
array
الاهتمامات المستهدفة للإعلان كمصفوفة من معرّفات اهتمامات Instagram.
number
افتراضي:65
الحد الأقصى للعمر لاستهداف الإعلان (الافتراضي: 65).
number
افتراضي:18
الحد الأدنى للعمر لاستهداف الإعلان (الافتراضي: 18).
string
تاريخ ووقت البدء بتنسيق ISO 8601، على سبيل المثال 2025-03-01T00:00:00Z.إذا لم يتم تعيينه، سيبدأ الإعلان فورًا.
استبدل المعرّفات الواردة في الأمثلة بمعرّفاتك الخاصة. عيّن startDate وendDate وفق الجدول الزمني الذي تريده؛ فالتواريخ في الأمثلة توضيحية فقط.