บัญชีโฆษณา

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

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

อ้างสิทธิ์บัญชี

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

แต่ไม่สามารถอ้างสิทธิ์บัญชีชิ้นงานโฆษณาได้

หากต้องการอ้างสิทธิ์บัญชีโฆษณาให้กับธุรกิจของคุณ ให้ระบุ 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 บัญชี คุณต้องดำเนินการด้วยตนเอง

ช่องที่ใช้ได้มีดังต่อไปนี้

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

name

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

ชื่อบัญชีโฆษณา

timezone_id

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

ID ของโซนเวลา

currency

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

ตัวย่อสกุลเงินที่ใช้สำหรับบัญชีโฆษณานี้

partner

ประเภท: แบบยาวหรือสตริง

Facebook Business Partner (FBP) โดยต้องเป็นนามแฝงของเพจ Facebook, ID เพจ Facebook หรือ ID แอพ Facebook แต่หากไม่มี ให้ใช้ NONE หรือ UNFOUND

end_advertiser

ประเภท: แบบยาวหรือสตริง

นิติบุคคลที่โฆษณาจะกำหนดเป้าหมาย โดยต้องเป็น ID ธุรกิจ แต่หากไม่มี ให้ใช้ NONE หรือ UNFOUND

media_agency

ประเภท: แบบยาวหรือสตริง

เอเจนซี่ ซึ่งอาจเป็นธุรกิจของคุณเองก็ได้ โดยต้องเป็นนามแฝงของเพจ Facebook, ID เพจ Facebook หรือ ID แอพ Facebook แต่หากไม่มี ให้ใช้ NONE หรือ UNFOUND

invoice

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

หากธุรกิจมีวงเงินเครดิตปกติที่ตัวจัดการธุรกิจเป็นเจ้าของกับ 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 คำอธิบาย

การรายงานเท่านั้น

['ANALYZE']

สามารถดูข้อมูลเกี่ยวกับประสิทธิภาพของโฆษณาได้

ผู้ใช้ทั่วไป

['ADVERTISE', 'ANALYZE']

สามารถดู แก้ไข และสร้างโฆษณาโดยใช้แหล่งเงินทุนที่เชื่อมโยงกับบัญชีโฆษณา แต่ไม่สามารถตั้งค่าในระดับบัญชีโฆษณาได้ เช่น แหล่งเงินทุน

ผู้ดูแล

['MANAGE', 'ADVERTISE', 'ANALYZE']

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

คุณจำเป็นต้องมีสิ่งต่อไปนี้

  • 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"