Windows » Campagnes » Publicités

Publicités

Avant-propos
Pour bien débuter
Marquage
Exemples de marquage
Classe Publisher
Propriétés
Méthodes
Classe SelfPromotion
Propriétés
Méthodes

Avant-propos

Le SDK AT Internet propose la mesure de vos publicités in-app afin d’évaluer leurs performances.

Lobjectif est de mesurer les « clics » et les impressions des campagnes de publicité dauto-promotion mais également de campagnes affichées sur votre app pour un tiers, puis de les analyser.

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez débuter le marquage de vos publicités in-app.

Pour utiliser les classes et les méthodes du SDK, veillez à ajouter le namespace ATInternet dans votre Page.

Marquage

Pour marquer vos publicités, le tracker expose deux objets Publishers et SelfPromotions selon le type de publicité à mesurer.

Ces deux objets exposent à leur tour deux méthodes :

Add
SendImpressions

La méthode Add permet d’ajouter un marqueur de publicité et de le mettre en attente d’envoi. Cette méthode renvoie un objet de type Publisher ou SelfPromotion selon le cas.

Pour envoyer les informations définies, vous devrez appeler la méthode SendTouch ou SendImpression de votre objet, en fonction du type d’action effectuée par l’utilisateur ou appeler la méthode Dispatch du Tracker.

Attention, l’appel aux méthodes SendTouch et SendImpression, modifie la propriété action de l’objet.

La méthode SendImpressions permet d’envoyer toutes les informations de publicités dont l’action est définie comme Impression.

Exemples de marquage

Marquage d’une impression d’une publicité pour un tiers


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.Publishers.Add("[ad1]").SendImpression();
        }
    }
}

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.Publishers.Add("[ad1]").SendImpression();

}

Marquage d’un « clic » sur une publicité pour un tiers


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.Publishers.Add("[ad1]").SendTouch();
        }
    }
}

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.Publishers.Add("[ad1]").SendTouch();

}

Marquage d’un « clic » sur une campagne d’auto-promotion

C#

private void Button_clicked(object button, RoutedEventArgs e) { tracker.SelfPromotions.Add(3).SendTouch(); }

1
2
3
4
5
6

private void Button_clicked(object button, RoutedEventArgs e)
{
tracker.SelfPromotions.Add(3).SendTouch();
}

Marquage de plusieurs publicités et envoie des impressions


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)
        {
            Publisher publisher = tracker.Publishers.Add("[ad1]");
            publisher.Creation = "[creation]";
            publisher.Variant = "[variant]";
            publisher.Format = "[120x40]";
            publisher.GeneralPlacement = "[generalPlacement]";
            publisher.DetailedPlacement = "[detailedPlacement]";
            publisher.AdvertiserId = "1[http://advertiser-url.com]";
            publisher.Url = "[creation]";

            Publisher publisher2 = tracker.Publishers.Add("[ad2]");
            Publisher publisher3 = tracker.Publishers.Add("[ad3]");
            publisher3.Creation = "[creation]";
            publisher3.Variant = "[variant]";
            tracker.Publishers.SendImpressions();
       }
    }
}

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)

{

Publisher publisher = tracker.Publishers.Add("[ad1]");

publisher.Creation = "[creation]";

publisher.Variant = "[variant]";

publisher.Format = "[120x40]";

publisher.GeneralPlacement = "[generalPlacement]";

publisher.DetailedPlacement = "[detailedPlacement]";

publisher.AdvertiserId = "1[http://advertiser-url.com]";

publisher.Url = "[creation]";

Publisher publisher2 = tracker.Publishers.Add("[ad2]");

Publisher publisher3 = tracker.Publishers.Add("[ad3]");

publisher3.Creation = "[creation]";

publisher3.Variant = "[variant]";

tracker.Publishers.SendImpressions();

}

Marquage de plusieurs campagnes d’auto-promotion et envoie des impressions


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, TrackerReadyHandler
    {
        Tracker tracker;

        public MainPage()
        {
            this.InitializeComponent();
            tracker = SmartTag.Instance.defaultTracker;
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            SelfPromotion promotion = tracker.SelfPromotions.Add(1);
            promotion.Format = "[120x40]";
            promotion.ProductId = "p1";

            tracker.SelfPromotions.Add(1);

            SelfPromotion promotion2 = tracker.SelfPromotions.add(3);
            promotion2.ProductId = "p3";
            tracker.SelfPromotions.SendImpressions();
        }
    }
}

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, TrackerReadyHandler

{

Tracker tracker;

public MainPage()

{

this.InitializeComponent();

tracker = SmartTag.Instance.defaultTracker;

}

protected override void OnNavigatedTo(NavigationEventArgs e)

{

SelfPromotion promotion = tracker.SelfPromotions.Add(1);

promotion.Format = "[120x40]";

promotion.ProductId = "p1";

tracker.SelfPromotions.Add(1);

SelfPromotion promotion2 = tracker.SelfPromotions.add(3);

promotion2.ProductId = "p3";

tracker.SelfPromotions.SendImpressions();

}

Marquage de publicités et de campagnes d’auto-promotion et utilisation du dispatcher


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, TrackerReadyHandler
    {
        Tracker tracker;

        public MainPage()
        {
            this.InitializeComponent();
            tracker = SmartTag.Instance.defaultTracker;
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            tracker.Publishers.Add();
            tracker.Publishers.Add();
            tracker.SelfPromotions.Add(1);
            tracker.Dispatch();
        }
    }
}

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, TrackerReadyHandler

{

Tracker tracker;

public MainPage()

{

this.InitializeComponent();

tracker = SmartTag.Instance.defaultTracker;

}

protected override void OnNavigatedTo(NavigationEventArgs e)

{

tracker.Publishers.Add();

tracker.SelfPromotions.Add(1);

tracker.Dispatch();

}

Marquage de publicités et campagnes d’auto-promotion et ajout des informations sur un écran


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, TrackerReadyHandler
    {
        Tracker tracker;

        public MainPage()
        {
            this.InitializeComponent();
            tracker = SmartTag.Instance.defaultTracker;
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            SelfPromotion promotion = tracker.SelfPromotions.Add(1);
            promotion.Format = "[120x40]";
            promotion.ProductId = "p1";

            tracker.SelfPromotions.Add(1);

            SelfPromotion promotion2 = tracker.SelfPromotions.Add(3);
            promotion2.ProductId = "p3";
            tracker.Screens.Add().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, TrackerReadyHandler

{

Tracker tracker;

public MainPage()

{

this.InitializeComponent();

tracker = SmartTag.Instance.defaultTracker;

}

protected override void OnNavigatedTo(NavigationEventArgs e)

{

SelfPromotion promotion = tracker.SelfPromotions.Add(1);

promotion.Format = "[120x40]";

promotion.ProductId = "p1";

tracker.SelfPromotions.Add(1);

SelfPromotion promotion2 = tracker.SelfPromotions.Add(3);

promotion2.ProductId = "p3";

tracker.Screens.Add().SendView();

}

Classe Publisher

Propriétés

Nom	Type	Valeur par défaut	Description
CampaignId	String	Chaîne vide	Obtient ou définit le nom de la campagne (ex : [libelle] ou id[libelle])
Creation	String	null	Obtient ou définit le nom de la création (ex : ([libelle] ou id[libelle])
Variant	String	null	Obtient ou définit le nom de la variante (ex : ([libelle] ou id[libelle])
Format	String	null	Obtient ou définit le nom du format (identifiant prédéfini ou personnalisé. ex : [120×40])
GeneralPlacement	String	null	Obtient ou définit l’emplacement général (id texte prédéfini par nos soins, à mettre au format [libelle])
DetailedPlacement	String	null	Obtient ou définit le détail de l’emplacement (ex : [libelle] ou id[libelle])
AdvertiserId	String	null	Obtient ou définit l’identifiant de l’annonceur (ex : id[libelle])
Url	String	null	Obtient ou définit lURL vers laquelle se fait le lien. Celle-ci est forcément liée à lidentifiant de l’annonceur
Action	Enum	OnAppAd.Action.View	Obtient ou définit le type d’action (View ou Touch)

Méthodes

Nom	Type de retour	Description
SendTouch	void	Envoie un hit indiquant qu’une pub a été touchée
SendImpression	void	Envoie un hit indiquant qu’une pub a été vue

Classe SelfPromotion

Propriétés

Nom	Type	Valeur par défaut	Description
AdId	Int	-1	Obtient ou définit l’identifiant de la publicité
Format	String	null	Obtient ou définit le nom du format (identifiant prédéfini ou personnalisé. ex : [120×40])
ProductId	String	null	Obtient ou définit l’identifiant du produit concerné par lauto-promotion que l’on pourra retrouver dans la commande (Soumis à l’option SalesTracker)
Action	Enum	OnAppAd.Action.View	Obtient ou définit le type d’action (View ou Touch)

Méthodes

Nom	Type de retour	Description
SendTouch	void	Envoie un hit indiquant qu’une campagne d’auto-promotion a été touchée
SendImpression	void	Envoie un hit indiquant qu’une campagne d’auto-promotion a été vue

Cet article vous a-t-il été utile ?

Oui

Non

Dernière mise à jour : 29/10/2015

Developers » Windows » Campagnes » Publicités