Skip to main content
GET
ابحث عن اهتمامات استهداف إعلانات Facebook المتاحة عبر كلمة مفتاحية. استخدم هذه النقطة النهائية للبحث عن معرّفات الاهتمامات لاستخدامها في نقطة نهاية Boost Post. تساعدك هذه النقطة النهائية في اكتشاف خيارات الاستهداف القائمة على الاهتمامات لإعلاناتك على Facebook، إلى جانب تقديرات حجم الجمهور.
  • يمكن استخدام معرّفات الاهتمامات في مصفوفة interests عند تعزيز المنشورات.
  • يتم تخزين النتائج مؤقتًا لمدة 10 دقائق.
  • استخدم مصطلحات بحث محددة وذات صلة للحصول على أفضل النتائج.
  • قد يعيد Facebook نتائج مختلفة بناءً على مجال ومنطقة حساب الإعلانات لديك.
  • توفر الحقول audienceSizeLowerBound وaudienceSizeUpperBound في استجابة JSON نطاقًا تقديريًا لحجم الجمهور للاهتمام، وهي مفيدة للاستهداف.
  • استخدم specialAdCategories لإعادة الاهتمامات التي تسمح بها Meta فقط لحملة فئة إعلانات خاصة. تتطلب الطلبات المُفلترة أيضًا accountId.

معاملات الرأس

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

استعلام البحث لاسترداد اهتمامات إعلانات Facebook.لا تنسَ تهريب استعلام البحث، على سبيل المثال Rhythm%20and%20blues%20music.
array
قصر النتائج على الاهتمامات التي تسمح Meta لحملة فئة إعلانات خاصة باستهدافها. استخدم هذا قبل تعزيز منشور يتعلق بالإسكان أو التوظيف أو منشور مالي أو سياسي، حتى تختار معرّفات اهتمامات ستتم الموافقة على الإعلان بها فعليًا.القيم التالية مدعومة، وهي مطابقة لمعامل Boost Post الذي يحمل الاسم نفسه:
  • housing
  • employment
  • financial_product_services — تُقبل financial_products_services وcredit كمكافئتين وتؤولان إلى الفئة نفسها
  • issues_elections_politics
  • none — مقبولة للتناظر مع Boost Post، حيث تعني “ليست ضمن فئة إعلانات خاصة”. تُرسل إلى Meta بصيغة regulated_categories=["NONE"]: يكون accountId مطلوبًا وتُعيد الاستجابة الناجحة ["NONE"]. لا يضمن هذا النتائج نفسها التي يعيدها بحث غير مُفلتر؛ ويعيد رفض Meta الخطأ code: 368. احذف specialAdCategories تمامًا بدلاً من إرسال none إذا أردت بحثًا عاديًا غير مُفلتر.
القيم غير حساسة لحالة الأحرف. تُرفض القيمة غير المتعارف عليها بـ 400 وcode: 101 مع سرد القيم المقبولة. تلك الرسالة مكتوبة بصيغة Meta ذات الأحرف الكبيرة وتذكر أيضًا التهجئات البديلة المذكورة أعلاه، فتظهر كالتالي: NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT — وهي الفئات نفسها المذكورة هنا، وليست فئات إضافية. ويعيد Boost Post الرسالة المطابقة. وتُرفض القيمة الفارغة، كما في ?specialAdCategories=، بالطريقة نفسها.مرّر أكثر من فئة بتكرار المعامل، على سبيل المثال ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. تعمل أيضًا الصيغة ذات الأقواس ?specialAdCategories[]=employment&specialAdCategories[]=housing. أما السلسلة المفصولة بفواصل مثل ?specialAdCategories=employment,housing فهي غير مدعومة وتُرفض بـ 400 وcode: 101. تُرسل جميع الفئات المطلوبة إلى Meta في بحث واحد. يعيد Ayrshare نتائج Meta ولا يحسب أو يضمن تقاطع الاهتمامات المؤهلة لكل فئة على حدة. تكرار فئة، أو إرسال تهجئتين للفئة نفسها، يُدمج في فئة واحدة.عند تقديم أكثر من فئة واحدة، يُعاد حقل specialAdCategories في الاستجابة مرتّبًا أبجديًا بدلاً من الترتيب الذي أرسلته به.احذف specialAdCategories تمامًا وستتصرف النقطة النهائية تمامًا كما كانت من قبل: بحث غير مُفلتر، دون الحاجة إلى accountId، وبشكل الاستجابة نفسه.
string
مطلوب عند تقديم specialAdCategories، ويُتجاهل فيما عدا ذلك. معرّف حساب إعلانات Facebook الذي يجري البحث عن الاهتمامات له، دون البادئة act_ — وهو القيمة نفسها التي تأخذها Boost Post. يمكنك استرداده من نقطة نهاية حسابات الإعلانات. يجب أن يكون رقميًا؛ تُقبل البادئة act_ وتُحذف، ويُرفض أي شيء آخر بـ 400 وcode: 101.
لا تتيح Meta البحث في الاهتمامات المُدرك للفئات إلا على حساب إعلانات، لذا يُرفض الطلب الذي يقدّم specialAdCategories دون accountId بـ 400 وcode: 101 قبل تشغيل أي بحث. الطلب الذي لا يحمل specialAdCategories لم يتغيّر ولا يزال لا يحتاج إلى accountId.
number
افتراضي:100
الحد الأقصى لعدد اهتمامات الإعلانات المُعادة.
تعيد الاستجابة المُفلترة الفئات المطبَّقة في حقل specialAdCategories، حتى تتمكن من تأكيد ما ضُيّقت النتائج على أساسه. أما الاستجابة غير المُفلترة فتحذف هذا الحقل تمامًا بدلاً من إعادته فارغًا. تحذف النتائج المُفلترة أيضًا حقل topic من كل اهتمام، لأن بحث Meta المُدرك للفئات لا يعيده — اقرأ name بدلاً منه. البحث الذي لا يجد اهتمامات مؤهلة يعيد 200 مع مصفوفة interests فارغة وcount: 0، وليس خطأً، والبحث المُفلتر لا يرجع أبدًا إلى نتائج غير مُفلترة.