ตั้งค่าตัวจัดการธุรกิจรองตัวใหม่

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

หมายเหตุ: คุณอาจต้องใช้ appsecret_proof เป็นพารามิเตอร์สำหรับการเรียกใช้แต่ละครั้ง ทั้งนี้ขึ้นอยู่กับว่าคุณได้เปิดใช้งาน appsecret_proof ในการตั้งค่าของแอพหรือไม่ ดูวิธีตั้งค่าตัวเลือกนี้และวิธีสร้าง appsecret_proof ได้ที่เอกสาร "การรักษาความปลอดภัยของคำขอ API กราฟ"

เริ่มต้น

ก่อนที่คุณจะเริ่ม เราขอแนะนำให้คุณอ่านข้อกำหนดและข้อมูลเหล่านี้

สิทธิ์การอนุญาตแอพ

business_management
ads_management

ID

PARENT_BM_ID: ID ตัวจัดการธุรกิจของพาร์ทเนอร์ที่เป็นเจ้าของแอพ
CHILD_BM_ID: ID ตัวจัดการธุรกิจที่ BM หลักสร้างให้กับลูกค้า

โทเค็นการเข้าถึง

USER_Personal_Access_Token: โทเค็นการเข้าถึงของบุคคลที่ให้ข้อมูลประจำตัวเพื่อสร้าง BM รอง
- ซึ่งระบบจะสร้างโทเค็นนี้โดยใช้การเข้าสู่ระบบด้วย Facebook
- พาร์ทเนอร์ควรส่งคำขอขอบเขต business_management แบบทั่วระบบสำหรับธุรกิจและเพจของผู้ใช้ แทนที่จะเป็นขอบเขตแบบละเอียด
- บุคคลนี้ควรจะมีสิทธิ์ระดับผู้แลในเพจที่ถูกแชร์ไปยัง BM รอง
- ทั้งนี้ หากเพจเป็นของอีก BM หนึ่ง บุคคลนี้ก็ควรมีสิทธิ์ระดับผู้แลใน BM ที่เป็นเจ้าของเพจดังกล่าว
- โทเค็นนี้ใช้เพื่ออนุญาตให้มีการสร้าง BM รองและแชร์เพจไปยัง BM รองดังกล่าวเพื่อการลงโฆษณา
PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: โทเค็นการเข้าถึงของผู้ใช้ระบบที่เป็นผู้ดูแลในตัวจัดการธุรกิจหลัก
- โทเค็นนี้ใช้เพื่อสร้างและจัดการ BM รอง
CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: โทเค็นการเข้าถึงของผู้ใช้ระบบที่เป็นผู้ดูแลซึ่งสร้างขึ้นใน BM รอง
- โทเค็นนี้ใช้เพื่อสร้างและจัดการแคมเปญและกิจกรรมอื่นใน BM รอง

สร้างตัวจัดการธุรกิจรอง

สร้างตัวจัดการธุรกิจรองโดยใช้ USER_Personal_Access_Token

ตัวอย่าง — ส่งคืน ID ตัวจัดการธุรกิจรอง

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

การตอบกลับ:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

การสร้างตัวจัดการธุรกิจรองหลายตัวต่อผู้ใช้หนึ่งราย

หากผู้ใช้ต้องการสร้างตัวจัดการธุรกิจรองหลายตัวโดยใช้ข้อมูลประจำตัวผู้ใช้เดียวกัน จะต้องกำหนด primary_page ให้กับตัวจัดการธุรกิจรองที่มีอยู่แล้วซึ่งสร้างขึ้นมาสำหรับผู้ใช้รายนั้น ให้เรียกใช้คำสั่ง POST อีกครั้งเพื่อกำหนด primary_page ของตัวจัดการธุรกิจรองที่มีอยู่แล้ว

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

เมื่อสร้างตัวจัดการธุรกิจรองอีกตัวหนึ่ง

ตัวจัดการธุรกิจรองที่มีอยู่แล้วทั้งหมดต้องมี primary_page ที่ไม่ซ้ำกัน
คุณต้องตั้งค่า shared_page_id ในตัวจัดการธุรกิจรองตัวใหม่
หากมีการใช้ shared_page_id เพื่อสร้างตัวจัดการธุรกิจรองตัวใหม่ เพจดังกล่าวต้องไม่ใช่ primary_page บนตัวจัดการธุรกิจรองตัวใดก็ตามที่มีอยู่แล้ว

ตั้งค่าวิธีการชำระเงิน

หากต้องการชำระเงินสำหรับการลงโฆษณาของ BM รอง คุณจะต้องแชร์วงเงินเครดิตกับ BM รองแต่ละตัว

ขั้นตอนที่ 1 เปิดวงเงินเครดิต โดยติดต่อตัวแทน Facebook ของคุณ จากนั้นเปิด LOC ในตัวจัดการธุรกิจนั้นๆ หากยังไม่มี LOC ซึ่งวงเงินเครดิตนี้จะปรากฏเป็นวิธีการชำระเงินในตัวจัดการธุรกิจหลัก

ขั้นตอนที่ 2 ยอมรับข้อกำหนดทางกฎหมายสำหรับวงเงินเครดิต

เปิดตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ > วิธีการชำระเงิน
คลิก "การตั้งค่าเครดิต" แล้วคลิก "ข้อกำหนดทางกฎหมาย" จากนั้นยอมรับข้อกำหนดทางกฎหมาย

ขั้นตอนที่ 3 รับ ID วงเงินเครดิต จากนั้นแชร์กับตัวจัดการธุรกิจรอง

ไปที่ตัวจัดการธุรกิจหลักของคุณ จากนั้นไปที่การตั้งค่าธุรกิจ > วิธีการชำระเงิน จากนั้นคลิกที่ "วิธีการชำระเงิน" บันทึก PARENT_BM_Line_Of_Credit_ID ที่ได้จาก URL โดย URL จะมีลักษณะดังนี้
```
https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
```
ใช้ ID วงเงินเครดิตของตัวจัดการธุรกิจหลักนี้ในการเรียกใช้ API ด้านล่างเพื่อแชร์ ID วงเงินเครดิตจากตัวจัดการธุรกิจหลักไปยังตัวจัดการธุรกิจรอง โดยคุณจะระบุ amount หรือไม่ก็ได้
```
curl \
  -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
  -F 'amount=<OPTIONAL_PARAMETER>' \  
  -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs
```

หากคุณไม่ระบุจำนวนเงิน วงเงินเครดิตจะถูกแบ่งให้กับบรรดาตัวจัดการธุรกิจรองของคุณในจำนวนเท่าๆ กัน

หากคุณระบุเฉพาะจำนวนเงิน วงเงินเครดิตส่วนดังกล่าวจะถูกกำหนดให้กับตัวจัดการธุรกิจรอง

รับโทเค็นผู้ใช้ระบบรอง

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

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

รับ ID ของผู้ใช้ระบบ

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

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

รับ ID แหล่งเงินทุน (LOC)

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

curl -G \
  -d 'fields=id,max_balance' \
  -d 'access_token=<Child BM Admin System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits

การชำระเงิน

การชำระเงินด้วยวงเงินเครดิต

payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=

จัดเก็บ ID วิธีการชำระเงินนี้ไว้เพื่อใช้ในภายหลัง

สร้างบัญชีโฆษณาใหม่ที่มีแหล่งเงินทุนเริ่มต้น

ใช้ ID วิธีการชำระเงินจากตัวจัดการธุรกิจรองเป็นพารามิเตอร์ funding_id

ซึ่งคุณจะไม่สามารถอัพเดต funding_id ได้หลังจากที่สร้างบัญชีโฆษณาขึ้นมาแล้ว

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

เพิ่มผู้ใช้ระบบในบทบาทผู้ดูแลให้กับบัญชีโฆษณาใหม่

เพิ่มผู้ใช้ระบบในบทบาทผู้ดูแลให้กับบัญชีโฆษณาใหม่ภายใต้ตัวจัดการธุรกิจรอง

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

ยินดีด้วย! นี่คือขั้นตอนสุดท้ายในการตั้งค่าตัวจัดการธุรกิจรองเพื่อสร้างและจัดการแคมเปญของลูกค้า

ค้นหาตัวจัดการธุรกิจรอง

หากต้องการค้นหา ID ตัวจัดการธุรกิจรองทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้เพื่อกรองตาม ID ผู้ใช้ในแอพของลูกค้า

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

ค้นหา ID ผู้ใช้ในแอพด้วย /me?fields=ids_for_apps (โทเค็นการเข้าถึงผู้ใช้ของลูกค้า)

ขั้นตอนถัดไป

หัวข้อถัดไปจะกล่าวถึงฟีเจอร์/การดำเนินการเพิ่มเติมที่คุณสามารถใช้เพื่อยกระดับประสบการณ์ในการใช้ตัวจัดการธุรกิจของคุณ

นอกจากนี้ โปรดดูคำแนะนำในการแชร์องค์ประกอบสำหรับการเข้าถึงองค์ประกอบของลูกค้าในตัวจัดการธุรกิจรองดังต่อไปนี้