Comment associer un devis à une vente (paramètre estimateref)

Comment associer un devis à une vente (paramètre estimateref)



Catégorie : Customer-Tracking
Tags : estimateref, devis, estimate, vente, sale, tag de vente, association

Question

Comment faire pour qu'une vente soit reliée à un ou plusieurs devis (estimates) dans Eulerian, et que cette association soit visible dans la Liste des ventes (champs Nombre de devis et Devis associé) ?

Réponse courte

Il faut transmettre la / les référence(s) du / des devis dans le tag de vente, via le paramètre estimateref, en utilisant le parametre : estimateref.
Exemple
EA_push([
'ref','ref-de-vente'
,'amount','le'
//LISTE DES AUTRES PARAMETRES
,'estimateref','devis-1'
,'estimateref','devis-2'
,'estimateref','devis-3'
])
Le ou les devis doivent obligatoirement remonter avant la vente.


Pré-requis

  • Le tag de devis doit être correctement déclenché, selon l'implémentation standard Eulerian.
  • Le devis doit être envoyé avant la vente. Si la vente arrive en premier, l'association ne pourra pas se faire.
  • La référence du devis utilisée dans le tag de vente doit correspondre exactement à celle envoyée dans le tag de devis (casse, préfixes, espaces).


Syntaxe JavaScript EA_push

Dans un tag JavaScript classique utilisant EA_push, la syntaxe historique avec clé estimateref répétée est tolérée :
EA_push([
  'ref', 'REF_VENTE',
  'amount', 'LO_AMOUNT',
  // … autres paramètres
  'estimateref', 'REF_DEVIS_1',
  'estimateref', 'REF_DEVIS_2',
  'estimateref', 'REF_DEVIS_3'
]);
Pour toute autre intégration (server-to-server, applications mobiles natives, postbacks, etc.), utiliser la forme indexée estimateref0..N.


Vérification dans l'interface

Une fois l'implémentation en place, contrôler :
  • Liste des ventes → les colonnes Nombre de devis (doit être ≥ 1) et Devis associé (doit afficher la / les références).
  • Liste des devis → vérifier que les devis existent bien dans le système, avec la même référence que celle envoyée via estimateref.


Troubleshooting

L'association ne se fait pas alors que le paramètre est bien envoyé

Cause la plus fréquente : le paramètre est envoyé sous la forme estimateref=... (clé simple) sur une intégration server-to-server, au lieu de la forme indexée estimateref0=....
Solution : remplacer estimateref par estimateref0 (et estimateref1, estimateref2, … si plusieurs devis).

Le devis et la vente existent mais ne sont pas liés

Vérifier la chronologie des hits dans le log brut : le tag de devis doit arriver avant le tag de vente. Si la vente est tirée en premier, Eulerian ne pourra pas faire l'association a posteriori.

La référence n'est pas reconnue

Vérifier qu'il n'y a pas de différence de casse, d'espace, ou de préfixe entre la référence envoyée dans le tag de devis et celle envoyée dans estimateref du tag de vente. Les deux doivent être strictement identiques.