> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على Ads API

> عزّز منشوراتك بتحويلها إلى إعلانات Facebook باستخدام API الخاص بـ Ayrshare.

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

## مقدمة إلى Ads API

يوفر Ayrshare Ads API وصولًا برمجيًا لإنشاء وإدارة وتحليل إعلانات وسائل التواصل الاجتماعي.

يدعم حاليًا **Facebook**، ويسمح لك Facebook Ads API، المعروف أيضًا بـ Facebook Marketing API، بتحويل المنشورات الحالية إلى إعلانات مدفوعة.
ويشمل ذلك تعزيز المنشورات (تحويل منشور إلى إعلان)، وإدارة الإعلانات، وتتبع الأداء، وتحليل الإنفاق الإعلاني.

يمكن دائمًا العثور على الإعلانات التي تُنشأ وتُحدَّث عبر Ayrshare في Facebook Ads Manager.
يتولى Ayrshare إدارة جميع الإعدادات على مستويات الإعلان ومجموعة الإعلان والحملة.
لا حاجة أبدًا لتعديل أي من الإعدادات يدويًا مباشرةً في Facebook Ads Manager.

<Note>
  1. تتطلب إمكانيات الإعلانات وظيفة Ads الإضافية المدفوعة والتي يمكن تفعيلها من صفحة
     Account في [لوحة التحكم على الويب](https://app.ayrshare.com/account).

  2. يجب على المستخدم [ربط طريقة دفع](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)
     في Facebook (Meta) قبل إنشاء إعلان.

  3. يجب إعادة ربط User Profiles المرتبطة بصفحة Facebook قبل 1 أبريل 2025 لتفعيل الإعلانات.
</Note>

لمزيد من المعلومات، راجع [دليل Facebook Ads API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).

## سير إنشاء إعلان

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/ads/ads-flow.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=3e57ee2134ddc3bb0937acf5b3d31781" alt="Ads Flow" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

يُعدّ تعزيز منشور على Facebook طريقة سريعة وبسيطة لتحويل أحد
منشوراتك الحالية إلى إعلان. فيما يلي تدفق عالي المستوى لكيفية تنفيذ ذلك في
منصتك:

<Steps>
  <Step title="اختر حساب إعلانات Facebook">
    سيختار المستخدم حساب إعلانات Facebook الذي تم فيه بالفعل تكوين جميع تفاصيل الفواتير.

    <Card title="احصل على حسابات إعلانات Facebook" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="حدد المنشور">
    اختر منشورًا من صفحتك على Facebook. يمكن أن يكون صورة أو فيديو أو تحديث حالة، إلخ.

    > **نصيحة:** المنشورات ذات التفاعل العضوي الجيد (الإعجابات والمشاركات والتعليقات) تميل إلى الأداء بشكل أفضل عند تعزيزها.
  </Step>

  <Step title="انقر على “Boost Post”">
    سينقر المستخدم على زر مثل "Boost Post" في منصتك لبدء
    إعداد الإعلان.

    <Card title="عزّز منشورًا بإرساله إلى منصة إعلانات Facebook" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="اضبط الهدف والجمهور والميزانية والمدة">
    يستطيع المستخدم ضبط عدد من المعاملات.

    <ul className="custom-bullets">
      <li>
        اختر استراتيجية هدف هذا المنشور المُعزَّز عن طريق تحديد هدف.
      </li>

      <li>خصّص الجمهور بناءً على العمر والجنس
      والموقع والاهتمامات، إلخ.</li>
      <li>اختر إجمالي مبلغ الإنفاق.</li>
      <li>حدّد الفترة الزمنية لتشغيل الإعلان.</li>
    </ul>
  </Step>

  <Step title="راجع وعزّز">
    تحقّق مرة أخرى من جميع الإعدادات. إذا بدا كل شيء جيدًا، سينقر المستخدم على زر مثل **"Boost Post Now"**.
  </Step>

  <Step title="مراجعة الإعلان وإطلاقه">
    سيراجع Facebook الإعلان — يستغرق ذلك عادةً من بضع دقائق
    إلى بضع ساعات. بمجرد الموافقة، يُطلق المنشور المُعزَّز ويعمل وفقًا
    للإعداد.
  </Step>

  <Step title="تتبّع الإنفاق والأداء">
    راقب ما يلي:

    * الوصول (Reach)
    * التفاعل
    * النقرات
    * الإنفاق
    * الميزانية المتبقية

    <Card title="احصل على إنفاق إعلانات Facebook والتحليلات" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## أفضل الممارسات لـ Ads API

1. **إدارة الميزانية**: ابدأ بميزانيات اختبار صغيرة (على سبيل المثال، 5-10 دولارات/يوم) لتحسين الأداء قبل التوسع.
2. **مدة الإعلان**: يتطلب Facebook حدًا أدنى لمدة تشغيل الإعلان يبلغ حوالي 30 ساعة بين وقتي البداية والنهاية.
3. **استهداف الاهتمامات**: اختر من 2 إلى 5 اهتمامات ذات صلة للحصول على دقة استهداف مثالية.
4. **إرشادات المحتوى الإبداعي**: استخدم صورًا عالية الجودة ورسائل موجزة لتحسين معدلات التفاعل.
5. **مراقبة الأداء**: تحقق بانتظام من أداء إعلانك واضبط الاستهداف أو العناصر الإبداعية حسب الحاجة.

للحصول على معلومات مفصلة حول كل نقطة نهاية، بما في ذلك معاملات الطلب وتنسيقات الاستجابة والأمثلة، يُرجى الرجوع إلى صفحات التوثيق الفردية لنقاط النهاية الخاصة بـ API.