เวอร์ชั่น 2.11

API การตลาด

เผยแพร่เมื่อวันที่ 7 พฤศจิกายน ปี 2017 | โพสต์บล็อก

• คุณสมบัติใหม่
• การเปลี่ยนแปลงที่สำคัญ
• สิ่งที่เลิกใช้
• สิ่งที่เลิกใช้ทันที

คุณสมบัติใหม่

การออกแบบ API ตัวจัดการธุรกิจใหม่

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

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

วิธีการเข้าถึงผู้ใช้บนธุรกิจ:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

วิธีการเข้าถึงองค์ประกอบของชิ้นงานโฆษณาที่กำหนดให้กับผู้ใช้:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

วิธีการเข้าถึงเพจธุรกิจ:

• BUSINESS_ID/owned_pages - เพื่อรับรายการเพจที่ธุรกิจเป็นเจ้าของ
• BUSINESS_ID/client_pages - เพื่อรับรายการเพจของไคลเอ็นต์ธุรกิจ
• BUSINESS_ID/pending_owned_pages - เพื่อรับรายการเพจที่ธุรกิจเป็นเจ้าของที่กำลังรอดำเนินการอนุมัติ
• BUSINESS_ID/pending_client_pages - เพื่อรับรายการเพจที่เป็นของไคลเอ็นต์ธุรกิจที่กำลังรอดำเนินการอนุมัติ

วิธีการเข้าถึงบัญชีผู้ใช้โฆษณาของธุรกิจ:

• BUSINESS_ID/owned_ad_accounts - เพื่อรับรายการบัญชีผู้ใช้โฆษณาที่ธุรกิจเป็นเจ้าของ
• BUSINESS_ID/client_ad_accounts - เพื่อรับรายการบัญชีผู้ใช้โฆษณาของไคลเอ็นต์ธุรกิจ
• BUSINESS_ID/pending_owned_ad_accounts - เพื่อรับรายการบัญชีผู้ใช้โฆษณาที่ธุรกิจเป็นเจ้าของที่กำลังรอดำเนินการอนุมัติ
• BUSINESS_ID/pending_client_ad_accounts - เพื่อรับรายการบัญชีผู้ใช้โฆษณาของไคลเอ็นต์ธุรกิจที่กำลังรอดำเนินการอนุมัติ

วิธีการเข้าถึงแค็ตตาล็อกสินค้าของธุรกิจ

• BUSINESS_ID/owned_product_catalogs - เพื่อรับรายการแค็ตตาล็อกสินค้าที่ธุรกิจเป็นเจ้าของ
• BUSINESS_ID/client_product_catalogs - เพื่อรับรายการของแค็ตตาล็อกสินค้าที่เป็นของไคลเอ็นต์ธุรกิจ

วิธีการเข้าถึงแอพของธุรกิจ:

• BUSINESS_ID/owned_apps - เพื่อรับรายการแอพที่ธุรกิจเป็นเจ้าของ
• BUSINESS_ID/client_apps - เพื่อรับรายการแอพของไคลเอ็นต์ธุรกิจ
• BUSINESS_ID/pending_client_apps - เพื่อรับรายการแอพที่เป็นของไคลเอ็นต์ธุรกิจที่กำลังรอดำเนินการอนุมัติ

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ API ตัวจัดการธุรกิจ, ผู้ใช้ระบบตัวจัดการธุรกิจ, API การจัดการองค์ประกอบของชิ้นงานโฆษณาของธุรกิจ, และ หลักปฏิบัติที่ดีที่สุดสำหรับ API ตัวจัดการธุรกิจ

โฆษณาแบบภาพสไลด์, ตำแหน่งที่ตั้งแบบเรียลไทม์

ตอนนี้คุณสามารถสร้างโฆษณาแบบภาพสไลด์ด้วยรายการแนบที่แสดงตำแหน่งที่ตั้งแบบเรียลไทม์ได้แล้ว เพิ่มตัวเลือก type=REALTIMEและlocation_source_id = PAGE_IDในplace_dataสำหรับAD_CREATIVE_ID/object_story_spec มีพร้อมใช้งานในช่องobject_story_specใน:

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

การเยี่ยมชมหน้าร้าน, ตำแหน่งที่ตั้งทางภูมิศาสตร์ของการกำหนดเป้าหมาย

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

• POST AD_ACCOUNT_ID/adsetsมีตัวเลือกใหม่
• สนับสนุนพื้นที่ทางภูมิศาสตร์ในตำแหน่งที่ตั้งที่เป็นข้อมูลจำเพาะการกำหนดเป้าหมายยกเว้นการกำหนดเป้าหมายโดยcountry_groupsและการกำหนดเป้าหมายประเภทตำแหน่งที่ตั้งtravel_in
• การสร้างโฆษณาด้วยวัตถุประสงค์STORE_VISITSนั้นพร้อมใช้งานแบบจำกัด โปรดดูที่การเยี่ยมชมหน้าร้าน

ชุดโฆษณา, ประเภทของปลายทาง

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

• ได้เพิ่มdestination_typeสำหรับชุดโฆษณา
• มีพร้อมใช้งานที่/ADSET_ID

ตัวชี้วัดประสิทธิภาพการทำงานหลัก

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

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

สำหรับข้อมูลเพิ่มเติม โปรดดูที่เอกสารอ้างอิงแคมเปญโฆษณา

การเปลี่ยนแปลงที่สำคัญ

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

• การกำหนดกลุ่มเป้าหมายที่ไม่ถูกต้องright_hand_column - การกำหนดกลุ่มเป้าหมายในมุมมองนี้ที่มีชิ้นงานโฆษณาที่ไม่ถูกต้องสำหรับ right_hand_column ที่ AD_ACCOUNT_ID/adsets จะให้ผลลัพธ์ที่ไม่ถูกต้อง เราไม่อนุญาตให้ใช้งานตำแหน่งการจัดวาง right_hand_columnเท่านั้นกับรูปแบบโฆษณาแบบวิดีโอ คอลเลกชั่น หรือโฆษณาบน Canvas สำหรับตำแหน่งการจัดวางright_hand_columnเท่านั้น คุณสามารถใช้รูปแบบภาพเดี่ยวและรูปแบบภาพสไลด์ได้

• การเปลี่ยนแปลงGET VERSION/RF_PREDICTION_ID/pause_periods - เพื่อตอบกลับ Array ในตอนนี้ แต่ไม่ใช่ String เพื่อการรับมือที่ง่ายดายขึ้น

API ตัวจัดการธุรกิจ

• ช่องที่ตั้งชื่อใหม่ — ช่องadmin_system_userที่ถูกตั้งชื่อใหม่ให้เป็นadmin และช่องsystem_user ที่ถูกตั้งชื่อใหม่เป็นemployee สิ่งนี้ส่งผลกระทบต่อจุดเชื่อมโยงต่อไปนี้:

  • /{business-id}/userpermissions
  • /{business-id}/system_users

สิ่งที่เลิกใช้

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

การปรับให้เหมาะสมที่เลิกใช้งานVIDEO_VIEWS - แคมเปญที่มีวัตถุประสงค์VIDEO_VIEWS จะไม่สามารถใช้งานCLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT, หรือREACHเป็นเป้าหมายการปรับให้เหมาะสมได้อีกต่อไป

• การสร้างชุดโฆษณาด้วยเป้าหมายการปรับให้เหมาะสมเหล่านี้จะตอบกลับผลลัพธ์เป็นข้อผิดพลาด
• สำเนาชุดโฆษณาที่มีเป้าหมายการปรับให้เหมาะสมเพื่อREACHจะแปลงเป็นเป้าหมายการปรับให้เหมาะสมเพื่อVIDEO_VIEWSโดยอัตโนมัติ
• สำเนาชุดโฆษณาที่มีเป้าหมายการปรับให้เหมาะสมเพื่อCLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, หรือ POST_ENGAGEMENTจะตอบกลับผลลัพธ์เป็นข้อผิดพลาด ทั้งนี้เป็นเพราะการสร้างหรือการทำสำเนาโฆษณาในชุดโฆษณาที่มีอยู่แล้วจะใช้งานเป้าหมายการปรับให้เหมาะสมที่เหมือนเดิม

จุดเชื่อมโยงที่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้:

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

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

การปรับให้เหมาะสมที่เลิกใช้งานBRAND_AWARENESS - แทนที่โดยAD_RECALL_LIFT. สิ่งนี้สะท้อนให้เห็นถึงโมเดลการนำส่งโฆษณาที่ใหม่และมีประสิทธิภาพการทำงานมากกว่า เป้าหมายการปรับให้เหมาะสมนั้นรองรับชิ้นงานโฆษณาแบบผสม เช่นสถิติและโฆษณาแบบวิดีโอที่อยู่ในชุดโฆษณาเดียวกันและการประมูลแบบกำหนดเอง โดยที่จะไม่มีBRAND_AWARENESSให้ใช้งานอีกต่อไปใน:

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

เลิกใช้งานfrequency_cap - ประกอบไปด้วยช่องlifetime_frequency_capและfrequency_cap_reset_periodที่อยู่ใน:

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

ให้ใช้ frequency_control_specs แทน

ต้นทุนต่อการดำเนินการที่เลิกใช้งานPOST_ENGAGEMENT - คุณจะไม่สามารถใช้งานPOST_ENGAGEMENT เป็นbilling_eventได้สำหรับวัตถุประสงค์นี้ โดยจะสอดคล้องกับการนำส่งโฆษณาและการวัดผลได้ดียิ่งขึ้น สิ่งนี้ส่งผลกระทบต่อปลายทาง: /AD_SET_ID

ข้อมูลเชิงลึกของโฆษณาและการวัดผล

เลิกใช้งานvideo_15_sec_watched_actionsที่:

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

เลิกใช้งานrecurrence_value - จาก API การวัดผลขั้นสูง อีกทั้งช่องดังกล่าวก็เปรียบเสมือนตารางการรายงานของ Atlas API เราแทนที่ช่องดังกล่าวด้วยrecurrence_values ดูที่ ตารางการรายงานของการวัดผลขั้นสูง

ตัวจัดการธุรกิจ

ปลายทางที่เลิกใช้งานสำหรับการออกแบบใหม่ของ API ตัวจัดการธุรกิจ

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

ปลายทางที่เลิกใช้งานสำหรับการจัดการองค์ประกอบของชิ้นงานโฆษณา:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

เพื่อเข้าถึงองค์ประกอบของชิ้นงานโฆษณา ให้ใช้งานBUSINESS_ID/owned_ASSETหรือBUSINESS_ID/client_ASSET

ปลายทางที่เลิกใช้งานสำหรับการจัดการองค์ประกอบของชิ้นงานโฆษณาที่เป็นของธุรกิจอื่น

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

ให้ใช้BUSINESS_USER_ID/assigned_ASSETแทน

สิ่งที่เลิกใช้ทันที

การเลิกใช้งานเหล่านี้จะส่งผลกระทบกับ API ทุกเวอร์ชั่นและจะมีผลใช้งานในวันที่ 14 พฤศจิกายน ปี 2017

โฆษณางานกิจกรรมและโฆษณาแบบลิงก์

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

ลายเซ็นที่ถูกเลิกใช้งาน:

• โฆษณางานกิจกรรม

  • วัตถุประสงค์: EVENT_RESPONSES
  • ช่องกรอกข้อมูลชิ้นงานโฆษณา: body, object_id
• โฆษณาแบบลิงก์

  • วัตถุประสงค์: LINK_CLICKS
  • ช่องกรอกข้อมูลชิ้นงานโฆษณา: title, body, object_url (image_fileหรือimage_hash)

ลายเซ็นที่รองรับ

• โฆษณางานกิจกรรม

  • วัตถุประสงค์: EVENT_RESPONSES
  • ช่องกรอกข้อมูลชิ้นงานโฆษณา: object_story_idหรือobject_story_spec
• โฆษณาแบบลิงก์

  • วัตถุประสงค์: LINK_CLICKS
  • ช่องกรอกข้อมูลชิ้นงานโฆษณา: object_story_idหรือobject_story_spec

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