Attribution et facturation - Topsort Documentation

Attribution et suivi des conversions

Votre configuration de suivi des conversions détermine comment les ventes sont attribuées aux publicités et quelles métriques sont disponibles dans Topsort. Pour un aperçu des choix d’intégration, consultez Suivi des conversions.

Attribution interne Topsort

Lorsque votre marketplace envoie des événements de clic et d’achat à Topsort, Topsort peut attribuer les achats aux publicités grâce à son attribution interne. Vous pouvez appliquer la même fenêtre d’attribution et la même configuration sur les plateformes publicitaires prises en charge, ce qui permet des comparaisons cohérentes des ventes et du retour sur investissement publicitaire (ROAS). Envoyer des événements à Topsort ne signifie pas automatiquement que chaque plateforme publicitaire les reçoit. Sur certaines plateformes publicitaires, dont Google, Topsort transmet les conversions éligibles. D’autres plateformes publicitaires nécessitent un partage de conversions distinct pour prendre en charge l’optimisation vers les conversions. Consultez Implémenter le suivi des événements offsite avec Topsort pour les instructions d’implémentation.

Attribution de la plateforme publicitaire

Lorsque votre marketplace envoie les conversions directement à une plateforme publicitaire, Topsort récupère les rapports résultants et les affiche dans son interface. Ces métriques suivent la méthodologie d’attribution de la plateforme publicitaire. Les différences de fenêtres d’attribution et de paramètres peuvent affecter les comparaisons entre plateformes publicitaires. L’attribution interne de Topsort n’est pas requise pour que l’intégration offsite fonctionne.

Modèle de facturation

La facturation offsite est pilotée par la marketplace et consolidée :

Les vendors consomment une capacité wallet par canal (par exemple wallet Google, Meta, Snapchat, TikTok ou Universal Ads).
La marketplace est facturée directement par le canal pour le media spend.
La marketplace facture ses vendors selon ses conditions commerciales.

Modes de paiement

Prepay : le vendor crédite son wallet avant de dépenser.
Postpay : la marketplace définit les limites de capacité de dépense puis régularise ensuite.

Implémenter le suivi des événements offsite avec Topsort

Cette section s’adresse aux développeurs, par exemple les développeurs frontend qui implémentent le suivi des événements. Elle explique comment envoyer les événements de clic et d’achat de la marketplace à Topsort pour l’attribution interne. Rapportez les événements offsite via le même endpoint /v2/events que pour les événements onsite, avec les paramètres offsite supplémentaires indiqués ci-dessous. L’exemple d’URL de clic et le payload de clic ci-dessous illustrent le suivi des clics Google. Ils ne constituent pas une spécification d’intégration des conversions OpenAI ou Universal Ads.

Identifiant utilisateur opaque

Le même opaqueUserId utilisé pour les événements onsite doit également être réutilisé pour l’attribution offsite. Aucun identifiant offsite distinct n’est requis. Topsort a besoin d’un identifiant utilisateur persistant et respectueux de la vie privée pour relier les clics et les achats entre canaux. Les mêmes exigences onsite s’appliquent à l’usage offsite :

Persistance : Doit rester stable pendant la fenêtre d’attribution (généralement 7–30 jours).
Cohérence : Le même utilisateur doit recevoir le même identifiant entre les visites et les canaux lorsque c’est possible.
Respect de la vie privée : Ne doit pas contenir de PII comme un email, un numéro de téléphone ou un nom.

URL de clic

L’URL sur laquelle arrive l’utilisateur depuis un clic publicitaire offsite comporte des paramètres de requête importants. Exemple d’URL de clic :

https://www.retailer.com/search?q=shampoo&
externalCampaignId=9d2d7d7d-5d4f-4d8e-a8d0-2d7a6f9c1234&
externalVendorId=vendor_abc123&
gclid=CjwKCAj_example123&
utm_source=google&
utm_medium=c

Paramètres de requête :

gclid — identifiant de clic ajouté par Google
externalCampaignId et externalVendorId — paramètres de requête contenant l’ID de campagne et l’ID de vendeur Topsort, ajoutés par Topsort. Ils doivent persister avec l’état d’attribution de l’utilisateur pendant au moins la durée de la fenêtre d’attribution (configurable 7–30 jours). Ils doivent survivre à la navigation et aux visites répétées afin que les événements d’achat ultérieurs puissent être correctement rattachés au clic publicitaire offsite d’origine.

Rapporter les clics

Envoyez l’événement ci-dessous lorsqu’un utilisateur arrive sur votre site depuis un clic publicitaire offsite. Tous les champs sont obligatoires.

POST /v2/events

{
  "clicks": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "entity": {
        "id": "product1",
        "type": "product"
      },
      "externalCampaignId": "<Topsort UUID>",
      "externalVendorId": "<Topsort externalVendorId>",
      "dsp_metadata": {
        "gclid": "<Google click ID>"
      },
      "channel": "offsite"
    }
  ]
}

Rapporter les achats

Tous les champs sont obligatoires.

POST /v2/events

{
  "purchases": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "items": [
        {
          "productId": "product1",
          "vendorId": "<externalVendorId>",
          "unitPrice": 75.0,
          "quantity": 1
        },
        {
          "productId": "product2",
          "vendorId": "<externalVendorId>",
          "unitPrice": 25.0,
          "quantity": 1
        }
      ]
    }
  ]
}

​Attribution et suivi des conversions

​Attribution interne Topsort

​Attribution de la plateforme publicitaire

​Modèle de facturation

​Modes de paiement

​Implémenter le suivi des événements offsite avec Topsort

​Identifiant utilisateur opaque

​URL de clic

​Rapporter les clics

​Rapporter les achats