Configuration

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

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.

1. Modification d’une clé de configuration

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

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

   public sealed partial class MainPage : Page, TrackerReadyHandler

    

2. 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);

    

3. 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);
   

    

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.

1. 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);

    

2. 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);

Liste des variables