Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

Si vous utilisez Twilio Segment pour suivre les événements sur votre site, vous pouvez envoyer des événements à Topsort directement en ajoutant la destination Topsort dans votre compte Segment. Veuillez consulter la documentation Topsort sur la base de connaissances de Twilio Segments. Comme prérequis pour cette intégration, vous devez avoir un compte Segment et une Source (site web ou application) fonctionnelle.
1

Comprendre les événements requis

Topsort utilise trois événements principaux, tous mappés depuis la spécification eCommerce de Segment :
Événement TopsortMappage Segment par défautMappage alternatif
impressionsProduct ViewedProduct List Viewed
clicksProduct ClickedProduct Added
purchasesOrder Completed—
  • Évitez d’envoyer des clics en double. Si Product Clicked et Product Added sont déclenchés par la même action utilisateur, choisissez-en un seul.
  • Si vous utilisez des événements personnalisés, contactez support@topsort.com pour les mapper correctement.
2

Ajouter la destination Topsort dans Segment

  1. Dans Segment, allez dans Connexions > Catalogue > Destinations
  2. Recherchez Topsort, puis cliquez sur Ajouter une destination
  3. Sélectionnez la Source pertinente (votre site ou application)
Application Segment
3

Configurer les paramètres de destination

  1. Dans la plateforme Topsort Manager, allez dans Paramètres > Intégration API
  2. Copiez ou créez votre clé API Marketplace
  3. De retour dans Segment, ouvrez l’onglet Paramètres de la destination Topsort et collez votre clé API
Paramètres Segment
La clé API permet à Segment d’envoyer des événements à votre compte Topsort.
4

Activer les événements Track et ajouter des métadonnées

  1. Activez uniquement les événements Track que vous envoyez activement depuis votre site
Mappages Segment
Évitez le double comptage en révisant votre logique de déclenchement d’événements.
  1. Ajoutez le champ resolvedBidId à :
  • Événements Product Viewed
  • Événements Product Clicked
Le resolvedBidId identifie de manière unique le gagnant promu de l’enchère. Vous pouvez le récupérer depuis la réponse de l’Auctions API ou du Proxy.Exemple d’appel :
analytics.track('Product Clicked', {
  productId: '12345',
  resolvedBidId: '67890' // requis pour l'attribution Topsort
});
5

Identifier les utilisateurs

Topsort recommande d’identifier les utilisateurs connectés avec la méthode identify de Segment. Exemple :
analytics.identify('361b1fdfbeaa9d64a13c033eb9f970dc6740f6bc', {
  email: 'john.doe@example.com'
});
Les utilisateurs déconnectés sont suivis avec un anonymousId. Si vous utilisez des sources côté serveur, incluez au moins userId ou anonymousId. Une fois qu’un utilisateur est identifié, chaque appel à la méthode Track de Segment enregistre automatiquement l’ID utilisateur. Les utilisateurs qui ne sont pas connectés peuvent être suivis en utilisant un anonymousId.