Passer au contenu principal
L’Events API vous permet d’envoyer des données d’interaction utilisateur en temps réel à Topsort. Ces données alimentent l’attribution de campagne, les rapports et les algorithmes d’optimisation.

​
Types d’événements

Topsort suit trois types d’événements principaux :
ÉvénementDescriptionQuand envoyer
ImpressionL’utilisateur voit un produit promuLorsqu’un produit sponsorisé est rendu à l’écran
ClickL’utilisateur clique sur un produit promuLorsqu’un utilisateur clique sur un produit sponsorisé
PurchaseL’utilisateur complète une transactionLorsqu’une commande est confirmée

​
Options d’intégration

API directe

Envoyez les événements directement à l’Events API de Topsort pour un contrôle et une flexibilité maximum.

Analytics.js

Utilisez notre SDK JavaScript pour un suivi d’événements facile côté client.

Twilio Segment

Routez les événements via Segment si vous l’utilisez déjà pour les analyses.

RudderStack

Intégrez via RudderStack pour un routage d’événements unifié.

​
Concepts clés

​
Resolved Bid ID

Le resolvedBidId est un identifiant unique retourné par l’Auctions API qui lie un événement à un gagnant d’enchère spécifique. Ceci est requis pour les événements d’impression et de clic pour permettre une attribution appropriée. 
{
  "impressions": [
    {
      "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVh...",
      "occurredAt": "2023-05-01T12:00:00Z"
    }
  ]
}

​
Attribution d’événements

Les événements sont attribués aux campagnes en fonction de :
  • Attribution directe : L’utilisateur interagit avec un produit promu et convertit
  • Attribution halo : L’utilisateur voit un produit promu mais achète un produit différent du même vendeur
En savoir plus sur les modèles d’attribution.

​
Étapes d’implémentation

1

Stocker le Resolved Bid ID

Lors de l’affichage des gagnants d’enchères, stockez le resolvedBidId de la réponse de l’enchère.
2

Suivre les impressions

Envoyez un événement d’impression lorsqu’un produit sponsorisé devient visible pour l’utilisateur.
3

Suivre les clics

Envoyez un événement de clic lorsqu’un utilisateur clique sur un produit sponsorisé.
4

Suivre les achats

Envoyez des événements d’achat lorsque les commandes sont complétées, y compris tous les produits achetés.

​
Exemple : Envoi d’événements

curl -X POST https://api.topsort.com/v2/events \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "impressions": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:00Z"
      }
    ],
    "clicks": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:05Z"
      }
    ]
  }'

​
Prochaines étapes

Besoin d'aide avec votre intégration Topsort ?

Parlez-nous, l'équipe d'ingénierie des intégrations.Contactez-nous via votre canal de messagerie dédié ou à support@topsort.com.Si vous n'êtes pas encore client, planifiez une démo avec notre équipe de vente.