ในฐานะผู้ดูแลธุรกิจ คุณสามารถอ้างสิทธิ์บัญชีโฆษณาที่เป็นของธุรกิจได้ ซึ่งจะทำให้คุณสามารถกำหนดผู้ใช้ที่ควรมีสิทธิ์เข้าถึงบัญชีโฆษณาดังกล่าวได้อย่างง่ายดาย อีกทั้งคุณยังสามารถกำหนดแหล่งเงินทุนที่ใช้ร่วมกันให้กับบัญชีโฆษณาของคุณได้อีกด้วย
ธุรกิจจะไม่สามารถอ้างสิทธิ์กลุ่มบัญชีโฆษณา ส่วนผู้ใช้ที่มีสิทธิ์เข้าถึงกลุ่มบัญชีโฆษณานั้นๆ จะยังคงสามารถเข้าถึงได้หลังจากเพิ่มผู้ใช้เหล่านั้นลงในตัวจัดการธุรกิจแล้ว
หากคุณจัดการบัญชีโฆษณานอกตัวจัดการธุรกิจด้วยบทบาทผู้ดูแล คุณสามารถอ้างสิทธิ์บัญชีเหล่านั้นให้กับธุรกิจของคุณได้ ซึ่งขั้นตอนนี้เป็นขั้นตอนที่ดำเนินการเพียงครั้งเดียว เมื่ออ้างสิทธิ์แล้ว คุณจะจัดการได้เฉพาะบัญชีโฆษณาในตัวจัดการธุรกิจนั้นเท่านั้น
แต่ไม่สามารถอ้างสิทธิ์บัญชีชิ้นงานโฆษณาได้
หากต้องการอ้างสิทธิ์บัญชีโฆษณาให้กับธุรกิจของคุณ ให้ระบุ ID บัญชีโฆษณาในรูปแบบ act_###
ส่ง POST
: \ผู้ขอต้องเป็นผู้ดูแลของธุรกิจที่อ้างสิทธิ์บัญชีโฆษณา
curl \ -F "adaccount_id=act_<AD_ACCOUNT_ID>" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"
หากคุณเป็นผู้ดูแลบัญชีโฆษณา เราจะอนุมัติคำขออ้างสิทธิ์นี้ทันที โดย Facebook จะส่งคืน access_status
ที่ตั้งค่าเป็น CONFIRMED
หากคุณเป็นผู้ใช้ที่ไม่มีสิทธิ์การอนุญาตที่จำเป็นสำหรับบัญชีโฆษณา เราจะส่งคำขอเป็นเจ้าของไปยังผู้ดูแลของบัญชีโฆษณา เมื่อเราส่งคำขอแล้ว การตอบกลับจะมี access_status
ที่ตั้งค่าเป็น PENDING
ในการยอมรับคำขอเป็นเจ้าของ คุณจะต้องเป็นผู้ดูแลบัญชีโฆษณา และคุณควรเข้าสู่ระบบและยอมรับคำขอดังกล่าวในตัวจัดการโฆษณา
บริษัทการตลาดส่วนใหญ่ไม่จำเป็นต้องอ้างสิทธิ์บัญชีโฆษณาจากลูกค้าของตน โปรดดูฟังก์ชั่นระหว่างธุรกิจกับธุรกิจเพื่อขอสิทธิ์การเข้าถึงองค์ประกอบที่ตัวจัดการธุรกิจอื่นๆ เป็นเจ้าของ
คุณต้องเป็นผู้ดูแลของธุรกิจจึงจะสามารถสร้างบัญชีโฆษณาใหม่ได้ และคุณไม่สามารถใช้การเข้าสู่ระบบสำหรับผู้ดูแลธุรกิจที่ใช้ร่วมกันเพื่อสร้างบัญชีโฆษณาใหม่หรือดำเนินการอื่นๆ ได้
หากต้องการใช้ API นี้ คุณต้องมีธุรกิจและการตั้งค่าเพจที่ถูกต้อง หากคุณมีบัญชีโฆษณาที่ไม่สมบูรณ์หรือเพจที่เลิกเผยแพร่โดย Facebook คุณจะไม่สามารถสร้างบัญชีโฆษณาใหม่ได้
เราจำกัดให้สร้างบัญชีโฆษณาโดยใช้ API ได้เพียง 5 บัญชีโฆษณาเท่านั้น หากต้องการสร้างบัญชีโฆษณามากกว่า 5 บัญชี คุณต้องดำเนินการด้วยตนเอง
ช่องที่ใช้ได้มีดังต่อไปนี้
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | ชื่อบัญชีโฆษณา |
ประเภท: จำนวนเต็ม | ID ของโซนเวลา |
ประเภท: สตริง | ตัวย่อสกุลเงินที่ใช้สำหรับบัญชีโฆษณานี้ |
ประเภท: แบบยาวหรือสตริง | Facebook Business Partner (FBP) โดยต้องเป็นนามแฝงของเพจ Facebook, ID เพจ Facebook หรือ ID แอพ Facebook แต่หากไม่มี ให้ใช้ |
ประเภท: แบบยาวหรือสตริง | นิติบุคคลที่โฆษณาจะกำหนดเป้าหมาย โดยต้องเป็น ID ธุรกิจ แต่หากไม่มี ให้ใช้ |
ประเภท: แบบยาวหรือสตริง | เอเจนซี่ ซึ่งอาจเป็นธุรกิจของคุณเองก็ได้ โดยต้องเป็นนามแฝงของเพจ Facebook, ID เพจ Facebook หรือ ID แอพ Facebook แต่หากไม่มี ให้ใช้ |
ประเภท: บูลีน | หากธุรกิจมีวงเงินเครดิตปกติที่ตัวจัดการธุรกิจเป็นเจ้าของกับ Facebook เราจะเชื่อมโยงบัญชีโฆษณาเข้ากับวงเงินเครดิตนั้น |
หากต้องการสร้างบัญชีโฆษณาใหม่ให้กับธุรกิจ ให้ระบุ name
, currency
, timezone_id
, end_advertiser
, media_agency
และ partner
โปรดดูเงื่อนไขต่อไปนี้
media_agency
และ partner
ต้องเป็นนามแฝงของเพจ Facebook, ID เพจ Facebook หรือ ID แอพ Facebook end_advertiser
ต้องเป็น ID ธุรกิจหากบัญชีโฆษณาของคุณไม่มีผู้ลงโฆษณา มีเดียเอเจนซี่ หรือพาร์ทเนอร์ ให้ระบุ NONE
หากบัญชีโฆษณาของคุณมีผู้ลงโฆษณา มีเดียเอเจนซี่ หรือพาร์ทเนอร์ แต่ไม่ได้อยู่บน Facebook ในรูปแบบเพจหรือแอพ ให้ระบุ UNFOUND
วิธีสร้างบัญชีโฆษณามีดังนี้
curl \ -F "name=MyAdAccount" \ -F "currency=USD" \ -F "timezone_id=1" \ -F "end_advertiser=<END_ADVERTISER_ID>" \ -F "media_agency=<MEDIA_AGENCY_ID>" \ -F "partner=NONE" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"
หากคุณมีวงเงินเครดิตกับ Facebook อยู่แล้ว คุณสามารถตั้งค่า invoice
เป็น true
ได้ จากนั้นเราจะเชื่อมโยงบัญชีโฆษณาใหม่ของคุณกับวงเงินเครดิตแบบขยาย
การตอบกลับจะมีลักษณะดังนี้
{ "id": "act_<ADACCOUNT_ID>", "account_id": "<ADACCOUNT_ID>", "business_id": "<BUSINESS_ID>", "end_advertiser_id": "<END_ADVERTISER_ID>", "media_agency_id": "<MEDIA_AGENCY_ID>", "partner_id": "NONE" }
ดูบัญชีโฆษณาทั้งหมดที่ธุรกิจของคุณสามารถเข้าถึงได้โดยเรียกใช้คำสั่ง GET
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"
การดำเนินการนี้จะส่งคืนบัญชีโฆษณาทั้งหมดที่ธุรกิจเป็นเจ้าของ โดยจะมีบางช่องที่ระบุความสัมพันธ์ระหว่างธุรกิจและบัญชีโฆษณาโดยเฉพาะ
permitted_tasks
คืออาร์เรย์ของงานที่คุณสามารถกำหนดให้กับบัญชีโฆษณานั้นๆ ได้access_type
จะระบุว่าธุรกิจของคุณทำหน้าที่เป็น OWNER
หรือ AGENCY
ของบัญชีโฆษณาหากต้องการดูบัญชีโฆษณาที่ยังคงรออนุมัติสิทธิ์การเข้าถึง ให้เรียกใช้คำสั่ง GET
นี้
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"
คุณไม่สามารถลบบัญชีโฆษณาออกจากธุรกิจของคุณได้หากคุณเป็น OWNER
และบัญชีมีสถานะ CONFIRMED
หากคุณมีคำขอรับสิทธิ์การเข้าถึงที่มีสถานะ PENDING
หรือมีสิทธิ์การเข้าถึง AGENCY
สำหรับบัญชีโฆษณา คุณสามารถเรียกใช้คำสั่ง DELETE
นี้ได้
curl \ -X DELETE \ -F "adaccount_id=act_<AD_ACCOUNT_ID>" \ -F "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"
ดูบัญชีโฆษณาที่ผู้ใช้มีสิทธิ์เข้าใช้งานโดยเรียกใช้คำสั่ง GET
นี้
curl -G \ -d "access_token=ACCESS_TOKEN" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"
หากต้องการดูสิทธิ์การอนุญาตที่ผู้ใช้มีสำหรับใช้งานบัญชีโฆษณา ให้เรียกใช้คำสั่ง GET
นี้
curl -G \ -d "access_token=ACCESS_TOKEN" \ "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"
หลังจากที่ตัวจัดการธุรกิจของคุณเชื่อมโยงกับบัญชีโฆษณาแล้ว คุณสามารถมอบหมายงานให้กับผู้ใช้ธุรกิจรายอื่นๆ ได้ โดยงานที่สามารถมอบหมายได้มีดังต่อไปนี้
ชื่อ | ค่าคงที่ของ API | คำอธิบาย |
---|---|---|
การรายงานเท่านั้น |
| สามารถดูข้อมูลเกี่ยวกับประสิทธิภาพของโฆษณาได้ |
ผู้ใช้ทั่วไป |
| สามารถดู แก้ไข และสร้างโฆษณาโดยใช้แหล่งเงินทุนที่เชื่อมโยงกับบัญชีโฆษณา แต่ไม่สามารถตั้งค่าในระดับบัญชีโฆษณาได้ เช่น แหล่งเงินทุน |
ผู้ดูแล |
| สามารถจัดการทุกด้านของแคมเปญ การรายงาน การเรียกเก็บเงิน และสิทธิ์การอนุญาตของบัญชีโฆษณาได้ |
คุณจำเป็นต้องมีสิ่งต่อไปนี้
adaccount_id
— ID บัญชีโฆษณาในรูปแบบ act_123
user_id
— ID ผู้ใช้ที่จะเพิ่มหากต้องการเพิ่มผู้ใช้ใหม่พร้อมด้วยงาน ['MANAGE', 'ADVERTISE', 'ANALYZE']
ให้เรียกใช้คำสั่ง POST
นี้
curl \ -F "user=BUSINESS_SCOPED_USER_ID" \ -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \ -F "access_token=ACCESS_TOKEN" \ "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"
เรียกใช้คำสั่ง POST
เดียวกันกับที่คุณเรียกใช้เมื่อเพิ่มผู้ใช้ใหม่เพื่อเปลี่ยนงานของผู้ใช้ที่มีอยู่
curl \ -F "user=BUSINESS_SCOPED_USER_ID" \ -F "tasks=['ANALYZE']" \ -F "access_token=ACCESS_TOKEN" \ "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"
หากต้องการลบผู้ใช้ออกจากบัญชี คุณจำเป็นต้องมีสิ่งต่อไปนี้
adaccount_id
— ID บัญชีโฆษณาในรูปแบบ act_123
user_id
— ID ผู้ใช้ที่จะลบการเรียกใช้คำสั่ง DELETE
มีลักษณะดังนี้
curl \ -X DELETE \ -F "user=<BUSINESS_SCOPED_USER_ID>" \ -F "access_token=ACCESS_TOKEN" \ "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"