Suivre les achats
Les vues et les clics disent si vos recommandations sont regardées. Les achats disent ce qu’elles rapportent, et ce sont aussi le signal le plus fort pour entraîner le modèle. Tout site envoie le même événement, purchase ; seul l’endroit d’où il part change.
C’est facultatif. Sans achats, les recommandations s’affichent et le modèle apprend des vues et des clics. Les achats ajoutent le chiffre d’affaires attribué dans la console, et le signal le plus fort pour le modèle.
Ce qui fait qu’un achat compte
Un achat compte dans le chiffre d’affaires attribué de la console quand il porte le recommendation_id du clic d’où il vient, et un properties.price numérique. Un achat sans ces deux champs est quand même enregistré et sert à l’entraînement. Envoyez un événement par produit de la commande.
| Champ | Statut | Rôle |
|---|---|---|
item_id | Obligatoire | L’identifiant du produit, le même que dans votre catalogue LIKYLY. |
user_id et/ou session_id | Obligatoire | Le client connecté, et/ou l’identifiant anonyme du visiteur (le même que pour ses vues et ses clics). |
recommendation_id | Pour le CA attribué | Celui de la recommandation où le produit a été cliqué. Sans lui, l’achat entraîne le modèle mais n’est pas attribué. |
properties.price | Pour le CA attribué | Le prix unitaire, en nombre (49.9), pas en texte ("49,90 €"). Le CA d’une ligne = price × quantity. |
quantity | Conseillé | Le nombre d’exemplaires (1 par défaut). |
event_id | Conseillé | Une clé unique, par exemple purchase_<commande>_<produit> : un achat renvoyé deux fois ne compte qu’une fois. |
properties.currency, .order_id | Facultatif | Conservés tels quels avec l’événement, pour vos propres rapprochements. |
D’où l’envoyer, selon votre site
La règle : l’achat part de l’endroit où la commande est confirmée. Quand cet endroit est votre code, c’est lui qui l’envoie ; sur Shopify, le paiement a lieu sur le checkout de Shopify, où le code du thème ne tourne pas : un pixel fait le relais.
| Site | À faire |
|---|---|
| Magento / Adobe Commerce (module du wizard) | AutomatiqueRien à faire : le module envoie chaque achat depuis la page de confirmation de commande, avec son prix et la recommandation d’où il vient. |
| WordPress / WooCommerce (plugin LIKYLY) | AutomatiqueRien à faire : le plugin garde la recommandation sur la ligne du panier, puis envoie l’achat quand la commande passe en « en cours » ou « terminée ». |
| Thème Shopify (section du wizard) | FacultatifLes vues, impressions et clics partent déjà de la section du thème. Pour ajouter les ajouts au panier et les achats (et le chiffre d’affaires), colle une fois le pixel LIKYLY dans l’admin Shopify : le paiement se fait sur le checkout de Shopify, où le code du thème ne tourne pas, et seul un pixel y voit ces deux événements. |
| Laravel (paquet likyly/laravel) | FacultatifTrois petites étapes dans votre code : garder la recommandation du clic, la mettre sur la ligne du panier, puis envoyer l’achat de chaque ligne quand la commande est confirmée. |
| Votre code (SDK ou API REST) | FacultatifTrois petites étapes dans votre code : garder la recommandation du clic, la mettre sur la ligne du panier, puis envoyer l’achat de chaque ligne quand la commande est confirmée. |
Shopify : le pixel
Sur Shopify, le paiement se fait sur le checkout de Shopify, où le code du thème ne s’exécute pas. Le pixel LIKYLY y écoute les ajouts au panier et les commandes, retrouve la recommandation du clic (gardée par le bloc LIKYLY dans le navigateur) et envoie un achat par produit, avec son prix. Il se colle une fois, dans l’admin Shopify :
- Récupérez le code : dans le dossier du thème,
npx @likyly/wizard pixell’affiche avec votre clé publique et le copie ; ou, dans la console, Événements → Envoyer les achats → Shopify : le code y est déjà prêt, avec votre clé publique. - Admin Shopify → Paramètres → Événements clients → Ajouter un pixel personnalisé ; nommez-le « LIKYLY », collez le code, enregistrez, puis Connecter.
- Testez depuis l’adresse de la boutique, pas depuis
127.0.0.1: le clic dans le bloc et le paiement doivent avoir lieu sur le même domaine.
Voir le code du pixel
// LIKYLY - add to cart and purchases, so LIKYLY can count the revenue its recommendations bring.
// Shopify admin → Settings → Customer events → Add custom pixel → paste this code → Save → Connect.
// Same code as: npx @likyly/wizard pixel
const LIKYLY_KEY = "pk_VOTRE_CLE_PUBLIQUE";
const LIKYLY_API = "https://api.likyly.com";
const numericId = (value) => (String(value ?? "").match(/(\d+)$/) || [])[1] || null;
async function stored(name) {
try {
return await browser.localStorage.getItem(name);
} catch (error) {
return null;
}
}
// The visitor: the same anonymous id as the LIKYLY blocks, and the customer when signed in.
async function who(orderId) {
const out = {};
const session = await stored("likyly_anonymous_id");
if (session) out.session_id = session;
const customer = numericId(init && init.data && init.data.customer && init.data.customer.id);
if (customer) out.user_id = customer;
if (!out.session_id && !out.user_id && orderId) out.session_id = "shopify_order_" + orderId;
return out;
}
// The recommendation this product was clicked in (30 days at most), from the LIKYLY block.
async function attribution(productId) {
try {
const entry = JSON.parse((await stored("likyly_rec")) || "{}")[productId];
if (Array.isArray(entry) && entry[0] && Date.now() - Number(entry[2] || 0) < 30 * 24 * 3600 * 1000) {
return entry[1] ? { recommendation_id: String(entry[0]), placement: String(entry[1]) } : { recommendation_id: String(entry[0]) };
}
} catch (error) {}
return {};
}
function send(events) {
if (!events.length) return;
fetch(LIKYLY_API + "/events/batch", {
method: "POST",
headers: { "Content-Type": "application/json", "X-API-Key": LIKYLY_KEY, "X-Likyly-Client": "likyly-console shopify-custom-pixel" },
body: JSON.stringify({ events: events }),
keepalive: true,
}).catch(() => {});
}
analytics.subscribe("product_added_to_cart", async (event) => {
const line = event.data && event.data.cartLine;
const productId = numericId(line && line.merchandise && line.merchandise.product && line.merchandise.product.id);
if (!productId) return;
const price = Number(line.merchandise.price && line.merchandise.price.amount);
send([Object.assign({
event_type: "add_to_cart",
item_id: productId,
quantity: Math.max(1, Number(line.quantity) || 1),
event_id: "cart_" + event.id,
occurred_at: event.timestamp,
}, await who(), await attribution(productId), Number.isFinite(price) ? { properties: { price: price, currency: line.merchandise.price.currencyCode } } : {})]);
});
// One purchase per product of the order, with its price: what LIKYLY's revenue adds up.
analytics.subscribe("checkout_completed", async (event) => {
const checkout = event.data && event.data.checkout;
if (!checkout) return;
const orderId = numericId(checkout.order && checkout.order.id) || String(checkout.token || event.id);
const byProduct = {};
for (const line of checkout.lineItems || []) {
const productId = numericId(line.variant && line.variant.product && line.variant.product.id);
if (!productId) continue;
const quantity = Math.max(1, Number(line.quantity) || 1);
const total = Number(line.finalLinePrice ? line.finalLinePrice.amount : Number(line.variant.price.amount) * quantity);
const sum = byProduct[productId] || { quantity: 0, revenue: 0 };
sum.quantity += quantity;
sum.revenue += Number.isFinite(total) ? total : 0;
byProduct[productId] = sum;
}
const buyer = await who(orderId);
const events = [];
for (const productId of Object.keys(byProduct)) {
const sum = byProduct[productId];
events.push(Object.assign({
event_type: "purchase",
item_id: productId,
quantity: sum.quantity,
// The same order seen twice (thank-you page reloaded) counts once.
event_id: "purchase_" + orderId + "_" + productId,
occurred_at: event.timestamp,
properties: {
order_id: orderId,
price: Math.round((sum.revenue / sum.quantity) * 100) / 100,
revenue: Math.round(sum.revenue * 100) / 100,
currency: checkout.currencyCode,
},
}, buyer, await attribution(productId)));
}
send(events);
});
Ne mettez qu’une clé publique (pk_…) dans un pixel. Changez de clé publique ? Recollez le pixel avec la nouvelle.
Votre code : SDK ou API REST, en trois étapes
1. Au clic sur un produit recommandé : garder sa recommandation
Chaque réponse de LIKYLY a un identifiant de recommandation (
recommendationId). Quand le visiteur clique un produit dans un bloc, gardez cet identifiant pour ce produit :JavaScript, dans vos pages// Au clic sur un produit recommandé : garder sa recommandation, par produit. function rememberRecommendation(itemId, recommendationId) { const kept = JSON.parse(localStorage.getItem("likyly_clicks") || "{}"); kept[itemId] = [recommendationId, Date.now()]; localStorage.setItem("likyly_clicks", JSON.stringify(kept)); } // À l'ajout au panier : la joindre à la ligne (métadonnée du panier, puis de la commande). function recommendationFor(itemId) { const entry = JSON.parse(localStorage.getItem("likyly_clicks") || "{}")[itemId]; return entry && Date.now() - entry[1] < 30 * 24 * 3600 * 1000 ? entry[0] : undefined; }2. À l’ajout au panier : la mettre sur la ligne du panier
Enregistrez l’identifiant avec la ligne, comme sa quantité ou son prix (
recommendationFor(itemId)ci-dessus). Il suit la ligne jusqu’à la commande. C’est ce que font le plugin WordPress et le module Magento.3. Quand la commande est confirmée : un achat par ligne
Une commande de 3 produits, c’est 3 événements
purchase. Chacun porte la recommandation de sa ligne, ou rien si ce produit n’a pas été trouvé par une recommandation : il est alors enregistré, mais pas compté dans le chiffre d’affaires des recommandations. Le plus fiable : depuis votre serveur, avec la clé secrète, une fois le paiement validé.JavaScript / TypeScriptimport { Likyly } from "@likyly/sdk"; // Sur votre serveur (clé secrète), une fois le paiement validé. // Sur la page de confirmation, la clé publique suffit. const likyly = new Likyly({ apiKey: process.env.LIKYLY_SECRET_KEY }); for (const line of order.lines) { await likyly.events.purchase({ itemId: line.productId, // l'identifiant du produit dans votre catalogue LIKYLY userId: order.customerId, // et/ou sessionId pour un visiteur anonyme recommendationId: line.likylyRecommendationId, // celui du clic, gardé avec la ligne du panier quantity: line.quantity, eventId: `purchase_${order.id}_${line.productId}`, // rejoué, l'achat ne compte qu'une fois properties: { price: line.unitPrice, currency: order.currency, order_id: order.id }, }); }Pythonimport os from likyly import Likyly likyly = Likyly(api_key=os.environ["LIKYLY_SECRET_KEY"]) for line in order.lines: likyly.events.purchase( item_id=line.product_id, user_id=order.customer_id, # et/ou session_id recommendation_id=line.likyly_recommendation_id, # celui du clic quantity=line.quantity, event_id=f"purchase_{order.id}_{line.product_id}", properties={"price": float(line.unit_price), "currency": order.currency, "order_id": order.id}, )PHPuse Likyly\LikylyClient; $likyly = new LikylyClient(apiKey: getenv('LIKYLY_SECRET_KEY')); foreach ($order->lines as $line) { $likyly->events()->purchase( itemId: $line->productId, userId: $order->customerId, // et/ou sessionId recommendationId: $line->likylyRecommendationId, // celui du clic quantity: $line->quantity, properties: ['price' => (float) $line->unitPrice, 'currency' => $order->currency, 'order_id' => $order->id], eventId: "purchase_{$order->id}_{$line->productId}", ); }API RESTcurl -X POST https://api.likyly.com/events/purchase \ -H "X-API-Key: $LIKYLY_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{ "item_id": "SKU-42", "user_id": "customer_123", "recommendation_id": "rec_…", "quantity": 1, "event_id": "purchase_1001_SKU-42", "properties": { "price": 49.9, "currency": "EUR", "order_id": "1001" } }'
Paiement par Stripe, PayPal…
Rien à installer chez Stripe ni chez PayPal. Le paiement se passe chez eux, puis ils préviennent votre serveur que le paiement est validé (la notification « paiement réussi » que votre site reçoit déjà pour valider la commande). C’est à ce moment que votre serveur envoie l’étape 3, plutôt que depuis la page de retour, que le client peut fermer avant qu’elle charge.
Vérifier
- Console → Performance : achats attribués, chiffre d’affaires, conversion (le détail par emplacement et par produit en Pro). Un message y apparaît si quelque chose manque : des clics sans aucun achat reçu, des achats sans leur recommandation, ou un prix envoyé en texte.
- Terminal :
npx @likyly/wizard impact, ou/likyly-impactdans Claude Code.