الاستهداف بمعايير البحث

استهدف مجموعات إعلانية حسب عدد المعايير التي توفرها في مواصفات الاستهداف. وتكون معظم الأهداف عبارة عن قيم محددة مسبقًا مثل البلد "اليابان" أو المدينة "طوكيو".

ابحث عن قيم صالحة من خلال واجهة API التسويق والاستهداف بمعايير البحث: https://graph.facebook.com/{API_VERSION}/search. ويجب أن توفر سلسلة استعلامك بتنسيق UTF8.

حالة خيار الاستهداف

للتحقق من حالة كائنات الاستهداف الحالية و/أو المخطط لها، استخدم المعلمة targeting_option_list:

curl -G \
  -d 'targeting_option_list=[<TARGETING_OPTION_ ID>,<TARGETING_OPTION_ID>]' 
  -d 'type=targetingoptionstatus'  
  https://graph.facebook.com/<API_VERSION>/search

الاستجابة:

{"data":[{"id":"<TARGETING_OPTION_ ID>","current_status":"NON-DELIVERABLE"},{"id":"<TARGETING_OPTION_ID>","current_status":"NON-DELIVERABLE","future_plan":[{"key":"2018-05-10T00:00:00+0000","value":"DEPRECATING"}]}]

إرجاع الحقول

المعلومات الجغرافية

ابحث عن الاستهداف حسب البلد ومجموعة البلدان والمدينة والولاية والرمز البريدي والمناطق الجغرافية الأخرى من خلال type=adgeolocation. ويمكنك تحديد معلمات اختيارية باستخدام type=adgeolocation. للعثور على كود البلد للولايات المتحدة:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=un' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "key": "GB", 
      "name": "United Kingdom", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "AE", 
      "name": "United Arab Emirates", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "UM", 
      "name": "United States Minor Outlying Islands", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }
  ]
}

يمثل key رقمًا ثابتًا فريدًا لكل فئة، مثل البلدان أو مجموعات البلدان. وتخضع الحقول الأخرى، بما في ذلك name، للتغيير. استخدم key لتحديد مواصفات الاستهداف.

في الاستجابة:

• إذا كانت supports_region بالقيمة true، فيتضمن هذا البلد أكواد المناطق
• إذا كانت supports_city بالقيمة true، فيتضمن هذا البلد أكواد المدن

البلدان

تتضمن كل البلدان التي يمكنك استهدافها كود البلد. المعلمات الاختيارية لـ type=adgeolocation&location_types=['country']:

مجموعة البلدان

تتضمن كل مجموعات البلدان كود من أجل البحث به والحصول على قائمة بالبلدان. بالنسبة لكل مجموعات البلدان بالاسم mercosur:

curl -G \
  -d 'location_types=["country_group"]' \
  -d 'type=adgeolocation' \
  -d 'q=mercosur' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "key": "mercosur",
      "name": "Mercosur",
      "type": "country_group",
      "country_codes": [
        "BR",
        "AR",
        "UY",
        "PY",
        "VE"
      ],
      "is_worldwide": false,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

إذا كانت is_worldwide بالقيمة true، فإنها تشير إلى مجموعة بلدان عالمية. وإذا كانت supports_region بالقيمة true، فتحتوي مجموعة البلدان على أكواد المناطق. إذا كانت supports_city بالقيمة true، فتحتوي المجموعة على أكواد المدن.

المناطق

للبحث عن كل المناطق التي تبدأ بالكود al:

curl -G \
  -d 'location_types=["region"]' \
  -d 'type=adgeolocation' \
  -d 'q=al' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "key": "3843",
      "name": "Alabama",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "3844",
      "name": "Alaska",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "527",
      "name": "Alberta",
      "type": "region",
      "country_code": "CA",
      "country_name": "Canada",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "1089",
      "name": "Alsace",
      "type": "region",
      "country_code": "FR",
      "country_name": "France",
      "supports_region": true,
      "supports_city": true
    }
  ]
}

خيارات type=adgeolocation&location_types=['region']:

إذا كانت supports_region بالقيمة true، يمكنك استهداف هذه المنطقة. وإذا كانت supports_city بالقيمة true، فتحتوي المنطقة على أكواد المدن.

المدن

منذ مارس 2019، أعدنا تصنيف العديد من المدن إلى أدوار أخرى، ولكن يمكنك متابعة استخدام city. وسيقوم البحث بإرجاع النتائج التي كانت مدنًا في السابق.

للبحث عن أكواد كل المدن التي تبدأ بكلمة Manhattan:

curl -G \
     -d 'location_types=["city"]' \
     -d 'type=adgeolocation' \
     -d 'q=Manhattan' \
     -d 'access_token=ACCESS_TOKEN' \
     https://graph.facebook.com/VERSION/search

الاستجابة:

{
  "data": [
    {
      "key": "2447439",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Kansas",
      "region_id": 3859,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2439596",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Illinois",
      "region_id": 3856,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2479541",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Montana",
      "region_id": 3869,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2428908",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Florida",
      "region_id": 3852,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2703980",
      "name": "Manhattan",
      "type": "subcity",
      "country_code": "US",
      "country_name": "United States",
      "region": "New York",
      "region_id": 3875,
      "supports_region": true,
      "supports_city": true,
      "geo_hierarchy_level": "SUBCITY",
      "geo_hierarchy_name": "BOROUGH"
    },
   ...

إذا كانت supports_region صحيحة، فتتوفر منطقة هذه المدينة للاستهداف. وإذا كانت supports_city بالقيمة true، فتتوفر هذه المدينة للاستهداف.

المناطق الجغرافية

تتوفر لدينا مناطق جغرافية أخرى يمكنك استخدامها في الاستهداف. ولم يتم تحديد بعض هذه المناطق بعد كما هو ملحوظ أدناه.

فيما يلي التسلسل الهرمي للمناطق الجغرافية من الأكبر إلى الأصغر:

• REGION
• LARGE_GEO_AREA
• MEDIUM_GEO_AREA
• SMALL_GEO_AREA
• METRO_AREA
• CITY
• SUBCITY
• NEIGHBORHOOD
• SUBNEIGHBORHOOD

الرمز البريدي

يمكنك أيضًا البحث عن الرموز البريدية لاستهدافها على فيسبوك. وللبحث بالرمز البريدي، نوصي باستخدام adgeolocation الذي يتضمن location_types=['zip']. تفضل بزيارة مركز مساعدة Meta لعرض قائمة بالبلدان التي لديها رموز بريدية مدعومة.

ابحث عن الرموز البريدية التي تبدأ بالرقم 9:

curl -G \
  -d 'location_types=["zip"]' \
  -d 'type=adgeolocation' \
  -d 'q=9' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/search

الاستجابة:

{
  "data": [
    {
      "key": "US:90028",
      "name": "90028",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Los Angeles",
      "primary_city_id": 2420379,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94110",
      "name": "94110",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Francisco",
      "primary_city_id": 2421836,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94501",
      "name": "94501",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Alameda",
      "primary_city_id": 2417628,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:95190",
      "name": "95190",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Jose",
      "primary_city_id": 2421846,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

اللغات المحلية

تمثل اللغات المحلية القابلة للاستهداف حسب رموز اللغات المحلية. وللبحث عن كل اللغات المحلية التي تبدأ بالرمز en:

curl -G \
  -d 'type=adlocale' \
  -d 'q=en' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
{
      "data": [
        {
          "key": 51, 
          "name": "English (Upside Down)"
        }, 
        {
          "key": 6, 
          "name": "English (US)"
        }, 
        {
          "key": 24, 
          "name": "English (UK)"
        }
      ]
    }
}

رموز DMA

للحصول على هذه الرموز، حدد type=adgeolocation وlocation_types=['geo_market'] في استعلامك. وللبحث عن رموز DMA التي تبدأ بكلمة "جديد":

curl -G \
  -d 'location_types=["geo_market"]' \
  -d 'type=adgeolocation' \
  -d 'q=New' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

النتيجة:

{
  "data": [
    {
      "key": "DMA:622",
      "name": "New Orleans",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:501",
      "name": "New York",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:533",
      "name": "Hartford & New Haven",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
....
    }
  ]
}

الدوائر الانتخابية

للبحث عن دوائر انتخابية لاستهدافها، حدد type=adgeolocation وlocation_types=['electoral_district']. وللبحث عن دوائر انتخابية في كاليفورنيا:

curl -G \
  -d 'location_types=["electoral_district"]' \
  -d 'type=adgeolocation' \
  -d 'q=California' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "key": "US:CA14",
      "name": "California's 14th District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:CA02",
      "name": "California's 2nd District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
 ...
}

بيانات تعريف المواقع الجغرافية

يمكنك استخدام معلمات اختيارية إضافية مع type=adgeolocationmeta:

curl -G \
  -d 'cities=[2418779]' \
  -d 'zips=["US:90210"]' \
  -d 'countries=["US","JP"]' \
  -d 'regions=[10]' \
  -d 'type=adgeolocationmeta' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة هي كائن بلغة JSON يتضمن بيانات تعريف للمواقع الجغرافية المحددة:

{
  "data": {
    "countries": {
      "US": {
        "key": "US", 
        "type": "country", 
        "name": "United States", 
        "supports_city": true, 
        "supports_region": true
      }, 
      "JP": {
        "key": "JP", 
        "type": "country", 
        "name": "Japan", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "regions": {
      "10": {
        "key": "10", 
        "type": "region", 
        "name": "Dubai", 
        "country_code": "AE", 
        "supports_city": true, 
        "supports_region": false
      }
    }, 
    "cities": {
      "2418779": {
        "key": "2418779", 
        "type": "city", 
        "name": "Danville", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "zips": {
      "US:90210": {
        "key": "US:90210", 
        "type": "zip", 
        "name": "90210", 
        "primary_city": "Beverly Hills", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }
  }
}

فيما يلي الخيارات:

اقتراحات بشأن النطاق

لاستهداف نطاق يحيط بموقع معين، اجعل النطاق المُقترح يصل إلى عدد كاف من الأشخاص من خلال suggested_radius:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة هي كائن بلغة JSON يتضمن suggested_radius وdistance_unit.

{
  "data": [
    {
      "suggested_radius": 10,
      "distance_unit": "mile"
    }
  ]
}

مثال يوضح الحصول على suggested_radius باستخدام وحدة distance_unit محددة:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

{
  "data": [
    {
      "suggested_radius": 16,
      "distance_unit": "kilometer"
    }
  ]
}

استخدم المعلمات التالية:

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

الاهتمامات

أرسل طلب GET إلى نقطة النهاية /search وقم بتعيين type إلى adinterest وq إلى الاهتمام المحدد المطلوب البحث فيه:

curl -G \
  -d 'type=adinterest' \
  -d 'q=baseball' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

ستقوم الاستجابة بإرجاع الحقول التالية:

اقتراحات الاهتمامات

أرسل طلب GET إلى نقطة النهاية /search وقم بتعيين type إلى adinterestsuggestion للحصول على قائمة بالاهتمامات المُقترحة المتعلقة بالاهتمام.

عينة من الاستعلام

curl -G \
  -d 'interest_list=["Basketball"]' \
  -d 'type=adinterestsuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/search

عينة من الاستجابة

{
  "data": [
    {
      "id": "6003598240487",
      "name": "la biblia",
      "audience_size": 7419780,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003022269556",
      "name": "Rugby football",
      "audience_size": 13214830,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003146664949",
      "name": "Netball",
      "audience_size": 4333770,
      "path": [
  ],
"description": null
   },
   {
      "id": "6003013291881",
      "name": "Kaizer Chiefs F.C.",
      "audience_size": 1812850,
      "path": [
  ],
      "description": null
  },
  ....
  {
      "id": "6003400886535",
      "name": "espn sportscenter",
      "audience_size": 222960,
      "path": [
  ],
     "description": null
  },
  {
     "id": "6002925969459",
     "name": "watching movies",
     "audience_size": 4630950,
     "path": [
  ],
     "description": null
  },
  {
     "id": "6003214125247",
     "name": "lakers",
     "audience_size": 340360,
     "path": [
  ],
     "description": null
  }

تتضمن الخيارات ما يلي:

التقييدات

• لن يتم إرجاع كل الاهتمامات المتوفرة في البحث.
• يمكن إعادة تسمية الاهتمامات في أي وقت، وقد تفشل عملية التحقق بالاسم عند حدوث ذلك. لذلك نوصي بالتحقق من الاهتمامات باستخدام interest_fbid_list بدلًا من استخدام الاسم. وتحقق مما إذا كانت المصطلحات صالحة أم لا من خلال الاستعلام باستخدام type=adinterestvalid والاهتمام المطلوب التحقق منه:

curl -G \
  -d 'interest_list=["Japan","nonexistantkeyword"]' \
  -d 'type=adinterestvalid' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "name": "Japan",
      "valid": true,
      "id": 6003700426513,
      "audience_size": 68310258
    },
    {
      "name": "nonexistantkeyword",
      "valid": false
    }
  ]
}

فيما يلي الخيارات:

الاهتمامات

لتصفح الاهتمامات المحتملة للاستهداف، أرسل طلب GET إلى نقطة النهاية /search مع تعيين type إلى adTargetingCategory وتعيين class إلى interests.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=interests' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

التقييدات

• لن يتم إرجاع كل الاهتمامات المتوفرة في البحث.

السلوكيات

استهدف بناءً على إجراءات المستخدم أو سلوك شراء سابق. ويمكنك استعادة كل خيارات استهداف السلوك الممكنة باستخدام type=adTargetingCategory&class=behaviors.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=behaviors' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

تتضمن الاستجابة ما يلي:

المعلومات الديموغرافية

تتضمن هذه المعلومات مكان العمل والتعليم وأنواع المسميات الوظيفية وأنواع الحالة الاجتماعية. ويمكنك أيضًا الاستهداف بناءً على حداثة المناسبة الشخصية: 3 أشهر و6 أشهر وسنة. ويمكنك الإشارة إلى المدارس المطلوب استهدافها باستخدام معرف واسم.

للبحث عن كل المدارس التي تبدأ بحرفي ha:

curl -G \
  -d 'type=adeducationschool' \
  -d 'q=ha' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

 {
  "data": [
    {
      "name": "Harvard University", 
      "id": 105930651606,
      "coverage": 8395398,
      "subtext": "Cambridge, Massachusetts"
    }, 
    {
      "name": "Hajvery University", 
      "id": 148971135122588,
      "coverage": 124162
    }, 
    {
      "name": "Harvard-Westlake School", 
      "id": 107799365910274,
      "coverage": 14106
    }
  ]
}

التخصصات التعليمية

استهدف التخصصات باستخدام معرف واسم. وللبحث عن كل التخصصات التي تبدأ بحرفي ph:

curl -G \
  -d 'type=adeducationmajor' \
  -d 'q=ph' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "name": "Photography", 
      "id": 108170975877442,
      "coverage": 613618
    }, 
    {
      "name": "Physics", 
      "id": 109279729089828,
      "coverage": 942491
    }, 
    {
      "name": "Philosophy", 
      "id": 108026662559095,
      "coverage": 701271
    }
  ]
}

جهة العمل

يمكنك الرجوع إلى جهات العمل القابلة للاستهداف باستخدام المعرف والاسم. وللبحث عن كل جهات العمل التي تبدأ بأحرف mic:

curl -G \
  -d 'type=adworkemployer' \
  -d 'q=mic' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
  "data": [
    {
      "name": "Western Michigan University", 
      "id": 10022826163,
      "coverage": 24366
    }, 
    {
      "name": "University of Michigan", 
      "id": 21105780752,
      "coverage": 17357
    }, 
    {
      "name": "Michigan State University - SPARTANS", 
      "id": 8891783019,
      "coverage": 65853
    }
  ]
}

المسمى الوظيفي

يتضمن كل مسمى وظيفي محدد ذاتيًا وقابل للاستهداف معرفًا واسمًا. للحصول على كل المسميات الوظيفية التي تتضمن Business Analyst:

curl -G \
  -d 'type=adworkposition' \
  -d 'q=Business Analyst' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

الاستجابة:

{
   "data": [
    {
      "name": "Business Analyst", 
      "id": 105763692790962,
      "coverage": 282124
    }, 
    {
      "name": "Financial Analyst", 
      "id": 112930925387573,
      "coverage": 212889
    }
  ]
}

تتضمن الاستجابة الحقول التالية:

تتوفر فيما يلي المعلمات الشائعة لواجهة API هذه. وبالنسبة لمعلمات الإدخال الخاصة بنوع محدد، يمكنك الرجوع إلى التفاصيل أدناه.

بناءً على فئة بيانات الإكمال التلقائي، يمكنك توفير النوع type المناسب. لاستعادة اللغات المحلية، حدد type=adlocale. وتكون الفئات الصالحة هي:

تصفح المعلومات الديموغرافية

يمكنك استعادة كل خيارات استهداف المعلومات الديموغرافية المحتملة باستخدام type=adTargetingCategory وclass.

تحتوي الاستجابة على الحقول التالية: