พารามิเตอร์ข้อมูลลูกค้า

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

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

โปรดเข้าชมคู่มือความเป็นส่วนตัวและการใช้ข้อมูลของ Meta เพื่อเรียนรู้ว่ามีการส่งข้อมูลอะไรบ้างเมื่อใช้ API คอนเวอร์ชั่น

ระบบของเราได้รับการออกแบบมาไม่ให้ยอมรับข้อมูลลูกค้าที่เป็นข้อมูลติดต่อที่ไม่มีการแฮช เว้นแต่มีการระบุไว้ด้านล่าง ข้อมูลติดต่อคือข้อมูลที่ระบุตัวบุคคล เช่น ชื่อ อีเมล และหมายเลขโทรศัพท์ที่เราใช้ในการจับคู่เท่านั้น หากคุณกำลังใช้ Meta Business SDK ระบบจะแฮชข้อมูลโดยอัตโนมัติ

การเปรียบเทียบพิกเซล

คุณสามารถส่งพารามิเตอร์ข้อมูลลูกค้าหลายรายการผ่านทางพิกเซลของ Meta ได้ แม้ว่าระบบจะส่งพารามิเตอร์บางตัว (เช่น client_user_agent) ให้โดยอัตโนมัติอยู่แล้วตามการทำงานของอินเทอร์เน็ต ตัวอย่างเช่น หากจะส่ง external_id ผ่านพิกเซล ให้ใช้โค้ดต่อไปนี้

fbq('init', 'PIXEL_ID', {'external_id': 12345});

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

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

การจัดรูปแบบพารามิเตอร์ user_data

คุณต้องระบุพารามิเตอร์ user_data ต่อไปนี้อย่างน้อย 1 รายการโดยจัดรูปแบบอย่างถูกต้องไว้ในคำขอของคุณ

โปรดดาวน์โหลดไฟล์ CSV นี้

หากต้องการดูตัวอย่างข้อมูลที่แฮชและทำให้เป็นมาตรฐานอย่างเหมาะสมสำหรับพารามิเตอร์ด้านล่าง



ดาวน์โหลด (คลิกขวา > บันทึกลิงก์เป็น)
พารามิเตอร์คำอธิบาย
em

อีเมล

สตริงหรือรายการ<string>

ต้องมีการแฮช
ตัดช่องว่างที่อยู่นำหน้าและต่อท้ายออก แปลงอักขระทั้งหมดเป็นตัวพิมพ์เล็ก


ตัวอย่าง:

อินพุต: John_Smith@gmail.com
รูปแบบที่เป็นมาตรฐาน: john_smith@gmail.com
เอาต์พุต SHA256 ที่คาดหวัง: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f

ph

หมายเลขโทรศัพท์

สตริงหรือรายการ<string>

ต้องมีการแฮช
ลบสัญลักษณ์ ตัวอักษร และเลขศูนย์ที่อยู่นำหน้าออก หมายเลขโทรศัพท์ต้องมีรหัสประเทศเพื่อใช้ในการจับคู่ (เช่น หมายเลขโทรศัพท์ในสหรัฐอเมริกาต้องขึ้นต้นด้วยหมายเลข 1) ใส่รหัสประเทศร่วมกับหมายเลขโทรศัพท์ของลูกค้าของคุณเสมอ แม้ว่าข้อมูลทั้งหมดของคุณจะมาจากประเทศเดียวกัน


ตัวอย่าง:

อินพุต: หมายเลขโทรศัพท์ของสหรัฐฯ (650)555-1212
รูปแบบที่เป็นมาตรฐาน: 16505551212
เอาต์พุต SHA256 ที่คาดหวัง:

e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176

fn

ชื่อ

สตริงหรือรายการ<string>

ต้องมีการแฮช
ขอแนะนำให้ใช้อักขระตัวอักษรโรมัน a-z ตัวพิมพ์เล็กเท่านั้น ไม่มีเครื่องหมายวรรคตอน หากใช้อักขระพิเศษ ต้องมีการเข้ารหัสข้อความในรูปแบบ UTF-8


ตัวอย่าง:
อินพุต: Mary
รูปแบบที่เป็นมาตรฐาน: mary
เอาต์พุต SHA256 ที่คาดหวัง: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec


อินพุต:
รูปแบบที่เป็นมาตรฐาน: อักขระ UTF-8 ของ "정"
เอาต์พุต SHA256 ที่คาดหวัง: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14


อินพุต: Valéry
รูปแบบที่เป็นมาตรฐาน: valéry
เอาต์พุต SHA256 ที่คาดหวัง: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c

ln

นามสกุล

สตริงหรือรายการ<string>

ต้องมีการแฮช
ขอแนะนำให้ใช้อักขระตัวอักษรโรมัน a-z ตัวพิมพ์เล็กเท่านั้น ไม่มีเครื่องหมายวรรคตอน หากใช้อักขระพิเศษ ต้องมีการเข้ารหัสข้อความในรูปแบบ UTF-8


ดูชื่อ (fn) เป็นตัวอย่าง

db

วันเกิด

สตริงหรือรายการ<string>

ต้องมีการแฮช
เราอนุญาตให้ใช้รูปแบบ YYYYMMDD ในการระบุช่วงเดือน วัน และปี ซึ่งมีหรือไม่มีเครื่องหมายวรรคตอนก็ได้

  • ปี: ใช้รูปแบบ YYYY ตั้งแต่ 1900 ถึงปีปัจจุบัน
  • เดือน: ใช้รูปแบบ MM: 01 ถึง 12
  • วันที่: ใช้รูปแบบ DD: 01 ถึง 31

ตัวอย่าง:

อินพุต: 16/2/1997
รูปแบบที่เป็นมาตรฐาน: 19970216
เอาต์พุต SHA256 ที่คาดหวัง: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c

ge

เพศ

สตริงหรือรายการ<string>

ต้องมีการแฮช
เราอนุญาตให้ระบุเพศในรูปแบบอักษรย่อตัวพิมพ์เล็ก


ตัวอย่าง:

  • f สำหรับผู้หญิง
  • m สำหรับผู้ชาย
ct

เมือง

สตริงหรือรายการ<string>

ต้องมีการแฮช
ขอแนะนำให้ใช้อักขระตัวอักษรโรมัน a-z ตัวพิมพ์เล็กเท่านั้น ไม่มีเครื่องหมายวรรคตอน ไม่มีอักขระพิเศษ และไม่มีการเว้นวรรค หากใช้อักขระพิเศษ ต้องมีการเข้ารหัสข้อความในรูปแบบ UTF-8


ตัวอย่าง:
paris
london
newyork

st

รัฐ

สตริงหรือรายการ<string>

ต้องมีการแฮช
ใช้รหัสย่อ ANSI ที่มี 2 อักขระ โดยเป็นตัวพิมพ์เล็ก ปรับชื่อรัฐที่อยู่นอกสหรัฐฯ ให้เป็นมาตรฐานโดยใช้ตัวพิมพ์เล็ก ไม่มีเครื่องหมายวรรคตอน ไม่มีอักขระพิเศษ และไม่มีการเว้นวรรค


ตัวอย่าง:
az
ca

zp

รหัสไปรษณีย์

สตริงหรือรายการ<string>

ต้องมีการแฮช
ใช้ตัวพิมพ์เล็ก โดยไม่มีการเว้นวรรคและไม่มียัติภาค ใช้ตัวเลข 5 หลักแรกเท่านั้นสำหรับรหัสไปรษณีย์ของสหรัฐฯ ใช้รูปแบบพื้นที่ เขต และภาคส่วนสำหรับสหราชอาณาจักร


ตัวอย่าง:
รหัสไปรษณีย์ของสหรัฐฯ: 94035
รหัสไปรษณีย์ของออสเตรเลีย: 1987
รหัสไปรษณีย์ของฝรั่งเศส:75018
รหัสไปรษณีย์ของสหราชอาณาจักร: m11ae

country

ประเทศ

สตริงหรือรายการ<string>

ต้องมีการแฮช
ใช้รหัสประเทศตัวพิมพ์เล็ก 2 ตัวอักษรในรูปแบบ ISO 3166-1 alpha-2
ข้อสำคัญที่ควรทราบ: ให้ใส่ประเทศของลูกค้าของคุณเสมอ แม้ว่ารหัสประเทศทั้งหมดของคุณจะมาจากประเทศเดียวกันก็ตาม เราจับคู่ข้อมูลทั่วโลก และขั้นตอนง่ายๆ นี้จะช่วยให้เราจับคู่บัญชีต่างๆ ในศูนย์บัญชีได้มากที่สุดเท่าที่จะเป็นไปได้จากรายการของคุณ


ตัวอย่าง:
อินพุต: สหรัฐอเมริกา
รูปแบบที่เป็นมาตรฐาน us
เอาต์พุต SHA256 ที่คาดหวัง: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621

external_id

ID ภายนอก

สตริงหรือรายการ<string>

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

client_ip_address

ที่อยู่ IP ของไคลเอ็นต์

สตริง

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


ตัวอย่าง:
IPV4: 168.212.226.204
IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

client_user_agent

User Agent ของไคลเอ็นต์

สตริง

ไม่ต้องแฮช
User Agent สำหรับเบราว์เซอร์ที่สอดคล้องกับเหตุการณ์ ต้องระบุ client_user_agent สำหรับเหตุการณ์บนเว็บไซต์ที่แชร์โดยใช้ API คอนเวอร์ชั่น

การส่งทั้งพารามิเตอร์ client_ip_address และ client_user_agent สำหรับเหตุการณ์ทั้งหมดที่คุณส่งผ่าน API คอนเวอร์ชั่น อาจช่วยปรับปรุงการจับคู่เหตุการณ์และอาจช่วยปรับปรุงการแสดงโฆษณาสำหรับแคมเปญโฆษณาที่เพิ่มประสิทธิภาพเหตุการณ์ที่คุณส่งผ่านทาง API คอนเวอร์ชั่นได้อีกด้วย
หมายเหตุ: ระบบจะเพิ่มข้อมูลนี้ไปยังเหตุการณ์ที่ส่งผ่านเบราว์เซอร์โดยอัตโนมัติ แต่สำหรับเหตุการณ์ที่ส่งผ่านเซิร์ฟเวอร์นั้นต้องกำหนดค่าด้วยตนเอง


ตัวอย่าง:
Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 (KHTML เช่น Gecko)
Chrome/87.0.4280.141
Safari/537.36

fbc

ID การคลิก

สตริง

ไม่ต้องแฮช
ค่า ID การคลิกของ Facebook มีการจัดเก็บไว้ในคุกกี้ของเบราว์เซอร์ _fbc ภายใต้โดเมนของคุณ ดูการจัดการพารามิเตอร์ fbc และ fbp สำหรับวิธีรับค่านี้หรือสร้างค่านี้จากพารามิเตอร์การสืบค้น fbclid

รูปแบบคือ fb.${subdomain_index}.${creation_time}.${fbclid}


ตัวอย่าง:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

fbp

ID เบราว์เซอร์

สตริง

ไม่ต้องแฮช
ค่า ID เบราว์เซอร์ของ Facebook มีการจัดเก็บไว้ในคุกกี้ของเบราว์เซอร์ _fbp ภายใต้โดเมนของคุณ ดูการจัดการพารามิเตอร์ fbc และ fbp สำหรับวิธีรับค่านี้

รูปแบบคือ fb.${subdomain_index}.${creation_time}.${fbclid}


ตัวอย่าง:
fb.1.1596403881668.1116446470

subscription_id

ID การสมัครรับข้อมูล

สตริง

ไม่ต้องแฮช
ID การสมัครรับข้อมูลสำหรับผู้ใช้ในธุรกรรมนี้ ซึ่งคล้ายกับ ID คำสั่งซื้อของสินค้าแต่ละรายการ

fb_login_id

ID การเข้าสู่ระบบด้วย Facebook

จำนวนเต็ม

ไม่ต้องแฮช
ID ที่ออกโดย Meta เมื่อบุคคลเข้าสู่ระบบอินสแตนซ์ของแอพเป็นครั้งแรก โดยเรียกอีกอย่างว่า ID ในแอพ

lead_id

ID ข้อมูลลูกค้า

จำนวนเต็ม

ไม่ต้องแฮช
ID ที่เชื่อมโยงกับข้อมูลลูกค้าที่รวบรวมได้จากโฆษณาแบบกรอกฟอร์มของ Meta

anon_id
สตริง

ไม่ต้องแฮช
ID การติดตั้งของคุณ ช่องนี้แสดงถึงอินสแตนซ์การติดตั้งแอพพลิเคชั่นที่ไม่ซ้ำกัน


หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับเหตุการณ์ในแอพเท่านั้น

madid
สตริง

ไม่ต้องแฮช
ID ผู้ลงโฆษณาบนมือถือของคุณ, ID การโฆษณาจากอุปกรณ์ Android หรือตัวระบุการโฆษณา (IDFA) จากอุปกรณ์ Apple


หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับเหตุการณ์ในแอพเท่านั้น

page_id
สตริง

ไม่ต้องแฮช
ID เพจของคุณ ระบุ ID เพจที่เชื่อมโยงกับเหตุการณ์ ใช้ ID เพจ Facebook ของเพจที่เชื่อมโยงกับบอท

page_scoped_user_id
สตริง

ไม่ต้องแฮช
ระบุ ID ผู้ใช้ในเพจที่เชื่อมโยงกับบอท Messenger ที่บันทึกเหตุการณ์ ใช้ ID ผู้ใช้ในเพจที่ระบุให้กับ Webhook

ctwa_clid
สตริง

ไม่ต้องแฮช
ID การคลิกที่สร้างโดย Meta สำหรับโฆษณาที่คลิกไปยัง WhatsApp

ig_account_id
สตริง

ไม่ต้องแฮช
ID บัญชี Instagram ที่เชื่อมโยงกับธุรกิจ

ig_sid
สตริง

ไม่ต้องแฮช
ผู้ใช้ที่โต้ตอบกับ Instagram จะถูกระบุโดย ID ผู้ใช้ใน Instagram (IGSID) คุณสามารถรับ IGSID ได้จาก Webhook นี้