3 min de lecture

Comment mesurer l'attribution et le retour sur investissement (ROI) de WhatsApp avec Meta Conversions API (CAPI) ?

Guide développeur : reliez vos ventes WhatsApp à vos publicités Meta Ads via la Conversions API (CAPI) avec ctwa_clid et le hachage SHA-256.

1. Pourquoi la perte de traçabilité entre le clic publicitaire et la vente finale détruit-elle votre rentabilité ?

Lorsqu'un e-commerçant ou une entreprise de services diffuse des publicités Click-to-WhatsApp, l'algorithme de Meta Ads optimise la diffusion sur le critère du clic initial. Mais sans retour d'information sur ce qui se passe après le clic, l'algorithme est 'aveugle'.

Si vos ventes réelles (notamment les livraisons payées en Cash on Delivery) ne sont pas renvoyées aux serveurs de Meta, l'algorithme continue de cibler des utilisateurs qui discutent sans jamais commander, gaspillant ainsi une part substantielle de votre budget publicitaire.

2. Comment capturer et stocker le paramètre ctwa_clid depuis le webhook d'entrée referral de Meta ?

Lorsqu'un prospect arrive via une publicité payante, le premier webhook de message délivré par Meta contient la clé d'attribution unique ctwa_clid (Click-to-WhatsApp Click ID) :

json
{
  "messages": [{
    "from": "212612345678",
    "id": "wamid.HBgL...",
    "referral": {
      "source_type": "ad",
      "source_id": "1202058473920102",
      "ctwa_clid": "ARBxk9_2Lp01XYZ..."
    }
  }]
}

Votre système doit impérativement stocker ce ctwa_clid dans la fiche client ou le panier en cours pour le relier à la transaction future.

3. Comment remonter les événements de conversion vers Meta Conversions API ?

Dès qu'une vente est confirmée ou encaissée sur le terrain, votre serveur déclenche un appel sécurisé vers l'endpoint Meta Conversions API (CAPI) en fournissant les données de réconciliation :

  • Le paramètre ctwa_clid capturé lors du premier contact.
  • Le numéro de téléphone du client haché en SHA-256 (ph).
  • La valeur de la commande (value), la devise (MAD, EUR) et l'événement standardisé (Purchase ou Lead).

Meta associe instantanément la vente à la campagne publicitaire d'origine, affinant son ciblage d'enchères intelligentes vers les profils acheteurs.

4. Comment calculer la valeur à vie client (LTV) par cohorte d'acquisition WhatsApp sur 30, 60 et 90 jours ?

En analysant vos cohortes clients sur 90 jours, vous mesurez la réelle puissance du canal conversationnel :

Période d'analyseChiffre d'affaires moyen par client acquis sur le webChiffre d'affaires moyen par client acquis sur WhatsApp
Jour J (Première commande)350 DH320 DH
J+30 (Réapprovisionnement)+45 DH (taux de réachat 12 %)+180 DH (taux de réachat 42 %)
J+60 (Recommandations croisées)+25 DH+140 DH
J+90 (LTV Totale consolidée)420 DH640 DH (+52 % de LTV)

La proximité du canal WhatsApp favorise des réachats récurrents impossibles à obtenir par de simples newsletters par email.

5. Comment implémenter l'envoi d'événements d'achat hors-ligne vers Meta CAPI en Node.js ?

typescript
import crypto from 'node:crypto';

export async function sendMetaCapiPurchaseEvent({
  pixelId,
  accessToken,
  ctwaClid,
  phoneE164,
  orderId,
  amountMad
}: {
  pixelId: string;
  accessToken: string;
  ctwaClid: string;
  phoneE164: string;
  orderId: string;
  amountMad: number;
}) {
  const hashedPhone = crypto.createHash('sha256').update(phoneE164.trim()).digest('hex');

  const payload = {
    data: [{
      event_name: 'Purchase',
      event_time: Math.floor(Date.now() / 1000),
      action_source: 'business_messaging',
      event_id: orderId,
      user_data: {
        ph: [hashedPhone],
        ctwa_clid: ctwaClid
      },
      custom_data: {
        currency: 'MAD',
        value: amountMad
      }
    }]
  };

  const res = await fetch(`https://graph.facebook.com/v21.0/${pixelId}/events?access_token=${accessToken}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload)
  });

  return res.json();
}

Questions fréquentes

Faut-il installer un Pixel Facebook sur son site si on vend exclusivement sur WhatsApp ?

Non. La Conversions API (CAPI) fonctionne de serveur à serveur et peut être alimentée directement par vos événements de vente WhatsApp sans nécessiter de site web ou de Pixel côté navigateur.

Combien de temps après le clic le ctwa_clid reste-t-il valide pour l'attribution ?

Meta permet d'attribuer des événements de conversion jusqu'à 7 jours après le clic initial (ou jusqu'à 28 jours selon les paramètres de fenêtre d'attribution de votre compte publicitaire).

Le hachage SHA-256 est-il obligatoire pour les données personnelles transmises à CAPI ?

Oui. Meta impose le hachage irréversible SHA-256 sur toutes les données d'identification personnelle (numéro de téléphone, adresse email) avant transmission pour protéger la vie privée des clients.

En quoi CAPI améliore-t-il le coût par acquisition (CPA) de mes campagnes ?

En fournissant à Meta les signaux d'achat réels, ses algorithmes d'apprentissage cessent d'afficher vos publicités aux simples curieux pour concentrer votre budget sur les profils ayant la plus forte probabilité de commander.