API การตลาด

การกำหนดเป้าหมายอย่างละเอียด

คุณสามารถใช้การค้นหาการกำหนดเป้าหมายเพื่อค้นหาการกำหนดเป้าหมายโดยใช้ประเภทการกำหนดเป้าหมายหนึ่งประเภทในการเรียกใช้ API เพียงรายการเดียว คุณสามารถใช้ API การกำหนดเป้าหมายอย่างละเอียดเพื่อค้นหาประเภทการกำหนดเป้าหมายจำนวนมากในคำขอเดียวได้พร้อมๆ กัน คุณสามารถดูคำแนะนำที่อิงตามรายการสืบค้นของคุณได้ด้วย

API มีสี่ปลายทางด้วยกัน: ค้นหาการค้นหาการแนะนำการเลือกดู และการตรวจสอบความถูกต้อง

การตอบกลับสำหรับปลายทางเหล่านี้ประกอบด้วยสิ่งต่อไปนี้

ชื่อ คำอธิบาย

id

ประเภท: สตริง

ID กลุ่มเป้าหมาย

name

ประเภท: สตริง

ชื่อของกลุ่มเป้าหมาย

audience_size_lower_bound

จำนวนเต็ม

ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตล่างสุดโดยประมาณ

audience_size_upper_bound

จำนวนเต็ม

ขนาดกลุ่มเป้าหมายที่เป็นขอบเขตบนสุดโดยประมาณ

path

ประเภท: อาร์เรย์ของสตริง

รวมหมวดหมู่และหมวดหมู่หลักที่อยู่ในการกำหนดเป้าหมาย

description

ประเภท: สตริง

คำอธิบายสั้นๆ เกี่ยวกับกลุ่มเป้าหมาย

หากคุณไม่ระบุ limit_type เราจะกรองผลลัพธ์ให้เหลือคนน้อยกว่า 2,000 คนโดยแบ่งออกเป็นหมวดหมู่ดังนี้ 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

ประเภท: สตริง

จำเป็นต้องระบุ

สตริงรายการสืบค้น

limit

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้

จำนวนผลลัพธ์

limit_type

ประเภท: สตริง

ระบุหรือไม่ก็ได้

จำกัดประเภทของกลุ่มเป้าหมายที่จะดึงข้อมูล เป็นค่าเริ่มต้นของทุกประเภท

ค่าที่ถูกต้อง ได้แก่

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

locale

ประเภท: สตริง

ระบุหรือไม่ก็ได้

ภาษาที่จะแสดงเป็นชื่อของกลุ่มเป้าหมายและคำอธิบาย หากมี ค่าเริ่มต้นจะเป็นภาษาของบัญชีโฆษณา

คำแนะนำ

แสดงกลุ่มเป้าหมายเพิ่มเติมที่คุณสามารถกำหนดเป้าหมายได้ตามกลุ่มเป้าหมายจำนวนไม่มากที่เลือกตามที่คุณระบุ

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

ประเภท: อาร์เรย์ของ {'type':'{TYPE}', 'id':{ID}}

จำเป็นต้องระบุ

อาร์เรย์ของคู่ {'type':'{TYPE}', 'id':{ID}} เป็นอินพุตกลุ่มเป้าหมายสำหรับคำแนะนำ

limit

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้

จำนวนผลลัพธ์ ค่าเริ่มต้นคือ 30 สูงสุดคือ 45

limit_type

ประเภท: สตริง

ระบุหรือไม่ก็ได้

จำกัดประเภทของกลุ่มเป้าหมายที่จะดึงข้อมูล เป็นค่าเริ่มต้นของทุกประเภท

ค่าที่ถูกต้อง ได้แก่

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

locale

ประเภท: สตริง

ระบุหรือไม่ก็ได้

ภาษาที่จะแสดงเป็นชื่อของกลุ่มเป้าหมายและคำอธิบาย ค่าเริ่มต้นจะเป็นภาษาของบัญชีโฆษณา

เลือกดู

ใช้การกำหนดเป้าหมายในรูปของการแบ่งหมวดหมู่ที่มีโครงสร้างสำหรับหมวดหมู่ Facebook ผู้ให้บริการข้อมูลบุคคลที่สาม และความสนใจบางประการ ผลลัพธ์จากปลายทางนี้จะปรากฏในฟังก์ชันการทำงานการเลือกดูในองค์ประกอบ UI การกำหนดเป้าหมายอย่างละเอียดในตัวจัดการโฆษณา

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

ระบุพารามิเตอร์ทางเลือกต่อไปนี้

ชื่อ คำอธิบาย

limit_type

ประเภท: สตริง

จำกัดประเภทของกลุ่มเป้าหมายที่จะดึงข้อมูล เป็นค่าเริ่มต้นของทุกประเภท

locale

ประเภท: สตริง

ภาษาที่จะแสดงเป็นชื่อของกลุ่มเป้าหมายและคำอธิบาย ค่าเริ่มต้นจะเป็นภาษาของบัญชีโฆษณา

การตรวจสอบความถูกต้อง

ตรวจสอบยืนยันว่ากลุ่มเป้าหมายนั้นถูกต้องสำหรับการกำหนดเป้าหมายหรือไม่ วิธีนี้มีประโยชน์หากคุณสร้างชุดโฆษณาไว้แล้วแต่อยากตรวจสอบว่าข้อมูลจำเพาะการกำหนดเป้าหมายนั้นยังถูกต้องอยู่ หากการกำหนดเป้าหมายไม่ถูกต้อง คุณควรลบออกจากข้อมูลจำเพาะการกำหนดเป้าหมาย

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

นอกเหนือจากการตอบกลับการกำหนดเป้าหมายอย่างละเอียดแล้ว ปลายทางนี้ยังแสดงสิ่งต่อไปนี้ด้วย

ชื่อ คำอธิบาย

valid

ประเภท: บูลีน

ว่ากลุ่มเป้าหมายถูกต้องหรือไม่

ต่อไปนี้เป็นรายการพารามิเตอร์อินพุต

ชื่อ คำอธิบาย

targeting_list

ประเภท: อาร์เรย์ของ {'type':'{TYPE}', 'id':{ID}}

อาร์เรย์ของคู่ {'type':'{TYPE}', 'id':{ID}} สำหรับการตรวจสอบความถูกต้อง แนะนำให้ใช้

id_list

ประเภท: อาร์เรย์ของสตริง

อาร์เรย์ ID สำหรับการตรวจสอบความถูกต้อง จะสำเร็จก็ต่อเมื่อ ID นั้นเป็น ID ที่สามารถระบุได้โดยไม่ซ้ำกันในฐานข้อมูลกลุ่มเป้าหมายของเรา

name_list

ประเภท: อาร์เรย์ของสตริง

อาร์เรย์สตริงสำหรับการตรวจสอบความถูกต้อง เฉพาะความสนใจระบุหรือไม่ก็ได้ใช้ตัวอักษรพิมพ์เล็กหรือพิมพ์ใหญ่

locale

ประเภท: สตริง

ภาษาที่จะแสดงชื่อของกลุ่มเป้าหมายและคำอธิบาย ค่าเริ่มต้นจะเป็นภาษาของบัญชีโฆษณา

ระบุข้อใดข้อหนึ่งต่อไปนี้เป็นอย่างน้อย: targeting_list, id_list และ name_list