Campagnes marketing

  • iOS
  • watchOS
  • tvOS
 

Avant-propos

Le SDK AT Internet vous permet de marquer vos différents types de campagnes (publicité, affiliation, liens sponsorisés, email marketing)

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez ajouter les informations de campagne à votre hit d’écran.

Dans le cas d’un projet Swift, veillez à importer le module SmartTracker (ou tvOSTracker/watchOSTracker si votre target est une Apple TV / Apple watch) dans votre ViewController. Dans le cas d’un projet Objective-C, veillez à importer les entêtes SmartTracker-Swift.h

 

Marquage

L’objet screen du tracker met à disposition une propriété campaign permettant de renseigner les informations de campagnes et d’ajouter ces dernières à votre marquage d’écran.

Le SDK vous permet de gérer deux modes de rémanence de campagne. Vous pouvez choisir de sauvegarder la première campagne ou la dernière campagne détectée durant une durée définie via la configuration (par défaut, la première campagne sera sauvegardée). Cette information se retrouvera dans la variable xtor de votre hit. Pour modifier le mode de rémanence, procédez comme suit :

  1. La première campagne détectée sera sauvegardée pendant la durée définie dans la configuration (par défaut, 30 jours)

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
            tracker.setConfig(["campaignLastPersistence": "false", "campaignLifetime" : "10"], override: false) { (isSet) -> Void in
                print("Campaign configuration is now set")
            }
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
        
        [self.tracker setConfig:@{@"campaignLastPersistence": @"false", @"campaignLifetime": @"10"} override:NO completionHandler:^(BOOL isSet) {
            NSLog(@"%@", @"Campaign configuration is now set");
        }];
    }
    
    @end
  2. La dernière campagne détectée sera sauvegardée pendant la durée définie dans la configuration (par défaut, 30 jours)

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
            
            tracker.setConfig(["campaignLastPersistence": "true", "campaignLifetime" : "15"], override: false) { (isSet) -> Void in
                print("Campaign configuration is now set")
            }
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
        
        [self.tracker setConfig:@{@"campaignLastPersistence": @"true", @"campaignLifetime": @"15"} override:NO completionHandler:^(BOOL isSet) {
            NSLog(@"%@", @"Campaign configuration is now set");
        }];
    }
    
    @end
 

Exemples de marquage

Une interface est accessible via notre marketplace si vous désirez simplifier le marquage de vos liens sans avoir besoin de connaître la signification de chaque champ. Veuillez noter que l 'interface a été créé par notre communauté et peut être améliorée, n 'hésitez pas à nous envoyer tous vos retours !

  1. Marquage d’une campagne publicitaire

    Le format de l’identifiant de campagne dans le cadre d’une publicité doit respecter les règles suivantes :

    Obligatoire

    – A (source) : préfixe AD
    – B : valeur de l’identifiant de campagne (donné par AT Internet)

    Facultatif :

    – C : création (selon le format [libellé] ou id[libellé]).
    – D : variante (selon le format [libellé] ou id[libellé]).
    – E : format (selon des identifiants donnés par AT Internet et mis entre []. Vous pouvez également spécifier tout autre format de votre choix en utilisant la nomenclature suivante : « [name] ». Exemple : vous pouvez saisir soit un libellé : [button], soit une taille : [120×40]).
    – F : site (en précisant l’URL selon le format [url]).
    – G : emplacement général sur l’ensemble du site (selon des identifiants donnés par AT Internet et mis entre []).
    – H : détail de l’emplacement sur la page web.

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(animated: Bool) {
            let screen = tracker.screens.add("Ad")
            screen.campaign = Campaign(campaignId: "AD-3030-[ad_Version_7]-[without_text]-[468]-[www.site.com]-[GT]-[top_page]")
            screen.sendView()
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        Screen *screen = [self.tracker.screens add:@"Ad"]; 
        // Enable cart and set an identifier
        screen.campaign = [[Campaign alloc] initWithCampaignId:@"AD-3030-[ad_Version_7]-[without_text]-[468]-[www.site.com]-[GT]-[top_page]"];
        [screen sendView];
    }
    
    @end
  2. Marquage d’une campagne d’affiliation

    Le format de l’identifiant de campagne dans le cadre d’une affiliation doit respecter les règles suivantes :

    Obligatoire

    – A (source) : préfixe AL
    – B : valeur de l’identifiant de campagne (selon le format [libellé] ou id[libellé])

    Facultatif :

    – C : type affilié (selon le format [libellé] ou id[libellé]).
    – D : identifiant affilié (selon format numérique ou id[libelle]).
    – E : format de la publicité d’affiliation (selon des identifiants prédéfinis. Vous pouvez également spécifier tout autre format de votre choix en utilisant la nomenclature suivante : « [name] ». Exemple : vous pouvez saisir soit un libellé : [button], soit une taille : [120×40]).
    – F : identifiant création (selon le format [libellé] ou id[libellé])
    – G : variante (selon le format [libellé] ou id[libellé])
    C1* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).
    – C2* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).
    – C3* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).

    * non disponible dans l’Analytics Suite, pour tout besoin d’information nous vous invitons à contacter notre support

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(_ animated: Bool) {
            let screen = tracker.screens.add("Affiliation")
            screen.campaign = Campaign(campaignId: "AL-3030-1[comparison_shopper]-34253-[468]-4[cars_advertisement]-6[blue_version]|233[customer_name]-3425[id_contract]")
            screen.sendView()
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        // Enable cart and set an identifier
        Screen *screen = [self.tracker.screens add:@"Affiliation"]
        screen.campaign = [[Campaign alloc] initWithCampaignId:@"AL-3030-1[comparison_shopper]-34253-[468]-4[cars_advertisement]-6[blue_version]|233[customer_name]-3425[id_contract]"];
        [screen sendView];
    }
    
    @end
  3. Marquage d’une campagne de liens sponsorisés

    Le format de l’identifiant de campagne dans le cadre de liens sponsorisés doit respecter les règles suivantes :

    Obligatoire :

    – A (source) : préfixe SEC
    – B : valeur de l’identifiant de campagne (donné par AT Internet)

    Facultatif :

    – C : identifiant de la plateforme (uniquement si votre campagne est distincte selon chaque plateforme)
    – D : groupe d’annonces (selon le format [libellé] ou id[libellé]). Cette variable est obligatoire dans le cadre de l’import de données issues de Google Adwords.
    – E : variante de l’annonce (selon le format [libellé] ou id[libellé]). En saisissant exactement [{creative}] sur Google, Google placera un ID de variante unique qui permettra d’être relié aux résultats lors des imports de data depuis Google.
    – F : « S » ou « C » selon que la provenance vient du résultat de recherche (« S » pour Search) ou des publicités sur les réseaux de contenus (« C » pour « Content »).
    – G : mot clé précis acheté. En saisissant exactement [{keyword}] pour une campagne sur Google, Google place automatiquement le mot clé précis acheté (qui peut légèrement différer du mot clé saisi). Le principe est similaire pour Yahoo ([{YSMKEY}]).

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(_ animated: Bool) {
            let screen = tracker.screens.add("Sponsored Link")
            screen.campaign = Campaign(campaignId: "SEC-300-GOO-[group_1]-[Var_1]-{ifContent:C}{ifSearch:S}-[{keyword}]&xts=1111111")
            screen.sendView()
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        // Enable cart and set an identifier
        Screen *screen = [self.tracker.screens add:@"Sponsored Link"];
        [self.tracker.campaigns initWithCampaignId:@"SEC-300-GOO-[group_1]-[Var_1]-{ifContent:C}{ifSearch:S}-[{keyword}]&xts=1111111"];
        [screen sendView];
    }
    
    @end
  4. Marquage d’une campagne d’email marketing

    Le format de l’identifiant de campagne dans le cadre d’un emailing doit respecter les règles suivantes :

    Obligatoire :

    – A (source) : préfixe EREC, EPR ou ES
    – B : valeur de l’identifiant de campagne
    – C : identifiant de l’emailing au format [libellé] ou id[libellé] (sans ce libellé, il ne sera pas possible d’obtenir l’analyse overlay de l’emailing).

    Facultatif :

    – D : Date du mail en format court : AAAAMMJJ
    – E : ID du lien au format « [libellé] » (renseigné par vos soins en fonction du lien). A ne renseigner que si vous souhaitez le détail précis du clic de l’internaute (et notamment les analyses d’overlay sur l’emailing).
    La précision du clic reste à l’appréciation du client : chaque lien ou uniquement les principales zones.
    – F : liste de contacts avec identifiant du contact selon id@liste (par exemple 1435@1 pour le contact 1435 de la liste 1).
    – G : Date et heure précise en format long : AAAMMJJHHMMSS

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(_ animated: Bool) {
            let screen = tracker.screens.add("eMailing")
            screen.campaign = Campaign(campaignId: "EPR-300-[Presentation_service]-20070304-[link2]-1435@1-20070304130405")
            screen.sendView()
        }
    }
    #import "ViewController.h"
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        Screen *screen = [self.tracker.screens add:@"eMailing"]
        // Enable cart and set an identifier
        [[Campaign alloc] initWithCampaignId:@"EPR-300-[Presentation_service]-20070304-[link2]-1435@1-20070304130405"];
        [screen sendView];
    }
    
    @end