Suivi des événements

Utilisez converlay.track(eventName, properties) pour envoyer des événements. Le SDK enrichit automatiquement chaque événement avec le client ID, la session, les UTMs, les Click ID et l'état du consentement.

Signature de l'API

track() signature

converlay.track('event_name', {
  ecommerce: {
    transaction_id: 'ORD-123',
    value: 99.99,
    currency: 'USD',
    items: [
      {
        item_id: 'SKU-001',
        item_name: 'Classic Tee',
        price: 29.99,
        quantity: 2,
      },
    ],
  },
  userData: {
    email: 'customer@example.com',
  },
  pageType: 'product',
})

Noms d'événements standard

Utilisez ces noms d'événements pour un mapping automatique vers les types d'événements GA4, Meta et TikTok :

Nom de l'événement	Quand le déclencher
`page_view`	Chargement de page ou navigation côté client
`view_item`	Page détail produit
`view_item_list`	Page de collection ou résultats de recherche
`add_to_cart`	Article ajouté au panier
`remove_from_cart`	Article retiré du panier
`search`	Requête de recherche soumise
`begin_checkout`	Checkout démarré
`add_payment_info`	Informations de paiement saisies
`add_shipping_info`	Informations de livraison saisies
`purchase`	Commande finalisée

Événements personnalisés

Vous pouvez utiliser n'importe quelle chaîne de caractères comme nom d'événement. Les événements personnalisés seront transférés tels quels aux destinations qui les prennent en charge.

Champs TrackProperties

Champ	Type	Description
`ecommerce`	`EcommerceData`	Données de transaction et d'articles
`userData`	`UserData`	PII client pour le matching amélioré (hachées côté serveur)
`pageType`	`string`	Libellé du type de page (par ex., "product", "collection", "cart")
`[key: string]`	`unknown`	Toute propriété personnalisée supplémentaire

Exemples

Voir un article

typescript

converlay.track('view_item', {
  ecommerce: {
    items: [{
      item_id: 'SKU-001',
      item_name: 'Classic Tee',
      item_variant: 'Blue / Large',
      price: 29.99,
      quantity: 1,
    }],
  },
})

Ajouter au panier

typescript

converlay.track('add_to_cart', {
  ecommerce: {
    value: 29.99,
    currency: 'USD',
    items: [{
      item_id: 'SKU-001',
      item_name: 'Classic Tee',
      price: 29.99,
      quantity: 1,
    }],
  },
})

Achat

typescript

converlay.track('purchase', {
  ecommerce: {
    transaction_id: 'ORD-5678',
    value: 129.99,
    currency: 'USD',
    items: [
      { item_id: 'SKU-001', item_name: 'Classic Tee', price: 29.99, quantity: 2 },
      { item_id: 'SKU-042', item_name: 'Hoodie', price: 70.01, quantity: 1 },
    ],
  },
  userData: {
    email: 'customer@example.com',
    phone: '+15551234567',
    firstName: 'Jane',
    lastName: 'Doe',
  },
})

Précédent← Démarrage rapide SuivantIdentification des utilisateurs →