Poproś o wcześniejszy dostęp

Podaj imię oraz adres e-mail lub numer telefonu. Wyślemy Ci informacje o dostępie do Tajo.

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/events
Content-Type: application/json
api-key: YOUR_API_KEY
{
"email": "[email protected]",
"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:

{
"email": "[email protected]",
"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:

{
"email": "[email protected]",
"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:

{
"email": "[email protected]",
"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:

{
"email": "[email protected]",
"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śćTypOpis
emailStringAdres email klienta (wymagany)
eventStringNazwa zdarzenia (wymagana)
propertiesObjectDane specyficzne dla zdarzenia

Właściwości zalecane dla programu lojalnościowego

WłaściwośćTypOpis
customer_idStringWewnętrzny identyfikator klienta
loyalty_idStringIdentyfikator programu lojalnościowego
points_balanceNumberStan punktów po zdarzeniu
loyalty_tierStringAktualny poziom
event_valueNumberWartość 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": [
{
"email": "[email protected]",
"event": "Purchase Completed",
"properties": { "order_id": "ORD-001", "amount": 99.99 }
},
{
"email": "[email protected]",
"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

  1. Spójne nazwy zdarzeń: stosuj standardowe konwencje nazewnicze
  2. Bogate właściwości: w każdym zdarzeniu umieszczaj dane istotne dla programu lojalnościowego
  3. Śledzenie w czasie rzeczywistym: wysyłaj zdarzenia natychmiast po ich wystąpieniu
  4. Ścieżka klienta: śledź pełny lejek zakupowy i zaangażowania
  5. Dane do segmentacji: dołączaj atrybuty, które ułatwiają targetowanie

Kolejne kroki

Poproś o wcześniejszy dostęp

Podaj imię oraz adres e-mail lub numer telefonu. Wyślemy Ci informacje o dostępie do Tajo.

rozpoznajemy automatycznie
Asystent AI

Cześć! Zapytaj mnie o dokumentację.