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 d’ajouter ces dernières à votre marquage d’écran.

Cette méthode renvoie un objet de type Order.

 

Exemples de marquage

  1. Marquage d’une commande et d’un écran à objectif principal

    Sans l’option SalesTracker

    Même sans l’option SalesTracker, vous avez la possibilité de mesurer l’écran de finalisation de commande (objectif principal) en y insérant le montant de l’achat (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();
        }
    }
}
  2. 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();
        }
    }
}
  3. Marquage d’écran de confirmation sur app ou site extérieur

    L’objectif 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();
        }
    }
}
  4. 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
Cet article vous a-t-il été utile ?
Oui
Non
Dernière mise à jour : 21/11/2017
Developers » Windows » Ecommerce » Commandes