Business Management APIs

เริ่มต้นใช้งาน

เรียนรู้วิธีนำการจัดการองค์ประกอบชิ้นงานโฆษณาไปใช้งาน

การจัดการองค์ประกอบชิ้นงานโฆษณาพร้อมให้ใช้งานเฉพาะกับพาร์ทเนอร์บางรายเท่านั้น โปรดติดต่อพาร์ทเนอร์ Meta ของคุณเพื่อสอบถามข้อมูลเพิ่มเติม

ข้อกำหนด

หากต้องการใช้ API นี้ คุณต้องมีสิ่งต่อไปนี้

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

เมื่อเข้าสู่ระบบแอพของคุณ คุณจะต้องขอสิทธิ์การอนุญาตต่อไปนี้จากผู้ใช้

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

ข้อจำกัด

  • ผู้ใช้แอพ (ผู้ลงโฆษณา) ต้องเป็นผู้ดูแลธุรกิจของ ID ตัวจัดการธุรกิจ

ขั้นตอนที่ 1: สร้างโฟลเดอร์ชิ้นงานโฆษณาธุรกิจ

สร้างโฟลเดอร์ชิ้นงานโฆษณาธุรกิจในนามธุรกิจของผู้ลงโฆษณาโดยการส่งคำขอ POST ไปยังตำแหน่งข้อมูล {business-id}/creative_folders ซึ่งในกรณีนี้ {business-id} คือ ID ธุรกิจของผู้ลงโฆษณา

ต้องใช้สิทธิ์การอนุญาต business_creative_management เพื่อดำเนินการนี้

ตัวอย่างคำขอ

curl -X POST \
  -F 'name={folder-name}' \
  -F 'access_token={access-token}' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

ตัวอย่างการตอบกลับ

{ “id”: “{business-creative-folder-id}” }

นอกจากนี้ คุณยังสามารถสร้างโฟลเดอร์ย่อย

ขั้นตอนที่ 2: เพิ่มชิ้นงานโฆษณาไปยังโฟลเดอร์

เพิ่มองค์ประกอบชิ้นงานโฆษณาที่มีอยู่ไปยังโฟลเดอร์โดยการส่งคำขอ POST ถึง {business-id}/images หรือ {business-id}/videos คุณต้องใช้สิทธิ์การอนุญาต business_management เพื่อดำเนินการนี้

เพิ่มรูปภาพ

ตัวอย่าง — วิธีเพิ่มรูปภาพ

curl -X POST \
  -F 'bytes={image-content-in-bytes-format}' \
  -F 'name={image-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph.facebook.com/{version}/{business-id}/images

การตอบกลับ

{
  "images":{
    "{image-name}":{
      "id":"{business-image-id}",
      "hash":"{hash}",
      "url":"{image-url}"
    }
  }
}

อัพโหลดวิดีโอ

อัพโหลดวิดีโอโดยใช้คำขอเดียวหากวิดีโอมีขนาดไม่กี่เมกะไบต์ หรืออัพโหลดเป็นกลุ่ม เรียกใช้ API ของคุณเพื่ออัพโหลดวิดีโอที่ graph-video.facebook.com แทน graph.facebook.com

ตัวอย่าง — ส่ง POST ไปยัง {business-id}/video และใส่ชื่อวิดีโอของคุณ แหล่งที่มา และ ID โฟลเดอร์ชิ้นงานโฆษณาธุรกิจ

curl -X POST \
  -F 'name={video-name}' \
  -F 'source='@{video-path}'' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph-video.facebook.com/{version}/{business-id}/videos

การตอบกลับ

{ 
    "success": true, 
    "business_video_id": "{business-video-id}" 
}

อัพโหลดวิดีโอแบบเป็นกลุ่ม

สำหรับวิดีโอขนาดใหญ่ ให้ส่งคำขอ start หนึ่งคำขอ คำขอ transfer หนึ่งหรือหลายคำขอ และคำขอ finish หนึ่งคำขอ

หากต้องการส่งคำขอ start และสร้างเซสชั่นการอัพโหลดวิดีโอ ให้ส่งคำขอ POST ไปยัง /{business-id}/videos ตั้งค่าช่อง upload_phase เป็น start และระบุ file_size โดยมีหน่วยเป็นไบต์

curl -X POST \
  -F 'title={video-name}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'access_token={access-token}' \
  -F 'upload_phase=start' \
  -F 'file_size={video_file_size_in_bytes}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

ตัวอย่างการตอบกลับ

{
  "upload_session_id": "{session-id}",
  "business_video_id": "{business-video-id}",
  "video_id": "{video-id}",
  "start_offset": "0",
  "end_offset": "52428800"
}

ในการอัพโหลด [0, 52428800] จากวิดีโอของคุณ ให้แบ่งไฟล์ออกเป็นกลุ่มๆ ตามออฟเซ็ตเริ่มต้นและออฟเซ็ตสิ้นสุด จากนั้นให้ส่งกลุ่มวิดีโอเหล่านั้นพร้อมกับคำขอ transfer เราจะส่งออฟเซ็ตใหม่ให้คุณสำหรับแต่ละกลุ่ม ให้ใช้ออฟเซ็ตใหม่เหล่านี้เพื่ออัพโหลดแต่ละกลุ่ม

ตัวอย่าง: ส่งกลุ่มแรกของคุณ

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'upload_session_id={session-id}' \
  -F 'start_offset=0' \
  -F 'video_file_chunk=@{binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

เมื่อสำเร็จ เราจะตอบกลับด้วยออฟเซ็ตสำหรับกลุ่มต่อไปของคุณ

{
 "start_offset": "52428800",    //Start byte position of the next file chunk.
 "end_offset": "104857601"      //End byte position of the next file chunk.
}

ตัดและอัพโหลดกลุ่มที่ 2 ด้วยช่วง [52428800, 104857601] จากไฟล์ของคุณแล้วส่ง

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'start_offset=52428801' \
  -F 'upload_session_id={your-upload-sesson-id}' \
  -F 'video_file_chunk={binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

ส่งกลุ่มเพิ่มเติมทั้งหมดจนกว่า start_offset จะเท่ากับ end_offset

{
  "start_offset": "152043520",
  "end_offset": "152043520"
}

การตอบกลับนี้หมายความว่าคุณได้อัพโหลดทั้งไฟล์แล้ว ตอนนี้คุณต้องโพสต์วิดีโอนี้และปิดเซสชั่นการอัพโหลด

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=finish' \
  -F 'upload_session_id={session-id}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

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

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

ชิ้นงานโฆษณาที่อัพโหลดทั้งหมดจะปรากฏในตัวจัดการโฆษณา > UI การเลือกสื่อ คุณสามารถใช้ชิ้นงานโฆษณาในการสร้างโฆษณาและการแก้ไขโฆษณาได้ นอกจากนี้ โฟลเดอร์และองค์ประกอบชิ้นงานโฆษณายังพร้อมให้ใช้งานได้ในเครื่องมือคลังสื่อของตัวจัดการธุรกิจในตัวจัดการธุรกิจ > คลังสื่อ

ขั้นตอนที่ 3: ระบุ URL ของ Deep Link ที่ไปยังองค์ประกอบ และสร้างโฆษณาหรือโพสต์

หากต้องการรับ URL ของ Deep Link สำหรับองค์ประกอบใดองค์ประกอบหนึ่ง ให้สืบค้นช่อง media_library_url ขององค์ประกอบรูปภาพหรือวิดีโอที่อัพโหลด

curl -X GET \  
  -F 'access_token={partner-access-token}' \
https://graph.facebook.com/v<API_VERSION>/<asset_id>?fields=media_library_url

หากต้องการใช้ Deep Link ของคุณเพื่อสร้างโฆษณาหรือโพสต์บนเพจ ให้แนบ &action=CREATE_AD หรือ &action=CREATE_POST ต่อท้ายลิงก์

https://business.facebook.com/asset_library/business_creatives/?object_id=<OBJECT_ID>&action=CREATE_AD