แบบฟอร์มข้อมูลลูกค้าสำหรับโฆษณา

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

คุณต้องทำตามขั้นตอนเหล่านี้เพื่อสร้างและเผยแพร่โฆษณาแบบกรอกฟอร์ม

สร้างแคมเปญโฆษณา
สร้างชุดโฆษณาที่เชื่อมโยงโฆษณาเข้ากับแคมเปญโฆษณาของคุณ
สร้างแบบฟอร์มข้อมูลลูกค้า
สร้างชิ้นงานโฆษณาที่มีแบบฟอร์มข้อมูลลูกค้า
เชื่อมโยงแคมเปญและโฆษณาของคุณเพื่อสร้างโฆษณา
เผยแพร่โฆษณาของคุณ

ก่อนเริ่มต้น

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

คุณจำเป็นต้องมีสิ่งต่อไปนี้

สิทธิ์การอนุญาต ads_management
สิทธิ์การอนุญาต pages_manage_ads
สิทธิ์การอนุญาต pages_read_engagement
สิทธิ์การอนุญาต pages_show_list
โทเค็นการเข้าถึงเพจจากบุคคลที่สามารถดำเนินงาน ADVERTISE บนเพจได้

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

เมื่อต้องการสร้างแคมเปญสำหรับโฆษณาเพื่อการรวบรวมข้อมูลลูกค้า ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_AD_ACCOUNT_ID/campaigns ที่มีพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
buying_type ที่ตั้งเป็น AUCTION
name ที่ตั้งเป็นชื่อแคมเปญของคุณ
objective ที่ตั้งเป็น LEAD_GENERATION
special_ad_categories ที่ตั้งเป็น NONE หรือ หมวดหมู่โฆษณาพิเศษ
status ที่ตั้งเป็น PAUSED

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและตัวเอียง เช่น AD_ACCOUNT_ID ด้วยค่าของคุณ

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "buying_type":"AUCTION",
           "name":"Messenger_ad_campaign_name",
           "objective":"LEAD_GENERATION",
           "special_ad_categories":["NONE"],
           "status":"PAUSED"
         }'

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

{
  "id": "YOUR_CAMPAIGN_ID"
}

ไปที่ข้อมูลอ้างอิงเกี่ยวกับแคมเปญโฆษณา เพื่อเรียนรู้เพิ่มเติม

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

หากต้องการสร้างชุดโฆษณา ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล act_ad_account_id/adsets โดย ad_account_id คือ ID สำหรับบัญชีโฆษณา Meta ของคุณ คำขอของคุณต้องมีสิ่งต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
bid_amount ที่ตั้งเป็นจำนวนเงินสูงสุดที่คุณต้องการชำระ
billing_event ที่ตั้งค่าเป็น IMPRESSIONS
campaign_id ที่ตั้งเป็น ID สำหรับแคมเปญโฆษณาจากขั้นตอนที่ 1
daily_budget ที่ตั้งเป็นจำนวนที่คุณต้องการใช้จ่ายต่อวัน
name ที่ตั้งเป็นชื่อชื่อชุดโฆษณาของคุณ
optimization_goal ที่ตั้งเป็น LEAD_GENERATION หรือ QUALITY_LEAD
promoted_object – ตั้งค่าเป็น ID สำหรับเพจ Facebook ของธุรกิจของคุณ
status ที่ตั้งเป็น PAUSED

หมายเหตุ: หากคุณได้ตั้งค่าแหล่งข้อมูล CRM และเลือก QUALITY_LEAD เป็นเป้าหมายในการปรับให้เหมาะสม คุณสามารถเพิ่ม pixel_id ลงใน promoted_object เพื่อดำเนินการปรับคุณภาพให้เหมาะสมเพิ่มเติมได้ โปรดทราบว่าคุณไม่จำเป็นต้องระบุ pixel_rule ควบคู่กับ pixel_id

ตัวอย่างคำขอ

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"Your_page_access_token",
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "name:"YOUR_LEADADS_ADSET",
           "optimization_goal:LEAD_GENERATION",
           "promoted_object":"YOUR_PAGE_ID",
           "status:PAUSED"
         }'

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

{
  "id": "YOUR_ADSET_ID"
}

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

ขั้นตอนที่ 3 สร้างแบบฟอร์มข้อมูลลูกค้า

ในการสร้างแบบฟอร์ม ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE_ID/leadgen_forms ที่มีพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
name ที่ตั้งเป็นชื่อแบบฟอร์มของคุณ
questions ที่ตั้งเป็นอาร์เรย์อ็อบเจ็กต์ซึ่งระบุประเภทคำถามและลำดับการแสดงคำถามในแบบฟอร์ม โดยใช้พารามิเตอร์ key
- คำถามที่กำหนดเองโดยใช้พารามิเตอร์ label
- คำถามที่กำหนดเองโดยใช้พารามิเตอร์ options พร้อมรายการคำตอบแบบเมนูดร็อปดาวน์

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและเอียงด้วยค่าของคุณ

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_PAGE_ACCESS_TOKEN",
           "name": "YOUR_LEADADS_FORM_NAME",
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

แบบฟอร์มสำหรับการสนทนาใน Messenger

แบบฟอร์มที่คุณต้องการใช้ในโฆษณาในการสนทนาใน Messenger ต้องมีรายการดังต่อไปนี้

พารามิเตอร์ questions.type สามารถตั้งค่าเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
CUSTOM
EMAIL
FIRST_NAME
FULL_NAME
LAST_NAME
PHONE
หากแบบฟอร์มมี questions.type ที่ตั้งค่าเป็นค่าอื่นนอกเหนือจากที่ระบุไว้ แบบฟอร์มนั้นจะไม่มีสิทธิ์
ต้องตั้งค่าพารามิเตอร์ block_display_for_non_targeted_viewer เป็น false ซึ่งจะแสดงว่าแบบฟอร์มนี้เป็นการแชร์แบบเปิด

ตัวอย่างคำขอแบบฟอร์มข้อมูลลูกค้าใน Messenger ที่มีสิทธิ์

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "page_ACCESS_TOKEN"
           "block_display_for_non_targeted_viewer": "false"
           "name": "LeadAds Form for Messenger Conversation Name"
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

ประเภทคำถามเพิ่มเติม

นอกจากประเภทคำถามทั่วไปที่แสดงใน[ส่วนสร้างแบบฟอร์มข้อมูลลูกค้า]{#create-a-lead-form}แล้ว คุณยังเพิ่มประเภทคำถามที่เฉพาะเจาะจงสำหรับกรณีการใช้งานต่อไปนี้ได้อีกด้วย

การกำหนดเวลานัดหมาย - คำถามการกำหนดเวลานัดหมายจะแสดงตัวเลือกวันที่และเวลา พร้อมกับตัวเลือกชั่วโมงที่จำกัด และข้อความยืนยันด้านล่างคำถาม
หมายเลขบัตรประจำตัวประชาชนหรือหมายเลขที่รัฐบาลออกให้ – คำถามเกี่ยวกับหมายเลขบัตรประจำตัวประชาชนจะแสดงคำถามตามประเทศของบุคคลนั้นๆ และตรวจสอบรูปแบบของหมายเลขที่ป้อน
ตัวระบุตำแหน่งร้านค้า - คำถามเพื่อระบุตำแหน่งร้านค้าจะแสดงตัวเลือกตัวค้นหาร้านค้าตามรหัสไปรษณีย์ของบุคคลนั้นๆ หรือรหัสไปรษณีย์ที่กรอก

การกำหนดเวลานัดหมาย

คำถามการกำหนดเวลานัดหมายจะแสดงตัวเลือกวันที่และเวลา พร้อมกับตัวเลือกชั่วโมงที่จำกัด และข้อความยืนยันด้านล่างคำถาม

ในการเพิ่มคำถามการกำหนดเวลานัดหมาย ให้เพิ่มอ็อบเจ็กต์คำถามที่มีพารามิเตอร์ type ซึ่งตั้งเป็น DATE_TIME นอกจากนี้ยังสามารถเพิ่มข้อความยืนยันในพารามิเตอร์ inline_context ได้อีกด้วย ซึ่งจะแสดงด้านล่างช่องคำถามโดยตรงเป็นบริบทเพิ่มเติม หากต้องการ

...
           "questions": "[
               ...
               {"type": "DATE_TIME", 
                "label": "Appointment time", 
                "inline_context": "We will verify and call you to confirm your appointment."
               },
...

หมายเลขบัตรประจำตัวประชาชน

คำถามเกี่ยวกับหมายเลขบัตรประจำตัวประชาชนจะแสดงคำถามตามประเทศของบุคคลนั้นๆ และตรวจสอบรูปแบบของหมายเลขที่ป้อน คำถามนี้อาจแสดงกับประเทศต่อไปนี้

อาร์เจนตินา - {"type": "ID_AR_DNI"}
บราซิล - ID_CPF
ชิลี - ID_CL_RUT
โคลอมเบีย - ID_CO_CC
เอกวาดอร์ - ID_EC_CI
เปรู - ID_PE_DNI

ในการเพิ่มคำถามเกี่ยวกับหมายเลขประจำตัวประชาชน ให้เพิ่มอ็อบเจ็กต์คำถามที่มีพารามิเตอร์ type ซึ่งตั้งเป็นประเภทประเทศของบุคคล

ข้อจำกัด

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

...
           "questions": "[
               ...
               {"type": "ID_AR_DNI"
               },
...

ตัวระบุตำแหน่งร้านค้า

คำถามเพื่อระบุตำแหน่งร้านค้าจะแสดงตัวเลือกตัวค้นหาร้านค้าตามรหัสไปรษณีย์ของบุคคลนั้นๆ หรือรหัสไปรษณีย์ที่กรอก

คุณต้องตั้งโครงสร้างเพจร้านค้าเพื่อใช้คำถามนี้ เรียนรู้วิธีในตั้งค่าโครงสร้างเพจร้านค้าบน Facebook - ศูนย์ช่วยเหลือทางธุรกิจของ Meta

หากต้องการเพิ่มคำถามเพื่อระบุตำแหน่งร้านค้า ให้เพิ่มอ็อบเจ็กต์คำถามที่มีพารามิเตอร์ type ซึ่งตั้งเป็น STORE_LOOKUP และพารามิเตอร์ STORE_LOOKUP ที่ตั้งเป็น LOCATION_MANAGER

...
           "questions": "[
               ...
               {"type": "STORE_LOOKUP", 
                "label": "Which store do you want to visit?", 
                "context_provider_type": "LOCATION_MANAGER"
               },
...

การตั้งค่าแบบฟอร์มขั้นสูง

รับข้อมูลลูกค้าที่มีคุณภาพสูงขึ้นโดยเพิ่มการตั้งค่าแบบฟอร์มต่อไปนี้อย่างน้อยหนึ่งรายการ

การติดตามประสิทธิภาพของแบบฟอร์มเพื่อติดตามแหล่งที่มาของข้อมูลลูกค้า
แบบฟอร์มแบบเน้นความตั้งใจเพื่อเพิ่มการตรวจสอบและยืนยันขั้นตอนในกระบวนการของแบบฟอร์ม
การคัดกรองข้อมูลลูกค้าแบบออร์แกนิกเพื่อคัดกรองข้อมูลลูกค้าแบบออร์แกนิก

เพิ่มการติดตามประสิทธิภาพ

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

ตัวอย่างคำขอ

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "tracking_parameters": {"your_tracking_parameter_name":"your_tracking_parameter_value"},
           "questions": "[
...

เพิ่มการตั้งค่าแบบเน้นความตั้งใจ

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

หากต้องการเพิ่มขั้นตอนการยืนยันนี้ลงในแบบฟอร์ม ให้เพิ่มพารามิเตอร์ is_optimized_for_quality ที่ตั้งค่าเป็น true เมื่อสร้างแบบฟอร์ม

ตัวอย่างคำขอ

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "is_optimized_for_quality": "true",
           "questions": "[
...

คัดกรองข้อมูลลูกค้าแบบออร์แกนิก

เมื่อต้องการคัดกรองข้อมูลลูกค้าแบบออร์แกนิก ให้เพิ่มพารามิเตอร์ block_display_for_non_targeted_viewer ไปยัง true เมื่อคุณสร้างแบบฟอร์ม

ตัวอย่างคำขอ

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "block_display_for_non_targeted_viewer": "true",
           "questions": "[
...

ตัวอย่างการตอบกลับ

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

{
  "id": "leadgen_form_id",
}

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

เมื่อต้องการสร้างชิ้นงานโฆษณาที่มีรูปภาพและแบบฟอร์มของคุณ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_AD_ACCOUNT_ID/adcreatives ที่มีพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
object_story_spec ที่มีอ็อบเจ็กต์ link_data ที่มีพารามิเตอร์ต่อไปนี้
- call_to_action ที่ตั้งเป็นอ็อบเจ็กต์ที่มี type และ value ที่ตั้งเป็น ID แบบฟอร์มข้อมูลลูกค้าของคุณ
- description ที่ตั้งเป็นคำอธิบายสำหรับชิ้นงานโฆษณาของคุณ
- image_hash ที่ตั้งเป็นแฮชสำหรับรูปภาพสำหรับชิ้นงานโฆษณาของคุณ
- link_url ที่ตั้งเป็น URL ของคุณ โดยที่จะต้องไม่ใช่เพจ Facebook ของคุณ
- message ที่ตั้งเป็นข้อความสำหรับชิ้นงานโฆษณาของคุณ
page_id ที่ตั้งเป็น ID เพจ Facebook ของคุณ

หมายเหตุ: ขณะสร้าง link_data ค่าที่เชื่อมโยงกับช่อง link ต้องเป็น https//fb.me/ เท่านั้น

พารามิเตอร์ link_data.call_to_action จะต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

APPLY_NOW
DOWNLOAD
GET_QUOTE
LEARN_MORE
SIGN_UP
SUBSCRIBE

ตัวอย่างคำขอ

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/act_AD_ACCOUNT_ID/adcreatives" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "object_story_spec":{ 
             "link_data": { 
               "call_to_action": {
                 "type":"SIGN_UP",
                 "value":{
                   "lead_gen_form_id":"YOUR_FORM_ID"
                 }
               }, 
               "description": "YOUR_AD_CREATIVE_DESCRIPTION", 
               "image_hash": "YOUR_IMAGE_HASH", 
               "link": "http:\/\/fb.me\/", 
               "message": "YOUR_AD_CREATIVE_MESSAGE" 
             }, 
           "page_id": "YOUR_PAGE_ID" 
         }'

โฆษณาแบบภาพสไลด์

คุณสามารถสร้างโฆษณาแบบกรอกฟอร์มแบบภาพสไลด์ได้โดยใช้ object_story_spec เดียวกัน แต่มีช่อง lead_gen_form_id เพิ่มเติมที่กำหนดไว้ในพารามิเตอร์ child_attachments

คุณสามารถระบุได้เฉพาะ <FORM_ID> แบบเดียวกันสำหรับไฟล์แนบรองทั้งหมด

curl \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "link_data": { 
      "message": "My description", 
      "link": "http:\/\/www.google.com", 
      "caption": "WWW.EXAMPLE.COM", 
      "child_attachments": [ 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        } 
      ], 
      "multi_share_optimized": true, 
      "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/act_<AD_ACCOUNT_ID>/adcreatives

โฆษณาแบบวิดีโอ

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

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "link_description": "try it out",
         "image_url": "<IMAGE_URL>",
         "video_id": "<VIDEO_ID>",
         "call_to_action": {
           "type": "SIGN_UP",
           "value": {
             "link": "http://fb.me/",
             "lead_gen_form_id": "<FORM_ID>"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

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

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

{
  "id": "YOUR_AD_CREATIVE_ID"
}

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

หากต้องการสร้างโฆษณา คุณจำเป็นต้องเชื่อมโยงชิ้นงานโฆษณาและชุดโฆษณา เมื่อต้องการสร้างโฆษณา ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /act_AD_ACCOUNT_ID/ads คำขอของคุณต้องมีสิ่งต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
adset_id (จากขั้นตอนที่ 2)
creative_id (จากขั้นตอนที่ 4)
ชื่อ
สถานะ

ตัวอย่างคำขอสำหรับโฆษณาที่มีชิ้นงานโฆษณา

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token"="YOUR_PAGE_ACCESS_TOKEN",
           "adset_id"="YOUR_AD_SET_ID",
           "creative"={ "creative_id": "YOUR_AD_CREATIVE_ID" },
           "status"="PAUSED"
         }'

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

{
  "id": "YOUR_AD_ID"
}

ขั้นตอนที่ 6 เผยแพร่โฆษณาของคุณ

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

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

Meta จะตรวจสอบโฆษณาของคุณ และสถานะจะเป็น PENDING_REVIEW เมื่อได้รับอนุมัติแล้ว สถานะก็จะเป็น ACTIVE และระบบจะแสดงโฆษณาของคุณ

การจัดการแบบฟอร์ม

เรียกดูรายการแบบฟอร์ม คำถามเกี่ยวกับแบบฟอร์ม และจัดเก็บแบบฟอร์มเก่าๆ ของคุณ

เรียกดูรายการแบบฟอร์ม

หากต้องการดึงข้อมูลรายการแบบฟอร์มการสร้างข้อมูลลูกค้า ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /page_id/leadgen_forms พร้อมพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
fields (มีหรือไม่ก็ได้) ที่ตั้งเป็นรายการช่องที่คั่นด้วยเครื่องหมายจุลภาคเพื่อรับข้อมูลที่เฉพาะเจาะจง เช่น ชื่อและ ID แบบฟอร์ม

ตัวอย่างคำขอ

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=name,id
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

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

ดึงข้อมูลรายการแบบฟอร์มที่มีสิทธิ์สำหรับ Messenger

เฉพาะแบบฟอร์มที่มีข้อกำหนดที่เฉพาะเจาะจงเท่านั้นที่มีสิทธิ์ได้รับการส่งในการสนทนาใน Messenger

หากต้องการดึงข้อมูลรายการแบบฟอร์มข้อมูลลูกค้าที่มีสิทธิ์ ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /page_id/leadgen_forms พร้อมพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
fields ที่ตั้งเป็น is_eligible_for_in_thread_forms

ตัวอย่างคำขอ

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=is_eligible_for_in_thread_forms
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

เมื่อดำเนินการเสร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ที่มีรายการ ID แบบฟอร์มที่มีสิทธิ์อยู่

{
  "data": [
    {
      "id": "eligible_form_1_id"
    },
    {
      "id": "eligible_form_2_id"
    }
  ],
...
}

ดึงข้อมูลรายการคำถาม

หากต้องการดึงข้อมูลรายการคำถามสำหรับแบบฟอร์มการสร้างข้อมูลลูกค้าที่เฉพาะเจาะจง ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /page_id/leadgen_form_id พร้อมพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
fields ที่ตั้งเป็น questions

ตัวอย่างคำขอ

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?fields=questions
    &access_token=page_access_token"

เมื่อดำเนินการเสร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ที่มีรายการคำถามของคุณอยู่

จัดเก็บแบบฟอร์ม

คุณจะสามารถจัดเก็บแบบฟอร์มได้ก็ต่อเมื่อระบบไม่รองรับการลบเท่านั้น เมื่อแบบฟอร์มได้รับการจัดเก็บ

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

หากต้องการจัดเก็บแบบฟอร์มการสร้างข้อมูลลูกค้าที่เฉพาะเจาะจง ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /page_id/leadgen_form_id พร้อมพารามิเตอร์ต่อไปนี้

access_token ที่ตั้งเป็นโทเค็นการเข้าถึงเพจของคุณ
status ที่ตั้งเป็น ARCHIVED

ตัวอย่างคำขอ

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

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

คุณสามารถเปิดใช้งานแบบฟอร์มที่จัดเก็บได้อีกครั้งโดยส่งคำขอที่มี status ซึ่งตั้งเป็น ACTIVE

เพิ่มแบบฟอร์มลงในเว็บไซต์ของคุณ

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

ข้อจำกัด

ระบบไม่รองรับกล่องโต้ตอบนี้ในอุปกรณ์มือถือ

โปรดสังเกตว่า act_ นั้นไม่อยู่ในค่า ad_account_id

ตัวอย่าง SDK

แทนที่ค่าที่เป็นตัวหนาและเอียงด้วยค่าของคุณ


FB.ui({
  method: 'lead_gen',
  page_id: YOUR_PAGE_ID,
  ad_account_id: AD_ACCOUNT_ID, 
}, function(response) {
...
});

การตอบกลับการเรียกกลับที่คุณจะได้รับจะมีข้อมูลเกี่ยวกับแบบฟอร์ม

{
  follow_up_action_text: "YOUR_FOLLOW_UP_ACTION_TEXT",
  follow_up_action_url: "YOUR_FOLLOW_UP_ACTION_URL",
  formID: YOUR_FORM_ID,
  form_url: "YOUR_FORM_URL",
  is_tcpa_compliant: false,
  name: "YOUR_FORM_NAME",
  pageID: YOUR_PAGE_ID,
  privacy_policy_url: "YOUR_PRIVACY_POLICY_URL",
  status: "success"
}

คุณสมบัติการตอบกลับ

ชื่อ	คำอธิบาย
สตริง`custom_disclaimer_responses`	การตอบกลับกล่องกาเครื่องหมายข้อจำกัดความรับผิดชอบที่กำหนดเอง
สตริง`follow_up_action_text`	คำบรรยายของข้อความดำเนินการติดตามในหน้าสุดท้ายของแบบฟอร์ม
สตริง`follow_up_action_url`	ปลายทางของข้อความดำเนินการติดตามในหน้าสุดท้ายของแบบฟอร์ม
สตริง`formID`	จำเป็นต้องระบุ ID ของแบบฟอร์ม
สตริง`form_url`	URL ที่ไปยังแบบฟอร์ม
สตริง`name`	ชื่อของแบบฟอร์ม
สตริง`pageID`	ID ของหน้าซึ่งเป็นของแบบฟอร์มนี้
สตริง`privacy_policy_url`	URL นโยบายความเป็นส่วนตัวที่มี
สตริง`status`	ส่งคืน `success` เมื่อสร้างแบบฟอร์มแล้ว

หากคุณยกเลิกการสร้าง คุณจะเห็นข้อมูลต่อไปนี้

{
  error_code: 4201,
  error_message: "User canceled the Dialog flow"
}

ดูเพิ่มเติม

ไปที่คำแนะนำอื่นๆ ของเราเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับส่วนประกอบต่างๆ ในเอกสารนี้

แบบฟอร์มข้อมูลลูกค้าสำหรับโฆษณา

ก่อนเริ่มต้น

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

ตัวอย่างคำขอ

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

ตัวอย่างคำขอ

ขั้นตอนที่ 3 สร้างแบบฟอร์มข้อมูลลูกค้า

ตัวอย่างคำขอ

แบบฟอร์มสำหรับการสนทนาใน Messenger

ตัวอย่างคำขอแบบฟอร์มข้อมูลลูกค้าใน Messenger ที่มีสิทธิ์

ประเภทคำถามเพิ่มเติม

การกำหนดเวลานัดหมาย

หมายเลขบัตรประจำตัวประชาชน

ข้อจำกัด

ตัวระบุตำแหน่งร้านค้า

การตั้งค่าแบบฟอร์มขั้นสูง

เพิ่มการติดตามประสิทธิภาพ

ตัวอย่างคำขอ

เพิ่มการตั้งค่าแบบเน้นความตั้งใจ

ตัวอย่างคำขอ

คัดกรองข้อมูลลูกค้าแบบออร์แกนิก

ตัวอย่างคำขอ

ตัวอย่างการตอบกลับ

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

ตัวอย่างคำขอ

โฆษณาแบบภาพสไลด์

โฆษณาแบบวิดีโอ

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

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

ตัวอย่างคำขอสำหรับโฆษณาที่มีชิ้นงานโฆษณา

ขั้นตอนที่ 6 เผยแพร่โฆษณาของคุณ

การจัดการแบบฟอร์ม

เรียกดูรายการแบบฟอร์ม

ตัวอย่างคำขอ

ดึงข้อมูลรายการแบบฟอร์มที่มีสิทธิ์สำหรับ Messenger

ตัวอย่างคำขอ

ดึงข้อมูลรายการคำถาม

ตัวอย่างคำขอ

จัดเก็บแบบฟอร์ม

ตัวอย่างคำขอ

เพิ่มแบบฟอร์มลงในเว็บไซต์ของคุณ

ข้อจำกัด

ตัวอย่าง SDK

คุณสมบัติการตอบกลับ

ดูเพิ่มเติม

เอกสารของผู้พัฒนา API การตลาด

ศูนย์ช่วยเหลือทางธุรกิจของ Meta