API กราฟ

เวอร์ชั่น 2.9

API กราฟ | API การตลาด

รายการบันทึกการเปลี่ยนแปลงแบ่งออกเป็นหมวดหมู่ในลักษณะต่อไปนี้:

  • คุณสมบัติใหม่ — ผลิตภัณฑ์หรือบริการใหม่ๆ ซึ่งรวมถึงโหนด จุดเชื่อมโยง และช่องใหม่
  • การเปลี่ยนแปลง — การเปลี่ยนแปลงต่อผลิตภัณฑ์หรือบริการที่มีอยู่แล้ว (ไม่รวมรายการที่เลิกใช้แล้ว)
  • รายการที่เลิกใช้แล้ว — สินค้าหรือบริการที่มีอยู่ซึ่งกำลังถูกนำออกไป
  • การเปลี่ยนแปลงที่สำคัญใน 90 วัน — การเปลี่ยนแปลงและรายการที่เลิกใช้แล้วที่จะมีผลบังคับใช้ 90 วัน หลังวันที่ปล่อยเวอร์ชั่นออกไป

คุณสมบัติใหม่การเปลี่ยนแปลง และรายการที่เลิกใช้แล้วจะส่งผลต่อเวอร์ชั่นนี้เท่านั้น การเปลี่ยนแปลงที่สำคัญใน 90 วัน จะส่งผลต่อทุกเวอร์ชั่น

การเปลี่ยนแปลงที่สำคัญจะไม่รวมอยู่ในที่นี้ เนื่องจากไม่ขึ้นอยู่กับการออกเวอร์ชั่นใดโดยเฉพาะ

API กราฟ

เผยแพร่เมื่อวันที่ 18 เมษายน 2017 | ใช้งานได้จนถึงวันที่ 18 กรกฎาคม 2019

ฟีเจอร์ใหม่

ทั่วไป

  • รูปแบบอ่านหลังจากเขียน - ขณะนี้ คำขอ POST ของ API กราฟรองรับการส่งคืนค่าที่ระบุของอ็อบเจ็กต์ในระหว่างคำขอเดียวกันกับการเขียนแล้วเพื่อประหยัดเวลาการส่งไปกลับของไคลเอ็นต์ หากมีการระบุพารามิเตอร์ fields (คำอธิบายรูปแบบคำสั่ง) คำขอจะทำการเขียนก่อน จากนั้นจึงจะอ่านอ็อบเจ็กต์ที่สร้างหรืออัพเดต แล้วเลือกช่องโดยใช้พารามิเตอร์ fields เป็นการตอบกลับ ขณะนี้มีการเปิดใช้งานรูปแบบอ่านหลังจากเขียนสำหรับ API กราฟในทุกเวอร์ชั่นแล้ว เรียนรู้เพิ่มเติมที่หน้าเอกสาร

  • ช่อง short_names ใหม่ในอ็อบเจ็กต์ผู้ใช้ - เพิ่มช่องต่อไปนี้ไปยังตำแหน่งข้อมูล user

    • short_name - first_name ถือว่าการเรียกบุคคลหนึ่งด้วยชื่อจริงเป็นวิธีที่ใช้ได้ในวงกว้าง อย่างไรก็ตาม ในหลายๆ วัฒนธรรม (โดยเฉพาะจีน ญี่ปุ่น เกาหลี ไทย อินเดีย และที่อื่นๆ) การเรียกชื่อบุคคลด้วยชื่อจริงนั้นไม่เหมาะสม เมธอด short_name ใหม่เข้าใจกฎเฉพาะของวัฒนธรรมดังกล่าวในการเรียกบุคคลด้วยชื่อย่อ ดังนั้น ผู้ชมในสหรัฐอเมริกาจะยังคงเห็นเพื่อนในจีน ญี่ปุ่น เกาหลี และอินเดียได้รับการกล่าวถึงด้วยชื่อจริงอยู่ แต่เพื่อนในเอเชียตะวันออกและเอเชียใต้จะเห็นชื่อเพื่อนแบบเต็ม

เพจ

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

  • โพสต์บนเพจรองรับการเพิ่มเพจเพื่อโพสต์ข้ามวิดีโอ - อนุมัติและยอมรับคำขอเกี่ยวกับความสัมพันธ์ในลักษณะการโพสต์ข้ามจากอีกเพจหนึ่งโดย POST /{page_id}/crossposting_pages

  • ID ของ Webhooks จัดลำดับเป็นสตริง - แปลง ID ตัวเลขเป็นสตริงในการอัพเดต Webhooks นี้

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

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

กราฟสถานที่

  • สถานที่ปัจจุบัน - มีการเพิ่มช่องต่อไปนี้ไว้

    • GET /current_place/results - ช่วยระบุสถานที่ปัจจุบันของผู้ใช้โดยการใช้สัญญาณบอกตำแหน่ง ซึ่งต้องมีสิทธิ์การอนุญาตของผู้ใช้
    • POST /current_place/feedback - ช่วยให้คุณสามารถแสดงความเห็นว่าผู้ใช้อยู่ที่นั่นจริงหรือไม่ โปรดดูข้อมูลเพิ่มเติมที่กราฟสถานที่

  • GET /search?type=place - มีการเพิ่มพารามิเตอร์ต่อไปนี้ไว้

    • categories - ค้นหาตามหมวดหมู่
    • matched_categories - ระบุหมวดหมู่ที่มีตำแหน่งผลลัพธ์ตรงกัน ซึ่งต้องนำไปใช้กับ categories

API วิดีโอ

  • เวลาที่ใช้ไปกับเกณฑ์ชี้วัดของวิดีโอสำหรับเพจ - มีการเพิ่มเกณฑ์ชี้วัดต่อไปนี้ไว้ โปรดดูข้อมูลเพิ่มเติมที่เกณฑ์ชี้วัดเชิงลึก /{object-id}/insights/{metric}

    • page_video_view_time - เวลาที่ใช้ไปกับวิดีโอบนเพจ
    • post_video_view_time_by_country_id - เวลาที่ใช้ไปกับวิดีโอบนเพจตามแต่ละประเทศ

Webhooks

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

  • เอกสารประกอบ - ขณะนี้ Webhooks มีเอกสารอ้างอิงสำหรับหัวข้อและช่องต่างๆ ให้คุณสามารถติดตามได้แล้ว โดยเอกสารฉบับนี้อยู่ในเว็บไซต์ผู้พัฒนา Facebook ในส่วนข้อมูลอ้างอิงเกี่ยวกับ Webhooks ใน API กราฟ

  • เครื่องมือผู้ส่งตัวอย่าง - เครื่องมือใหม่นี้ช่วยให้ผู้พัฒนาสามารถทดสอบโครงสร้างการอัพเดต Webhooks ได้ง่ายขึ้นก่อนที่จะติดตามหัวข้อ แต่ก่อน ผู้พัฒนาต้องติดตามช่อง แล้วพยายามทริกเกอร์การอัพเดตโดยทำการเปลี่ยนแปลงผ่าน Facebook ตัวอย่างเช่น แอพอาจต้องทราบเวลาที่ผู้ใช้ (ผู้ใช้ที่ติดตั้งแอพและได้รับสิทธิ์การอนุญาตที่จำเป็น) เปลี่ยนรูปโปรไฟล์ของตน แอพจะติดตามช่องรูปโปรไฟล์ในเฟรมเวิร์ก Webhooks อย่างไรก็ตาม เพื่อทดสอบวิธีการทำงาน คุณต้องเปลี่ยนรูปโปรไฟล์ของผู้ใช้บางรายที่ติดตั้งแอพเพื่อดูโครงสร้างของการอัพเดตที่เราส่ง เครื่องมือผู้ส่งตัวอย่างช่วยให้แอพสามารถทดสอบโครงสร้างการอัพเดตได้โดยไม่ต้องทำการเปลี่ยนแปลงใดๆ ที่ไม่จำเป็น คุณสามารถค้นหาเครื่องมือผู้ส่งตัวอย่างได้ในส่วน Webhooks ของแดชบอร์ดของแอพ

  • การกำหนดเวอร์ชั่น - เวอร์ชั่น Webhooks ในขณะนี้จะเหมือนกับ API กราฟ การติดตาม Webhooks ที่มีอยู่จะทำงานบนแอพในเวอร์ชั่นเก่าที่สุดที่รองรับ ก่อนหน้านี้ การติดตาม Webhooks ไม่รองรับการกำหนดเวอร์ชั่น การเปลี่ยนแปลงเดียวที่ทำได้คือการเปลี่ยนแปลงแบบที่ส่งผลต่อการทำงาน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับเวอร์ชั่น Webhooks ที่การกำหนดเวอร์ชั่น

การเปลี่ยนแปลง

ทั่วไป

  • API แบตช์จะส่งคืนข้อผิดพลาดแทนการตอบกลับที่เป็นค่าว่างสำหรับรายการคำขอที่ล้มเหลวใน API แบตช์ โปรดดูข้อมูลเพิ่มเติมที่ API กราฟ, การส่งคำขอหลายรายการ

  • GET /{url}/share - ตำแหน่งข้อมูล share ถูกลบออกและแทนที่ด้วยรายการต่อไปนี้

    • ช่อง engagement พร้อมช่องย่อย ดังนี้
      • comment_count
      • comment_plugin_count
      • reaction_count
      • share_count

เพจ

  • /{page-id}/feed - โพสต์ย้อนหลังจะรวมอยู่ในคำขอ {page_id}/feed หาก backdated_time ของโพสต์อยู่ภายในช่วงเวลา since และ until โดย created_time คือเวลาการสร้างจริง (โปรดดูการเปลี่ยนแปลงต่อโพสต์ด้านล่าง)

  • page-restaurant-services - ขณะนี้ ทุกช่องจะส่งคืน false หรือ true แทน 0 หรือ 1

  • overall_star_rating - หากมีคะแนน 0 หรือจำนวนการให้คะแนนน้อย ช่อง overall_star_rating จะไม่ถูกส่งคืน
  • GET /{post-id} - เพิ่มช่องต่อไปนี้ไปยังตำแหน่งข้อมูลนี้
    • promotable_id - ก่อนหน้านี้ บางโพสต์จะไม่สามารถนำมาโปรโมทได้ แต่จะโปรโมทได้เพียงเนื้อหาในโพสต์เท่านั้น ในกรณีดังกล่าว ช่อง id จะส่งคืน ID ของเนื้อหาแทน ID สำหรับโพสต์ ขณะนี้ โพสต์จะส่งคืน ID ของตนเองเสมอในช่อง id และช่องใหม่ promotable_id ซึ่งจะเพิ่มไปยังตำแหน่งข้อมูล GET {post-id} ที่จะใช้เมื่อโปรโมทโพสต์

โพสต์

  • การโพสต์ย้อนหลังจะไม่มีการอัพเดตค่า created_time ของโพสต์อีกต่อไป ซึ่งจะสร้างต้นฉบับซ้ำแทน แต่จะตั้ง created_time และ backdated_time เป็นค่าใหม่ โพสต์ต้นฉบับจะเก็บค่า created_time เดิมไว้และรับ backdated_time และค่าใหม่ ท้ายที่สุด GET {post-id}/feed จะไม่ส่งคืนโพสต์ต้นฉบับอีกต่อไป แต่จะส่งคืนรายการที่สร้างซ้ำขึ้นใหม่แทน

API วิดีโอ

  • เปิดเผย URL ของแดชพรีวิวสำหรับวิดีโอถ่ายทอดสดแทน URL ของ RTMP

  • GET /{page_id}/crosspost_pending_approval_pages - แสดงรายการเพจทั้งหมดที่เพจของคุณได้ส่งคำขอโพสต์ข้ามไปถึง แต่ยังไม่ได้ยอมรับ

  • GET /{page_id}/crosspost_whitelisted_pages - แสดงรายการเพจทั้งหมดที่คุณได้ให้สิทธิ์การอนุญาตการโพสต์ข้าม

  • POST /{video_id}/allow_crossposting_for_pages = [{"page_id": {page_id}, "allow": {true/false}] - ให้สิทธิ์หรือไม่ให้สิทธิ์การอนุญาตสำหรับบางเพจในรายการที่อนุญาตให้โพสต์ข้ามเพื่อโพสต์ข้ามแต่ละวิดีโอ

  • POST /{page_id}/crossposting_pages=[{"page_id": {page_id}, "allow": false, "action": "EXPIRE_ALL_CROSSPOSTS_ON_SHARED_ASSETS"}] - ลบเพจออกจากรายการที่อนุญาตให้โพสต์ข้ามของคุณและกำหนดวันหมดอายุเนื้อหาที่โพสต์ข้ามทั้งหมดก่อนหน้านี้

  • POST /{page_id}/crossposting_pages=[{"page_id": {page_id}, "allow": false, "action": "NO_ACTION"}] - ลบเพจออกจากรายการที่อนุญาตให้โพสต์ข้ามโดยไม่กระทบต่อเนื้อหาที่โพสต์ข้ามก่อนหน้านี้

Webhooks

  • GET /{app-id}/subscriptions - ตอนนี้ตำแหน่งข้อมูลนี้จะส่งคืนเวอร์ชั่นต่างๆ สำหรับช่องแล้ว ก่อนแนะนำการกำหนดเวอร์ชั่น Webhooks ตำแหน่งข้อมูลส่งคืนรายการช่องที่ติดตามเท่านั้น ขณะนี้ ตำแหน่งข้อมูลจะส่งคืนรายการช่องในเวอร์ชั่นที่สอดคล้องกัน

รายการที่เลิกใช้แล้ว

ข้อความ

  • GET /{message-id} - ช่องต่อไปนี้เลิกใช้แล้ว
    • subject
  • GET /{thread-id} - ช่องต่อไปนี้เลิกใช้แล้ว
    • tags

การเปลี่ยนแปลงที่มีผลต่อการทำงานใน 90 วัน

  • ช่องต่อไปนี้เลิกใช้กับจุดเชื่อมโยงและกล่องโต้ตอบที่อนุญาตให้แนบลิงก์ไปยังโพสต์แล้ว

    • caption
    • description
    • name
    • picture
    • thumbnail

  • จุดเชื่อมโยงและกล่องโต้ตอบที่มีการเลิกใช้แล้ว ได้แก่

    • POST /{event-id}/feed
    • POST /{group-id}/feed
    • POST /{page-id}/feed
    • POST /{user-id}/feed
    • กล่องโต้ตอบ share และ feed

วิดีโอ

  • จุดเชื่อมโยงข้อมูลเชิงลึก - เกณฑ์ชี้วัด paid และ organic ทั้งหมดเลิกใช้แล้ว

Webhooks

  • ช่อง Webhooks ต่อไปนี้จากหัวข้อผู้ใช้เลิกใช้แล้ว

    • about_me
    • birthday_date
    • contact_email
    • current_location
    • education_history
    • hometown_location
    • sex
    • statuses
    • tv
    • work_history

  • ให้ใช้ช่องต่อไปนี้แทน

    • about
    • birthday
    • education
    • email
    • gender
    • hometown
    • location
    • status
    • television
    • work

คุณสมบัติใหม่ใน API การตลาดเวอร์ชั่น 2.9

ชิ้นงานโฆษณา

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

โฆษณาแบบไดนามิก

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

  • รูปภาพสินค้าตัวเดียวหลายๆ รูป - แสดงรูปภาพสินค้าตัวเดียวหลายๆ รูปในโฆษณาแบบไดนามิกในรูปแบบภาพสไลด์ ขณะนี้เราสนับสนุนการใช้รูปภาพสูงสุด 20 รูปจากแค็ตตาล็อกเพื่อแสดงสินค้าตัวเดียวในรูปแบบภาพสไลด์สำหรับโฆษณาแบบไดนามิก ซึ่งทำให้คุณสามารถแสดงสินค้าตัวเดียว เช่น โรงแรมหรือปลายทางที่มีรูปภาพหลายรูป ในการสนับสนุนลักษณะดังกล่าว เรามีตัวเลือกใหม่ๆ ให้ได้แก่ force_single_link = true และ show_multiple_images = true สำหรับรายละเอียด โปรดดู "โฆษณาแบบไดนามิก การจัดการโฆษณา เทมเพลตชิ้นงานโฆษณา"

การจัดการโฆษณา

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

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

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

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

ตำแหน่งการจัดวางโฆษณา

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

การเปลี่ยนแปลงที่สำคัญใน API การตลาดเวอร์ชั่น 2.9

การจัดการโฆษณา

  • ตำแหน่งการจัดวางวิดีโอที่แนะนำ - เป็นส่วนหนึ่งของตำแหน่งการจัดวางบนฟีดสำหรับ Facebook คุณจะได้รับตำแหน่งการจัดวางนี้โดยอัตโนมัติหากคุณใช้ตำแหน่งการจัดวางบนฟีด ตั้งแต่เวอร์ชั่น 2.9 เป็นต้นไป เราจะแยกตำแหน่งการจัดวางวิดีโอที่แนะนำออกจากตำแหน่งการจัดวางบนฟีด คุณจึงสามารถเลือกที่จะไม่รับตำแหน่งการจัดวางวิดีโอที่แนะนำแม้ว่าคุณจะเลือกรับตำแหน่งการจัดวางบนฟีดก็ตามได้ สำหรับเวอร์ชั่น 2.8 หากคุณใช้ตำแหน่งการจัดวางบนฟีดสำหรับ Facebook เราจะไม่แสดงโฆษณาของคุณกับวิดีโอที่แนะนำอีกต่อไปเมื่อคุณเลือกที่จะรับตำแหน่งการจัดวางบนฟีด

  • วัตถุประสงค์การรับรู้ในพื้นที่ - เราเลิกใช้วัตถุประสงค์แคมเปญ LOCAL_AWARENESS นี้แล้ว ตั้งแต่เวอร์ชั่น 2.9 เป็นต้นไป เราจะไม่รับ LOCAL_AWARENESS เป็นวัตถุประสงค์ในการสร้างแคมเปญใหม่ กระตุ้นการรับรู้ในพื้นที่สำหรับชุดโฆษณาตำแหน่งที่ตั้งด้วยแคมเปญ REACH เราไม่สนับสนุน LOCAL_AWARENESS สำหรับตำแหน่งที่ตั้งหลายแห่งอีกต่อไป หากคุณมีแคมเปญที่มีวัตถุประสงค์นี้อยู่แล้ว คุณจะยังสามารถอ่านหรือแก้ไขวัตถุประสงค์ได้อยู่ และคุณจะสามารถสร้างชุดโฆษณาและโฆษณาใหม่ๆ ได้ หากคุณคัดลอกแคมเปญมาจากแคมเปญที่มีอยู่แล้ว ประเภทแคมเปญจะเป็นตัวกำหนดว่าคุณสามารถคัดลอกได้หรือไม่ เราจะLOCAL_AWARENESSคัดลอกแคมเปญที่มีการระบุด้วยตำแหน่งที่ตั้งเดียวREACH สำหรับ LOCAL_AWARENESS และตำแหน่งที่ตั้งหลายแห่ง คุณจะไม่สามารถคัดลอกแคมเปญได้

  • วัตถุประสงค์ของโฆษณาบนมือถือ - เพื่อทำให้วัตถุประสงค์ของโฆษณาง่ายขึ้น เราจึงจะเลิกใช้ CanvasAppEngagement, CanvasAppInstalls, MobileAppInstalls และ MobileAppEngagement เหล่านี้ทั้งหมดเรียกว่า CAE, MAE, CAI และ MAI ตามลำดับ ตั้งแต่เวอร์ชั่น 2.9 เป็นต้นไป คุณจะไม่สามารถสร้างแคมเปญใหม่ด้วยวัตถุประสงค์ทั้งสี่นี้ได้ แต่เราจะสนับสนุน:

    • ชุดโฆษณา CAE โดยแคมเปญ LINK_CLICKS คุณต้องใช้ LINK_CLICKS เพื่อสร้างแคมเปญสำหรับโฆษณา CAE

    • MAEชุดโฆษณาที่มีแคมเปญวัตถุประสงค์ LINK_CLICKS หรือ CONVERSIONS คุณจะต้องเปลี่ยนเป็น LINK_CLICKS หรือ CONVERSIONS เพื่อสร้างแคมเปญสำหรับโฆษณา MAE

    • ชุดโฆษณา CAI ที่มี APP_INSTALLS คุณควรใช้ APP_INSTALLS เพื่อสร้างแคมเปญสำหรับโฆษณา CAI

    • MAI ที่มี APP_INSTALLS คุณควรใช้ APP_INSTALLS เพื่อสร้างแคมเปญสำหรับโฆษณา MAI

  • วัตถุประสงค์ของโฆษณาบนมือถือ ความเข้ากันได้ - เมื่อคุณทำแคมเปญ CAE, MAE, CAI และ MAI ซ้ำด้วย API การตลาดหรือเครื่องมือของ Facebook เราจะแปลวัตถุประสงค์ที่เลิกใช้เหล่านี้ให้เทียบเท่ากับเวอร์ชั่น 2.9 ดังนี้:

    • แคมเปญ MAI หรือ CAI แปลงเป็นวัตถุประสงค์ APP_INSTALLS

    • แคมเปญ CAE แปลงเป็นแคมเปญ LINK_CLICKS

    • แคมเปญ MAE แปลงเป็นแคมเปญ LINK_LICKS หรือ CONVERSIONS ตามการปรับชุดโฆษณาให้เหมาะสมที่คุณทำไว้ในแคมเปญ หากมีชุดโฆษณาย่อยที่ปรับให้เหมาะสมกับ OFFSITE_CONVERSION เราจะแปลงแคมเปญ MAE ของคุณให้เป็นแคมเปญ CONVERSIONS มิเช่นนั้นเราจะแปลแคมเปญ MAE ของคุณเป็นแคมเปญ LINK_CLICKS

  • หมวดหมู่ที่ถูกบล็อก - เรากำลังเลิกใช้หมวดหมู่ Audience Network วิดีโอแบบสตรีม และบทความทันใจบางอย่างเพื่อการสร้างหมวดหมู่ที่เป็นเอกภาพขึ้นในตำแหน่งการจัดวางเหล่านี้ หมวดหมู่เหล่านี้จะช่วยให้คุณสามารถป้องกันการแสดงโฆษณาที่มีเนื้อหาที่ไม่เหมาะสมได้ เช่น การพนัน แอลกอฮอล์ เป็นต้น หมวดหมู่ politics และ religion ได้เลิกใช้ไปแล้ว หมวดหมู่ต่อไปนี้สามารถใช้งานได้:

    • สำหรับบทความทันใจและ Audience Network: debated_social_issues, mature_audiences, tragedy_and_conflict, dating, gambling

    • สำหรับวิดีโอแบบสตรีม: debated_social_issues, mature_audiences, tragedy_and_conflict

  • เลิกใช้ SUPPLEMENTAL_MEDIA_ID แล้วจากชิ้นงานโฆษณาในระดับบัญชีผู้ใช้โฆษณาและระดับโฆษณา คุณจะไม่สามารถอ่านช่องนี้ได้อีกต่อไป

  • เลิกใช้ ACTION_SPEC แล้วจากชิ้นงานโฆษณา ซึ่งเคยมีการใช้กับเรื่องราวที่ได้รับการสนับสนุนซึ่งเราไม่สนับสนุนแล้ว

  • เลิกใช้ช่อง actor_image_hash, actor_image_url และ actor_name ในชิ้นงานโฆษณาในเวอร์ชั่น 2.9 และ 2.8 แล้ว ซึ่งเคยมีการใช้กับ action_spec ซึ่งเราก็ได้เลิกใช้เช่นกัน

  • เลิกใช้ link_title และ link_description ใน call_to_action แล้วจากชิ้นงานโฆษณา หากต้องการระบุชื่อและคำอธิบายชิ้นงานโฆษณา ให้ใช้ name และ description ใน link_data หรือ title และ link_description ใน video_data

  • run_status=3 - คุณเคยสามารถลบชิ้นงานโฆษณาที่มีช่องและค่านี้ได้ การลบนี้ทำให้เกิดความสับสน เราจึงได้เปลี่ยนชื่อ run_status เป็น status และค่าจาก Int เป็นค่าสตริง DELETED หากต้องการลบชิ้นงานโฆษณา ให้ใช้ status=DELETED

  • COVER_PHOTO_ID จาก GET ที่ปลายทางชิ้นงานโฆษณา {creative_id} และ {ad_account_id}/adcreatives ถูกเลิกใช้แล้ว เนื่องจากไม่ค่อยมีการใช้งานและมีไว้เพื่อการใช้ภายในและที่จำกัดเท่านั้น

  • image_url หรือ image_hash - ตอนนี้คุณสามารถระบุรายการใดรายการหนึ่งได้เท่านั้นใน video_data สำหรับ object_story_spec ของชิ้นงานโฆษณา โปรดดู "ชิ้นงานโฆษณา ข้อมูลอ้างอิง"

  • OBJECT_INSTAGRAM_ID จาก GET สำหรับปลายทางของชิ้นงานโฆษณาถูกเลิกใช้แล้ว รวมทั้ง {creative_id} และ AD_ACCOUNT_ID/adcreatives ช่องนี้ไม่ใช้สำหรับการใช้ภายนอก

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

  • ประเภทการส่งคืน spent, today_spent และ yesterday_spent สำหรับวัตถุประสงค์ของโฆษณาทั้งหมดตอนนี้เป็น String ไม่ใช่ Integer ซึ่งจะส่งผลต่อแคมเปญ ชุดโฆษณา และโฆษณา

โฆษณาแบบไดนามิก

  • ห้ามมีชุดสินค้าที่เหมือนกัน - เราไม่อนุญาตให้มีชุดสินค้าที่เหมือนกับชุดสินค้าอื่นจากแค็ตตาล็อกเดียวกันอีกต่อไป หากคุณพยายามที่จะสร้างชุดสินค้าที่เหมือนกันจากแค็ตตาล็อกเดียวกัน API ของเราจะส่งคืน FacebookApiException ด้วยโค้ด 10803 ที่มี ID ของชุดสินค้าที่เหมือนกัน

  • เลิกใช้ quoted_fields ใน POST /{product_feed_id} แล้ว ในเวอร์ชั่น 2.6 เราได้ลบ quoted_fields ภายใต้ POST /{product_feed_id/product_feeds} ออกแล้ว ตอนนี้เราได้เลิกใช้แล้วเพื่อจัดระเบียบเพิ่มเติม

  • ปลายทาง POST {catalog-id}/batch ตอนนี้จะส่งคืน STRING เพื่อปรับปรุงแค็ตตาล็อกสินค้าโฆษณาแบบไดนามิกอย่างต่อเนื่อง

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

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

สัญญาณและการกำหนดเป้าหมาย

  • การเปลี่ยนชื่อที่มาของเหตุการณ์ - ในอดีต เมื่อคุณสร้างหรือสืบค้นคอนเวอร์ชั่นแบบกำหนดเอง คุณจะต้องใช้ช่องชื่อว่า pixel_id, pixel_rule และ pixel_aggregation_rule เนื่องจากเรากำลังเพิ่มการสนับสนุนข้อมูลคอนเวอร์ชั่นออฟไลน์และข้อมูลคอนเวอร์ชั่นแบบกำหนดเองจากแอพ เราจะทำการเปลี่ยนชื่อช่องเพื่อแสดงขอบเขตที่ขยายขึ้น ตอนนี้ช่องเหล่านี้จะมีชื่อว่า event_source_id, rule และ aggregation_rule

  • พิกเซลติดตามคอนเวอร์ชั่น - เลิกใช้แล้วตั้งแต่วันที่ 15 กุมภาพันธ์ 2017 เราได้ลบจุดเชื่อมโยงและโหนดทั้งหมดออกสำหรับการสร้าง การอัพเดต การอ่าน หรือการอ้างอิงโหนดสำหรับ API ทุกเวอร์ชั่นออกด้วย

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

  • การสนับสนุน delivery_estimate - เราได้ทำการเปลี่ยนแปลงกับค่าประมาณการเข้าถึงเพื่อสนับสนุน delivery_estimate ที่เพิ่งเปิดใช้งาน:

    • ลบ bid_estimations ออกจากปลายทาง /reach_estimates และย้ายฟังก์ชั่นที่จัดทำเป็นเอกสารไปยัง /delivery_estimate

    • /AD_ID/reachestimate ถูกเลิกใช้แล้ว วิธีเข้าข้อมูลนี้ ให้ใช้ /ADSET_ID/delivery_estimate

    • ลบช่อง data ออก

ข้อมูลเชิงลึก

  • date_preset การเลิกใช้งาน - เรากำลังจะเลิกใช้ค่า date_preset หลายค่าซึ่งเราจะแทนที่ด้วยค่าใหม่ ค่าใหม่จะได้รับการออกแบบมาเพื่อการใช้งานที่ง่ายและสอดคล้องกับความคาดหวังของผู้ลงโฆษณา และจะไม่มีข้อมูลจากวันปัจจุบันอีกต่อไป ตัวอย่างเช่น คำขอที่ส่งมาในวันที่ 8 กุมภาพันธ์และใช้ช่วงวันที่ที่กำหนดไว้ล่วงหน้าเป็น “7 วันที่ผ่านมา” จะสร้างรายงานที่มีวันที่ 1 กุมภาพันธ์จนถึงเวลา 23:59 น.ในวันที่ 7 กุมภาพันธ์รวมกัน และจะไม่รวมวันที่ 8 กุมภาพันธ์ ค่าต่อไปนี้ถูกเลิกใช้แล้ว:

    • last_3_days เปลี่ยนเป็น last_3d

    • last_7_days เปลี่ยนเป็น last_7d

    • last_14_days เปลี่ยนเป็น last_14d

    • last_28_days เปลี่ยนเป็น last_28d

    • last_30_days เปลี่ยนเป็น last_30d

    • last_90_days เปลี่ยนเป็น last_90d

    • last_week เปลี่ยนเป็น last_week_sun_sat และ last_week_mon_sun

    • this_week เปลี่ยนเป็น this_week_sun_today และ this_week_mon_today

    • last_3_months ถูกเลิกใช้แล้ว

    • สำหรับเวอร์ชั่น 2.8 และเก่ากว่า เราจะสนับสนุนทั้งค่าใหม่เหล่านี้และค่าวันที่เก่าที่กำหนดไว้ล่วงหน้า

  • ค่าเริ่มต้น date_preset - หากคุณทำการสืบค้นข้อมูลเชิงลึกโดยไม่มี date_preset เราจะเปลี่ยนเป็น last_30_days ตามค่าเริ่มต้นซึ่งจะมีกิจกรรมจากวันนี้จนถึงเวลา 00:00 น. ในโซนเวลาของบัญชีผู้ใช้โฆษณา ตั้งแต่เวอร์ชั่น 2.9 เป็นต้นไป จะเปลี่ยนเป็น last_30d ตามค่าเริ่มต้น ซึ่งจะรวม 30 วันก่อนหน้านี้ สิ้นสุดเวลา 23:59 น.ในคืนก่อนในโซนเวลาของบัญชีผู้ใช้ของคุณ และจะไม่รวมวันนี้

  • video_complete_watched_actions ถูกเลิกใช้แล้ว ซึ่งจะมีข้อมูลเดียวกันกับ video_30_sec_watched_actions

  • unique_impression และ unique_social_impressions ถูกเลิกใช้แล้ว โปรดใช้ reach และ social_reach แทน

  • newsfeed_clicks, newsfeed_impressions, newsfeed_avg_position, video_avg_sec_watched_actions, video_avg_pct_watched_actions เป็นเกณฑ์ชี้วัดที่ล้าสมัยที่จะถูกเลิกใช้

  • รายการต่อไปนี้ถูกเลิกใช้ภายใต้ action_type:: follow, gift_sale, video_play, และvote

  • click_to_play_video ตอนนี้สามารถเข้าถึงได้ผ่านข้อมูลแยกย่อย action_video_type

  • ช่องข้อมูลแยกย่อย placement สำหรับข้อมูลการแสดงโฆษณาถูกเลิกใช้แล้วจาก API ข้อมูลเชิงลึก เฉพาะ ["publisher_platform", "platform_position"] เท่านั้นที่ได้รับการสนับสนุนในเวอร์ชั่น 2.9 ในเวอร์ชั่น 2.8 เราจะสนับสนุนทั้ง ["placement"] หรือ ["publisher_platform", "platform_position"] เป็นข้อมูลแยกย่อย

  • attribution_spec - ในอดีต เราใช้ช่องแยกกันสองช่องสำหรับช่วงการระบุที่มาแบบคลิกผ่านและดูผ่านใน API ข้อมูลเชิงลึก ตอนนี้คุณควรใช้ attribution_spec เพื่อตั้งค่าช่วงการระบุที่มาทั้งสองแบบ เมื่อคุณตั้งค่า attribution_spec จะเป็นการแทนที่การตั้งค่าที่มีอยู่ทั้งหมด หากคุณได้ตั้งค่าทั้งการคลิกผ่านและการดูผ่านไว้ เมื่อคุณตั้งค่า attribution_spec ให้เป็น event_type = CLICK_THROUGH คุณเพียงจะลบการระบุที่มาการดูผ่านออกเท่านั้น