Tworzenie zdarzenia
Śledź interakcje klientów, zakupy i aktywności w programie lojalnościowym, aby napędzać spersonalizowane zaangażowanie i nagrody.
Szybki start
Podstawowe śledzenie zdarzeń
POST https://api.brevo.com/v3/eventsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "event": "Purchase Completed", "properties": { "order_id": "ORD-2024-001", "amount": 149.99, "currency": "USD", "products": ["Product A", "Product B"], "points_earned": 150, "loyalty_tier": "Gold" }}Odpowiedź
{ "success": true, "eventId": "evt_abc123"}Zdarzenia programu lojalnościowego
Zdarzenia zakupowe
Śledź zakupy, aby przyznawać punkty i aktualizować status lojalnościowy:
{ "event": "Purchase Completed", "properties": { "order_id": "ORD-2024-001", "order_total": 299.99, "currency": "USD", "payment_method": "Credit Card", "products": [ { "id": "PROD-001", "name": "Premium Widget", "category": "Electronics", "price": 149.99, "quantity": 2 } ], "points_earned": 300, "bonus_points": 50, "points_multiplier": 1.2, "loyalty_tier_before": "Silver", "loyalty_tier_after": "Gold", "tier_upgraded": true, "shipping_cost": 9.99, "discount_applied": 29.99, "coupon_code": "SAVE10" }, "eventdate": "2024-01-25T14:30:00Z"}Wymiana punktów
Śledź moment, w którym klienci wymieniają punkty lojalnościowe:
{ "event": "Points Redeemed", "properties": { "points_redeemed": 1000, "reward_type": "Discount", "reward_value": 50.00, "reward_description": "$50 Off Next Purchase", "coupon_generated": "LOYALTY50", "expiry_date": "2024-03-25", "remaining_points": 750, "redemption_source": "Mobile App" }}Aktywności na koncie
Śledź aktywności związane z kontem:
{ "event": "Account Created", "properties": { "signup_source": "Website", "referral_code": "REF-12345", "welcome_bonus": 500, "initial_tier": "Bronze", "marketing_consent": true, "sms_consent": false, "preferred_categories": ["Fashion", "Electronics"] }}Zdarzenia zaangażowania
Śledź zaangażowanie klientów na potrzeby personalizacji:
{ "event": "Email Opened", "properties": { "campaign_id": "CAMP-001", "campaign_name": "Weekly Offers", "subject_line": "Exclusive Deals Just for You!", "open_time": "2024-01-25T09:15:00Z", "device": "Mobile", "email_client": "Gmail", "location": "New York, NY" }}Zdarzenia ecommerce w Tajo
Zdarzenia koszyka
{ "event": "Product Added to Cart", "properties": { "product_id": "PROD-123", "product_name": "Smart Watch", "category": "Electronics", "price": 299.99, "cart_total": 459.98, "cart_items_count": 2, "potential_points": 460 }}{ "event": "Cart Abandoned", "properties": { "cart_value": 459.98, "items_count": 2, "potential_points_lost": 460, "abandonment_stage": "Checkout", "time_in_cart": "25 minutes" }}Zdarzenia przeglądania
{ "event": "Product Viewed", "properties": { "product_id": "PROD-456", "product_name": "Wireless Headphones", "category": "Electronics", "price": 199.99, "view_duration": "45 seconds", "referrer": "Search Results", "loyalty_discount_shown": true }}Zdarzenia typowo lojalnościowe
{ "event": "Tier Upgraded", "properties": { "previous_tier": "Silver", "new_tier": "Gold", "points_balance": 2500, "benefits_unlocked": ["Free Shipping", "Priority Support"], "next_tier": "Platinum", "points_to_next_tier": 1500 }}{ "event": "Reward Earned", "properties": { "reward_type": "Birthday Bonus", "points_awarded": 500, "trigger": "Birthday", "total_points": 3000, "tier_progress": 75 }}Wytyczne dotyczące właściwości zdarzeń
Właściwości wymagane
| Właściwość | Typ | Opis |
|---|---|---|
email | String | Adres email klienta (wymagany) |
event | String | Nazwa zdarzenia (wymagana) |
properties | Object | Dane specyficzne dla zdarzenia |
Właściwości zalecane dla programu lojalnościowego
| Właściwość | Typ | Opis |
|---|---|---|
customer_id | String | Wewnętrzny identyfikator klienta |
loyalty_id | String | Identyfikator programu lojalnościowego |
points_balance | Number | Stan punktów po zdarzeniu |
loyalty_tier | String | Aktualny poziom |
event_value | Number | Wartość pieniężna zdarzenia |
Zaawansowane śledzenie zdarzeń
Własne właściwości zdarzeń
{ "event": "Product Review Submitted", "properties": { "product_id": "PROD-789", "rating": 5, "review_length": "detailed", "verified_purchase": true, "points_earned": 25, "review_bonus": true, "helpful_votes": 0 }}Tworzenie zdarzeń w partiach
{ "events": [ { "event": "Purchase Completed", "properties": { "order_id": "ORD-001", "amount": 99.99 } }, { "event": "Points Redeemed", "properties": { "points_used": 500, "reward": "Free Shipping" } } ]}Obsługa błędów
{ "code": "invalid_event", "message": "Event name must be a non-empty string", "details": { "field": "event", "value": "" }}Dobre praktyki dla Tajo
- Spójne nazwy zdarzeń: stosuj standardowe konwencje nazewnicze
- Bogate właściwości: w każdym zdarzeniu umieszczaj dane istotne dla programu lojalnościowego
- Śledzenie w czasie rzeczywistym: wysyłaj zdarzenia natychmiast po ich wystąpieniu
- Ścieżka klienta: śledź pełny lejek zakupowy i zaangażowania
- Dane do segmentacji: dołączaj atrybuty, które ułatwiają targetowanie
Kolejne kroki
- Skonfiguruj automatyzację opartą na zdarzeniach
- Śledź zaangażowanie w emailach
- Skonfiguruj procesy lojalnościowe
- Przeglądaj analitykę zdarzeń