Suivi côté serveur

Le suivi côté serveur, parfois appelé S2S ou suivi backend, signifie que les conversions sont envoyées directement de votre serveur à Addrevenue, et non via le navigateur du visiteur.

Cela diffère du suivi côté client, également appelé suivi frontend, où le suivi est effectué via JavaScript dans le navigateur. Le suivi côté client est souvent plus facile à mettre en place, mais il est aussi plus dépendant de l'environnement du navigateur. Le suivi côté serveur vous offre un meilleur contrôle sur le moment et la manière dont une conversion est soumise, et constitue donc souvent un bon choix lorsque le suivi doit être plus robuste ou lorsque la conversion elle-même intervient plus tard dans le processus.

Quand utiliser le suivi côté serveur ?

Le suivi côté serveur est souvent utilisé pour les conversions dites hors ligne, c'est-à-dire lorsque la conversion n'a pas lieu directement sur le site web.

Cela peut être le cas, par exemple, lorsqu'un utilisateur soumet une candidature en ligne, mais que la transaction proprement dite a lieu ultérieurement.

Un exemple courant se trouve dans le secteur financier, où un visiteur fait une demande de prêt sur un site web, mais la commission est calculée en fonction du prêt débloqué. Dans ce cas, la conversion n'a lieu que lorsque le prêt est effectivement débloqué, ce qui se produit souvent plusieurs jours plus tard. Le suivi côté serveur est tout aussi pertinent pour les achats en ligne classiques. En déplaçant le suivi des conversions sur votre serveur, vous réduisez la dépendance au navigateur, ce qui se traduit généralement par une collecte de données plus stable et cohérente.

Des données de meilleure qualité
Moins de conversions perdues
Meilleure cohérence entre les systèmes

Fonctionnement

Le processus est le suivant :

Un utilisateur clique sur un lien d'affiliation.
Addrevenue enregistre le clic et génère un clickId. L'utilisateur arrive sur votre site web avec les paramètres clickId, advertiserId et channelId dans l'URL. Vous enregistrez ces valeurs dans votre environnement, liées à la session.
Lorsqu'une conversion a lieu, votre serveur envoie une requête POST à Addrevenue.

Il est important d'enregistrer les trois valeurs : clickId, advertiserId et channelId, afin qu'elles puissent être envoyées au moment de la conversion.

Stockage sur votre serveur

Le choix du mode de stockage des données dépend de votre implémentation, mais il est généralement conseillé de suivre les recommandations suivantes :

Enregistrez systématiquement clickId, advertiserId et channelId.
Associez ces valeurs à la session, à la commande, au client ou à toute autre identité pertinente côté serveur.
Assurez-vous que les données sont conservées tout au long du parcours d'achat, même s'il comporte plusieurs étapes.
Vérifiez que le stockage fonctionne correctement. Dans certains cas particuliers, comme les visites répétées ou, de préférence, l'utilisation de plusieurs appareils (analyse multi-appareils), si possible.
Évitez de stocker plus de données que nécessaire.

On utilise souvent une combinaison de session côté serveur, de cookies internes et d'une connexion ultérieure à la commande ou au client.

Paramètres de redirection vers votre site web

Lorsque du trafic est envoyé d'Addrevenue vers votre site web, les paramètres sont généralement transmis lors de la redirection, afin que vous puissiez les enregistrer pour une utilisation ultérieure lors du postback.

Les paramètres les plus importants à récupérer sont :

clickId
advertiserId
channelId

Nous pouvons également personnaliser les noms des paramètres ainsi que les paramètres transmis lors de la redirection vers votre site web. Ceci est souvent important si vous utilisez des systèmes existants ou des outils tiers de suivi côté serveur qui attendent des noms différents, par exemple leurs propres paramètres internes ou des formats similaires à `adv_sub`, `aff_sub2` ou `aff_click_id`. Les noms des paramètres dans la requête POST à Addrevenue sont toutefois plus stricts et doivent respecter le schéma ci-dessous. Envoyer une requête POST à Addrevenue Pour le suivi côté serveur, envoyez une requête à : https://addrevenue.io/t

Vous pouvez utiliser la méthode `POST` avec une charge utile JSON ou la méthode `GET` avec des paramètres dans l'URL. Pour les implémentations les plus simples, les deux options conviennent, mais si vous souhaitez envoyer des données plus complexes, comme des listes de produits, le format JSON est la solution la plus claire. Paramètres Paramètres requis Pour la plupart des e-commerçants, il s'agit de Purchase, mais cela peut être n'importe quelle chaîne de caractères correspondant à l'ID de l'événement de conversion de votre programme de commission sur notre plateforme. Identifiant unique de la conversion. Utilisé pour la déduplication et l'identification entre les plateformes.

clickId
Identifie le clic à attribuer.
advertiserId
Votre identifiant d'annonceur chez Addrevenue.
channelId
Identifiant du canal d'affiliation ayant généré le trafic.

Paramètres conditionnels

value
La valeur de conversion, généralement le montant de la commande.
currency
Code de devise selon la norme ISO 4217, par exemple SEK ou EUR.

Ces champs sont obligatoires si vous utilisez un type de commission variable, qui est alors basé sur la valeur de la commande.

Facultatif Paramètre

Marché
Code pays, généralement selon la norme ISO 3166-1 alpha-2, par exemple SE ou DE.

Si ce paramètre est manquant, nous essayons de déduire le marché à partir de l'utilisateur et du premier clic.

Paramètres optionnels pour le e-commerce

Pour les e-commerçants, il existe également des paramètres optionnels supplémentaires qui peuvent être pertinents selon votre configuration.

Codes de réduction

discountCodes peuvent être envoyés sous forme de liste de codes de réduction séparés par des virgules, utilisés lors de l'achat.

Ceci est principalement utilisé pour le suivi des codes de réduction, c'est-à-dire lorsqu'un achat peut être attribué via un code de réduction même si aucun clic n'a été enregistré. Un exemple typique est celui d'un affilié qui publie un code de réduction exclusif dans une publication ou sur les réseaux sociaux sans inclure de lien vers le site web.

Produits

Il est également possible d'envoyer l'intégralité du panier d'achat dans le paramètre products.

products est envoyé sous forme de tableau d'objets, chaque objet devant contenir des propriétés telles que :

item_id
item_name
price
quantity
category

L'objectif est double : d'une part, vous permettre, en tant qu'annonceur, d'obtenir des statistiques par produit ; d'autre part, vous permettre de créer des programmes de commissionnement personnalisés avec des commissions différentes selon les produits.

Puisque La structure de données products est plus complexe et se prête mieux à une requête POST via une charge utile JSON plutôt que via des paramètres GET.

Les champs discountCodes et products sont optionnels et concernent principalement les sites de vente en ligne.

Exemple de requête GET

Les données sont envoyées en tant que paramètres dans l'URL d'une requête GET :

https://addrevenue.io/t?type=Purchase&advertiserId=YOUR_ADVERTISER_ID&channelId=123456&clickId=61f180ac133415.32320128&value=423.00&currency=SEK&orderId=W6234&market=SE

Exemple de requête POST avec charge utile JSON

Les données sont envoyées au format JSON via une requête POST à :

https://addrevenue.io/t

avec En-tête :

Type de contenu : application/json

et corps JSON comme ci-dessous :

{
	"type": "Purchase",
	"advertiserId": "YOUR_ADVERTISER_ID",
	"channelId": "123456",
	"clickId": "61f180ac133415.32320128",
	"value": 42.30,
	"currency": "EUR",
	"orderId": "W6234",
	"market": "DE"
}

Exemple de requête POST avec données e-commerce étendues

Si vous souhaitez envoyer des codes de réduction et des données produit, requête POST avec charge utile JSON est préférable :

{
	"type": "Purchase",
	"advertiserId": "YOUR_ADVERTISER_ID",
	"channelId": "123456",
	"clickId": "61f180ac133415.32320128",
	"value": 42.30,
	"currency": "EUR",
	"orderId": "W6234",
	"market": "SE",
	"discountCodes": "SPRING20,INFLUENCER10",
	"products": [
		{
			"item_id": "SKU-123",
			"item_name": "Running Shoes",
			"price": 29.90,
			"quantity": 1,
			"category": "Shoes"
		},
		{
			"item_id": "SKU-456",
			"item_name": "Sports Socks",
			"price": 12.40,
			"quantity": 1,
			"category": "Accessories"
		}
	]
}

Intégration avec les systèmes existants

Si vous utilisez déjà un outil ou une plateforme de suivi côté serveur, l'intégration avec Addrevenue est généralement possible sans modifications majeures.

Dès lors que les données nécessaires peuvent être transmises par mailback, nous pouvons souvent adapter la redirection au format souhaité, tandis que le mailback vers nous est envoyé selon notre calendrier.

Prise en charge des plateformes

Nos plugins pour WooCommerce et Shopify intégreront bientôt le suivi côté serveur en standard. Pour beaucoup, cela signifie que la mise en œuvre peut être réalisée avec un développement interne considérablement réduit. Résumé Le suivi côté serveur est une méthode flexible et robuste pour signaler les conversions à Addrevenue, qu'il s'agisse de conversions différées ou de transactions e-commerce classiques. L'élément essentiel de la mise en œuvre est la capture et l'enregistrement des identifiants clickId, advertiserId et channelId lorsque l'utilisateur arrive sur votre site web, et leur renvoi à Addrevenue lors de la conversion. Pour les e-commerçants, il est également possible d'ajouter les identifiants discountCodes et products pour le suivi des codes de réduction, les statistiques produits ou des règles de commission plus détaillées.

Créer un compte

Choisissez le type de compte qui correspond le mieux à votre profil