event_nameสตริง | จำเป็นต้องระบุ
ชื่อของเหตุการณ์มาตรฐานหรือเหตุการณ์ที่กำหนดเอง ช่องนี้ใช้เพื่อลบเหตุการณ์ที่ซ้ำกันซึ่งส่งมาจากทั้งเว็บ (ผ่านพิกเซลของ Meta) หรือแอพ (ผ่าน SDK หรือ API เหตุการณ์ในแอพ) และ API คอนเวอร์ชั่น นอกจากนี้ยังสามารถใช้พารามิเตอร์ event_id เพื่อลบรายการที่ซ้ำกันได้อีกด้วย
ในกรณีที่เป็นการดำเนินการของลูกค้าแบบเดียวกัน event จากเหตุการณ์ในเบราว์เซอร์หรือเหตุการณ์ในแอพจะตรงกับ event_name จากเหตุการณ์เซิร์ฟเวอร์ หากเราพบรายการที่ตรงกันระหว่างเหตุการณ์ที่ส่งห่างกันไม่เกิน 48 ชั่วโมง เราจะพิจารณาเฉพาะเหตุการณ์แรก แต่หากได้รับเหตุการณ์เซิร์ฟเวอร์และเหตุการณ์ในเบราว์เซอร์/แอพในเวลาไล่เลี่ยกัน (กล่าวคือ ห่างกันไม่เกิน 5 นาที) เราจะเลือกเหตุการณ์ในเบราว์เซอร์/แอพ เรียนรู้เพิ่มเติมเกี่ยวกับการลบเหตุการณ์พิกเซลและเหตุการณ์เซิร์ฟเวอร์ที่ซ้ำกัน |
event_timeจำนวนเต็ม | จำเป็นต้องระบุ
การประทับเวลา Unix เป็นจำนวนวินาที ซึ่งระบุถึงเวลาที่เหตุการณ์จริงเกิดขึ้น ทั้งนี้ เวลาดังกล่าวอาจเกิดขึ้นก่อนเวลาที่คุณส่งเหตุการณ์ไปยัง Facebook เพื่อให้สามารถปรับการประมวลผลแบบแบตช์และประสิทธิภาพของเซิร์ฟเวอร์ให้เหมาะสม โดยคุณต้องส่งวันที่นี้ในรูปแบบโซนเวลา GMT
event_time อาจอยู่ได้ถึง 7 วัน ก่อนที่คุณจะส่งเหตุการณ์ไปยัง Facebook หาก event_time ใน data ผ่านมาแล้วมากกว่า 7 วัน เราจะส่งคืนข้อผิดพลาดสำหรับคำขอทั้งหมด และจะไม่ประมวลผลเหตุการณ์
|
user_dataอ็อบเจ็กต์ | จำเป็นต้องระบุ
แผนที่ซึ่งประกอบด้วยข้อมูลลูกค้า โปรดดูพารามิเตอร์ข้อมูลลูกค้าเพื่อค้นหาตัวเลือก และดูการจับคู่ขั้นสูงเพื่อค้นหาตัวเลือกที่เทียบเท่าซึ่งสามารถใช้กับข้อมูลที่ส่งทางพิกเซลของ Meta |
custom_dataอ็อบเจ็กต์ | ระบุหรือไม่ก็ได้
แผนที่ซึ่งมีข้อมูลทางธุรกิจเพิ่มเติมเกี่ยวกับเหตุการณ์รวมอยู่ด้วย ดูข้อมูลเพิ่มเติมที่พารามิเตอร์ข้อมูลที่กำหนดเอง |
event_source_urlสตริง | ระบุหรือไม่ก็ได้
URL ของเบราว์เซอร์ที่เหตุการณ์นั้นๆ เกิดขึ้น URL ควรจะตรงกับโดเมนที่ตรวจสอบยืนยันแล้ว
หมายเหตุ: คุณจะต้องระบุ event_source_url สำหรับเหตุการณ์บนเว็บไซต์ที่แชร์โดยใช้ API คอนเวอร์ชั่น |
opt_outบูลีน | ระบุหรือไม่ก็ได้
การรายงานปัญหาที่ระบุว่าเราไม่ควรใช้เหตุการณ์นี้เพื่อปรับการแสดงโฆษณาให้เหมาะสม หากตั้งค่าเป็น true เราจะใช้เหตุการณ์เพื่อระบุที่มาเท่านั้น |
event_idสตริง | ระบุหรือไม่ก็ได้
ID นี้อาจเป็นสตริงใดก็ได้ที่ไม่ซ้ำกันซึ่งเลือกโดยผู้ลงโฆษณา พารามิเตอร์ event_id และ event_name ใช้เพื่อลบเหตุการณ์ที่ซ้ำกันซึ่งส่งมาจากทั้งเว็บ (ผ่านพิกเซลของ Meta) หรือแอพ (ผ่าน SDK หรือ API เหตุการณ์ในแอพ) และ API คอนเวอร์ชั่น โปรดทราบว่า แม้จะกำหนด event_id เป็นพารามิเตอร์ที่ระบุหรือไม่ก็ได้ แต่เราขอแนะนำให้คุณระบุเพื่อลบเหตุการณ์ที่ซ้ำกัน
ในกรณีที่ต้องการลบเหตุการณ์ที่ซ้ำกัน eventID จากเหตุการณ์ในเบราว์เซอร์หรือแอพจะต้องตรงกับ event_id ที่อยู่ในเหตุการณ์เซิร์ฟเวอร์ที่เกี่ยวข้อง โปรดเรียนรู้เพิ่มเติมเกี่ยวกับการจัดการกับเหตุการณ์พิกเซลและเหตุการณ์ API คอนเวอร์ชั่นที่ซ้ำกัน
หมายเลขคำสั่งซื้อหรือ ID ธุรกรรมคือตัวระบุ 2 รายการที่ใช้ได้ ซึ่งสามารถใช้กับ event_id ได้ ตัวอย่างเช่น หากลูกค้าทำการซื้อ 2 ครั้งบนเว็บไซต์ของคุณโดยมีหมายเลขคำสั่งซื้อเป็น 123 และ 456 การเรียกใช้ API คอนเวอร์ชั่นแต่ละครั้งจำเป็นจะต้องใส่หมายเลขคำสั่งซื้อของรายการนั้นๆ ใน event_id ด้วย ซึ่งจะช่วยให้เราสามารถแยกแยะเหตุการณ์การซื้อ 2 ครั้งนี้เป็นคำสั่งซื้อที่แยกกันได้อย่างเหมาะสม นอกจากนี้ เหตุการณ์การซื้อที่สอดคล้องกัน 2 ครั้งในพิกเซลบนเบราว์เซอร์ยังจำเป็นต้องส่งหมายเลขคำสั่งซื้อเดียวกันในพารามิเตอร์ eventID ด้วย เพื่อให้เราเข้าใจว่ามีเหตุการณ์เกิดขึ้นเพียง 2 ครั้ง ไม่ใช่การซื้อที่ไม่ซ้ำกัน 4 ครั้ง
ในกรณีที่เป็นเหตุการณ์อื่นที่ไม่มีหมายเลข ID มาด้วย คุณสามารถใช้หมายเลขแบบสุ่ม (ตราบเท่าที่มีการส่งหมายเลขแบบสุ่มเดียวกันนี้ระหว่างเหตุการณ์บนเบราว์เซอร์กับเหตุการณ์เซิร์ฟเวอร์) แทนได้ |
action_sourceสตริง | จำเป็นต้องระบุ
ช่องนี้ช่วยให้คุณสามารถระบุตำแหน่งที่เกิดคอนเวอร์ชั่นได้ การทราบว่าเหตุการณ์ของคุณเกิดขึ้นที่ใด จะช่วยให้โฆษณาของคุณเข้าถึงกลุ่มคนที่เหมาะสม เมื่อคุณใช้ API คอนเวอร์ชั่น แสดงว่าคุณยอมรับว่าพารามิเตอร์ action_source นั้นถูกต้องเท่าที่คุณทราบ
ค่าที่คุณสามารถส่งในช่อง action_source มีดังนี้
email — คอนเวอร์ชั่นเกิดขึ้นทางอีเมล
website — คอนเวอร์ชั่นเกิดขึ้นบนเว็บไซต์ของคุณ
app — คอนเวอร์ชั่นเกิดขึ้นบนแอพมือถือของคุณ
phone_call — คอนเวอร์ชั่นเกิดขึ้นทางโทรศัพท์
chat — คอนเวอร์ชั่นเกิดขึ้นผ่านทางแอพส่งข้อความ, SMS หรือฟีเจอร์การส่งข้อความออนไลน์
physical_store — คอนเวอร์ชั่นเกิดขึ้นผ่านการติดต่อที่หน้าร้านของคุณโดยตรง
system_generated — คอนเวอร์ชั่นเกิดขึ้นโดยอัตโนมัติ เช่น การต่ออายุการสมัครใช้บริการที่ตั้งค่าให้จ่ายเงินแต่ละเดือนแบบอัตโนมัติ
business_messaging — คอนเวอร์ชั่นเกิดขึ้นจากโฆษณาที่คลิกไปยัง Messenger, Instagram หรือ WhatsApp
other — คอนเวอร์ชั่นเกิดขึ้นในลักษณะอื่นที่ไม่ได้ระบุตามข้างต้น
หมายเหตุ: ค่าแหล่งที่มาของการดำเนินการทั้งหมดจะช่วยให้สามารถวัดผลโฆษณาและสร้างกลุ่มเป้าหมายที่กำหนดเองได้ แหล่งที่มาของการดำเนินการทั้งหมดยกเว้น physical_store จะช่วยให้สามารถปรับโฆษณาให้เหมาะสมได้ |
data_processing_optionsอาร์เรย์ | ระบุหรือไม่ก็ได้
ตัวเลือกการประมวลผลที่คุณต้องการเปิดใช้งานสำหรับเหตุการณ์ใดเหตุการณ์หนึ่ง ค่าที่ยอมรับในปัจจุบันคือ LDU ซึ่งหมายถึง "การใช้ข้อมูลแบบจำกัด" ทั้งนี้ สามารถส่งอาร์เรย์เปล่าเพื่อระบุอย่างชัดแจ้งว่าไม่ควรประมวลผลเหตุการณ์นี้ด้วยข้อจำกัดแบบ "การใช้ข้อมูลแบบจำกัด" โปรดเรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกการประมวลผลข้อมูล โปรดดูตัวอย่างการนำ API คอนเวอร์ชั่นไปใช้งาน |
data_processing_options_countryจำนวนเต็ม | จำเป็นต้องระบุ หากคุณส่ง LDU ภายใต้ data_processing_options
ประเทศที่คุณต้องการเชื่อมโยงกับตัวเลือกการประมวลผลข้อมูลนี้ ค่าที่ยอมรับในปัจจุบัน ได้แก่ 1 ซึ่งหมายถึงสหรัฐอเมริกา หรือ 0 เพื่อส่งคำขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น เรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกการประมวลผลข้อมูล โปรดดูตัวอย่างการนำ API คอนเวอร์ชั่นไปใช้งาน |
data_processing_options_stateจำนวนเต็ม | จำเป็นต้องระบุในบางกรณี (โปรดดูรายละเอียดที่หมายเหตุด้านล่าง)
รัฐที่คุณต้องการเชื่อมโยงกับตัวเลือกการประมวลผลข้อมูลนี้ ค่าที่ยอมรับในปัจจุบัน ได้แก่ 1000 ซึ่งหมายถึงรัฐแคลิฟอร์เนีย หรือ 0 เพื่อส่งคำขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
หมายเหตุ: หากคุณกำหนดประเทศ คุณจะต้องกำหนดรัฐด้วย มิฉะนั้น เราจะใช้ตรรกะการกำหนดตำแหน่งทางภูมิศาสตร์กับเหตุการณ์ทั้งหมด คุณต้องระบุข้อมูลในช่องนี้ หากส่ง LDU ภายใต้ data_processing_options และไม่ได้ระบุที่อยู่ IP
เรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกการประมวลผลข้อมูล โปรดดูตัวอย่างการนำ API คอนเวอร์ชั่นไปใช้งาน |
app_data
อ็อบเจ็กต์ | จำเป็นต้องระบุสำหรับเหตุการณ์ในแอพ พารามิเตอร์สำหรับการแชร์ข้อมูลแอพและข้อมูลอุปกรณ์ด้วย API คอนเวอร์ชั่น extinfo เป็นพารามิเตอร์ย่อยของ app_data
|
extinfo
อ็อบเจ็กต์ | จำเป็นต้องระบุสำหรับเหตุการณ์ในแอพ
ข้อมูลอุปกรณ์เพิ่มเติม เช่น ความกว้างและความสูงของหน้าจอ พารามิเตอร์นี้เป็นอาร์เรย์และค่าต่างๆ ซึ่งคั่นด้วยเครื่องหมายจุลภาค เมื่อใช้ extinfo คุณต้องระบุค่าให้ครบทั้งหมด และค่าเหล่านี้จะต้องเรียงตามลำดับที่ทำดัชนีไว้ด้านล่าง หากมีค่าหนึ่งหายไป ให้เติมสตริงเปล่าเข้าไปเป็นตัวยึดตำแหน่ง
หมายเหตุ:
version ต้องเป็น a2 สำหรับ Android
version ต้องเป็น i2 สำหรับ iOS
|
0
สตริง | ต้องระบุ เวอร์ชั่น extinfo
ตัวอย่าง: i2 |
1
สตริง | ชื่อแพ็คเกจแอพ
ตัวอย่าง: com.facebook.sdk.samples.hellofacebook |
2
สตริง | เวอร์ชั่นแบบสั้น (จำนวนเต็มหรือสตริง)
ตัวอย่าง: 1.0 |
3
สตริง | เวอร์ชั่นแบบยาว
ตัวอย่าง: 1.0 long |
4
สตริง | ต้องระบุ เวอร์ชั่นของระบบปฏิบัติการ
ตัวอย่าง: 13.4.1 |
5
สตริง | ชื่อรุ่นของอุปกรณ์
ตัวอย่าง: iPhone5,1 |
6
สตริง | รูปแบบภาษา
ตัวอย่าง: En_US |
7
สตริง | ตัวย่อของโซนเวลา
ตัวอย่าง: PDT |
8
สตริง | ผู้ให้บริการ
ตัวอย่าง: AT&T |
9
int64 | ความกว้างของหน้าจอ
ตัวอย่าง: 320 |
10
int64 | ความสูงของหน้าจอ
ตัวอย่าง: 568 |
11
สตริง | ความหนาแน่นของหน้าจอ
ตัวอย่าง: 2 |
12
int64 | จำนวน Core ของ CPU
ตัวอย่าง: 2 |
13
int64 | ขนาดพื้นที่เก็บข้อมูลภายนอก โดยมีหน่วยเป็น GB
ตัวอย่าง: 13 |
14
int64 | พื้นที่ว่างบนพื้นที่เก็บข้อมูลภายนอก โดยมีหน่วยเป็น GB
ตัวอย่าง: 8 |
15
สตริง | โซนเวลาของอุปกรณ์
ตัวอย่าง: USA/New York |
referrer_urlสตริง | ระบุหรือไม่ก็ได้
HTTP จะอ้างอิงถึงส่วนหัวตามที่สังเกตได้จากหน้าที่ทริกเกอร์เหตุการณ์ API คอนเวอร์ชั่นหรือพิกเซลของ Meta ซึ่งโดยปกติแล้ว จะเป็นหน้าก่อนหน้าในเบราว์เซอร์ |
original_event_dataอ็อบเจ็กต์ | ระบุหรือไม่ก็ได้
ช่องเมตาดาต้าทั้งหมดที่ผู้ลงโฆษณาสามารถใช้เพื่อระบุลักษณะที่เหตุการณ์ "ที่ล่าช้า" เชื่อมโยงกับเหตุการณ์การหาลูกค้าในอดีต เราขอแนะนำอย่างยิ่งว่าให้ใช้ original_event_data เมื่อมีความล่าช้าเกิดขึ้นระหว่างเวลาที่ส่งเหตุการณ์กับเหตุการณ์การหาลูกค้าในอดีตที่เหตุการณ์นั้นๆ เชื่อมโยงอยู่ โปรดดูข้อมูลเพิ่มเติมที่พารามิเตอร์ข้อมูลเหตุการณ์เดิม |
