Vytvoření kontaktu
Přidávejte nové zákazníky do své databáze kontaktů Brevo spolu s informacemi o věrnostním programu a vlastními atributy pro personalizovanou komunikaci.
Rychlý start
Základní vytvoření 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}Odpověď
{ "id": 123456}Napojení na věrnostní program
Nový zákazník s věrnostními atributy
{ "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}Aktualizace stávajícího 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}Atributy specifické pro Tajo
Věrnostní data zákazníka
| Název atributu | Typ | Popis |
|---|---|---|
LOYALTY_ID | String | Jedinečné ID věrnostního programu |
LOYALTY_POINTS | Number | Aktuální stav bodů |
LOYALTY_TIER | String | Aktuální úroveň (Bronze, Silver, Gold, Platinum) |
POINTS_EARNED_YTD | Number | Body získané letos |
POINTS_REDEEMED_YTD | Number | Body uplatněné letos |
TIER_PROGRESS | Number | Postup k další úrovni (%) |
NEXT_TIER_POINTS | Number | Body potřebné pro další úroveň |
Nákupní chování
| Název atributu | Typ | Popis |
|---|---|---|
TOTAL_SPENT | Number | Celoživotní hodnota |
AVERAGE_ORDER_VALUE | Number | Průměrná hodnota nákupu |
PURCHASE_FREQUENCY | String | Jak často zákazník nakupuje |
LAST_PURCHASE | Date | Datum posledního nákupu |
FAVORITE_CATEGORIES | Array | Preferované kategorie produktů |
SEASONAL_BUYER | Boolean | Nakupuje sezónně |
Metriky zapojení
| Název atributu | Typ | Popis |
|---|---|---|
ENGAGEMENT_SCORE | Number | Hodnocení zapojení 1 až 10 |
EMAIL_OPEN_RATE | Number | Osobní míra otevření v % |
CLICK_THROUGH_RATE | Number | Osobní CTR v % |
LAST_EMAIL_OPENED | Date | Poslední interakce s e-mailem |
PREFERRED_CHANNEL | String | Email, SMS, WhatsApp |
Hromadné vytváření kontaktů
Vytvořte více kontaktů najednou:
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}Ošetření chyb
Časté chyby a jejich řešení:
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Osvědčené postupy pro Tajo
- Vždy uvádějte klíčová věrnostní pole: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
- Zapněte aktualizace: povolte aktualizaci stávajících kontaktů
- Používejte segmentační seznamy: třiďte podle úrovně, chování a preferencí
- Sledujte zapojení: monitorujte míru interakce s e-maily a SMS
- Pravidelně synchronizujte data: udržujte věrnostní data ve svém systému aktuální
Další kroky
- Aktualizace atributů kontaktu
- Správa seznamů kontaktů
- Nastavení vlastních atributů
- Hromadný import kontaktů