Créer un événement

Suivez les interactions, achats et activités du programme de fidélité des clients pour favoriser un engagement personnalisé et des récompenses.

Démarrage rapide

Suivi d’événement de 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"
  }
}

Réponse

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

Événements du programme de fidélité

Événements d’achat

Suivez les achats pour attribuer des points et mettre à jour le statut de fidélité :

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

Échange de points

Suivez les échanges de points de fidélité par les clients :

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

Activités de compte

Suivez les activités liées au compte :

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

Événements d’engagement

Suivez l’engagement des clients pour la personnalisation :

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

Événements e-commerce pour Tajo

Événements de panier

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

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

Événements spécifiques à la fidélité

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

Directives sur les propriétés d’événement

Propriétés requises

Propriété	Type	Description
`email`	String	Email du client (obligatoire)
`event`	String	Nom de l’événement (obligatoire)
`properties`	Object	Données spécifiques à l’événement

Propriétés recommandées pour la fidélité

Propriété	Type	Description
`customer_id`	String	ID client interne
`loyalty_id`	String	ID du programme de fidélité
`points_balance`	Number	Points actuels après l’événement
`loyalty_tier`	String	Niveau actuel
`event_value`	Number	Valeur monétaire de l’événement

Suivi avancé des événements

Propriétés d’événement personnalisées

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

Création d’événements en masse

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

Gestion des erreurs

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

Bonnes pratiques pour Tajo

Noms d’événements cohérents : Utilisez des conventions de nommage standard
Propriétés riches : Incluez des données liées à la fidélité dans chaque événement
Suivi en temps réel : Envoyez les événements immédiatement après leur occurrence
Parcours client : Suivez le parcours d’achat et d’engagement complet
Données de segmentation : Incluez les attributs qui facilitent le ciblage