Vytvorenie kontaktu
Pridajte nových zákazníkov do svojej databázy kontaktov v Brevo spolu s informáciami o vernostnom programe a vlastnými atribútmi pre personalizovanú komunikáciu.
Rýchly štart
Základné vytvorenie kontaktu
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}Odpoveď
{ "id": 123456}Integrácia s vernostným programom
Nový zákazník s atribútmi vernostného programu
{ "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}Aktualizácia existujúceho zákazníka
{ "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}Atribúty špecifické pre Tajo
Vernostné údaje zákazníka
| Názov atribútu | Typ | Popis |
|---|---|---|
LOYALTY_ID | String | Jedinečné ID vernostného programu |
LOYALTY_POINTS | Number | Aktuálny zostatok bodov |
LOYALTY_TIER | String | Aktuálna úroveň (Bronze, Silver, Gold, Platinum) |
POINTS_EARNED_YTD | Number | Body získané tento rok |
POINTS_REDEEMED_YTD | Number | Body uplatnené tento rok |
TIER_PROGRESS | Number | Postup k ďalšej úrovni (%) |
NEXT_TIER_POINTS | Number | Body potrebné na ďalšiu úroveň |
Nákupné správanie
| Názov atribútu | Typ | Popis |
|---|---|---|
TOTAL_SPENT | Number | Celoživotná hodnota |
AVERAGE_ORDER_VALUE | Number | Priemerná hodnota nákupu |
PURCHASE_FREQUENCY | String | Ako často zákazník nakupuje |
LAST_PURCHASE | Date | Dátum posledného nákupu |
FAVORITE_CATEGORIES | Array | Preferované kategórie produktov |
SEASONAL_BUYER | Boolean | Nakupuje sezónne |
Metriky zapojenia
| Názov atribútu | Typ | Popis |
|---|---|---|
ENGAGEMENT_SCORE | Number | Hodnotenie zapojenia od 1 do 10 |
EMAIL_OPEN_RATE | Number | Osobná miera otvorení v % |
CLICK_THROUGH_RATE | Number | Osobná miera preklikov v % |
LAST_EMAIL_OPENED | Date | Posledná interakcia s e-mailom |
PREFERRED_CHANNEL | String | E-mail, SMS, WhatsApp |
Hromadné vytváranie kontaktov
Vytvorte viacero kontaktov naraz:
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}Spracovanie chýb
Bežné chyby a ich riešenia:
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Osvedčené postupy pre Tajo
- Vždy uvádzajte základné vernostné polia: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
- Zapnite aktualizácie: povoľte aktualizáciu existujúcich kontaktov
- Používajte segmentačné zoznamy: usporiadajte kontakty podľa úrovne, správania a preferencií
- Sledujte zapojenie: monitorujte miery interakcie s e-mailmi a SMS
- Pravidelná synchronizácia dát: udržujte vernostné údaje aktuálne so svojím systémom
Ďalšie kroky
- Aktualizácia atribútov kontaktu
- Správa zoznamov kontaktov
- Nastavenie vlastných atribútov
- Hromadný import kontaktov