EURECA shoppingcartamount
Un article de Eulerian Support.
Contexte
Ce marqueur est utilisé pour enregistrer les commandes réalisées sur votre site.
Syntaxe avec le marqueur Javascript
<script type="text/javascript">
/*<![CDATA[*/
EURECA_shoppingcartamount('<IDENTIFIANT_SITE>', '<MONTANT_COMMANDE>', '<REFERENCE_COMMANDE>', '<VALIDITEE_PANIER>', '<TYPE_DE_COMMANDE>', '<TYPE_DE_PAIEMENT>');
/*]]>*/
</script>
Paramètres
- <IDENTIFIANT_SITE>, obligatoire, correspond à l'identifiant de votre site dans EUreca.
- <MONTANT_COMMANDE>, obligatoire, correspond au montant de la commande.
- <REFERENCE_COMMANDE>, obligatoire, correspond à la référence de la commande. Cette référence doit être unique.
- <VALIDITEE_PANIER>, optionnel, correspond à la durée de validité de votre panier (par défaut à 30 minutes). Format: 30m (30 minutes), 2d (2 jours).
- <TYPE_DE_COMMANDE>, optionnel, correspond à une chaîne de caractére décrivant le type de la commande.
- <TYPE_DE_PAIEMENT>, optionnel, correspond à une chaîne de caractére décrivant le type du paiement.
Exemple
<script type="text/javascript">
/*<![CDATA[*/
EURECA_shoppingcartamount('test', '77.10', 'order123', '', 'hifi', 'CB');
/*]]>*/
</script>
Syntaxe avec un appel IMG
<img src="http://et.eulerian.net/scart/IDENTIFIANT_SITE/?scp=<TYPE_DE_PAIEMENT>&sct=<TYPE_DE_COMMANDE>&scr=<REFERENCE_COMMANDE>&sca=<MONTANT_COMMANDE>&scdur=<VALIDITE_PANIER>" width="1" height="1" border="0" />
Paramètres
- <IDENTIFIANT_SITE>, obligatoire, correspond à l'identifiant de votre site dans EUreca.
- <MONTANT_COMMANDE> : sca, obligatoire, correspond au montant de la commande.
- <REFERENCE_COMMANDE> : scr, obligatoire, correspond à la référence de la commande. Cette référence doit être unique.
- <VALIDITEE_PANIER> : scdur, optionnel, correspond à la durée de validité de votre panier (par défaut à 30 minutes). Format: 30m (30 minutes), 2d (2 jours).
- <TYPE_DE_COMMANDE> : sct, optionnel, correspond à une chaîne de caractére décrivant le type de la commande.
- <TYPE_DE_PAIEMENT> : scp, optionnel, correspond à une chaîne de caractére décrivant le type du paiement.
Exemple
<img src="http://et.eulerian.net/scart/test/?scp=CB&sct=hifi&scr=order123&sca=77.10&scdur=" width="1" height="1" border="0" />
Implémentation
- Ce marqueur doit être posé sur la page de confirmation de commande.
- Le marqueur doit apparaître une seule fois sur une même page.
- Il impératif que la référence commande soit unique et corresponde à celle fournie par votre application e-commerce.
- Il est conseillé de poser ce marqueur le plus haut possible dans la page, entre les balises <body></body>.
- Le montant de la commande peut-être fournie en utilisant le . ou la , comme séparateur, EUreca le transféra avec un . comme séparateur.
- Les types de commandes et les types de paiements sont injectés à la volée et non pas besoin d'être pré-déclaré dans EUreca, il faut donc prendre soin de toujours fournir la même chaine de caractére pour éviter la création de nouvelles entrées.
Remarques spécifiques à l'appel Javascript
- L'appel à la librairie JavaScript EUreca est obligatoire.
- Assurez-vous que d'autres appels Javascript présents sur la page n'interfére pas avec l'appel au marqueur empêchant son exécution.
Remarques spécifiques à l'appel IMG
- Il faut vous assurer que les différentes paramétres sont correctement escapés afin que des charactéres spéciaux (comme le &) n'interfére pas dans l'appel.
Données collectées
- Canal de provenance
- Délai entre réalisation de la commande et exposition à la campagne
- Montant de la commande
- Référence de la commande
- Type de la commande
- Type de paiement
- Adresse IP de l'internaute
- Pays d'origine de l'internaute
- Email de l'internaute si disponible
- Délai entre réalisation de la commande et début de la visite
- Liste des devis liés si disponible
- Si une requête sur le moteur interne a été effectuée, la dernière requête sera liée à la commande
- Si un ou plusieurs paramétres ont été activés, ceux-ci seront liés à la commande
Remarque
Où positionner ce marqueur ?
La solution EUreca vous permet d'annuler des commandes afin que vous puissiez connaître votre nombre de commandes ayant été réellement encaissées. Il est par conséquent conseillé d'implémenter le marqueur d'enregistrement de commande le plus tôt possible dans le processus d'achat.
Il est notamment fortement conseillé de l'implémenter le plus tôt possible dans le process d'achat du client lorsqu'une plateforme de paiement tierce-partie est utilisée et donc, si possible, avant la redirection vers la plateforme de paiement. En effet, ces plateformes ne forcent pas toujours l'internaute à repasser par le site marchand pour valider sa commande, si le marqueur de commande est positionné après la plateforme de paiement et que votre client ferme son navigateur, le marqueur de commande ne sera jamais appelé.
Ceci aura pour conséquence que la commande ne sera pas récupérée dans EUreca alors qu'elle existera dans votre système d'information.
Il est donc plus sur d'implémenter le marqueur dès que vous possédez les informations nécessaires pour l'appeler (référence, montant, type de paiement, etc ...) afin de récupérer le plus de commande possible.
Vérifiez auprès de votre prestataire de paiement en ligne, vous devriez pouvoir forcer le retour depuis l'interface de paiement vers la page de confirmation contenant les marqueurs, cela fiabilisera d'autant les remontées des ventes.
Produits liés à une commande
Si vous désirez récupérer le détail du panier et ainsi connaître la liste des produits liés à une commande, il faut implémenter le marqueur EURECA_shoppingcartadd.
Prise en compte d'une plateforme de paiement électronique tierce-partie
Dans le cas où vous utilisez une plateforme de paiement électronique tierce-partie, il faut enregistrer le nom de domaine de cette plateforme comme alias de domaines, afin qu'elle n'apparaisse pas dans les référants. Il peut arriver, selon les navigateurs, que le nom de domaine de la plateforme soit associé à la commande comme canal de provenance.
Plusieurs ventes à enregistrer sur la même page
Dans certains cas, il est nécessaire de réaliser plusieurs appels au marqueur EURECA_shoppingcartamount sur une même page afin d'enregistrer plusieures ventes avec des références différentes et qui contiennent chacune différents produits.
Pour cela il faut suivre l'exemple ci-dessous qui présente les marqueurs à mettre en place pour enregistrer 2 ventes avec 2 produits chacunes et qui sont liées à un devis. Les appels sont contenus dans un seul et même bloc de code Javascript.
Exemple
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('eulerian.support', '/confirm');
/* facultatif : lien vers le devis ayant pour référence DEVIS01 */
EURECA_shoppingcartestimate('DEVIS01');
/* premier vente ayant pour référence CMD0025 */
EURECA_shoppingcartadd('34.5', '1', 'ref-prd01');
EURECA_shoppingcartadd('134.5', '1', 'ref-prd02');
EURECA_shoppingcartamount('test', '169', 'CMD0025', '30d', 'test', 'CB');
/* deuxiéme vente ayant pour référence CMD0026 */
EURECA_shoppingcartadd('3.5', '1', 'ref-prd03');
EURECA_shoppingcartadd('14.5', '2', 'ref-prd02');
EURECA_shoppingcartamount('test', '32.5', 'CMD0026', '30d', 'test', 'CB');
/*]]>*/
</script>
Explication de la série d'appels :
- EURECA_tag : appel du marqueur générique pour récupérer le canal de provenance
- EURECA_shoppingcartestimate : ceci est facultatif et utile uniquement dans le cas où vous utilisez le marqueur EURECA_estimate et que vous trackez des devis.
- Première vente : 2 appels EURECA_shoppingcartadd car vous avez deux produits différents ayant pour référence ref-prd01 et ref-prd02, puis appel au marqueur EURECA_shoppingcartamount pour enregistrer la vente ayant pour référence CMD0025.
- Deuxième vente : 2 appels EURECA_shoppingcartadd pour les produits ayant pour référence ref-prd03 et ref-prd02, puis appel au marqueur EURECA_shoppingcartamount pour enregistrer la vente ayant pour référence CMD0026.
Pages sécurisées
Si votre process d'achat est sécurisé en SSL, assurez-vous que l'appel à la librairie eureca.js est lui aussi sécurisé.
Si ce n'est pas le cas, une fenêtre d'alerte de sécurité peut s'ouvrir, bloquant l'appel à nos serveurs et empêchant la remontée de la vente dans Eulerian Analytics.
