الانتقال إلى المحتوى الرئيسي
GET
احصل على أداء إعلاناتك على Instagram مباشرةً، بصف واحد لكل يوم، لحملاتك أو مجموعات إعلاناتك أو إعلاناتك. اختر المقاييس التي تريدها، وقسّمها حسب العمر أو الجنس أو الدولة أو موضع الظهور، وتصفّح النطاقات الزمنية الطويلة صفحةً تلو الأخرى.
  • تُقرأ الأرقام من Meta لحظة استدعائك، وليس من نسخة تُحدَّث كل ليلة.
  • استخدم السجل للاطلاع على سجل الإنفاق اليومي. واستخدم الرؤى لإعداد التقارير والتحليل.
  • جميع القيم النقدية بعملة حساب الإعلانات، وتُعاد في الحقل currency في كل صف.
  • يجب أن تكون الحملات قد أُنشئت عبر Ayrshare لهذا الملف الشخصي، ويجب أن تكون مجموعات الإعلانات ضمن حملة كهذه. يُرفض الإعلان الذي أُنشئ عبر Ayrshare لملف شخصي آخر. أما معرّفات الإعلانات الأخرى فتُقرأ باستخدام حساب Meta المرتبط بهذا الملف الشخصي، لذا لا تُعيد Meta إلا الإعلانات التي يستطيع ذلك الحساب رؤيتها.
  • يغطي الطلب الواحد حساب إعلانات واحدًا. تُعيد المعرّفات التابعة لعدة حسابات إعلانات الرمز 101، وكذلك عدة معرّفات إعلانات لا يملك Ayrshare سجلًا لها. اطلب هذه المعرّفات واحدًا تلو الآخر.

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

معاملات الاستعلام

string
مطلوب
ما يُبلغ عنه كل صف: campaign أو adSet أو ad.
string
معرّفات الحملات أو مجموعات الإعلانات أو الإعلانات مفصولة بفواصل، بحد أقصى 50. مطلوب مع level=campaign وlevel=adSet.مع level=ad، يمكنك حذف ids وإرسال accountId بدلًا منه. يُعدّ هذا تقريرًا عن الإعلانات التي أنشأتها عبر Ayrshare لهذا الملف الشخصي في حساب الإعلانات ذلك، وليس عن كل إعلان فيه. ويعمل ذلك مع ما يصل إلى 50 إعلانًا من هذا النوع. لأكثر من ذلك، أرسل معرّفاتها، أو أعدّ التقرير حسب الحملة. وإذا لم يُعثر على أي إعلان، يكون التقرير فارغًا.
string
معرّف حساب الإعلانات، مع البادئة act_ أو بدونها (1234567890 أو act_1234567890).مطلوب مع level=ad عند حذف ids.
string
المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع المقاييس.
string
التقسيمات مفصولة بفواصل: age وgender وcountry وplacement. يصبح لكل يوم عندئذٍ صف واحد لكل قيمة، أو لكل تركيبة مع age,gender. أرسل تقسيمًا واحدًا في كل مرة، أو age,gender؛ إذ ترفض Meta التركيبات الأخرى (مثل age,country)، لذا تُعيد الرمز 101.
string
افتراضي:"قبل 30 يومًا"
اليوم الأول، بصيغة YYYY-MM-DD. يمكن أن يعود إلى ما يصل إلى 37 شهرًا مضت.
string
افتراضي:"اليوم"
اليوم الأخير، بصيغة YYYY-MM-DD.
string
قيمة meta.pagination.next من الاستجابة السابقة، للحصول على الصفحة التالية.

المقاييس

يُبلغ Instagram عن كل مقياس في هذا الجدول. باستثناء واحد: لا تُبلغ Meta عن reach في تقرير يتضمن breakdowns ويبدأ قبل أكثر من 13 شهرًا، لذا يُحذف reach من تلك الصفوف. وعلى الشبكات التي لا تُبلغ عن مقياس ما، يُحذف ذلك المقياس من الصفوف بدلًا من إرجاعه بالقيمة 0، ويُعيد طلبه الرمز 101.
تحتسب Meta بعض الإجراءات ضمن أكثر من نوع، لذا لا تجمع قيم actions معًا. على سبيل المثال، يتضمن omni_purchase بالفعل purchase. أما conversionValue فيحتسب كل عملية شراء مرة واحدة.

ترقيم الصفحات

تُعيد كل استجابة ما يصل إلى 500 صف. إذا كان هناك المزيد، تكون قيمة meta.pagination.hasMore هي true وتُعيَّن قيمة meta.pagination.next. أرسل الطلب نفسه مرة أخرى مع تعيين next إلى تلك القيمة للحصول على الصفحة التالية. في الصفحة الأخيرة، تكون قيمة hasMore هي false ولا توجد next. تعمل قيمة next فقط مع المعلمات التي جاءت منها: مع معلمات مختلفة يُعيد الطلب code: 101.

الأخطاء