สร้างผู้ติดต่อ
เพิ่มลูกค้าใหม่เข้าสู่ฐานข้อมูลผู้ติดต่อ Brevo ของคุณ พร้อมข้อมูลโปรแกรมสะสมคะแนนและแอตทริบิวต์ที่กำหนดเอง เพื่อการสื่อสารที่ตรงใจลูกค้าแต่ละราย
เริ่มต้นอย่างรวดเร็ว
การสร้างผู้ติดต่อแบบพื้นฐาน
POST https://api.brevo.com/v3/contactsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "attributes": { "FIRSTNAME": "John", "LASTNAME": "Doe", "LOYALTY_POINTS": 1500, "LOYALTY_TIER": "Gold", "SIGNUP_DATE": "2024-01-15", "LAST_PURCHASE": "2024-01-20", "TOTAL_SPENT": 299.99 }, "listIds": [1, 2], "updateEnabled": true}การตอบกลับ
{ "id": 123456}การเชื่อมต่อกับโปรแกรมสะสมคะแนน
ลูกค้าใหม่พร้อมแอตทริบิวต์สะสมคะแนน
{ "attributes": { "FIRSTNAME": "Sarah", "LASTNAME": "Johnson", "PHONE": "+1234567890", "LOYALTY_ID": "LYL-2024-001", "LOYALTY_POINTS": 0, "LOYALTY_TIER": "Bronze", "PREFERRED_REWARDS": "Discounts", "BIRTHDAY": "1990-05-15", "SIGNUP_SOURCE": "Website", "REFERRAL_CODE": "REF-12345", "COMMUNICATION_PREFERENCES": "Email,SMS", "PURCHASE_CATEGORIES": ["Electronics", "Fashion"], "AVERAGE_ORDER_VALUE": 0 }, "listIds": [1], // New customers list "emailBlacklisted": false, "smsBlacklisted": false, "updateEnabled": true}การอัปเดตลูกค้าที่มีอยู่แล้ว
{ "attributes": { "LOYALTY_POINTS": 2500, "LOYALTY_TIER": "Platinum", "LAST_PURCHASE": "2024-01-25", "TOTAL_SPENT": 1299.99, "RECENT_PURCHASES": ["Product A", "Product B"], "ENGAGEMENT_SCORE": 8.5, "LAST_EMAIL_OPENED": "2024-01-24", "PREFERRED_CONTACT_TIME": "Evening" }, "listIds": [1, 3], // Add to platinum customers list "updateEnabled": true}แอตทริบิวต์เฉพาะของ Tajo
ข้อมูลสะสมคะแนนของลูกค้า
| ชื่อแอตทริบิวต์ | ประเภท | คำอธิบาย |
|---|---|---|
LOYALTY_ID | String | รหัสโปรแกรมสะสมคะแนนที่ไม่ซ้ำกัน |
LOYALTY_POINTS | Number | ยอดคะแนนคงเหลือปัจจุบัน |
LOYALTY_TIER | String | ระดับปัจจุบัน (Bronze, Silver, Gold, Platinum) |
POINTS_EARNED_YTD | Number | คะแนนที่ได้รับในปีนี้ |
POINTS_REDEEMED_YTD | Number | คะแนนที่แลกไปในปีนี้ |
TIER_PROGRESS | Number | ความคืบหน้าสู่ระดับถัดไป (%) |
NEXT_TIER_POINTS | Number | คะแนนที่ต้องใช้เพื่อเลื่อนสู่ระดับถัดไป |
พฤติกรรมการซื้อ
| ชื่อแอตทริบิวต์ | ประเภท | คำอธิบาย |
|---|---|---|
TOTAL_SPENT | Number | มูลค่าตลอดอายุการเป็นลูกค้า |
AVERAGE_ORDER_VALUE | Number | มูลค่าการซื้อเฉลี่ยต่อครั้ง |
PURCHASE_FREQUENCY | String | ความถี่ในการซื้อของลูกค้า |
LAST_PURCHASE | Date | วันที่ซื้อครั้งล่าสุด |
FAVORITE_CATEGORIES | Array | หมวดหมู่สินค้าที่ลูกค้าชื่นชอบ |
SEASONAL_BUYER | Boolean | ซื้อสินค้าตามฤดูกาล |
ตัวชี้วัดการมีส่วนร่วม
| ชื่อแอตทริบิวต์ | ประเภท | คำอธิบาย |
|---|---|---|
ENGAGEMENT_SCORE | Number | คะแนนการมีส่วนร่วม 1-10 |
EMAIL_OPEN_RATE | Number | อัตราการเปิดอ่านรายบุคคล (%) |
CLICK_THROUGH_RATE | Number | อัตราการคลิก (CTR) รายบุคคล (%) |
LAST_EMAIL_OPENED | Date | การโต้ตอบอีเมลครั้งล่าสุด |
PREFERRED_CHANNEL | String | Email, SMS, WhatsApp |
การสร้างผู้ติดต่อแบบกลุ่ม
สร้างผู้ติดต่อหลายรายพร้อมกัน
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}การจัดการข้อผิดพลาด
ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}แนวปฏิบัติที่ดีสำหรับ Tajo
- ใส่ฟิลด์สะสมคะแนนหลักเสมอ: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
- เปิดใช้งานการอัปเดต: อนุญาตให้อัปเดตผู้ติดต่อที่มีอยู่แล้วได้
- ใช้รายชื่อแบบแบ่งเซกเมนต์: จัดกลุ่มตามระดับ พฤติกรรม และความชอบ
- ติดตามการมีส่วนร่วม: เฝ้าดูอัตราการโต้ตอบทางอีเมลและ SMS
- ซิงค์ข้อมูลอย่างสม่ำเสมอ: รักษาข้อมูลสะสมคะแนนให้ตรงกับระบบของคุณเสมอ
ขั้นตอนถัดไป
- อัปเดตแอตทริบิวต์ของผู้ติดต่อ
- จัดการรายชื่อผู้ติดต่อ
- ตั้งค่าแอตทริบิวต์ที่กำหนดเอง
- นำเข้าผู้ติดต่อจำนวนมาก