คู่มือนี้จะอธิบายวิธีสร้างและเผยแพร่โฆษณาที่คลิกไปยังหลายปลายทางโดยใช้ API การตลาด
โฆษณาที่คลิกไปยังหลายปลายทางจะนำผู้ที่คลิกโฆษณาของคุณเข้าสู่การสนทนากับธุรกิจของคุณโดยตรงในแอพส่งข้อความแอพหนึ่งหรือมากกว่านั้น (Messenger, Instagram หรือ WhatsApp) ที่ผู้คลิกมีแนวโน้มว่าจะตอบกลับมากที่สุด ใช้โฆษณาเหล่านี้เพื่อเข้าถึงผู้คนในวงกว้างและมอบบริการแบบเฉพาะบุคคลที่เหนือระดับ
โฆษณาหลายปลายทาง หมายความว่าโฆษณาสามารถนำผู้คลิกไปยังปลายทางร่วมกันแบบใดก็ได้ ไม่ว่าจะเป็นแชท Messenger, แชท Instagram, แชท WhatsApp
หากคุณต้องการสร้างโฆษณาที่นำไปยังปลายทางเดียวเท่านั้น โปรดดูเพิ่มเติมดังต่อไปนี้
เอกสารนี้สรุปขั้นตอนที่คุณต้องปฏิบัติตามเพื่อตั้งค่าการผสานการทำงานของโฆษณาที่คลิกไปยังหลายปลายทาง คุณต้องดำเนินการต่อไปนี้
คู่มือนี้เขียนขึ้นโดยถือว่าคุณมีและดำเนินการต่อไปนี้แล้ว
เริ่มต้นด้วยการสร้างแคมเปญโฆษณาของคุณ วิธีดำเนินการคือ ส่งคำขอ POST
ไปยัง ตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/campaigns
โดย <AD_ACCOUNT_ID>
คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้
ชื่อ | คำอธิบาย |
---|---|
สตริง | จำเป็นต้องระบุ |
enum | จำเป็นต้องระบุ |
ลิสต์<Object> | จำเป็นต้องระบุ |
enum | ระบุหรือไม่ก็ได้ |
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>" }
เมื่อคุณมีแคมเปญโฆษณาแล้ว ให้สร้างชุดโฆษณาของคุณ หากต้องการสร้างชุดโฆษณา ให้ส่งคำขอ POST
ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/adsets
ที่ซึ่ง <AD_ACCOUNT_ID>
คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้
ชื่อ | คำอธิบาย |
---|---|
int32 ที่ไม่ได้ลงนาม | จำเป็นต้องระบุ หากตั้งค่า bid_strategy (กลยุทธ์การประมูล) เป็น |
enum | ระบุหรือไม่ก็ได้ |
enum | จำเป็นต้องระบุ |
สตริงตัวเลขหรือจำนวนเต็ม | จำเป็นต้องระบุ |
จำนวนเต็มแบบ 64 บิต | จำเป็นต้องระบุ หากไม่ได้ตั้งค่า |
สตริง | จำเป็นต้องระบุ
หมายเหตุ: หากคุณใส่ WhatsApp ไว้ในปลายทาง โปรดตรวจสอบให้แน่ใจว่าคุณเชื่อมหมายเลขธุรกิจ WhatsApp เข้ากับเพจของคุณแล้ว หากคุณใส่ Instagram ไว้ในปลายทาง โปรดตรวจสอบให้แน่ใจว่าคุณเชื่อมบัญชีธุรกิจของ Instagram เข้ากับเพจของคุณแล้ว |
วันที่และเวลา | จำเป็นต้องระบุ เมื่อมีการระบุ |
จำนวนเต็มแบบ 64 บิต | จำเป็นต้องระบุ หากไม่ได้ตั้งค่า |
สตริง | จำเป็นต้องระบุ |
enum | จำเป็นต้องระบุ |
| จำเป็นต้องระบุ
ดูรายละเอียดเพิ่มเติมได้ที่ ชุดโฆษณา, อ็อบเจ็กต์ที่โปรโมท |
วันที่และเวลา | ระบุหรือไม่ก็ได้ |
enum | ระบุหรือไม่ก็ได้ |
อ็อบเจ็กต์การกำหนดเป้าหมาย | จำเป็นต้องระบุ |
วันที่และเวลา | ระบุหรือไม่ก็ได้ |
วันที่และเวลา | จำเป็นต้องระบุ เมื่อมีการระบุ |
ไปที่ข้อมูลอ้างอิงชุดโฆษณาบัญชีโฆษณาเพื่อดูรายการพารามิเตอร์ทั้งหมดที่สามารถใช้ได้
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>" }
ชิ้นงานโฆษณาช่วยให้คุณเพิ่มองค์ประกอบต่างๆ ลงในโฆษณาของคุณได้ หากต้องการสร้างชิ้นงานโฆษณา ให้ส่งคำขอ POST
ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/adcreatives
โดย <AD_ACCOUNT_ID>
คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ จำเป็นต้องระบุ:
Messenger { "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" } } |
สตริง | จำเป็นต้องระบุ |
| จำเป็นต้องระบุ จำเป็นต้องระบุ:
ระบุหรือไม่ก็ได้:
|
| ระบุหรือไม่ก็ได้ |
ไปที่ข้อมูลอ้างอิงชิ้นงานโฆษณาเพื่อดูรายการพารามิเตอร์ทั้งหมดที่สามารถใช้ได้
ข้อความเริ่มต้นที่ลูกค้าเห็นคือ "สวัสดี! ฉันขอข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้ได้ไหม" คุณสามารถสร้างประสบการณ์ผู้ใช้ที่ได้รับการปรับแต่งให้เหมาะกับโฆษณาของคุณที่คลิกไปยังหลายปลายทางมากขึ้นได้โดยการปรับแต่งข้อความทักทาย ประโยคเริ่มการโฆษณา หรือข้อความที่กรอกอัตโนมัติของโฆษณานั้นๆ ในช่อง page_welcome_message
ในส่วน object_story_spec
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับประโยคเริ่มการสนทนาที่ข้อมูลอ้างอิงเกี่ยวกับ ice_breakers
สร้างอ็อบเจ็กต์ 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"
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
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
ดูรายละเอียดเพิ่มเติมได้ที่ "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>" }
โฆษณาช่วยให้คุณสามารถเชื่อมโยงข้อมูลชิ้นงานโฆษณากับชุดโฆษณาของคุณ หากต้องการสร้างโฆษณา ให้ส่งคำขอ POST
ไปยังตำแหน่งข้อมูล /act_<AD_ACCOUNT_ID>/ads
โดย <AD_ACCOUNT_ID>
คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องประกอบด้วยสิ่งต่อไปนี้
ชื่อ | คำอธิบาย |
---|---|
สตริง | จำเป็นต้องระบุ |
สตริงตัวเลขหรือจำนวนเต็ม | จำเป็นต้องระบุ |
| จำเป็นต้องระบุ |
enum | จำเป็นต้องระบุ |
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>" }