Crea Evento

Traccia le interazioni dei clienti, gli acquisti e le attività del programma fedeltà per guidare il coinvolgimento personalizzato e i premi.

Avvio Rapido

Tracciamento Evento Base

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"
  }
}

Risposta

{
  "success": true,
  "eventId": "evt_abc123"
}

Eventi del Programma Fedeltà

Eventi di Acquisto

Traccia gli acquisti per assegnare punti e aggiornare lo stato fedeltà:

{
  "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"
}

Riscatto Punti

Traccia quando i clienti riscattano i punti fedeltà:

{
  "email": "[email protected]",
  "event": "Points Redeemed",
  "properties": {
    "points_redeemed": 1000,
    "reward_type": "Discount",
    "reward_value": 50.00,
    "reward_description": "$50 di sconto sul prossimo acquisto",
    "coupon_generated": "LOYALTY50",
    "expiry_date": "2024-03-25",
    "remaining_points": 750,
    "redemption_source": "Mobile App"
  }
}

Attività Account

Traccia le attività relative all’account:

{
  "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"]
  }
}

Eventi di Coinvolgimento

Traccia il coinvolgimento dei clienti per la personalizzazione:

{
  "email": "[email protected]",
  "event": "Email Opened",
  "properties": {
    "campaign_id": "CAMP-001",
    "campaign_name": "Offerte Settimanali",
    "subject_line": "Offerte esclusive solo per te!",
    "open_time": "2024-01-25T09:15:00Z",
    "device": "Mobile",
    "email_client": "Gmail",
    "location": "Milano, IT"
  }
}

Eventi E-commerce per Tajo

Eventi Carrello

{
  "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 minuti"
  }
}

Eventi di Navigazione

{
  "event": "Product Viewed",
  "properties": {
    "product_id": "PROD-456",
    "product_name": "Cuffie Wireless",
    "category": "Electronics",
    "price": 199.99,
    "view_duration": "45 secondi",
    "referrer": "Risultati di ricerca",
    "loyalty_discount_shown": true
  }
}

Eventi Specifici per la Fedeltà

{
  "event": "Tier Upgraded",
  "properties": {
    "previous_tier": "Silver",
    "new_tier": "Gold",
    "points_balance": 2500,
    "benefits_unlocked": ["Spedizione Gratuita", "Supporto Prioritario"],
    "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
  }
}

Linee Guida Proprietà Evento

Proprietà Obbligatorie

Proprietà	Tipo	Descrizione
`email`	Stringa	Email del cliente (obbligatoria)
`event`	Stringa	Nome dell’evento (obbligatorio)
`properties`	Oggetto	Dati specifici dell’evento

Proprietà Consigliate per la Fedeltà

Proprietà	Tipo	Descrizione
`customer_id`	Stringa	ID cliente interno
`loyalty_id`	Stringa	ID programma fedeltà
`points_balance`	Numero	Punti totali dopo l’evento
`loyalty_tier`	Stringa	Livello attuale
`event_value`	Numero	Valore monetario dell’evento

Tracciamento Avanzato degli Eventi

Proprietà Evento Personalizzate

{
  "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
  }
}

Creazione Evento in Batch

{
  "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" }
    }
  ]
}

Gestione degli Errori

{
  "code": "invalid_event",
  "message": "Event name must be a non-empty string",
  "details": {
    "field": "event",
    "value": ""
  }
}

Best Practice per Tajo

Nomi Evento Coerenti: Usa convenzioni di denominazione standard
Proprietà Ricche: Includi dati rilevanti per la fedeltà in ogni evento
Tracciamento in Tempo Reale: Invia gli eventi immediatamente dopo che si verificano
Customer Journey: Traccia il funnel completo di acquisto e coinvolgimento
Dati di Segmentazione: Includi attributi utili per il targeting