‏API التسويق‏

الاستهداف التفصيلي

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

تشتمل واجهة API على أربع نقاط نهاية: البحث والاقتراحات والتصفح والتدقيق.

تتضمن الاستجابة لنقاط النهاية هذه ما يلي:

الاسم الوصف

id

النوع: string (سلسلة)

معرف الجمهور المستهدف

name

النوع: string (سلسلة)

اسم الجمهور المستهدف

audience_size_lower_bound

integer (عدد صحيح)

يمثل الحد الأدنى للحجم التقديري للجمهور المستهدف

audience_size_upper_bound

integer (عدد صحيح)

يمثل الحد الأقصى للحجم التقديري للجمهور المستهدف

path

النوع: array of strings (مصفوفة السلاسل)

يتضمن الفئة وأي فئات رئيسية يندرج الاستهداف ضمنها

description

النوع: string (سلسلة)

وصف قصير عن الجمهور المستهدف

إذا لم تقدم limit_type، فستتم فلترة النتائج الأقل من 2000 شخص إلى أربع فئات: work_employers وwork_positions وeducation_majors وeducation_schools. وإلا، فستحصل على نتائج أقل أهمية. عندما تستخدم limit_type، سنعمل على فلترة إحدى هذه الفئات الأربع ولن نعرض كل شيء.

استرداد الجماهير المستهدفة لإعلاناتك التي تطابق استعلام البحث الخاص بك. يمكنك تقديم المعلمات التالية في نقطة النهاية هذه:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
الاسم الوصف

q

النوع: string (سلسلة)

مطلوب.

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

limit

النوع: integer (عدد صحيح)

اختياري.

عدد النتائج

limit_type

النوع: string (سلسلة)

اختياري.

تقييد نوع الجمهور الذي سيتم استرجاعه. الإعداد الافتراضي لجميع الأنواع.

وفيما يلي القيم الصالحة:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

النوع: string (سلسلة)

اختياري.

اللغة المستخدمة لعرض أسماء الجمهور وأوصافه، إذا كانت متوفرة. الإعداد الافتراضي للغة الحساب الإعلاني

الاقتراحات

إرجاع جماهير إضافية يمكنك استهدافها استنادًا إلى عدد قليل من الجماهير المحددة التي تقدمها.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

قدم المعلمات التالية:

الاسم الوصف

targeting_list

النوع: Array of (مصفوفة من) {'type':'{TYPE}', 'id':{ID}}

مطلوب.

مصفوفة أزواج {'type':'{TYPE}', 'id':{ID}} عند إدخال اقتراحات الجمهور.

limit

النوع: integer (عدد صحيح)

اختياري.

عدد النتائج. الإعداد الافتراضي هو 30. الحد الأقصى هو 45.

limit_type

النوع: string (سلسلة)

اختياري.

تقييد نوع الجمهور الذي سيتم استرجاعه. الإعداد الافتراضي لجميع الأنواع

وفيما يلي القيم الصالحة:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

النوع: string (سلسلة)

اختياري.

اللغة المستخدمة لعرض أسماء الجمهور وأوصافه. الإعداد الافتراضي للغة الحساب الإعلاني

التصفح

الاستهداف في تصنيف منظم لفئات فيسبوك ومزودي بيانات الجهات الخارجية وبعض الاهتمامات. تظهر النتائج من نقطة النهاية هذه في وظيفة التصفح في مكون واجهة مستخدم الاستهداف التفصيلي داخل مدير الإعلانات.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

قدم المعلمات الاختيارية التالية:

الاسم الوصف

limit_type

النوع: string (سلسلة)

تقييد نوع الجمهور الذي سيتم استرجاعه. الإعداد الافتراضي لجميع الأنواع.

locale

النوع: string (سلسلة)

اللغة المستخدمة لعرض أسماء الجمهور وأوصافه. الإعداد الافتراضي للغة الحساب الإعلاني

التحقق

التحقق مما إذا كان الجمهور صالحًا للاستهداف أم لا. هذا مفيد إذا كنت قد أنشأت مجموعة إعلانات بالفعل وتريد التحقق من أن مواصفات الاستهداف الخاصة بها لا تزال صالحة. إذا كان الاستهداف غير صالح، يجب حذفه من مواصفات الاستهداف.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

بالإضافة إلى حقول استجابة الاستهداف التفصيلي القياسية، ترجع نقطة النهاية هذه أيضًا:

الاسم description

valid

النوع: boolean (قيمة منطقية)

سواء أكان الجمهور المستهدف صالحًا أم لا

فيما يلي قائمة بمعلمات الإدخال:

الاسم الوصف

targeting_list

النوع: Array of (مصفوفة من) {'type':'{TYPE}', 'id':{ID}}

مصفوفة أزواج {'type':'{TYPE}', 'id':{ID}} للتحقق من الصحة. مفضل.

id_list

النوع: array of strings (مصفوفة السلاسل)

مصفوفة معرفات للتحقق من الصحة. تنجح فقط إذا كان المعرف قابلاً للتعريف بشكل فريد في قاعدة بيانات الجمهور لدينا

name_list

النوع: array of strings (مصفوفة السلاسل)

مصفوفة السلاسل للتحقق من الصحة. الاهتمامات فقط، غير حساسة بالنسبة لحالة الأحرف

locale

النوع: string (سلسلة)

اللغة المستخدمة لعرض أسماء الجمهور وأوصافه. الإعداد الافتراضي للغة الحساب الإعلاني

قدم واحدة مما يلي على الأقل: targeting_list وid_list وname_list.