กำหนดเป้าหมายชุดโฆษณาตามจำนวนเกณฑ์ที่คุณระบุไว้ในข้อมูลจำเพาะของการกำหนดเป้าหมาย เป้าหมายส่วนใหญ่จะได้รับการกำหนดค่าไว้ล่วงหน้า เช่น ประเทศ "ญี่ปุ่น" หรือเมือง "โตเกียว"
ค้นหาค่าที่ถูกต้องด้วย 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
เป็น true แปลว่าสามารถกำหนดเป้าหมายภูมิภาคดังกล่าวของเมืองนี้ได้ หาก supports_city
เป็น true
แปลว่าสามารถกำหนดเป้าหมายเมืองนี้ได้
เรามีพื้นที่ทางภูมิศาสตร์อื่นๆ ที่คุณสามารถใช้กำหนดเป้าหมายได้ เรายังไม่ได้กำหนดบางพื้นที่ ดังที่ระบุไว้ด้านล่าง
พื้นที่ | คำอธิบาย |
---|---|
| รู้จักกันโดยทั่วไปว่าเป็นเขตหรือเขตการปกครองที่ครอบคลุมพื้นที่อย่างน้อยหลายร้อยตารางกิโลเมตร ตัวอย่าง: |
| รู้จักกันโดยทั่วไปว่าเป็นประเทศ ซึ่งครอบคลุมมากกว่า 1 เมือง ตัวอย่าง: เขตปกครอง |
| รู้จักกันโดยทั่วไปว่าเป็นเขตที่พักอาศัยใกล้เมืองหรือเทศบาล ตัวอย่าง: |
| เช่น เขตเทศบาล ตัวอย่าง: |
| พื้นที่ในเมือง ตัวอย่าง: |
| ยังไม่พร้อมใช้งาน |
| พื้นที่ที่มีประชากรอาศัยอยู่หนาแน่นรอบเมืองที่ใหญ่กว่า ยังไม่พร้อมใช้งาน |
ลำดับชั้นของพื้นที่ทางภูมิศาสตร์มีดังต่อไปนี้ โดยเรียงลำดับตั้งแต่ใหญ่ที่สุดไปจนเล็กที่สุด
REGION
LARGE_GEO_AREA
MEDIUM_GEO_AREA
SMALL_GEO_AREA
METRO_AREA
CITY
SUBCITY
NEIGHBORHOOD
SUBNEIGHBORHOOD
คุณสามารถค้นหารหัสไปรษณีย์เพื่อกำหนดเป้าหมายบน Facebook ได้ด้วยเช่น ในการค้นหารหัสไปรษณีย์ เราขอแนะนำให้ใช้ 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)" } ] } }
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | สตริงที่ต้องการกำหนดค่าโดยอัตโนมัติ หากต้องการรับข้อมูลรูปแบบภาษาทั้งหมด ให้เว้น |
หากต้องการรับรหัสเหล่านี้ ให้ระบุ type=adgeolocation
และ location_types=['geo_market']
ในการสืบค้นของคุณ วิธีค้นหารหัส DMA ที่ขึ้นต้นด้วย "New":
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
การตอบกลับจะส่งคืนช่องต่อไปนี้:
ชื่อ | คำอธิบาย |
---|---|
integer | Facebook ID ของการกำหนดเป้าหมายตามความสนใจ |
string | หากมี ให้เรียกดูเนื้อหาในรูปแบบภาษาที่เฉพาะเจาะจงในรูปแบบ |
สตริง | ชื่อของความสนใจ |
array of strings | รวมหมวดหมู่และหมวดหมู่หลักสำหรับการกำหนดเป้าหมาย |
ส่งคำขอ 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 } ] }
ตัวเลือก:
ชื่อ | คำอธิบาย |
---|---|
ประเภท: อาร์เรย์ของสตริง | ต้องระบุ หากไม่มี รายการคำต่างๆ ที่จะตรวจสอบความถูกต้อง คำนึงถึงอักษรตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก |
ประเภท: อาร์เรย์ของ ID | ต้องระบุ หากไม่มี รายการของ ID ที่จะตรวจสอบความถูกต้อง |
หากต้องการดูความสนใจที่อาจใช้ในการกำหนดเป้าหมายได้ ให้ส่งคำขอ 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
การตอบกลับจะมีข้อมูลดังนี้:
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ชื่อของรูปแบบพฤติกรรมที่กำหนดเป้าหมาย |
ประเภท: จำนวนเต็ม | Facebook ID ของการกำหนดเป้าหมายตามพฤติกรรม |
จำนวนเต็ม | ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตล่างสุดโดยประมาณ |
จำนวนเต็ม | ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตบนสุดโดยประมาณ |
ประเภท: อาร์เรย์ของสตริง | หมวดหมู่และหมวดหมู่หลักสำหรับการกำหนดเป้าหมายนี้ |
ประเภท: สตริง | อธิบายกลุ่มเป้าหมาย |
ประเภท: สตริง | คลาสหมวดหมู่การกำหนดเป้าหมาย |
ข้อมูลในส่วนนี้ประกอบด้วยสถานที่ทำงาน การศึกษา ประเภทตำแหน่งงาน และประเภทสถานะความสัมพันธ์ นอกจากนี้คุณยังสามารถกำหนดเป้าหมายตามช่วงระยะเวลาล่าสุดนับจากที่เกิดเหตุการณ์ในชีวิตได้ด้วย ได้แก่ 3 เดือน, 6 เดือน และ 1 ปี คุณสามารถอ้างอิงโรงเรียนที่ต้องการกำหนดเป้าหมายได้ด้วย ID และชื่อ
วิธีค้นหาโรงเรียนทั้งหมดที่ขึ้นต้นด้วย 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 } ] }
กำหนดเป้าหมายวิชาเอกตาม ID และชื่อ วิธีค้นหาวิชาเอกทั้งหมดที่ขึ้นต้นด้วย 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 } ] }
นายจ้างที่สามารถกำหนดเป้าหมายได้สำหรับอ้างอิงเรียงตาม ID และชื่อ วิธีค้นหานายจ้างที่ทำงานทั้งหมดที่ขึ้นต้นด้วย 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 } ] }
ตำแหน่งงานระบุเองที่กำหนดเป้าหมายได้ทั้งหมดจะมี ID และชื่อ วิธีรับตำแหน่งงานทั้งหมดที่มี 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 } ] }
การตอบกลับจะมีช่องเหล่านี้:
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ชื่อของการกำหนดเป้าหมายทางประชากรศาสตร์ |
ประเภท: จำนวนเต็ม | Facebook ID ของการกำหนดเป้าหมายทางประชากรศาสตร์ |
ประเภท: จำนวนเต็ม | ขนาดกลุ่มเป้าหมายโดยประมาณ |
ประเภท: สตริง | คำอธิบายของกลุ่มเป้าหมาย |
พารามิเตอร์ต่อไปนี้เป็นพารามิเตอร์ทั่วไปสำหรับ API นี้ ในส่วนของพารามิเตอร์อินพุตเฉพาะประเภท โปรดดูรายละเอียดด้านล่าง
ชื่อพารามิเตอร์ | คำอธิบาย |
---|---|
| ต้องระบุสำหรับประเภทการค้นหาส่วนใหญ่ สตริงในการกำหนดค่าโดยอัตโนมัติ |
| จำเป็นต้องระบุ ประเภทของข้อมูลที่กำหนดค่าโดยอัตโนมัติที่ต้องการเรียกใช้ ดูด้านล่าง |
| ระบุหรือไม่ก็ได้ เรียกดู Facebook ID ทั่วโลกที่ต้องการ ไม่ใช่รหัส FIPS รองรับ เมื่อนำมาใช้ ค่าจะต้องเท่ากับ |
| ระบุหรือไม่ก็ได้ ผลลัพธ์สูงสุดที่จะส่งกลับ โดยมีค่าเริ่มต้นเป็น 8 |
จากหมวดหมู่ของข้อมูลที่กำหนดค่าโดยอัตโนมัติ ให้ระบุ type
ที่เหมาะสม และให้ระบุ type=adlocale
เพื่อเรียกดูรูปแบบภาษา หมวดหมู่ที่ถูกต้องคือ:
ค่าสำหรับพารามิเตอร์ `type` | คำอธิบาย |
---|---|
กำหนดค่าการกำหนดเป้าหมายมหาวิทยาลัยโดยอัตโนมัติ | |
กำหนดค่าการกำหนดเป้าหมายวิชาเอกของมหาวิทยาลัยโดยอัตโนมัติ | |
กำหนดค่าประเทศ เมือง รัฐ และรหัสไปรษณีย์โดยอัตโนมัติ | |
adgeolocation.adcountry | กำหนดค่าประเทศโดยอัตโนมัติ |
adgeolocation.adzipcode | กำหนดค่ารหัสไปรษณีย์โดยอัตโนมัติ |
adgeolocation.adgeolocationmeta | เมตาดาต้าเพิ่มเติมสำหรับตำแหน่งที่ตั้งทางภูมิศาสตร์ |
adgeolocation.adradiussuggestion | ส่งกลับรัศมีขอบเขตที่แนะนำรอบๆ ตำแหน่งที่ตั้ง |
กำหนดค่าการกำหนดเป้าหมายรูปแบบภาษาโดยอัตโนมัติ | |
adinterest.adinterestsuggestion | คำแนะนำจากข้อมูลการกำหนดเป้าหมายตามความสนใจ |
adinterest.adinterestvalid | ตรวจสอบสตริงว่าเป็นตัวเลือกการกำหนดเป้าหมายตามความสนใจที่ถูกต้อง |
กำหนดค่าการกำหนดเป้าหมายรูปแบบภาษาโดยอัตโนมัติ | |
adTargetingCategory | ระบบจะไม่ตอบสนองต่อพารามิเตอร์ |
กำหนดค่าสำหรับนายจ้างที่ทำงานโดยอัตโนมัติ | |
กำหนดค่าสำหรับตำแหน่งงานโดยอัตโนมัติ |
เรียกดูตัวเลือกการกำหนดเป้าหมายทางประชากรศาสตร์ที่เป็นไปได้ทั้งหมดด้วย type=adTargetingCategory
และ class
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ระบุ 1 รายการ: ตัวเลือกการกำหนดเป้าหมายทางประชากรศาสตร์ไม่สามารถใช้ได้ในบางประเทศ Facebook อาจส่งกลับผลลัพธ์ที่แตกต่างกัน รวมไปถึงผลลัพธ์เปล่า ทั้งนี้ขึ้นอยู่กับการตั้งค่าประเทศที่อยู่ของผู้ใช้ที่มีโทเค็นการเข้าถึงที่กำลังใช้งานเพื่อทำการเรียก API นี้ |
การตอบกลับจะมีช่องเหล่านี้:
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ชื่อของการกำหนดเป้าหมายทางประชากรศาสตร์ |
ประเภท: จำนวนเต็ม | Facebook ID ของการกำหนดเป้าหมายทางประชากรศาสตร์ |
จำนวนเต็ม | ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตล่างสุดโดยประมาณ |
จำนวนเต็ม | ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตบนสุดโดยประมาณ |
ประเภท: สตริง | คำอธิบายของกลุ่มเป้าหมาย |
ประเภท: สตริง | ประเภทของข้อมูลทางประชากรศาสตร์ หากคุณเรียกดูข้อมูลทางประชากรศาสตร์ทั้งหมด จะเป็นประโยชน์ |
ประเภท: อาร์เรย์ของสตริง | รวมหมวดหมู่และหมวดหมู่หลักที่อยู่ในการกำหนดเป้าหมาย |