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

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

يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.
  • 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؛ راجع المناطق والمدن. يُرفض الكائن الذي لا يحدد أي دولة أو منطقة أو مدينة، مثل {}، مع الرمز 101؛ احذف locations لاستهداف الولايات المتحدة.
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 أيضًا إلى معرفة الدول التي يُعرض فيها إعلان الفئة الخاصة. تأخذ Ayrshare هذه الدول من locations: الدول التي تحددها، بالإضافة إلى دولة كل منطقة ومدينة. لذا فإن تعزيز housing الذي يستهدف مدينة في المملكة المتحدة يُعدّ للمملكة المتحدة دون أي إضافة في طلبك. وبدون locations يُعرض الإعلان في الولايات المتحدة، وتُعدّ الحملة للولايات المتحدة.تحدد Meta أيضًا نصف قطر أدنى حول كل مدينة لهذه الفئات. فقد رُفضت مدينة في المملكة المتحدة بنصف قطر 17 كيلومترًا مع #2909039، الذي يتطلب 25 كيلومترًا (15 ميلًا) على الأقل، لذا استخدم 25 كيلومترًا أو أكثر.
تتطلب 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 وفق الجدول الزمني الذي تريده؛ فالتواريخ في الأمثلة توضيحية فقط.

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

للاحتفاظ بالميزانية على الحملة بدلًا من مجموعة الإعلانات، أرسل 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.instagram.bidAmount: إذ تحتفظ مجموعة الإعلانات بإعداداتها الخاصة. يؤدي إرسال أي منها إلى إرجاع 400 مع code: 101.
  • يجب أن تكون الحملة أو مجموعة الإعلانات ضمن الحساب الإعلاني المحدد بواسطة accountId، وألا تنتمي إلى تعزيزات مستخدم آخر. وإلا يُرجع الطلب 400. كذلك لا يمكن لتعزيز Instagram الارتباط بحملة أنشأها تعزيز Facebook، والعكس صحيح.
  • لا يمكن الجمع بين attachTo وbudget.level: "campaign" أو specialAdCategories أو adSetBudgetSharingEnabled، إذ تُضبط هذه على حملة جديدة. يؤدي إرسالها إلى إرجاع code: 101.
  • لا يُغيّر إيقاف التعزيز مؤقتًا أو تنشيطه إلا ما أنشأه التعزيز: الإعلان، ومجموعة الإعلانات إذا كان التعزيز هو من أنشأها. تحتفظ الحملة أو مجموعة الإعلانات التي حددتها في attachTo بحالتها الخاصة. لا يعمل الإعلان إلا عندما تكون الحملة ومجموعة الإعلانات اللتان تعلوانه نشطتين. ينطبق هذا أيضًا عندما توقف Ayrshare إعلاناتك مؤقتًا، على سبيل المثال عند حذف ملف شخصي.
  • إذا فشل التعزيز، فلا تُحذف أبدًا الحملة أو مجموعة الإعلانات المحددة في attachTo.
  • إذا كانت مجموعة الإعلانات التي ترتبط بها ضمن حملة تحمل الميزانية (ميزانية على مستوى الحملة)، فإن السجل يعرض التعزيز مثل أي إعلان بميزانية على مستوى الحملة: يعرض budgetDaily ميزانية الحملة بالكامل، لا حصة التعزيز منها، وبمجرد إنفاق ميزانية الحملة الإجمالية، يعرض كل إعلان تتتبعه Ayrshare في تلك الحملة deliveryStatus: "COMPLETED" بعد التحديث الليلي التالي، بما في ذلك الإعلان المجدول أو قيد المراجعة. يظل الإعلان المرفوض REJECTED.