ข้อมูลอ้างอิง: ธุรกิจ
หากต้องการใช้ตัวจัดการธุรกิจ ธุรกิจจะต้องมีเพจ ผู้ดูแล ชื่อธุรกิจ และที่อยู่อีเมลที่ถูกต้องอย่างละ 1 รายการเป็นอย่างน้อย
ชื่อธุรกิจจะใช้สำหรับธุรกิจของคุณเท่านั้นและธุรกิจอื่นใดที่คุณเลือกแชร์อ็อบเจ็กต์ด้วย หลังจากสร้างธุรกิจนี้ คุณจะสามารถเพิ่มเพจ บัญชีโฆษณา แอพ อ็อบเจ็กต์ติดตามคอนเวอร์ชั่นนอกเว็บไซต์ และองค์ประกอบที่เกี่ยวข้องกับโฆษณาอื่นๆ ที่เป็นของธุรกิจ
business_management
ด้วยbusiness_management
ด้วย สร้างตัวจัดการธุรกิจใหม่เพื่อแสดงถึงธุรกิจของคุณ ให้สร้างตัวจัดการธุรกิจใหม่เฉพาะเมื่อคุณสร้างสำหรับตัวเองหรือลูกค้าของคุณเท่านั้น หากคุณต้องการใช้บัญชีโฆษณาอื่นหรือเข้าใช้เพจอื่น คุณควรใช้ตัวจัดการและสิทธิ์การอนุญาตขององค์ประกอบที่มีอยู่แล้ว ระบบไม่อนุญาตให้ลบตัวจัดการธุรกิจ
ตัวอย่างเช่น สร้างตัวจัดการธุรกิจใหม่ด้วย POST
curl \ -F "name=Pomni Media" \ -F "vertical=ADVERTISING" \ -F "primary_page=<PAGE_ID>" \ -F "timezone_id=1" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<USER_ID>/businesses"
หากต้องการสร้างธุรกิจ คุณต้องใช้รายการต่อไปนี้
ID เพจที่คุณระบุควรเป็นเพจหลักของธุรกิจของคุณ เพจนี้จะแสดงถึงธุรกิจของคุณบน Facebook ต่อสาธารณะ ใครก็ตามที่สร้างธุรกิจจะเป็นผู้จัดการเพจนี้ หากคุณไม่มีเพจที่แสดงถึงธุรกิจของคุณบน Facebook ให้สร้างขึ้นมาหนึ่งเพจ
หมวดหมู่ธุรกิจคือค่าคงที่ที่เป็นสตริงเหล่านี้
ADVERTISING , AUTOMOTIVE , CONSUMER_PACKAGED_GOODS , ECOMMERCE , EDUCATION , ENERGY_AND_UTILITIES , ENTERTAINMENT_AND_MEDIA , FINANCIAL_SERVICES , GAMING , GOVERNMENT_AND_POLITICS ,MARKETING , ORGANIZATIONS_AND_ASSOCIATIONS , PROFESSIONAL_SERVICES , RETAIL , TECHNOLOGY , TELECOM , TRAVEL , OTHER
หากต้องการดูทรัพย์สินของธุรกิจ ให้ใช้ ID ของธุรกิจ โดย ID จะเป็นส่วนหนึ่งของการตอบกลับจากคำขอสร้างตัวจัดการธุรกิจ
curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>?access_token=<ACCESS_TOKEN>"
นอกจากนี้ คุณยังสามารถดูรายการตัวจัดการธุรกิจที่คุณเข้าถึงได้
curl "https://graph.facebook.com/<API_VERSION>/me/businesses?access_token=<ACCESS_TOKEN>"
ช่องการตอบกลับได้แก่
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ชื่อธุรกิจ |
ประเภท: int | |
ประเภท: อ็อบเจ็กต์ JSON | อ็อบเจ็กต์ของเพจหลักที่เชื่อมโยงกับตัวจัดการธุรกิจนี้ { "category": "App page", "name": "Sample Primary Page", "id": "123456789" } |
ประเภท: ยาว | ID ตัวจัดการธุรกิจ |
ประเภท: สตริง | เวลาล่าสุดที่มีการอัพเดตตัวจัดการธุรกิจนี้ |
ประเภท: อ็อบเจ็กต์ JSON | ผู้ใช้คนสุดท้ายที่อัพเดตตัวจัดการนี้ โดยระบุเป็นชื่อและ ID |
ประเภท: สตริง | เวลาที่สร้างธุรกิจนี้ |
ประเภท: อ็อบเจ็กต์ JSON | ชื่อผู้ใช้และ ID ของผู้ที่สร้างตัวจัดการนี้ |
อัพเดตช่องในตัวจัดการธุรกิจโดยใช้วิธีส่งคำขอ POST
ไปยัง https://graph.facebook.com/{API_VERSION}/{BUSINESS_ID}
ตัวอย่างเช่น เปลี่ยนชื่อธุรกิจ
curl \ -F "name=My Actual Business Name" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"
เปลี่ยนหมวดหมู่ธุรกิจโดยส่งคำขอ POST ต่อไปนี้
curl \ -F "vertical=RETAIL" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"
คุณมีตัวเลือกดังนี้
ชื่อ | คำอธิบาย |
---|---|
| ต้องระบุ ชื่อธุรกิจ |
| ID เพจหลักที่เชื่อมโยงกับตัวจัดการธุรกิจนี้ |
คุณสามารถอัพเดตเพจหลักได้โดยส่งคำขอ POST ต่อไปนี้ เพจหลักต้องมีตัวจัดการธุรกิจเป็นเจ้าของ
curl \ -F "primary_page=<PAGE_ID>" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"
คุณยังสามารถอัพเดตรายการทั้งหมดได้ในคำขอ POST เดียว
curl \ -F "name=My Actual Business Name" \ -F "vertical=RETAIL" \ -F "primary_page=<PAGE_ID>" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"
บทบาทในตัวจัดการธุรกิจมี 2 ประเภท ดังนี้
ชื่อ | ค่าคงที่ของ API | คำอธิบาย |
---|---|---|
ผู้ดูแล |
|
|
พนักงาน |
|
|
หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับบทบาทต่างๆ โปรดดูตั้งค่าบทบาทแค็ตตาล็อกในตัวจัดการธุรกิจ
เมื่อเริ่มแรก ผู้สร้างธุรกิจจะเป็นผู้ใช้หนึ่งเดียวในธุรกิจและจะเป็นผู้ดูแลด้วย
หากต้องการเพิ่มเพื่อนร่วมงานของคุณให้กับธุรกิจ คุณต้องเชิญเพื่อนร่วมงานเข้ามา ในการเชิญบุคคลอื่น ให้ป้อนอีเมลที่ถูกต้องซึ่งบุคคลนั้นสามารถเข้าถึงได้ การส่งคำขอเพิ่มพนักงานให้กับตัวจัดการธุรกิจนั้นทำได้จำกัด เมื่อคุณดำเนินการถึงขีดจำกัดแล้ว คุณจะได้รับรหัสข้อผิดพลาด 17 และจะกลับมาดำเนินการต่อได้หลังจากผ่านไป 24 ชั่วโมง
หากต้องการเชิญบุคคลอื่นเป็นผู้ดูแล ให้ส่งคำขอ POST
ดังนี้
curl \ -F "email=some@email.com" \ -F "role=ADMIN" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"
หากต้องการเชิญบุคคลอื่นเป็นพนักงาน ให้ส่งคำขอ POST
ดังนี้
curl \ -F "email=some@email.com" \ -F "role=EMPLOYEE" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"
Facebook จะส่งอีเมลคำเชิญไปยังอีเมลที่ทำงานตามที่คุณระบุ ผู้ได้รับคำเชิญจะต้องตรวจสอบอีเมลและดำเนินการตามกระบวนการสมัครใช้งาน เมื่อดำเนินการเสร็จสิ้นแล้ว คุณจะเห็นผู้ได้รับคำเชิญเหล่านั้นในรายชื่อผู้ใช้
ตั้งแต่เวอร์ชั่น 2.11 เราได้แยกตำแหน่งข้อมูลเพื่อรับผู้ใช้ตามสถานะของผู้ใช้ ส่งคำขอ GET
เพื่อดึงข้อมูลกลุ่มผู้ใช้แต่ละกลุ่ม หากต้องการดึงข้อมูลผู้ใช้ธุรกิจทั้งหมด (โปรดทราบว่าต้องใช้สิทธิ์การอนุญาตขั้นสูง):
curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users?access_token=<ACCESS_TOKEN>"
หากต้องการดึงข้อมูลผู้ใช้ระบบด้วยสิทธิ์การเข้าถึงระดับระบบ:
curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>"
หากต้องการดึงข้อมูลผู้ใช้ที่รอดำเนินการที่ได้รับคำเชิญให้เข้าถึงธุรกิจ แต่ยังไม่ได้ตอบรับคำเชิญ:
curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_users?access_token=<ACCESS_TOKEN>"
ตำแหน่งข้อมูลจะส่งคืนข้อมูลผู้ใช้ที่ใช้งานอยู่ รอดำเนินการ หรือผู้ใช้ระบบสำหรับธุรกิจของคุณ ตัวอย่างเช่น
{ "data": [ { "id": "<BUSINESS_ID>", "name": "Alpha MK", "email": "some@email.com", "role": "EMPLOYEE", } ] }
ผลลัพธ์สำหรับผู้ใช้ที่รอดำเนินการมีลักษณะดังนี้
{ "data": [ { "id": "<BUSINESS_ID>", "email": "some@email.com", "role": "EMPLOYEE", "status": "PENDING", "owner": { "id": "USER_ID", "name": "Generic Emporium" } } ] }
คำจำกัดความสำหรับช่องที่ส่งคืนมีดังนี้
ชื่อ | คำอธิบาย |
---|---|
ประเภท: ยาว | ID ของผู้ใช้รายนี้ที่อยู่ภายในขอบเขตของธุรกิจนี้ |
ประเภท: สตริง | ชื่อของผู้ใช้รายนี้ภายในธุรกิจนี้ |
ประเภท: อ็อบเจ็กต์ JSON | ตัวจัดการธุรกิจที่มีผู้ใช้รายนี้อยู่ |
ประเภท: สตริง | ชื่อจริงของผู้ใช้รายนี้ภายในธุรกิจนี้ |
ประเภท: สตริง | นามสกุลของผู้ใช้ภายในธุรกิจนี้ |
ประเภท: สตริง | ตำแหน่งข้อมูลผู้ใช้ภายในธุรกิจนี้ |
ประเภท: สตริง | บทบาทที่บุคคลนี้มีสำหรับธุรกิจนี้ |
ประเภท: สตริง | อีเมลของผู้ใช้ |
หากต้องการเปลี่ยนบทบาทของผู้ใช้ที่ใช้งานอยู่ในธุรกิจของคุณ ให้ระบุ ID ผู้ใช้ของผู้ใช้ดังกล่าว ตัวอย่างเช่น คุณสามารถอัพเกรดพนักงานเป็นบทบาทผู้ดูแลได้ด้วยคำขอ POST
ดังนี้
curl \ -F "role=ADMIN" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"
หากต้องการเปลี่ยนบทบาทของบุคคลจากผู้ดูแลเป็นพนักงาน ให้ส่งคำขอ POST ดังนี้
curl \ -F "role=EMPLOYEE" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"
คุณสามารถเปลี่ยนบทบาทสำหรับผู้ใช้ที่รอดำเนินการได้ด้วยคำขอ POST
นี้
curl \ -F "role=EMPLOYEE" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"
ลบสิทธิ์การอนุญาตที่ให้แก่บุคคลตามสถานะสมาชิกภายใต้ตัวจัดการธุรกิจ จำกัดการเข้าถึงบัญชีโฆษณาและเพจต่างๆ หากผู้ใช้มีสิทธิ์การเข้าถึงบัญชีโฆษณาหรือเพจต่างๆ นอกตัวจัดการธุรกิจของคุณ สิทธิ์การอนุญาตเหล่านั้นจะไม่เปลี่ยนแปลง ตัวอย่างเช่น ผู้ใช้บางรายอาจเพิ่มตนเองหรือมีสิทธิ์การเข้าถึงผ่านตัวจัดการธุรกิจ
หากต้องการลบผู้ใช้ที่ใช้งานอยู่จากธุรกิจของคุณ ให้ดำเนินการเรียกใช้ DELETE
ดังนี้
curl \ -X DELETE \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"
หากต้องการยกเลิกผู้ใช้ที่รอดำเนินการด้วยคำขอ DELETE
ให้ดำเนินการดังนี้
curl \ -X DELETE \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"
วิธีนี้จะเป็นการลบผู้ใช้จากธุรกิจของคุณและลบสิทธิ์การเข้าถึงสินทรัพย์ของธุรกิจ
สินทรัพย์ธุรกิจเป็นอ็อบเจ็กต์ของ Facebook (ตัวอย่างเช่น เพจ แอพ และอื่นๆ) ที่ผู้ดูแลจัดการอยู่ ผู้ดูแลอาจเป็นผู้ใช้หรือธุรกิจก็ได้ หรือในกรณีของแอพ ก็อาจเป็นผู้พัฒนาหรือผู้ลงโฆษณา ประเภทสินทรัพย์ธุรกิจ ได้แก่
ดูตัวอย่างการสืบค้นและเรียนรู้เพิ่มเติมที่สินทรัพย์ธุรกิจ
การอ้างอิง: ใบแจ้งหนี้ธุรกิจ
API ตัวจัดการธุรกิจจะช่วยให้คุณได้ดูและจัดการแหล่งที่มาของเครดิตที่เกี่ยวข้องกับธุรกิจ API จะดำเนินการกับใบแจ้งหนี้ที่แสดงในตัวจัดการธุรกิจทั้งหมดซ้ำอีกครั้ง นั่นหมายความว่าใบแจ้งหนี้ทั้งหมดที่ตัวจัดการธุรกิจนี้ต้องจ่ายจะแสดงผ่าน API ไม่ใช่เพียงใบแจ้งหนี้ที่เป็นของ ID ธุรกิจแต่ละรายเท่านั้น
สำหรับพาร์ทเนอร์ API การตลาดที่เปิดใช้งานการออกใบแจ้งหนี้เอาไว้ คุณสามารถใช้งานวงเงินเครดิตปกติที่เป็นของตัวจัดการธุรกิจได้
พาร์ทเนอร์การตลาดของ Facebook (FBMP) ต้องติดต่อตัวแทนจำหน่ายของตนเพื่อตั้งค่าตัวจัดการธุรกิจสำหรับเครดิต โปรดตรวจสอบให้แน่ใจว่าได้ขอใช้วงเงินเครดิตปกติที่เป็นของตัวจัดการธุรกิจแล้ว เมื่อตั้งค่ารายการนี้แล้ว คุณจะสามารถเริ่มใช้ API การสร้างบัญชีโฆษณาเพื่อเริ่มสร้างบัญชีโฆษณาได้ การเรียกเก็บค่าใช้จ่ายจะเรียกจากวงเงินเครดิตของตัวจัดการธุรกิจของคุณ
สำหรับบัญชีโฆษณาที่สร้างผ่าน API ต่อไปนี้ เราจะทยอยแจกจ่ายเครดิตไปยังบัญชีต่างๆ ไปเรื่อยๆ และอัพเดตขีดจำกัดเครดิตและยอดใช้จ่ายเพื่อไม่ให้ถึงขีดจำกัดของเครดิต คุณยังจะสามารถดูสรุปเครดิตที่มีและจำนวนเครดิตในแต่ละบัญชีได้ด้วย
ในปัจจุบัน เรารองรับเพียงการจ่ายหนี้แบบปกติเท่านั้น ยังไม่รองรับการจ่ายหนี้แบบตามลำดับ กระบวนการตั้งค่าดังกล่าวจะยังคงไม่เปลี่ยนแปลง
เมื่อตั้งค่าวงเงินเครดิตสำหรับธุรกิจแล้วและธุรกิจใช้วงเงินดังกล่าวในการเผยแพร่โฆษณา เราจะสร้างใบแจ้งหนี้สิ้นเดือนสำหรับบัญชีธุรกิจขึ้นมา หากต้องการดูใบแจ้งหนี้ธุรกิจ คุณต้องมีบทบาทการเงิน สำหรับผู้ดูแลและพนักงานทั่วไปของธุรกิจ คุณสามารถมอบหมายสิทธิ์การอนุญาตภายใต้ People
ในตัวจัดการธุรกิจได้ คุณยังสามารถมอบหมายสิทธิ์การอนุญาตทางการเงินให้กับผู้ใช้ระบบโดยใช้ตัวจัดการธุรกิจได้
หากต้องการดึงข้อมูลใบแจ้งหนี้ภายใต้บัญชีธุรกิจโดยใช้ API ให้ส่งคำขอ GET
ดังนี้
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?start_date=2017-01-01&end_date=2017-04-01"
ตัวอย่างผลลัพธ์จะมีลักษณะดังนี้
{ "business_invoices": { "data": [ { "id": "1659175694099710", "billing_period": "2017-03-01" }, { "id": "1303851778395619", "billing_period": "2017-01-01" }, { "id": "1415846861611329", "billing_period": "2017-02-01" } ], "paging": { "cursors": { "before": "MAZDZD", "after": "MgZDZD" } } }, "id": "249554531892085" }
คุณสามารถดึงข้อมูลรายละเอียดใบแจ้งหนี้ที่ระดับแคมเปญได้ด้วยคำขอนี้ ดังนี้
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?fields=billed_amount_details,billing_period,entity,id,invoice_id,payment_term,type,campaigns&start_date=2019-06-01&end_date=2019-07-01"
การตอบกลับจะมีลักษณะคล้ายคลึงกับตัวอย่างนี้:
{ "business_invoices": { "data": [ { "billed_amount_details": { "currency": "USD", "net_amount": "387.70", "tax_amount": "0.00", "total_amount": "387.70" }, "billing_period": "2017-03-01", "entity": "FBUS", "id": "1659175694099710", "invoice_id": "22736800", "liability_type": "Normal", "invoice_type": "Invoice", "payment_term": "CUSTOMER", "type": "Invoice", "campaigns": { "data": [ { "campaign_id": "6056967798500", "campaign_name": "Nhận ưu đãi", "tags": [ "hello2" ], "billed_amount_details": { "currency": "USD", "net_amount": "207.62", "tax_amount": "0.00", "total_amount": "207.62" } }, { "campaign_id": "6056958052500", "campaign_name": "Nhận ưu đãi", "billed_amount_details": { "currency": "USD", "net_amount": "180.08", "tax_amount": "0.00", "total_amount": "180.08" } "impressions": 100, "clicks": 50, "conversions": 30 } ] } }, { "billed_amount_details": { "currency": "USD", "net_amount": "382.99", "tax_amount": "0.00", "total_amount": "382.99" }, ...... "paging": { "cursors": { "before": "MAZDZD", "after": "MgZDZD" } } }, "id": "1515766328651000" }
คุณยังสามารถรับช่องการออกใบแจ้งหนี้เพิ่มเติมได้ ดังนี้
invoice_date
- วันที่ Facebook สร้างใบแจ้งหนี้due_date
- วันที่ครบกำหนดของใบแจ้งหนี้payment_status
- แสดงว่าใบแจ้งหนี้มีสถานะ Paid
, Unpaid
หรือ Partially Paid
amount_due
- จำนวนเงินที่ครบกำหนดชำระและยอดคงเหลือในใบแจ้งหนี้download_uri
- URI สำหรับดาวน์โหลด PDF ของใบแจ้งหนี้หากต้องการดึงข้อมูลแหล่งเงินทุนเครดิตเพิ่มเติมที่เชื่อมโยงกับตัวจัดการธุรกิจ ให้ส่งคำขอ GET นี้
curl "https://www.graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/extendedcredits"
หากต้องการตั้งค่าแหล่งเงินทุนสำหรับธุรกิจ ให้ไปที่ส่วนการตั้งค่าของธุรกิจบนตัวจัดการธุรกิจ
การจัดสรรเครดิตแบบต่อเนื่อง หรือที่เรียกว่า DCAF คือระบบจัดสรรเครดิตของเราสำหรับการปรับเครดิตที่ใช้ได้เป็นระยะต่อบัญชีโฆษณาแต่ละบัญชี สคริปต์อัตโนมัติของเราจะทำงานทุก 30 นาทีโดยประมาณและดึงเครดิตที่มีอยู่ไป แล้วกระจายเครดิตไปยังบัญชีที่ใช้งานอยู่ต่างๆ ที่เปิดใช้ DCAF เอาไว้โดยเท่าๆ กัน เครดิตที่ใช้ได้คิดได้จากการนำเครดิตรวมที่ได้รับอนุมัติมาลบด้วยยอดคงเหลือรวม วิธีนี้จะช่วยจัดการค่าใช้จ่ายในระดับบัญชีโฆษณาและจัดสรรเงินทุนของบัญชีโฆษณาแต่ละบัญชีได้
ธุรกิจยังสามารถ "เลิกใช้งาน" บัญชีโฆษณาที่ออกใบแจ้งหนี้แล้วได้ และลบบัญชีโฆษณาออกจากรายการที่ต้องมอบหมายเครดิต ธุรกิจไม่ต้องให้ Facebook จัดการสถานะนี้ให้อีกต่อไป