الانتقال إلى المحتوى الرئيسي
POST
عزّز منشورًا موجودًا على Instagram لإنشاء إعلان. تتيح لك نقطة النهاية هذه تحويل منشوراتك العضوية إلى إعلانات مدفوعة مع معلمات استهداف وميزانية وجدولة مخصصة.
  • قيم الميزانية وعرض السعر تكون بعملة الحساب الإعلاني. استخدم منزلتين عشريتين كحد أقصى، أو أعدادًا صحيحة للعملات التي تقبلها Meta بوحدات كاملة: CLP وCOP وCRC وHUF وIDR وISK وJPY وKRW وPYG وTWD وVND.
  • يجب أن يعمل الإعلان لمدة 30 ساعة على الأقل لتلبية متطلبات Instagram.
  • يمكنك استخدام نقطة نهاية الاهتمامات للعثور على معرّفات الاهتمامات للاستهداف.
  • قد يستغرق Instagram حتى 24 ساعة لمراجعة المنشورات المُعزَّزة والموافقة عليها.
  • عند استخدام socialPostId مباشرةً (بدلاً من postId الخاص بـ Ayrshare)، تأكّد من أنه معرّف منشور Instagram صالح.
  • إذا فشل التعزيز بعد أن أنشأ Facebook حملته (في خطوة التصميم الإعلاني أو مجموعة الإعلانات أو الإعلان)، فإننا نحاول حذف تلك الحملة. وإذا فشل الحذف أيضًا، تبقى الحملة الفارغة في حسابك الإعلاني. يمكنك العثور عليها وحذفها في Ads Manager.
ترفض Meta الإعلان حتى يتوفر الشرطان التاليان:
  • طريقة دفع في الحساب الإعلاني. أضف طريقة دفع في الفوترة والمدفوعات لدى Meta واربطها بالحساب الإعلاني الذي ترسله في accountId. لا تكفي طريقة دفع محفوظة في حافظة الأعمال فقط.
  • تفعيل الإعلانات المخصّصة (الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية وسويسرا). إذا اختار مالك حساب Facebook أو Instagram المرتبط بصفحة Facebook الخاصة بك عرض إعلانات أقل تخصيصًا، أو اشترك لاستخدام Meta بدون إعلانات، فلن تسمح Meta لذلك الحساب ولا للصفحة بعرض الإعلانات. يمكن للمالك العودة إلى الإعلانات المخصّصة، أو إلغاء الاشتراك، من مركز الحسابات ← تفضيلات الإعلانات ← تجربة الإعلانات. اعرف المزيد.

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

يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.
  • 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
مفتاح فريد وغير فارغ لطلب التعزيز هذا. أعد إرسال الحمولة نفسها بالمفتاح نفسه لتجنّب إنشاء إعلان مكرر. إعادة استخدام المفتاح مع حمولة مختلفة، أو لتعزيز على Facebook، تعيد HTTP 409. على أي منصة أخرى، يبدأ المفتاح نفسه تعزيزًا منفصلًا. والطلب الذي لا يزال قيد التنفيذ يعيد 409 أيضًا؛ أما الحجز غير المتاح فيعيد 503 دون إنشاء إعلان.
boolean
افتراضي:false
السماح لـ Meta بمشاركة الميزانية بين مجموعات الإعلانات في الحملة.
string
مطلوب
معرّف حساب إعلانات Instagram لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من نقطة نهاية حسابات الإعلانات.
string
مطلوب
اسم إعلانك (يظهر في Instagram Ad Manager) بالتنسيق {adName} - {postId or socialPostId} - {current date}. إذا أرسلت idempotencyKey، فسينتهي الاسم أيضًا بـ - {request reference}، وهو مرجع قصير يبقى ثابتًا لهذا المفتاح.
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 وفق الجدول الزمني الذي تريده؛ فالتواريخ في الأمثلة توضيحية فقط.

الميزانيات الإجمالية

يضبط جسم الطلب أعلاه ميزانية يومية على مجموعة الإعلانات. للحصول على ميزانية إجمالية، أرسل الصيغة المتداخلة لجسم طلب التعزيز بدلًا من ذلك. في الصيغة المتداخلة، تبقى accountId وpostId (أو socialPostId بدلًا من igPostId) وgoal وstatus وcallToAction في المستوى الأعلى. تحل ثلاثة كائنات محل حقول الميزانية والتواريخ والاستهداف المسطّحة: budget وschedule (start، end) وtargeting (locations، excludedLocations، ageMin، ageMax، genders، interests). أما الحقول المتبقية، adName وbidAmount وspecialAdCategories وadSetBudgetSharingEnabled وlink وtracking وurlTags وdsaBeneficiary وdsaPayor، فتنتقل إلى platformOptions.instagram.
  • budget.type: daily (الافتراضي) أو lifetime. تُنفَق الميزانية الإجمالية بين تاريخي البدء والانتهاء، لذا تتطلب schedule.end. وبدونه يُرفض الطلب مع 400 وcode: 101. تعمل مشاركة ميزانية مجموعة الإعلانات في Meta مع الميزانيات اليومية فقط، لذا تُرفض أيضًا الميزانية الإجمالية مع adSetBudgetSharingEnabled: true مع code: 101.
تضيف الاستجابة budgetType: "lifetime" للميزانية الإجمالية. لا تُرجع الميزانية اليومية budgetType، لذا اعتبر غياب الحقل بمعنى daily.

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

للاحتفاظ بالميزانية على الحملة بدلًا من مجموعة الإعلانات، أرسل 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.

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

يمكن لزر التعزيز أن يفتح محادثة مع نشاطك التجاري بدلًا من صفحة ويب. أرسل الصيغة المتداخلة مع 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 الخاص به. تخزّن Meta الإعدادات نفسها لكلا الهدفين، لذا قد يُدرج زر المحادثة المُعزَّز باستخدام interactions مع الهدف engagement عند قراءة الإعلان مجددًا من Meta.