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 :
- 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
- 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 !
- 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 lURL selon le format [url]).
– G : emplacement général sur lensemble du site (selon des identifiants donnés par AT Internet et mis entre []).
– H : détail de lemplacement 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
- 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é daffiliation (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
- 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 dannonces (selon le format [libellé] ou id[libellé]). Cette variable est obligatoire dans le cadre de limport de données issues de Google Adwords.
– E : variante de lannonce (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
- 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 lemailing 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 linternaute (et notamment les analyses doverlay sur lemailing).
La précision du clic reste à lappré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 : AAAMMJJHHMMSSimport 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