Windows » Bien commencer » Configuration

Configuration

Avant-propos
Modification de la configuration
Liste des variables

Avant-propos

Afin de faciliter l’intégration de votre marqueur, l’application Tag Composer vous permet de configurer et télécharger notre SDK.

Ces variables de configuration sont écrites dans le fichier defaultConfiguration.xml du tracker.

Modification de la configuration

Vous pouvez modifier à tout moment la configuration de votre marqueur.

Lors de la création d’un tracker :


Tracker specificTracker = SmartTag.Instance.Tracker("mySpecificTracker", new Dictionary<string, string>()
    {
        { "log","YOURLOG" },
        { "logSSL","YOURSSLLOG" },
        { "domain","YOURDOMAINLOG" },
        { "site", "YOURSITEID" },
        { "pixelPath","/hit.com" },
        { "secure","false" },
        { "identifier","deviceId" },
        { "storage","required" },
        { "hashUserId","false" },
        { "campaignLastPersistence","false" },
        { "campaignLifetime","30" },
        { "sessionBackgroundDuration","60" }
    });

Tracker specificTracker = SmartTag.Instance.Tracker("mySpecificTracker", new Dictionary<string, string>()

{

{ "log","YOURLOG" },

{ "logSSL","YOURSSLLOG" },

{ "domain","YOURDOMAINLOG" },

{ "site", "YOURSITEID" },

{ "pixelPath","/hit.com" },

{ "secure","false" },

{ "identifier","deviceId" },

{ "storage","required" },

{ "hashUserId","false" },

{ "campaignLastPersistence","false" },

{ "campaignLifetime","30" },

{ "sessionBackgroundDuration","60" }

});

Via l’utilisation de la méthode SetConfig du tracker :

Attention, la méthode setConfig est une méthode asynchrone. Pour vous assurer que la configuration a bien été appliquée, un callback vous indique que la configuration est prise en compte.

Modification d’une clé de configuration

C#

tracker.SetConfig("identifier", "deviceId", this);

1
2
3

tracker.SetConfig("identifier", "deviceId", this);

C#

public void TrackerReady() { System.Diagnostics.Debug.WriteLine("config set"); }

1
2
3
4
5
6

public void TrackerReady()
{
System.Diagnostics.Debug.WriteLine("config set");
}

C#

public sealed partial class MainPage : Page, TrackerReadyHandler

1
2
3

public sealed partial class MainPage : Page, TrackerReadyHandler

Remplacement de certaines clés de configuration :

Seules les clés passées en paramètre seront modifiées ou ajoutées dans la configuration existante


Dictionary<string, string> config = new Dictionary<string, string>()
{
      {"site", "YOURSITEID" },
      {"secure", "false" },
      {"identifier", "winId" },
};
tracker.SetConfig(config, false, this);

Dictionary<string, string> config = new Dictionary<string, string>()

{

{"site", "YOURSITEID" },

{"secure", "false" },

{"identifier", "winId" },

};

tracker.SetConfig(config, false, this);

Changement complet d’une configuration :

Les clés existantes seront supprimées et remplacées par les nouvelles clés passées en paramètre


Tracker specificTracker = SmartTag.Instance.Tracker("mySpecificTracker", new Dictionary<string, string>()
    {
        { "log","YOURLOG" },
        { "logSSL","YOURSSLLOG" },
        { "domain","YOURDOMAINLOG" },
        { "site", "YOURSITEID" },
        { "pixelPath","/hit.com" },
        { "secure","false" },
        { "identifier","winId" },
        { "storage","required" },
        { "hashUserId","false" },
        { "campaignLastPersistence","false" },
        { "campaignLifetime","30" },
        { "sessionBackgroundDuration","60" }
    }
);
specificTracker.SetConfig(config, true, this);

Tracker specificTracker = SmartTag.Instance.Tracker("mySpecificTracker", new Dictionary<string, string>()

{

{ "log","YOURLOG" },

{ "logSSL","YOURSSLLOG" },

{ "domain","YOURDOMAINLOG" },

{ "site", "YOURSITEID" },

{ "pixelPath","/hit.com" },

{ "secure","false" },

{ "identifier","winId" },

{ "storage","required" },

{ "hashUserId","false" },

{ "campaignLastPersistence","false" },

{ "campaignLifetime","30" },

{ "sessionBackgroundDuration","60" }

}

);

specificTracker.SetConfig(config, true, this);

Depuis la version 1.2.0, il est désormais possible d’utiliser des helpers et des constantes afin de simplifier la gestion de la configuration.

Exemple d’utilisation des helpers


// Log
SmartTag.Instance.defaultTracker.SetLog("YOURLOG", this);

// Secured log
SmartTag.Instance.defaultTracker.SetSecuredLog("YOURSSLLOG", this);

// Site id
SmartTag.Instance.defaultTracker.SetSiteId(YOURSITEID, this);

// Log

SmartTag.Instance.defaultTracker.SetLog("YOURLOG", this);

// Secured log

SmartTag.Instance.defaultTracker.SetSecuredLog("YOURSSLLOG", this);

// Site id

SmartTag.Instance.defaultTracker.SetSiteId(YOURSITEID, this);

Exemples d’utilisation des constantes (toutes les constantes sont disponibles dans la classe TrackerConfigurationKeys)


// Log
SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.LOG, "YOURLOG", this);

// Secured log
SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.LOG_SSL, "YOURSSLLOG", this);

// Site id
SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.SITE, "YOURSITEID", this);

// Log

SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.LOG, "YOURLOG", this);

// Secured log

SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.LOG_SSL, "YOURSSLLOG", this);

// Site id

SmartTag.Instance.defaultTracker.SetConfig(TrackerConfigurationKeys.SITE, "YOURSITEID", this);

Liste des variables

Nom	Valeur par défaut	Description
log	–	Définit le log de collecte des hits
logSSL	–	Définit le log de collecte sécurisé des hits
domain	xiti.com	Définit le domaine du log de collecte
pixelPath	–	Chemin pour le pixel de confirmation d’envoi
site	–	Définit l’identifiant du site
secure	false	Active l’utilisation du mode SSL
identifier	deviceId	Définit le type d’identifiant utilisateur (deviceId, guid)
storage	never	Définit le mode de stockage des hits (required, never, always)
hashUserId	false	Active le hashage de l’identifiant utilisateur (sha256)
persistIdentifiedVisitor	true	Active le stockage des informations de visiteur identifié (numérique ou texte)
campaignLifetime	30	Définit la durée de vie d’une campagne (par défaut : 30 jours)
campaignLastPersistence	false	Définit le mode de rémanence (par défaut, la première campagne détectée sera considérée comme campagne rémanente)
sessionBackgroundDuration	60	Définit la durée en secondes entre deux sessions une fois que l’application est passée en arrière-plan

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

Oui

Non

Dernière mise à jour : 09/06/2017

Developers » Windows » Bien commencer » Configuration