API การตลาด

ตัวเลือกข้อมูลจำเพาะของฟีดองค์ประกอบ

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

ชื่อคุณสมบัติ คำอธิบาย

images

ประเภท: อาร์เรย์ลิสต์

ต้องระบุสำหรับรูปแบบ SINGLE_IMAGE และ CAROUSEL_IMAGE

อาร์เรย์รูปภาพที่มีสิทธิ์ใช้งาน รูปภาพที่ให้ไว้ในอาร์เรย์นี้ควรรวมอยู่ในคลังรูปภาพของบัญชีโฆษณา


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"} อยู่ ต้องระบุ url หรือ hash อย่างใดอย่างหนึ่ง

videos

ประเภท: อาร์เรย์ลิสต์

ต้องระบุสำหรับรูปแบบ SINGLE_VIDEO

อาร์เรย์ video_idsvideo_id ที่ให้ไว้ในอาร์เรย์นี้ควรเป็นของบัญชีโฆษณา


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"} อยู่

carousels
ประเภท: อาร์เรย์ลิสต์

ระบุหรือไม่ก็ได้
อาร์เรย์ child_attachments พร้อมกับบูลีน multi_share_end_card และ multi_share_optimized และ adlabelschild_attachments ที่ให้ไว้ในอาร์เรย์นี้ควรเป็นของบัญชีโฆษณา



ระบุ child_attachments เป็นอาร์เรย์ลิสต์ที่มี {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}} อยู่ ต้องระบุ image_label หรือ video_label อย่างใดอย่างหนึ่ง

bodies

ประเภท: อาร์เรย์ลิสต์

ระบุหรือไม่ก็ได้

อาร์เรย์เนื้อความ ข้อความหรือคำโฆษณาหลักของโฆษณา


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"text": "{BODY_TEXT}", "url_tags": "{TAG}"} อยู่

call_to_action_types

ประเภท: อาร์เรย์ลิสต์

ต้องระบุสำหรับวัตถุประสงค์ทั้งหมด ยกเว้น OUTCOME_AWARENESS

อาร์เรย์ค่าประเภทการกระตุ้นให้ดำเนินการ


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"{CALL_TO_ACTION}"} อยู่ คุณสามารถระบุได้หลายค่าแต่ไม่เกินห้ารายการ

titles

ประเภท: อาร์เรย์ลิสต์

ระบุหรือไม่ก็ได้

อาร์เรย์หัวเรื่อง หัวเรื่องคือพาดหัวสั้นๆ ในโฆษณา โดยทั่วไปแล้วจะปรากฏถัดจากลิงก์ รูปภาพ หรือวิดีโอ


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"text": "{TITLE}", "url_tags": "{TAG}"} อยู่

descriptions

ประเภท: อาร์เรย์ลิสต์

ระบุหรือไม่ก็ได้

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


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"text": "{DESCRIPTION}", "url_tags": "{TAG}"} อยู่

link_urls

ประเภท: อาร์เรย์ลิสต์

จำเป็นต้องระบุ

อาร์เรย์ของ URL ลิงก์


ระบุช่องนี้เป็นอาร์เรย์ลิสต์ที่มี {"website_url": "{URL}"} อยู่

ad_formats

ประเภท: อาร์เรย์ของสตริง

จำเป็นต้องระบุ

อาร์เรย์รูปแบบโฆษณาบน Facebook ที่เราควรใช้สร้างโฆษณา รูปแบบที่รองรับได้แก่ SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT


ระบุช่องนี้เป็นอาร์เรย์สตริง ["{AD_FORMAT}"]

optimization_type

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

ระบุหรือไม่ก็ได้

ประเภทการปรับให้เหมาะสมที่ใช้ในฟีดองค์ประกอบ ค่าที่มีได้จะได้แก่ ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT และ REGULAR

message_extensions

ประเภท: อาร์เรย์ของสตริง

ระบุหรือไม่ก็ได้
ประเภทส่วนขยายของข้อความที่ใช้ในฟีดองค์ประกอบ


ค่าที่มีได้: whatsapp

onsite_destinations
ประเภท: อาร์เรย์ลิสต์

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

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

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

ต้องระบุสำหรับโฆษณาร้านค้า ใช้งานสำหรับโฆษณาแค็ตตาล็อก Advantage+
ระบุช่องนี้สำหรับการเพิ่มประสิทธิภาพร้านค้า ระบุประเภทการเพิ่มประสิทธิภาพของร้านค้าทั้ง reasons_to_shop และ automated_product_tags
ค่าที่มีได้จะได้แก่ true, false

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

ต้องระบุสำหรับโฆษณาร้านค้า ใช้งานสำหรับโฆษณาแค็ตตาล็อก Advantage+
ระบุช่องนี้สำหรับการเพิ่มประสิทธิภาพร้านค้า ไฮไลท์ข้อมูลสินค้าโดยอัตโนมัติจากร้านค้าของคุณ เช่น "จัดส่งฟรี", "กำลังนิยม" หรือ "ใกล้จะหมด"
ค่าที่มีได้จะได้แก่ true, false

ข้อจำกัดของข้อมูลจำเพาะของฟีดองค์ประกอบ

รูปแบบโฆษณา

  • รองรับ ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO และ AUTOMATIC_FORMAT
  • โดยอนุญาตให้ใช้ ad_format เพียง 1 รูปแบบต่อ 1 ฟีดองค์ประกอบเท่านั้น
  • ad_format นับเป็น 1 องค์ประกอบในฟีดองค์ประกอบ

จำนวนองค์ประกอบ:

  • สูงสุดรวม 30 องค์ประกอบ ตัวอย่างเช่น คุณองค์ประกอบ 28 ชิ้น ได้แก่ 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url และ 1 call_to_action_types
  • จำนวนรูปภาพรวม: ไม่เกิน 10
  • จำนวนวิดีโอรวม: ไม่เกิน 10 หากคุณใช้ Instagram เป็นตำแหน่งการจัดวางของคุณ เราจะอนุญาตเฉพาะวิดีโอจัตุรัสและวิดีโอแนวนอนเท่านั้น
  • จำนวนเนื้อความรวม: ไม่เกิน 5
  • จำนวนการกระตุ้นการดำเนินการรวม: ไม่เกิน 5
  • จำนวนหัวเรื่องรวม: ไม่เกิน 5
  • จำนวนลิงก์รวม: ไม่เกิน 5
  • จำนวนคำอธิบายรวม: ไม่เกิน 5

ข้อกำหนดของรูปภาพ:

  • ข้อมูลจำเพาะของรูปภาพที่แนะนำ: 1.9:1
  • ขนาดรูปภาพที่แนะนำ: 1,200 x 628 พิกเซล
  • สำหรับรูปแบบ SINGLE_IMAGE คุณต้องใส่รูปภาพอย่างน้อย 2 รูป
  • หากคุณใช้ Instagram เป็นตำแหน่งการจัดวางของคุณ ให้ใช้รูปภาพจัตุรัสเพื่อประสิทธิภาพที่ดียิ่งขึ้น

ข้อกำหนดของข้อความ:

  • ข้อความหัวเรื่องและคำอธิบาย: ความยาวสูงสุด 255 อักขระ
  • ข้อความเนื้อความ: ความยาวสูงสุด 1,024 อักขระ
  • หากคุณไม่ได้ระบุคำอธิบายใดเลย เราจะดึงข้อมูลลิงก์ที่คุณให้ไว้เพื่อดึงข้อมูลคำอธิบาย
  • สำหรับ CAROUSEL_IMAGE จะระบุหัวเรื่องหรือไม่ก็ได้

url_tags จะระบุหรือไม่ก็ได้และจะใช้งานได้สำหรับ images, videos, bodies, descriptions และ titles เท่านั้น Facebook จะเพิ่ม url_tags ไปยัง URL ของลิงก์เป็นพารามิเตอร์สำหรับองค์ประกอบแต่ละรายการในโฆษณา

ตัวอย่างเช่น การตั้งค่าชุดฟีดองค์ประกอบที่ถูกต้องสำหรับรูปแบบ SINGLE_IMAGE ได้แก่

  • 5 images
  • 3 bodies
  • 3 titles
  • 3 descriptions
  • 1 รูปแบบ: SINGLE_IMAGE
  • 2 link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

ใช้ Deep Link

คุณสามารถใช้ Deep Link ในข้อมูลจำเพาะของฟีดองค์ประกอบสำหรับแคมเปญที่มีวัตถุประสงค์ต่อไปนี้ได้

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

เพิ่ม deeplink_url ใน link_urls เมื่อคุณสร้าง asset_feed_spec

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

เว็บไซต์โฆษณา WhatsApp

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

เพิ่ม message_extensions เมื่อคุณสร้าง asset_feed_spec

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives