ในฐานะผู้ดูแลธุรกิจ คุณสามารถอ้างสิทธิ์บัญชีโฆษณาที่เป็นของธุรกิจได้ ซึ่งจะทำให้คุณสามารถกำหนดผู้ใช้ที่ควรมีสิทธิ์เข้าถึงบัญชีโฆษณาดังกล่าวได้อย่างง่ายดาย อีกทั้งคุณยังสามารถกำหนดแหล่งเงินทุนที่ใช้ร่วมกันให้กับบัญชีโฆษณาของคุณได้อีกด้วย
ธุรกิจจะไม่สามารถอ้างสิทธิ์กลุ่มบัญชีโฆษณา ส่วนผู้ใช้ที่มีสิทธิ์เข้าถึงกลุ่มบัญชีโฆษณานั้นๆ จะยังคงสามารถเข้าถึงได้หลังจากเพิ่มผู้ใช้เหล่านั้นลงในตัวจัดการธุรกิจแล้ว
หากคุณจัดการบัญชีโฆษณานอกตัวจัดการธุรกิจด้วยบทบาทผู้ดูแล คุณสามารถอ้างสิทธิ์บัญชีเหล่านั้นให้กับธุรกิจของคุณได้ ซึ่งขั้นตอนนี้เป็นขั้นตอนที่ดำเนินการเพียงครั้งเดียว เมื่ออ้างสิทธิ์แล้ว คุณจะจัดการได้เฉพาะบัญชีโฆษณาในตัวจัดการธุรกิจนั้นเท่านั้น
แต่ไม่สามารถอ้างสิทธิ์บัญชีชิ้นงานโฆษณาได้
หากต้องการอ้างสิทธิ์บัญชีโฆษณาให้กับธุรกิจของคุณ ให้ระบุ 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_123user_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_123user_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"