ใช้แอปเฉพาะสำหรับ Shopify เพื่อเพิ่มข้อมูลลูกค้า
แอป GenderAPI สำหรับ Shopify ประมวลผลลูกค้าเดิมและลูกค้าใหม่ เพิ่มสัญญาณเพศที่ได้จากการคาดการณ์ และสามารถหาชื่อ (first name) ที่ขาดหายไปจากอีเมลได้ เริ่มจากร้านค้า Shopify ที่ต้องการใช้ และเลือกการตั้งค่าแอปที่ตรงกับฟิลด์ลูกค้าที่ต้องการอัปเดต
แอปนี้เป็นแอปเฉพาะสำหรับ Shopify ที่มีการตั้งค่าการประมวลผลและแพ็กเกจของตนเอง โค้ดที่ตรวจสอบเมื่อวันที่ 27 กันยายน 2026 ไม่ได้เรียก endpoint การคาดการณ์ V2 สาธารณะ อย่าสันนิษฐานว่ายอดคงเหลือของคีย์ API ตัวเลือก AI ของ V2 หรือฟิลด์การตอบกลับ V2 ใช้กับแอปนี้
เตรียมร้านค้าและกำหนดสิ่งที่จะเปลี่ยนแปลง
- เปิด "Gender API - Determine gender" ใน Shopify App Store ก่อนติดตั้ง ให้ตรวจสอบว่าเป็นหน้ารายการของ Ozan Soft รวมถึงตรวจสอบร้านค้าเป้าหมาย สิทธิ์ปัจจุบัน และแพ็กเกจ
- ตรวจสอบยอดคงเหลือของแอปและการตั้งค่าการประมวลผลลูกค้า แล้วตัดสินใจว่าจะประมวลผลเรคคอร์ดเดิม เปิดการประมวลผลลูกค้าใหม่โดยอัตโนมัติ หรือทำทั้งสองอย่าง
- ตรวจสอบเรคคอร์ดลูกค้าจำนวนไม่มาก เช่น ลูกค้าที่มีชื่อ ลูกค้าที่ไม่มีชื่อ และลูกค้าที่มีข้อมูลนำเข้ากำกวม เปิดให้เห็นชื่อและแท็กเดิมไว้ระหว่างตรวจสอบผลลัพธ์
- เปิดการเติมชื่อที่ขาดหายไปเฉพาะเมื่อต้องการเขียนชื่อที่ได้จากอีเมลลงในฟิลด์ชื่อของลูกค้า การคาดการณ์เพศและการแก้ไขชื่อเป็นการตัดสินใจที่แยกจากกัน
- ตรวจสอบแท็กและเมตาฟิลด์ลูกค้าที่สร้างขึ้นก่อนนำไปใช้ในเซกเมนต์ และตรวจสอบว่าข้อมูลลูกค้าที่ไม่เกี่ยวข้องยังคงเดิม
ทำความเข้าใจฟิลด์ลูกค้าที่แอปใช้
การจับคู่ด้านล่างอ้างอิงจากโค้ดต้นฉบับของแอปที่ตรวจสอบ ก่อนเชื่อมต่อเวิร์กโฟลว์ถัดไป ให้ตรวจสอบกับแอปที่ติดตั้งไว้โดยใช้ตัวอย่างที่ควบคุมได้
| ฟิลด์ลูกค้าหรือการตั้งค่า | ทิศทาง | ลักษณะการทำงาน |
|---|---|---|
| ชื่อ (first name) | ข้อมูลนำเข้า | ข้อมูลนำเข้าชื่อที่ใช้ก่อนเมื่อมีค่า |
| อีเมล | ข้อมูลนำเข้า | ใช้หาชื่อที่เป็นไปได้เมื่อไม่มีชื่อ อีเมลที่ไม่มีชื่อที่ใช้ได้อาจยังคงระบุไม่ได้ |
| ประเทศในที่อยู่ | บริบทเสริม | ระหว่างการประมวลผล ประเทศในที่อยู่ของลูกค้าอาจใช้เป็นบริบทสำหรับการค้นหาชื่อได้เมื่อมีค่า |
| แท็กลูกค้า | ผลลัพธ์ | โค้ดที่ตรวจสอบใช้ male, female หรือ gender_null และคงแท็กที่ไม่เกี่ยวข้องไว้ตามเดิม |
| custom.gender | ผลลัพธ์ | เมตาฟิลด์ลูกค้าที่เก็บป้ายกำกับที่ได้จากการคาดการณ์เป็นค่าข้อความบรรทัดเดียว |
| การอัปเดตชื่อ | ผลลัพธ์เสริม | เมื่อเปิดใช้ ระบบสามารถเติมชื่อที่ขาดหายไปด้วยชื่อที่ได้จากอีเมล โค้ดจะเพิ่ม first_name_found_from_email |
| การเพิ่มข้อมูลอัตโนมัติ | การตั้งค่าแอป | ควบคุมการประมวลผลเหตุการณ์ลูกค้าใหม่ ความพร้อมใช้งานขึ้นอยู่กับแพ็กเกจและการตั้งค่าของแอป |
ตรวจสอบแท็ก ผลลัพธ์ที่ไม่ทราบ และการจัดประเภทเดิม
เปิดลูกค้าที่ประมวลผลแล้วใน Shopify และเปรียบเทียบแท็ก custom.gender และชื่อกับเรคคอร์ดเดิม อย่าสันนิษฐานว่าใช้เส้นทาง JSON ของ API ในเซกเมนต์ได้ ให้ใช้ฟิลด์และป้ายกำกับที่ถูกเขียนจริง
งานประมวลผลที่ตรวจสอบจะข้ามลูกค้าที่มีแท็ก male, female หรือ gender_null อยู่แล้ว ดังนั้นเรคคอร์ดที่ไม่เปลี่ยนแปลงอาจแสดงการจัดประเภทเดิม ไม่ใช่การค้นหาใหม่ ก่อนเรียกใช้อีกครั้ง ให้กำหนดวิธีตรวจสอบการจัดประเภทก่อนหน้า
เก็บ gender_null ไว้เป็นผลลัพธ์ที่ระบุไม่ได้ การจับคู่ของแอปนี้ไม่มีคะแนนค่าความเชื่อมั่นของ V2 ฟิลด์แหล่งที่มา หรือเรคคอร์ด usage ของแต่ละคำขอ อย่าสร้างค่าเหล่านี้ขึ้นเองในข้อมูลที่ส่งออกเป็นสเปรดชีต และอย่าเปลี่ยนผลลัพธ์ที่ไม่ทราบให้เป็นการจัดประเภทแบบสองขั้ว
| ผลลัพธ์ | ขั้นตอนถัดไปที่แนะนำ |
|---|---|
| แท็กและเมตาฟิลด์ตามที่คาดไว้ | ตรวจสอบ ID ลูกค้าต้นทาง และอนุญาตเฉพาะเซกเมนต์หรือการอัปเดตถัดไปที่ตั้งใจไว้ |
| gender_null | เก็บไว้เป็นผลลัพธ์ที่ระบุไม่ได้ และไม่นำไปใช้กับกฎที่ต้องใช้ผลลัพธ์ identified |
| แท็กเพศที่มีอยู่เดิม | ตรวจสอบว่าแอปข้ามลูกค้ารายนั้นหรือไม่ก่อนตัดสินใจประมวลผลใหม่ |
| การอัปเดตขาดหายหรือไม่ตรงกัน | ตรวจสอบสถานะงานของแอปก่อนเรียกใช้ใหม่กับทั้งกลุ่ม |
ตรวจสอบแพ็กเกจของแอปและสิทธิ์การเข้าถึงข้อมูล
ตรวจสอบขีดจำกัดการประมวลผลลูกค้าจากหน้าจอแพ็กเกจปัจจุบันและยอดคงเหลือของแอป Shopify แอปที่ตรวจสอบใช้ยอดคงเหลือเครดิตแยกตามร้านค้าและขั้นตอนการซื้อของ Shopify ไม่ได้ตั้งค่าด้วยคีย์ API สาธารณะของ GenderAPI อย่านำอัตราเครดิตของ V2 มาใช้ และตรวจสอบราคาปัจจุบันในหน้ารายการของแอป
แอปนี้ต้องเข้าถึงข้อมูลลูกค้าและสามารถแก้ไขเรคคอร์ดลูกค้าได้ เนื่องจากการประมวลผลมีคิวฝั่งแอปรวมอยู่ด้วย จึงไม่ควรตีความคำอธิบายเรื่องการเก็บรักษาการค้นหาอีเมลว่าเป็นการรับประกันว่าข้อมูลลูกค้าจะไม่คงอยู่ที่ใดเลยระหว่างเวิร์กโฟลว์นี้ ตรวจสอบสิทธิ์ของแอปในร้านค้าและนโยบายที่เผยแพร่
ป้ายกำกับที่ได้จากการคาดการณ์เป็นสัญญาณข้อมูลที่มีความไม่แน่นอน แยกป้ายกำกับนี้ออกจากข้อมูลที่บุคคลระบุด้วยตนเอง และอย่าใช้ป้ายกำกับนี้เป็นเกณฑ์เพียงอย่างเดียวในการตัดสินใจเรื่องคุณสมบัติ การเข้าถึง การกำหนดราคา หรือการตัดสินใจสำคัญอื่นๆ
ใช้ V2 เมื่อต้องการการตอบกลับที่มีโครงสร้าง
สำหรับการเชื่อมต่อที่คุณสร้างเอง GenderAPI V2 รับชื่อ อีเมล และชื่อผู้ใช้ แล้วส่งคืนฟิลด์ที่ระบุผลลัพธ์ ค่าความเชื่อมั่น แหล่งที่มา และการใช้งานอย่างชัดเจน ตั้งค่าการเชื่อมต่อนี้แยกต่างหาก การอ่านคู่มือ V2 ไม่ได้เปลี่ยนแอปที่ติดตั้งไว้หรือคอลัมน์ผลลัพธ์ที่แอปเขียน
ตัวอย่าง Python และ Node.js ครอบคลุมคำขอเดี่ยว คำขอแบบกลุ่ม ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาดในการดำเนินงาน เริ่มจากคู่มือการยืนยันตัวตน และเลือกโหมด AI ก่อนส่งคำขอที่มีการหักเครดิต
คำถามที่พบบ่อย
แอป Shopify ตั้งค่าด้วยคีย์ API ของ V2 หรือไม่?
แอปเฉพาะสำหรับ Shopify ที่ตรวจสอบใช้การติดตั้งผ่าน Shopify การตั้งค่าแพ็กเกจของตนเอง และยอดคงเหลือแยกตามร้านค้า เวิร์กโฟลว์ HTTP ของ V2 ที่คุณสร้างเองเป็นการเชื่อมต่อแยกต่างหาก และไม่ได้แทนที่การตั้งค่าของแอปนี้
ดูป้ายกำกับลูกค้าที่ได้จากการคาดการณ์ได้ที่ไหน?
แอปที่ตรวจสอบเขียนค่าลงในแท็กลูกค้าและเมตาฟิลด์ลูกค้า custom.gender ก่อนสร้างเซกเมนต์จากค่าเหล่านี้ ให้ตรวจสอบกับแอปที่ติดตั้งไว้และลูกค้าตัวอย่าง
gender_null หมายถึงอะไร?
ในแอปเฉพาะสำหรับ Shopify ที่ตรวจสอบ ค่านี้หมายถึงป้ายกำกับที่ระบุไม่ได้ อย่าเปลี่ยนค่านี้เป็น male หรือ female และให้จัดลูกค้ารายนั้นไว้ในกลุ่มผลลัพธ์ที่ไม่ทราบ
คงชื่อลูกค้าไว้โดยไม่เปลี่ยนแปลงได้หรือไม่?
ตรวจสอบการตั้งค่าการเติมชื่อที่ขาดหายไปแยกจากการประมวลผลเพศ และเปิดการตั้งค่านี้เฉพาะเมื่อต้องการให้แอปเติมชื่อที่ขาดหายไปด้วยชื่อที่ได้จากอีเมล
แหล่งที่มาและเอกสาร
คู่มือนี้ตรวจทานล่าสุดเมื่อ ตรวจสอบวิธีติดตั้งได้ในเอกสารของแต่ละแพลตฟอร์ม และใช้เอกสาร API ด้านล่างเมื่อสร้างการเชื่อมต่อ V2 แยกต่างหาก