Windows » Ecommerce » Commandes

Commandes

Avant-propos
Pour bien débuter
Marquage
Exemples de marquage
Classe Order
Propriétés
Classe OrderAmount
Propriétés
Méthodes
Classe OrderDiscount
Propriétés
Méthodes
Classe OrderDelivery
Propriétés
Méthodes
Classe OrderCustomVar
Propriétés
Annexe
Identifiants des moyens de paiement et états des 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();
        }
    }
}

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();
        }
    }
}

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();
        }
    }
}

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();
        }
    }
}

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();
        }
    }
}

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