Developers » Windows » Ecommerce » Commandes
Commandes
Avant-propos
Le SDK AT Internet vous permet de marquer les commandes effectuées par vos utilisateurs durant l’utilisation de votre application.
Pour bien débuter
Une fois votre marqueur initialisé, vous pouvez ajouter les informations de commandes à votre hit décran.
Pour utiliser les classes et les méthodes du SDK, veillez à ajouter le namespace ATInternet dans votre Page.
Marquage
Le tracker met à disposition un objet Orders. Cet objet expose une méthode Add permettant de renseigner les informations de commandes et dajouter ces dernières à votre marquage décran.
Cette méthode renvoie un objet de type Order.
Exemples de marquage
- Marquage d’une commande et d’un écran à objectif principal
Sans l’option SalesTracker
Même sans loption SalesTracker, vous avez la possibilité de mesurer l’écran de finalisation de commande (objectif principal) en y insérant le montant de lachat (TurnOver) ainsi que le numéro de la commande (OrderId).
using System; using System.Collections.Generic; using Windows.Data.Json; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using ATInternet; using Windows.UI.Xaml.Navigation; namespace App1 { public sealed partial class MainPage : Page { Tracker tracker; public MainPage() { this.InitializeComponent(); tracker = SmartTag.Instance.defaultTracker; } protected override void OnNavigatedTo(NavigationEventArgs e) { tracker.Orders.Add("4655", 3978.65); tracker.Screens.Add("order1").SendView(); } } }
Avec l’option SalesTracker
using System; using System.Collections.Generic; using Windows.Data.Json; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using ATInternet; using Windows.UI.Xaml.Navigation; namespace App1 { public sealed partial class MainPage : Page { Tracker tracker; public MainPage() { this.InitializeComponent(); tracker = SmartTag.Instance.defaultTracker; } protected override void OnNavigatedTo(NavigationEventArgs e) { Order order = tracker.Orders.Add("112", 0.22); order.NewCustomer = true; order.PaymentMethod = 1; order.Status = 1; order.Amount.AmountTaxFree = 23.1; order.Amount.TaxAmount = 10.7; order.Amount.AmountTaxIncluded = 2.8; order.Delivery.DeliveryMethod = "PLANE"; order.Delivery.ShippingFeesTaxIncluded = 1.1; order.Discount.PromotionalCode = "OVZER"; tracker.Screens.Add("Order confirmation").SendView(); } } }
- Marquage d’une commande avec les informations de panier
Pour plus d’informations quant au marquage de votre panier, rendez-vous sur cette page : Panier (SalesTracker)
using System; using System.Collections.Generic; using Windows.Data.Json; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using ATInternet; using Windows.UI.Xaml.Navigation; namespace App1 { public sealed partial class MainPage : Page { Tracker tracker; public MainPage() { this.InitializeComponent(); tracker = SmartTag.Instance.defaultTracker; } protected override void OnNavigatedTo(NavigationEventArgs e) { tracker.Cart.Set("3"); Product p1 = tracker.Cart.Products.Add("Product#1", "cat1"); p1.Category1 = "shoes"; p1.Quantity = 1; p1.UnitPriceTaxFree = 29.9; p1.UnitPriceTaxIncluded = 35; p1.PromotionalCode = "ERT51"; p1.DiscountTaxFree = 0; p1.DiscountTaxIncluded = 0; Product p2 = tracker.Cart.Products.Add("Product#2", "cat7"); p2.Category1 = "socks"; p2.Quantity = 1; p2.UnitPriceTaxFree = 2; p2.UnitPriceTaxIncluded = 3.5; tracker.Orders.Add("ord12", 45.2); tracker.Screens.Add("order and cart").SendView(); tracker.Cart.Unset(); } } }
- Marquage d’écran de confirmation sur app ou site extérieur
Lobjectif est ici de pouvoir mesurer les validations de commandes et réservations, malgré le fait que l’écran de confirmation soit hébergée par une app ou site extérieur (plateformes bancaires, paypal …).
Le marqueur doit être placé sur l’écran précédant le départ vers la banque (contenant toutes les informations de commandes/réservations et de contenu de commande/réservation)
using System; using System.Collections.Generic; using Windows.Data.Json; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using ATInternet; using Windows.UI.Xaml.Navigation; namespace App1 { public sealed partial class MainPage : Page { Tracker tracker; public MainPage() { this.InitializeComponent(); tracker = SmartTag.Instance.defaultTracker; } protected override void OnNavigatedTo(NavigationEventArgs e) { order = tracker.Orders.Add("cmd1", 94.3, 1); order.NewCustomer = true; order.PaymentMethod = 1; order.Status = 1; order.ConfirmationRequired = true; order.Amount.TaxAmount = 14; order.Amount.AmountTaxFree = 80; order.Amount.AmountTaxIncluded = 94.5; order.Delivery.DeliveryMethod = "Plane"; order.Delivery.ShippingFeesTaxFree = 10.0; order.Delivery.ShippingFeesTaxIncluded = 15.0; order.Discount.PromotionalCode = "SUMMER"; tracker.Screens.Add("Order info before payment").SendView(); } } }
- Marquage d’une commande avec ajout de variables personnalisées
using System; using System.Collections.Generic; using Windows.Data.Json; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using ATInternet; using Windows.UI.Xaml.Navigation; namespace App1 { public sealed partial class MainPage : Page { Tracker tracker; public MainPage() { this.InitializeComponent(); tracker = SmartTag.Instance.defaultTracker; } protected override void OnNavigatedTo(NavigationEventArgs e) { order = tracker.Orders.Add("cmd1", 94.3, 1); order.NewCustomer = true; order.PaymentMethod = 1; order.Status = 1; order.ConfirmationRequired = true; order.Amount.TaxAmount = 14; order.Amount.AmountTaxFree = 80; order.Amount.AmountTaxIncluded = 94.5; order.Delivery.DeliveryMethod = "Plane"; order.Delivery.ShippingFeesTaxFree = 10.0; order.Delivery.ShippingFeesTaxIncluded = 15.0; order.Discount.PromotionalCode = "SUMMER"; order.CustomVars.Add(1, "fr"); tracker.Screens.Add("Order info before payment").sendView(); } } }
Classe Order
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
OrderId | String | Chaîne vide | Obtient ou définit l’identifiant de la commande |
Turnover | Double | -1.0 | Obtient ou définit le chiffre d’affaire de la commande |
Status | Int | -1 | Obtient ou définit le status de la commande |
Discount | OrderDiscount | null | Obtient ou définit les informations de remises |
Amount | OrderAmount | null | Obtient ou définit les informations de montants |
Delivery | OrderDelivery | null | Obtient ou définit les informations de livraison |
CustomVariables | OrderCustomVars | null | Obtient ou définit les variables personnalisées |
NewCustomer | Boolean | false | Obtient ou définit si l’utilisateur est un nouveau client ou non |
PaymentMethod | Int | -1 | Obtient ou définit le moyen de paiement |
IsConfirmationRequired | Boolean | false | Obtient ou définit si la commande est en attente de validation par un site extérieur (banque, paypal …) |
Classe OrderAmount
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
AmountTaxFree | Double | -1.0 | Obtient ou définit le montant HT de la commande |
AmountTaxIncluded | Double | -1.0 | Obtient ou définit le montant TTC de la commande |
TaxAmount | Double | -1.0 | Obtient ou définit le montant de la taxe |
Méthodes
Nom | Type de retour | Description |
---|---|---|
Set | Order | Renseigne les informations de montant de la commande |
Classe OrderDiscount
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
DiscountTaxFree | Double | -1.0 | Obtient ou définit le montant HT de la remise |
DiscountTaxIncluded | Double | -1.0 | Obtient ou définit le montant TTC de la remise |
IromotionalCode | String | null | Obtient ou définit le code promotionnel utilisé par l’utilisateur |
Méthodes
Nom | Type de retour | Description |
---|---|---|
Set | Order | Renseigne les informations de montant de remise |
Classe OrderDelivery
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
ShippingFeesTaxFree | Double | -1.0 | Obtient ou définit le montant HT de la livraison |
ShippingFeesTaxIncluded | Double | -1.0 | Obtient ou définit le montant TTC de la livraison |
DeliveryMethod | String | null | Obtient ou définit la méthode de livraison |
Méthodes
Nom | Type de retour | Description |
---|---|---|
Set | Order | Renseigne les informations de livraison |
Classe OrderCustomVar
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
VarId | Int | 0 | Obtient ou définit l’identifiant de la variable |
Value | String | null | Obtient ou définit la valeur de la variable |
Annexe
Identifiants des moyens de paiement et états des commandes
Ci-dessous les correspondances libellés/identifiants pour les moyens de paiement.
Il est possible d’enrichir cette liste avec vos propres moyens de paiement dans la partie Configuration de votre interface.
Identifiant | Libellé | Catégorie |
---|---|---|
1 | CB | Cartes bancaires |
2 | Visa | Cartes bancaires |
3 | MasterCard | Cartes bancaires |
4 | Chèque | Chèques |
5 | Carte magasin | Cartes de crédit |
6 | Financement | Cartes de crédit |
7 | Virement | Virements |
8 | Prélèvement | Prélèvement |
9 | PayPal | Monnaie électronique |
Ci-dessous les correspondances libellés/identifiants pour les statuts des commandes.
Identifiant | Libellé |
---|---|
0 | Non renseigné |
1 | En attente |
2 | Annulée |
3 | Validée |
4 | Retour |