โฆษณาที่คลิกไปยังหลายปลายทาง

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

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

โฆษณาหลายปลายทาง หมายความว่าโฆษณาสามารถนำผู้คลิกไปยังปลายทางร่วมกันแบบใดก็ได้ ไม่ว่าจะเป็นแชท Messenger, แชท Instagram, แชท WhatsApp

หากคุณต้องการสร้างโฆษณาที่นำไปยังปลายทางเดียวเท่านั้น โปรดดูเพิ่มเติมดังต่อไปนี้

ภาพรวมเกี่ยวกับการสร้างโฆษณา

เอกสารนี้สรุปขั้นตอนที่คุณต้องปฏิบัติตามเพื่อตั้งค่าการผสานการทำงานของโฆษณาที่คลิกไปยังหลายปลายทาง คุณต้องดำเนินการต่อไปนี้

  1. สร้างแคมเปญโฆษณา
  2. สร้างชุดโฆษณาที่ลิงก์โฆษณาของคุณเข้ากับแคมเปญโฆษณา
  3. สร้างชิ้นงานโฆษณาสำหรับโฆษณาประเภทหลายปลายทางที่คุณต้องการแสดง
  4. สร้างโฆษณาโดยลิงก์ชิ้นงานโฆษณาของคุณเข้ากับชุดโฆษณา

ก่อนที่คุณจะเริ่ม

คู่มือนี้เขียนขึ้นโดยถือว่าคุณมีและดำเนินการต่อไปนี้แล้ว

ขั้นตอนที่ 1: สร้างแคมเปญโฆษณา

เริ่มต้นด้วยการสร้างแคมเปญโฆษณาของคุณ วิธีดำเนินการคือ ส่งคำขอ POST ไปยัง ตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/campaigns โดย <AD_ACCOUNT_ID> คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้

พารามิเตอร์

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

name

สตริง

จำเป็นต้องระบุ
ชื่อสำหรับแคมเปญที่คลิกไปยังหลายปลายทาง

objective

enum

จำเป็นต้องระบุ
วัตถุประสงค์ของแคมเปญ
วัตถุประสงค์ที่รองรับคือ OUTCOME_ENGAGEMENTOUTCOME_SALES และ OUTCOME_TRAFFIC

special_ad_categories

ลิสต์<Object>

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

status

enum

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

คำขอ

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

การตอบกลับ

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON พร้อม ID สำหรับแคมเปญที่สร้างขึ้นใหม่ของคุณ

{
  "id": "<AD_CAMPAIGN_ID>"
}

การอัพเดต

คุณสามารถอัพเดตแคมเปญโดยส่งคำขอ POST ไปยัง /<AD_CAMPAIGN_ID>

การอ่าน

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

คำขอ

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

การตอบกลับ

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

ขั้นตอนที่ 2: สร้างชุดโฆษณา

เมื่อคุณมีแคมเปญโฆษณาแล้ว ให้สร้างชุดโฆษณาของคุณ หากต้องการสร้างชุดโฆษณา ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/adsets ที่ซึ่ง <AD_ACCOUNT_ID> คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้

พารามิเตอร์

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

bid_amount

int32 ที่ไม่ได้ลงนาม

จำเป็นต้องระบุ หากตั้งค่า bid_strategy (กลยุทธ์การประมูล) เป็น LOWEST_COST_WITH_BID_CAP หรือ COST_CAP
ให้ระบุจำนวนสูงสุดที่คุณต้องการชำระให้กับผลลัพธ์ที่อิงตาม optimization_goal ของคุณ

bid_strategy

enum

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

billing_event

enum

จำเป็นต้องระบุ
ต้องได้รับการตั้งค่าเป็น IMPRESSIONS สำหรับโฆษณาที่คลิกไปยังหลายปลายทาง Meta จะเรียกเก็บเงินจากคุณเมื่อโฆษณาแสดงต่อผู้คน

campaign_id

สตริงตัวเลขหรือจำนวนเต็ม

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

daily_budget

จำนวนเต็มแบบ 64 บิต

จำเป็นต้องระบุ หากไม่ได้ตั้งค่า lifetime_budget
งบประมาณต่อวันที่กำหนดในสกุลเงินบัญชีของคุณ อนุญาตเฉพาะชุดโฆษณาที่มีระยะเวลา (ความแตกต่างระหว่าง end_time และ start_time) นานกว่า 24 ชั่วโมง
โดยที่ daily_budget หรือ lifetime_budget ต้องมากกว่า 0

destination_type

สตริง

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


  • ตั้งค่าเป็น MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP หากคุณต้องการใช้ปลายทางทั้ง 3 ประเภท (Messenger, WhatsApp และ Instagram)
  • ตั้งค่าเป็น MESSAGING_INSTAGRAM_DIRECT_MESSENGER หากคุณต้องการใช้ Messenger และ Instagram
  • ตั้งค่าเป็น MESSAGING_MESSENGER_WHATSAPP หากคุณต้องการใช้ Messenger และ WhatsApp
  • ตั้งค่าเป็น MESSAGING_INSTAGRAM_DIRECT_WHATSAPP หากคุณต้องการใช้ WhatsApp และ Instagram

หมายเหตุ: หากคุณใส่ WhatsApp ไว้ในปลายทาง โปรดตรวจสอบให้แน่ใจว่าคุณเชื่อมหมายเลขธุรกิจ WhatsApp เข้ากับเพจของคุณแล้ว หากคุณใส่ Instagram ไว้ในปลายทาง โปรดตรวจสอบให้แน่ใจว่าคุณเชื่อมบัญชีธุรกิจของ Instagram เข้ากับเพจของคุณแล้ว

end_time

วันที่และเวลา

จำเป็นต้องระบุ เมื่อมีการระบุ lifetime_budget ไว้
ขณะที่สร้างชุดโฆษณาที่มี daily_budget ให้ระบุ end_time=0 หรือเว้นช่องนี้ว่างไว้เพื่อตั้งค่าชุดโฆษณาให้ดำเนินต่อไปแบบไม่มีวันที่สิ้นสุด
ตัวอย่าง:2015-03-12 23:59:59-07:00 หรือ 2015-03-12 23:59:59 PDT ประทับเวลา UTC UNIX

lifetime_budget

จำนวนเต็มแบบ 64 บิต

จำเป็นต้องระบุ หากไม่ได้ตั้งค่า daily_budget
ให้ระบุงบประมาณตลอดอายุการใช้งานที่กำหนดในสกุลเงินบัญชีของคุณ หากระบุ คุณจะต้องระบุ end_time ด้วย
โดยที่ daily_budget หรือ lifetime_budget ต้องมากกว่า 0

name

สตริง

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

optimization_goal

enum

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

promoted_object

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

  • page_id: จำเป็นต้องระบุ ID ของเพจ Facebook

ดูรายละเอียดเพิ่มเติมได้ที่ ชุดโฆษณา, อ็อบเจ็กต์ที่โปรโมท

start_time

วันที่และเวลา

ระบุหรือไม่ก็ได้
เวลาเริ่มต้นสำหรับชุดโฆษณา ช่องนี้จะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น ถ้าไม่ได้ระบุค่าไว้
ตัวอย่าง:2015-03-12 23:59:59-07:00 หรือ 2015-03-12 23:59:59 PDT ประทับเวลา UTC UNIX

status

enum

ระบุหรือไม่ก็ได้
สถานะของชุดโฆษณา โดยอาจแตกต่างจากสถานะการใช้งานเนื่องจากแคมเปญหลักของชุดโฆษณานั้นๆ ได้ ช่องนี้จะใช้ ACTIVE เป็นค่าเริ่มต้น ถ้าไม่ได้ระบุค่าไว้
ค่า:ACTIVEPAUSEDDELETEDARCHIVED

targeting

อ็อบเจ็กต์การกำหนดเป้าหมาย

จำเป็นต้องระบุ
โครงสร้างการกำหนดเป้าหมายของโฆษณาที่คลิกไปยัง Instagram ดูรายละเอียดเพิ่มเติมได้ที่การกำหนดเป้าหมาย

time_start

วันที่และเวลา

ระบุหรือไม่ก็ได้
สามารถใช้แทน start_time

time_stop

วันที่และเวลา

จำเป็นต้องระบุ เมื่อมีการระบุ lifetime_budget ไว้
สามารถใช้แทน end_time

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

คำขอ

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

การตอบกลับ

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON พร้อม ID สำหรับชุดโฆษณาที่สร้างขึ้นใหม่ของคุณ

{
  "id": "<AD_SET_ID>"
}

การอัพเดต

คุณสามารถอัพเดตชุดโฆษณาโดยส่งคำขอ POST ไปยัง /<AD_SET_ID>

การอ่าน

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

คำขอ

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

การตอบกลับ

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

ขั้นตอนที่ 3: สร้างชิ้นงานโฆษณา

ชิ้นงานโฆษณาช่วยให้คุณเพิ่มองค์ประกอบต่างๆ ลงในโฆษณาของคุณได้ หากต้องการสร้างชิ้นงานโฆษณา ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/adcreatives โดย <AD_ACCOUNT_ID> คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้

พารามิเตอร์

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

asset_feed_spec

จำเป็นต้องระบุ
ระบุปลายทางของโฆษณาที่คลิกไปยังหลายปลายทาง

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

  • optimization_type: ต้องได้รับการตั้งค่าเป็น DOF_MESSAGING_DESTINATION สำหรับโฆษณาที่คลิกไปยังหลายปลายทาง
  • call_to_actions: อาร์เรย์ของปลายทางที่เลือกสำหรับโฆษณาที่คลิกไปยังหลายปลายทาง โดยต้องตรงกับ destination_type ที่ระบุในชุดโฆษณา

Messenger

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

WhatsApp

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

Instagram

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

name

สตริง

จำเป็นต้องระบุ
ชื่อชิ้นงานโฆษณาของคุณ

object_story_spec

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


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

  • page_id: ID ของเพจ Facebook
  • instagram_actor_id: ID บัญชี Instagram คุณสามารถรับ ID บัญชี Instagram ได้ 3 วิธี ได้แก่ บัญชี Instagram ที่ตัวจัดการธุรกิจเป็นเจ้าของ, บัญชี Instagram ที่เชื่อมต่อกับเพจ และบัญชี Instagram ที่สนับสนุนเพจ

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

  • link_data: ข้อมูลจำเพาะสำหรับลิงก์ที่โพสต์บนเพจหรือโฆษณาแบบภาพสไลด์
  • photo_data: ข้อมูลจำเพาะสำหรับรูปภาพที่โพสต์บนเพจ
  • text_data: ข้อมูลจำเพาะสำหรับข้อความที่โพสต์บนเพจ
  • video_data: ข้อมูลจำเพาะสำหรับวิดีโอที่โพสต์บนเพจ

degrees_of_freedom_spec

ระบุหรือไม่ก็ได้
ดูรายละเอียดเพิ่มเติมได้ที่การเพิ่มประสิทธิภาพมาตรฐานสำหรับชิ้นงานโฆษณา Advantage+

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

การกรอกข้อความต้อนรับในเพจ

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับประโยคเริ่มการสนทนาที่ข้อมูลอ้างอิงเกี่ยวกับ ice_breakers

ข้อจำกัด

  • ชื่อประโยคเริ่มการสนทนาต้องมีความยาวไม่เกิน 80 อักขระ
  • ข้อความตอบกลับประโยคเริ่มการสนทนาต้องมีความยาวไม่เกิน 300 อักขระ
  • เนื้อหาของข้อความต้องมีความยาวไม่เกิน 300 อักขระ

ตัวอย่าง

สร้างอ็อบเจ็กต์ page_welcome_message เพื่อเพิ่มประโยคเริ่มการสนทนาด้วยข้อความทักทาย

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

ตัวอย่างการสร้างชิ้นงานโฆษณา

เพิ่มช่อง page_welcome_message ลงในชิ้นงานโฆษณาดังนี้

คำขอ

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

การตอบกลับ

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON พร้อม ID สำหรับชิ้นงานโฆษณาที่คุณสร้างขึ้นใหม่

{
  "id": "<AD_CREATIVE_ID>"
}

การสร้างชิ้นงานโฆษณาโดยใช้เนื้อหาบน Instagram

โพสต์บน Instagram

ดูรายละเอียดเพิ่มเติมได้ที่ "ใช้โพสต์เป็นโฆษณาบน Instagram"

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

รูปภาพบน Instagram

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

การสร้างชิ้นงานโฆษณาโดยใช้เนื้อหาบน Facebook

ดูรายละเอียดเพิ่มเติมได้ที่ "Instagramใช้โพสต์เป็นโฆษณาบน Instagram: โพสต์บน Facebook"

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

โดยที่ object_story_id คือ ID ของโพสต์ในรูปแบบ postOwnerID_postID และ instagram_actor_id คือ ID บัญชี Instagram ที่เชื่อมต่อกับเพจหรือ ID บัญชี Instagram ที่สนับสนุนเพจ โปรดดูรายละเอียดเพิ่มเติมใน "ตั้งค่าบัญชี Instagram ที่มีเพจ

การอัพเดต

คุณสามารถอัพเดตชิ้นงานโฆษณาโดยส่งคำขอ POST ไปยัง /<AD_CREATIVE_ID>

การอ่าน

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

คำขอ

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

การตอบกลับ

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

ขั้นตอนที่ 4: สร้างโฆษณา

โฆษณาช่วยให้คุณสามารถเชื่อมโยงข้อมูลชิ้นงานโฆษณากับชุดโฆษณาของคุณ หากต้องการสร้างโฆษณา ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/ads โดย <AD_ACCOUNT_ID> คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้

พารามิเตอร์

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

name

สตริง

จำเป็นต้องระบุ
ชื่อชิ้นงานโฆษณาของคุณ

adset_id

สตริงตัวเลขหรือจำนวนเต็ม

จำเป็นต้องระบุ
ID สำหรับชุดโฆษณา

creative

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

status

enum

จำเป็นต้องระบุ
สถานะที่ได้รับการกำหนดค่าของโฆษณา
ค่า:ACTIVEPAUSEDDELETEDARCHIVED

คำขอ

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

การตอบกลับ

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON พร้อม ID สำหรับโฆษณาที่สร้างขึ้นใหม่ของคุณ

{
  "id": "<AD_ID>"
}

การกระตุ้นให้ดำเนินการ

คุณสามารถตั้งค่าการกระตุ้นให้ดำเนินการขณะสร้างโฆษณาได้เช่นกัน

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบเกี่ยวกับข้อมูลจำเพาะของฟีดองค์ประกอบ

การอัพเดต

คุณสามารถอัพเดตโฆษณาโดยส่งคำขอ POST ไปยัง /<AD_ID>

การอ่าน

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

คำขอ

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

การตอบกลับ

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}