Nouveau
!
Découvrez les nouvelles applications de l'Analytics Suite grâce à notre nouvelle
aide en ligne.
Sommaire : Masquer
Les « Webviews » sont des parties de l’application qui lisent des contenus web (pages). L’avantage de ces contenus repose surtout le fait qu’ils n’ont pas besoin d’être définis pour chaque plateforme : ils sont universels. Si votre application ne contient pas de webviews, vous pouvez ne pas tenir compte de ce paragraphe. Par contre, si votre application contient ces webviews, le calcul du visiteur se fera de 2 manières différentes : d’une part via cette bibliothèque qui déterminera un certain ID et d’autre part via le contenu web qui aura un autre ID. Le lien entre ces 2 IDs n’étant pas possible, les visiteurs seront comptés 2 fois. Il faut donc récupérer l’ID visiteur défini par cette bibliothèque et le transmettre comme paramètre au contenu web afin de faire un lien entre ces 2 types de contenus. Cela n’est pas automatique : si vous souhaitez de l’aide sur cette technique, veuillez prendre contact avec le centre support.
Ce document doit vous fournir les informations qui vous permettront d’effectuer le marquage de vos applications iPhone, iPad et IPodTouch.
Vous devez avoir souscrit un abonnement à la solution Analyzer III ainsi qu’à l’option SalesTracker pour pouvoir effectuer toutes les opérations de marquage décrites dans ce document.
Les deux étapes préalables décrites ci-après sont indispensables pour effectuer de marquage.
Etape 1 : import de la bibliothèque dans le projet
La bibliothèque de marquage est disponible depuis votre interface dans Outils > marqueurs dès lors que l'application est ajoutée sur votre contrat.
La bibliothèque se présente sous la forme d’un fichier *.a accompagné de deux fichiers header (ATTag.h et ATParams.h). Cette dernière est compatible avec l’environnement XCode disponible sous MAC uniquement et permet à ce titre d’effectuer un marquage sur les projets applicatifs pour plateformes iOS.
Un simple glisser / déposer dans l’environnement XCode de ces deux fichiers permet d’importer la bibliothèque dans le projet.
Il est également nécessaire d’importer 3 packages afin de rendre le marquage entièrement fonctionnel :
Etape 2 : configuration de la bibliothèque
Une première configuration s’effectue dans le fichier MONAPPLICATION-info.plist afin de paramétrer le sous-domaine (xtsd, de type logxxx) et le numéro du site étudié (xtsite, de type 123456).
Pour tout fichier *.m contenant du marquage il faut lui importer notre fichier ATParams.h
Pour chaque écran à auditer, il convient d’initialiser la bibliothèque. Cette initialisation peut se faire dans toute méthode du code du fichier *.m : par exemple, on peut utiliser la méthode
-(void)viewWillAppear.
ATParams *tag = [[ATParams alloc] init];
[tag xt_sendTag];
[tag release];
Variables de structures
Les variables de structures décrites ci-après vous permettent d’organiser une arborescence de l’application et d’établir des visites et des chemins de navigation. Elles sont obligatoires et doivent être répétées à chaque appel du marqueur.
*Marquer une page :
Utilisez la méthode setPage :
[tag setPage:@"TagBase"];
Elle permet de mesurer des pages vues, de leur attribuer un nom, et de les ranger dans des chapitres.
*Marquer un site de niveau 2 :
Utilisez la méthode setLevel2.
[tag setLevel2:@"1"];
Elle permet de ranger les pages dans un site de niveau 2, préalablement déclaré dans votre espace de travail.
*Heure locale
Ces paramètres sont gérés automatiquement par la bibliothèque. Il en va de même pour les informations de modèle (ex : iPhone) et d’OS (ex : iOS 4.2) du terminal, ainsi que le type de connexion utilisé (ex : Wifi). La langue est de même automatiquement générée.
Exemple :
import "ATParams.h"
@implementation TagBaseViewController
-(void)viewWillAppear:(BOOL)animated{
[super viewWillAppear:animated];
ATParams *tag = [[ATParams alloc] init];
[tag setPage:@"TagBase"];
[tag xt_sendTag];
[tag release];
}
*Libellés dynamiques
Les libellés dynamiques permettent de conserver l'historique d'une page dont le contenu est modifié.
On utilise la méthode setPageID.
-(void)setPageId: (NSString*) pageId
andPageChapter: (NSString*) pageChapter
andPageDate: (NSString*) pageDate
Paramètres:
pageID : identifiant dynamique permettant de renommer la page sans créer une nouvelle page
pageChapter : nom du chapitre correspondant au nouveau libellé de page
pageDate : date du changement de nom (au format AAAAMMJJHHMM)
Exemple :
[tag setPageId:@"123456"
andPageChapter:@"myChapter1::mychapter2::myChapter3"
andPageDate:@"201106010900"];
*Visiteur identifié
Il n’existe pas de méthode propre au passage des variables d’identification visiteur dans les hits, Il faut donc utiliser la méthode « put » afin d’ajouter ces variables.
Exemple :
[tag put:@"an" andValue:@"123456"];
[tag put:@"ac" andValue:@"2"];
Paramètres :
AN : identifiant du visiteur
AC : identifiant de la catégorie de visiteur
Variables complémentaires
Les variables suivantes permettent d’accéder à toutes les fonctionnalités complémentaires de la solution Analyzer III : campagnes publicitaires, indicateurs personnalisés, moteur de recherche interne, suivi des clics, etc.
*Moteur de recherche (moteur interne)
Utiliser la méthode suivante pour récupérer les mots-clés et le nombre de pages de résultats :
- (void) setSearchEngineKeywords: (NSString*) keywords
andNumberOfResults: (NSString*) number
Paramètres :
keywords : expressions clés recherchées (sans caractères spéciaux)
number : numéro de la page de résultats (0 = aucun résultat)
*Clics
Utiliser la méthode suivante pour récupérer tout événement qui ne doit pas être considéré comme une page :
–(void) xt_click: (NSString*) level2
andClickName: (NSString*) click_name
andClickType: (clicType) typeIn
Paramètres :
level2 : identifiant du site de niveau 2 du clic (facultatif)
click_name : libellé du clic
typeIn : type de clic. Les valeurs possibiles sont : action, exitPage, download, navigation.
*Indicateurs globaux
Utiliser la méthode suivante :
(void) setCustomCritera: (NSString*) idCritera
andValue: (NSString*) valueCritera
Paramètres :
idCritera : identifiant de l’indicateur global
valueCritera : valeur de l’indicateur global sous la forme x[i]
Exemple :
import "ATParams.h"
@implementation TagBaseViewController
-(void)viewWillAppear:(BOOL)animated{
[super viewWillAppear:animated];
ATParams *tag = [[ATParams alloc] init];
‚
[tag setPage:@"TagBase"];
[tag setCustomCritera:@"1" andValue:@"X"];
[tag setCustomCritera:@"2" andValue:@"Y"];
[tag setCustomCritera:@"3" andValue:@"Z"];
[tag xt_sendTag];
[tag release];
}
Cette méthode renverra ces variables sous cette forme : &x1=X&x2=Y&x3=Z
*Indicateurs de pages
Utiliser la méthode suivante :
- (void) setCustomForm: (NSString*) idFormCritera
andValue: (NSString*) valueForm
setCustomForm Set a form critera
Paramètres :
idFormCritera : identifiant de l’indicateur de page
valueForm : valeur de l’incidateur de page sous la forme f[i]
Exemple :
import "ATParams.h"
@implementation TagBaseViewController
-(void)viewWillAppear:(BOOL)animated{
[super viewWillAppear:animated];
ATParams *tag = [[ATParams alloc] init];
[tag setPage:@"TagBase"];
[tag setCustomForm:@"1" andValue:@"X"];
[tag setCustomForm:@"2" andValue:@"Y"];
[tag setCustomForm:@"3" andValue:@"Z"];
[tag xt_sendTag];
[tag release];
}
Cette méthode renverra ces variables sous cette forme : &f1=X&f2=Y&f3=Z
*Publicités on site
Utiliser la méthode suivante :
-(void)xt_ad: (BOOL)showOrClick // (Yes : impression ; No : clic)
andIsIntOrExt: (BOOL)IntOrExt // (Yes : auto-promotion ; No : publisher)
andIdCampaign: (NSString*)idCampaign
andIdCreation: (NSString*) creation
andVariant: (NSString*)variant
andFormat: (NSString*)format
andEmplacement: (NSString*)adEmplacement
andEmplacementDetail:(NSString*)adEmplacementDetail
andAnnonceur: (NSString*)annonceur
andIdProduct: (NSString*)idProduct
> Auto-promotion :
Paramètres :
idCampaign : identifiant de la campagne déclarée (variable X)
format : libellé du format de la publicité entres crochets (variable Y)
idProduct : identifiant du produit concerné (variable Z)
Tous les autres paramètres doivent recevoir la valeur "nil".
Exemple de clic (Auto-promotion) :
[tag xt_ad:NO
andIsIntOrExt:YES
andIdCampaign:@"2"
andIdCreation:nil
andVariant:nil
andFormat:@"[150x100]"
andEmplacement:nil
andEmplacementDetail:nil
andAnnonceur:nil
andIdProduct:@"123"];
Exemple d'impression (Auto-promotion) :
[tag xt_ad:YES
andIsIntOrExt:YES
andIdCampaign:@"2"
andIdCreation:nil
andVariant:nil
andFormat:@"[150x100]"
andEmplacement:nil
andEmplacementDetail:nil
andAnnonceur:nil
andIdProduct:@"123"];
> Publisher
Paramètres :
idCampaign : libellé de la campagne ([libelle] ou id[libelle])
creation : libellé de la création ([libelle] ou id[libelle])
variant : libellé de la variante ([libelle] ou id[libelle])
format : libellé du format entre crochets
adEmplacement : libellé de l’emplacement général [libelle]
adEmplacementDetail : libellé de l’emplacement ([libelle] ou id[libelle])
idAnnonceur : libellé de l’annonceur (avec format id[libelle])
Le paramètre "idProduct" doit recevoir la valeur "nil".
Exemple de clic (Publisher) :
[tag xt_ad:NO
andIsIntOrExt:NO
andIdCampaign:@"[campagne]"
andIdCreation:@"[creation]"
andVariant:@"[variant]"
andFormat:@"[150x100]"
andEmplacement:@"[TestEmplacement]"
andEmplacementDetail:@"[TestEmplacementDetail]"
andAnnonceur:@"1[Annonceur]"
andIdProduct:nil];
Exemple d'impression (Publisher) :
[tag xt_ad:YES
andIsIntOrExt:NO
andIdCampaign:@"[campagne]"
andIdCreation:@"[creation]"
andVariant:@"[variant]"
andFormat:@"[150x100]"
andEmplacement:@"[Emplacement]"
andEmplacementDetail:@"[EmplacementDetail]"
andAnnonceur:@"1[Annonceur]"
andIdProduct:nil];
Rich Media
Pour mesurer les contenus multimédias – vidéo, audio, diaporamas, etc. – utilisez la méthode suivante :
-(void)xt_rm: (mediaType) media_type
andLevel2: (NSString*) level2
andPlayerId: (NSString*) playerId
andMediaName: (NSString*) mediaName
andAction: (mediaAction) media_action
andRefreshTime: (NSString*) refreshTime
andMediaDuration: (NSString*) mediaDuration
andMediaQuality: (mediaQuality) media_quality
andMediaStream: (mediaStream) media_stream
andMediaSource: (mediaSource) media_source
andLiveOrClip: (BOOL) liveOrClip
andMediaSize: (NSString*) mediaSize
andMediaExtension: (mediaExtension) media_extension
Paramètres :
media_type : type de média mediaTypeAudio, mediaTypeVideo, ou mediaTypeAnimation
level2 : identifiant de niveau 2
playerId : identifiant du lecteur
mediaName : libellé du contenu
media_action : type d’action play, pause ou stop (voir annexe)
refreshTime : fréquence de rafraichissement, en secondes minimum 5 (0 pour désactiver)
mediaDuration : durée totale, en secondes
media_quality : qualité du contenu Voir annexe
media_stream : flux de lecture Voir annexe
media_source : lieu de diffusion sourceInt ou sourceExt
liveOrClip : Yes pour live, No pour clip
mediaSize : taille du média, en ko
media_extension : extension du média Voir annexe
La durée totale ainsi que la taille sont facultatives pour les contenus en streaming (live).
*Méthode de marquage Rich Media
La méthode de marquage pour le Rich Media diffère légèrement. En effet, pour chaque player présent dans un fichier *.m, vous devez déclarer une bibliothèque en tant qu’objet globale de ce même fichier *.m
Exemple de déclaration :
import "ATParams.h"
@implementation TagBaseViewController
ATParams *player1;
ATParams *player2;
-(void)viewWillAppear:(BOOL)animated{
…
}
Une fois que votre objet player1 est déclaré, vous devez :
Avant toute libération de mémoire, il faut envoyer un hit
avec un type d’action « stop » sous peine de voir les hits de refresh
continuer malgré la fin de la lecture.
Après chaque libération de mémoire, si une nouvelle lecture est lancée
il faut impérativement réinitialiser, par exemple si vous faites « stop
» puis « play », on doit voir les étapes suivantes : envoie d’un hit stop,
libération mémoire, réinitialisation, envoie d’un hit play
Exemple de hit Rich media
//initialization
player1 = [[ATParams alloc] init];
//exemple d’une action “play”
//***************************
[player1 xt_rm:mediaTypeVideo
andLevel2:@”1”
andPlayerId:@”monPlayer1”
andMediaName:@”maVideo”
andAction:play
andRefreshTime:@”5”
andMediaDuration:@”100”
andMediaQuality:quality22khz
andMediaStream:stream128kpbs
andMediaSource:sourceInt
andLiveOrClip:NO
andMediaSize:@”1000”
andMediaExtension:mov];
[player1 xt_sendTag];
//***************************
//libération de la mémoire sur événement de fin de lecture
//********************************************************
[player1 xt_rm:mediaTypeVideo
andLevel2:@”1”
andPlayerId:@”monPlayer1”
andMediaName:@”maVideo”
andAction:stop
andRefreshTime:@”5”
andMediaDuration:@”100”
andMediaQuality:quality22khz
andMediaStream:stream128kpbs
andMediaSource:sourceInt
andLiveOrClip:NO
andMediaSize:@”1000”
andMediaExtension:mov];
[player1 xt_sendTag];
[player1 release];
//********************************************************
Objectifs et ventes
*Variables de structure
Ces variables sont obligatoires pour mesurer les ventes, aussi bien dans Analyzer III que SalesTracker. Utilisez les méthodes :
- (void) setOrderId: (NSString*) orderId
- (void) setOrderPrice: (NSString*) price
Exemple :
[item setOrderId:@"2412201010"];
[item setOrderPrice:@"15,24"];
Les montants peuvent être renseignés avec une virgule ou un point pour la décimale. En revanche, il ne faut pas les utiliser comme séparateur de milliers.
*Variables SalesTracker
> Contenu du panier
Pour mesurer les produits du panier, appelez la méthode suivante autant de fois qu’il y a de produits différents dans le panier.
- (void) xt_addProduct: (NSString*) productName
andQuantity: (NSString*) quantity
andPriceWithoutTaxe: (NSString*) price
andPriceWithTaxes: (NSString*) priceTaxes
andTaxes: (NSString*) taxes
andDiscountBeforeTaxes: (NSString*) dsc
andDiscountWithTaxes: (NSString*) dscc
andDiscountCode: (NSString*) discountCode
Paramètres :
productName : identification produits et rayons Au format id[libellé]
quantity : quantité (entier)
price : prix unitaire HT
priceTaxes : prix unitaire TTC
taxes : montant de taxes
dsc : remise HT
dscc : remise TTC
discountCode : code promotion
> Panier
- (void) setCartId: (NSString*) cartId
> Type de client
Utilisez la méthode suivante pour déterminer si le client est nouveau (No) ou fidèle (Yes).
- (void) setNewCustomer: (BOOL) NewCustomer
> Mode de livraison
- (void) setDelivery: (NSString*) delivery
Paramètre :
delivery : libellé du mode de livraison
> Coût de la livraison avec / sans taxe
- (void) setShippingCostWithoutTaxe: (NSString*) shippingWithoutTaxe
andWithTaxes: (NSString*) shippingWithTaxes
Paramètres:
shippingWithoutTaxe : montant de la livraison HT
shippingWithTaxes : montant de la livraison TTC
> MOYEN DE PAIEMENT
- (void) setPaymentMethod: (NSString*) PaymentMethod
Paramètres :
PaymentMethod : identifiant du moyen de paiement Voir la table de correspondance en annexe.
> CODE DE PROMOTION
Utilisez la méthode suivante pour affecter un code promotion à l’ensemble de la commande :
(void) setPromotionCode: (NSString*) promotionCode
> MONTANT DE LA COMMANDE ET DES TAXES
- (void) setOrderPriceWithTaxes: (NSString*) priceWithTaxes
- (void) setOrderPriceWithoutTaxes: (NSString*) priceWithoutTaxes
- (void) setTaxes: (NSString*) taxes
> MONTANT DE LA REMISE
- (void) setDiscountWithTaxes: (NSString*) dsc
andWithoutTaxes: (NSString*) dscht
Paramètres:
dsc : montant de la remise TTC
dscht : montant de la remise HT
> STATUT DE LA COMMANDE
- (void) setStatus: (NSString*) status
Paramètres :
status identifiant du statut de la commande
1 : en attente
2 : annulée
3 : validée
EXEMPLE COMPLET :
ATParams *tag = [[ATParams alloc] init];
[tag xt_addProduct:12[Rayon_Chaussure]::3[Merazini]::4[Rouge]"
andQuantity:@"2"
andPriceWithoutTaxe:@"180,89"
andPriceWithTaxes:@"189,89"
andTaxes:@"9"
andDiscountBeforeTaxes:@"19"
andDiscountWithTaxes:@"21"
andDiscountCode:@"SOLDE"];
[tag setPage:@"salesTracker"];
[tag setOrderId:@"2412201010"];
[tag setCartId:@"123456"];
[tag setNewCustomer:YES];
[tag setDelivery:@"Colissimo"];
[tag setShippingCostWithoutTaxe:@"10" andWithTaxes:@"12"];
[tag setPaymentMethod:@"1"];
[tag setPromotionCode:@"PROMO"];
[tag setOrderPriceWithTaxes:@"189.89"];
[tag setOrderPriceWithoutTaxes:@"180.89"];
[tag setOrderPrice:@"189.89"];
[tag setTaxes:@"9"];
[tag setDiscountWithTaxes:@"21" andWithoutTaxes:@"19"];
[tag setStatus:@"3"];
[tag xt_sendTag];
[tag release];
La bibliothèque se présente sous la forme d’un fichier *.jar et permet de mesurer les applications mobiles tournant sous Android.
Vous devez avoir souscrit un abonnement à la solution Analyzer III ainsi qu’à l’option SalesTracker pour pouvoir effectuer toutes les opérations de marquage décrites dans ce document.
Vous accédez ainsi aux propriétés du projet.
Dans la partie « Java Build Path », cliquer sur « Add External Jars » puis naviguer vers le dossier contenant la bibliothèque et sélectionner cette dernière. Elle apparait ainsi dans la liste des bibliothèques (libraries) du projet :
Les lignes suivantes doivent impérativement être présentes dans le fichier AndroidManifest.xml à la racine du projet :
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
Dans chaque fichier .java, effectuer les imports suivants :
import com.at.ATParams;
import com.at.ATTag;
Considérons une classe que nous nommerons Home.
Déclarons les propriétés suivantes :
private static String SUBDOMAIN = "logxxx";
private static String SITEID = "123456";
private static String SUBSITE = "2";
public static ATTag attag = null ;
SUBDOMAIN = valeur du sous-domaine (obligatoire)
SITEID = valeur du numéro de site (obligatoire)
SUBSITE = valeur du numéro de site de niveau 2 (facultatif, on peut laisser vide).
Puis dans une méthode de cette classe, on va initialiser un objet de type ATTag :
Home.attag = ATTag.init(Home.this, SUBDOMAIN, SITEID,SUBSITE);
Il faut ensuite déclarer un objet de type ATParams. Nous allons utiliser des méthodes de cet objet pour construire le hit. Pour envoyer le hit, il faut appeller la méthode xt_sendTag() de cet objet.
Exemple :
ATParams atp = new ATParams(); // déclaration de notre objet
// on ajoute ici des éléments au hit
…
atp.xt_sendTag(); // envoi des hits
La configuration de base est prête pour l’envoi de hits. Voyons maintenant les différentes méthodes utilisables.
Marquer une page
*Libellé de page
On utilise la méthode setPage.
atp.setPage("TestPage");
*Libellés dynamiques
Les libellés dynamiques permettent de conserver l'historique d'une page dont le contenu est modifié.
On utilise la méthode setPageID.
public void setPageID(java.lang.String pageID,
java.lang.String pageChapter,
java.lang.String pageDate)
Paramètres:
pageID : identifiant dynamique permettant de renommer la page sans créer une nouvelle page
pageChapter : nom du chapitre correspondant au nouveau libellé de page
pageDate : date du changement de nom (au format AAAAMMJJHHMM)
Marquer un site de niveau 2
On utilise la méthode setLevel2.
atp.setLevel2("2");
*Identifiant visiteur et heure locale
Ces paramètres sont gérés automatiquement par la bibliothèque. Il en va de même pour les informations de modèle (ex : HTC) et d’OS (ex : Android 2.2) du terminal, ainsi que le type de connexion utilisé (ex :Wifi). La langue est de même automatiquement générée.
*Visiteur identifié
Il n’existe pas de méthode propre au passage des variables d’identification visiteur dans les hits, Il faut donc utiliser la méthode put afin d’ajouter ces variables.
Exemple :
atp.put("an","123456");
atp.put("ac","2");
Paramètres :
an : identifiant du visiteur
ac : identifiant de la catégorie de visiteur
ATParams atp = newATParams();
atp.setPage("TestPage");
atp.setLevel2("2");
atp.xt_sendTag(); => le hit est envoyé.
Les variables suivantes permettent d’accéder à toutes les fonctionnalités complémentaires de la solution Analyzer III : campagnes publicitaires, indicateurs personnalisés, moteur de recherche interne, suivi des clics, etc.
Moteur de recherche (moteur interne)
Utiliser la méthode suivante pour récupérer les mots-clés et le nombre de pages de résultats :
public void setSearchEngineKeywords(java.lang.String keywords,
java.lang.String number)
Paramètres :
Keywords : expressions clés recherchées (sans caractères spéciaux)
Number : numéro de la page de résultats (0 = aucun résultat)
Clics
Utiliser la méthode suivante pour récupérer tout événement qui ne doit pas être considéré comme une page :
public void xt_click(String level2, String clickName, clicType clickType)
Paramètres:
level2 : identifiant du site de niveau 2 du clic (facultatif)
clickName : libellé du clic
clickType : type de clic. Les valeurs possibles sont : action, exitPage, download, navigation.
Indicateurs globaux
Utiliser la méthode suivante :
public void setCustomCritera(java.lang.String idCritera, java.lang.String valueCritera)
Paramètres :
idCritera: identifiant de l’indicateur global
valueCritera: valeur de l’indicateur global sous la forme x[i]
Exemple :
ATParams atp = newATParams();
atp.setPage("TestPage");
atp.setCustomCritera("1", "X");
atp.setCustomCritera("2", "Y");
atp.setCustomCritera("3", "Z");
atp.xt_sendTag();
Cette méthode renverra ces variables sous cette forme : &x1=X&x2=Y&x3=Z
Indicateurs de pages
Utiliser la méthode suivante :
public void setCustomForm(java.lang.String idFormCritera,
java.lang.String valueForm)
Paramètres :
idFormCritera: identifiant de l’indicateur de page
valueForm: valeur de l’incidateur de page sous la forme f[i]
Exemple :
ATParams atp = newATParams();
atp.setPage("TestPage");
atp.setCustomForm("1", "X");
atp.setCustomForm("2", "Y");
atp.setCustomForm("3", "Z");
atp.xt_sendTag();
Cette méthode renverra ces variables sous cette forme : &f1=X&f2=Y&f3=Z
Publicités on site
Utiliser la méthode suivante :
public void xt_ad(
boolean showOrClick, // (True : impression ; False : clic)
boolean IntOrExt, // (True : auto-promotion ; False : Publisher)
java.lang.String idCampaign,
java.lang.String creation,
java.lang.String variant,
java.lang.String format,
java.lang.String adEmplacement,
java.lang.String adEmplacementDetail,
java.lang.String annonceur,
java.lang.String idProduct
}
> Auto-promotion
Paramètres:
idCampaign: identifiant de la campagne déclarée (variable X)
format: libellé du format de la publicité entres crochets (variable Y)
idProduct : identifiant du produit concerné (variable Z)
Tous les autres paramètres doivent recevoir une chaine vide ("") en valeur.
Exemple de clic (Auto-promotion)
atp.xt_ad(false, true, "2", "", "", "[120x40]", "", "", "", "156");
Exemple d’impression (Auto-promotion)
atp.xt_ad (true, true, "2", "", "", "[120x40]", "", "", "", "156");
>Publisher
Paramètres :
idCampaign : Identifiant de campagnes ([libelle] ou id[libelle])
creation : libellé de la création ([libelle] ou id[libelle])
variant : libellé de la variante ([libelle] ou id[libelle])
format : libellé du format entre crochets
adEmplacement : libellé de l’emplacement général [libelle]
adEmplacementDetail : libellé de l’emplacement ([libelle] ou id[libelle])
annonceur : identifiant de l’annonceur (avec format id[libelle])
Le paramètre « idProduct » doit recevoir une chaine vide ("") en valeur.
Exemple de clic (Publisher) :
atp.xt_ad (false, false, "[campagne]", "[TestCreation]", "[TestVariante]", "[150x100]", "[TestEmplacement]", "[TestEmplacementDetail]", "1[TestAnnonceur]", "");
Exemple d’impression (Publisher) :
atp.xt_ad (true, false, "[campagne]", "[TestCreation]", "[TestVariante]", "[150x100]", "[TestEmplaement]", "[TestEmplacementDetail]", "1[TestAnnonceur]", "");
Rich media
Pour mesurer les contenus multimédias – vidéo, audio, diaporamas, etc. – utilisez la méthode suivante :
public void xt_rm(
ATParams.mediaType mediaTp,
java.lang.String level2,
java.lang.String playerId,
java.lang.String mediaName,
ATParams.mediaAction mediaAct, java.lang.String refreshTime, java.lang.String mediaDuration,
ATParams.mediaQuality mediaQlt,
ATParams.mediaStream mediaStr,
ATParams.mediaSource mediaSrc,
booleanliveOrClip,
java.lang.String mediaSize,
ATParams.mediaExtension mediaExt)
Paramètres :
mediaTp: type de média (mediaTypeAudio, mediaTypeVideo)
level2 : identifiant du site de niveau 2
playerId : Identifiant du lecteur.
mediaName : libellé du contenu
mediaAct : type d’action (play, pause ou stop)
refreshTime : fréquence de rafraichissement, en secondes
mediaDuration : durée totale, en secondes
mediaQlt : identifiant de qualité
mediaStr : identifiant de flux
mediaSrc: lieu de diffusion (sourceInt ou sourceExt)
liveOrClip : true pour live, false pour clip
mediaSize : taille du média, en ko
mediaExtension : extension du média
La durée totale ainsi que la taille sont facultatives pour les contenus en streaming (live). Une durée de refresh ne peut être inférieure à 5 secondes. Les hits de refresh doivent absolument être stoppés lorsque le media n’est plus en cours de lecture par appel à la fonction xt_rm() avec une action de type « pause » ou « stop ».
Exemple de hit Rich media :
ATParams apParams = newATParams();
apParams.xt_rm(mediaType.mediaTypeVideo,
"",
"1",
"BigBuckBunnyTrailer",
mediaAction.Play,
"5",
"60",
mediaQuality.quality44khz,
mediaStream.mediaStream128Kpbs,
mediaSource.sourceInt,
false,
"500",
mediaExtension.mp3);
apParams.xt_sendTag();
Objectifs et ventes
*Variables de structure
public void setCartId(java.lang.String cartId)
public void setOrderId(java.lang.String orderId)
public void setOrderPrice(java.lang.String price)
Exemple :
atp.setPage(“salesBase”); => libellé de la page de conversion
atp.setOrderId("1234567"); => libellé de la commande
atp.setOrderPrice("15.24");
atp.xt_sendTag();
Les montants peuvent être renseignés avec une virgule ou un point pour la décimale. En revanche, il ne faut pas les utiliser comme séparateur de milliers.*
*Variables SalesTracker
La méthode xt_AddProduct permet d’ajouter un produit à la commande.
Il faut d’abord déclarer un objet ProductElement :
ATProductElement prod = new ATProductElement() ;
On initialise ensuite ce produit par la méthode xt_addProduct
public void xt_addProduct(java.lang.String productName,
java.lang.String quantity,
java.lang.String price,
java.lang.String priceTaxes,
java.lang.String dsc,
java.lang.String dscc,
java.lang.String discountCode)
Paramètres :
productName : identification produits et rayons (au format id[libellé])
quantity : quantité (entier)
price : prix unitaire HT
priceTaxes : prix unitaire TTC
dsc : remise HT
dscc : remise TTC
discountCode : code promotion
On ajoute ensuite le produit à la commande via la méthode xt_addProduct de l’objet ATParams :
Atp.xt_addProduct(prod) ;
>Type de client
Utilisez la méthode suivante pour déterminer si le client est nouveau (false) ou fidèle (true).
public void setNewCustomer(boolean NewCustomer)
>Mode de livraison
public void setDelivery(java.lang.String delivery)
Paramètre :
delivery : libellé du mode de livraison
>Coût de la livraison avec /sans taxe
public void setShippingCostWithoutTaxe(java.lang.String shippingWithoutTaxe,
java.lang.String shippingWithTaxes)
Paramètres:
shippingWithoutTaxe : montant de la livraison HT
shippingWithTaxes : montant de la livraison TTC
>Moyen de paiement
public void setPaymentMethod(java.lang.String paymentMethod)
Paramètre :
paymentMethod : identifiant du moyen de paiement
>Code de promotion
public void setPromotionCode(java.lang.String promotionCode)
Paramètre :
promotionCode : libellé du code de promotion
>Montant de la commande et des taxes
public void setOrderPriceWithTaxes(java.lang.String priceWithoutTaxes)
public void setOrderPriceWithoutTaxes(java.lang.String priceWithoutTaxes)
public void setTaxes(java.lang.String taxes)
>Montant de la remise
public void setDiscountWithTaxes(java.lang.String dsc,
java.lang.String dscht)
Paramètres:
dsc : montant de la remise TTC
dscht : montant de la remise HT
>Statut de la commande
public void setStatus(java.lang.String status)
Paramètre :
Status : identifiant du statut de la commande :
1 : en attente
2 : annulée
3 : validée
Exemple complet :
ATParams ap = newATParams();
ap.setPage("salesBase");
ap.setOrderId("201103301633");
ap.setOrderPriceWithoutTaxes("123.85");
ap.setOrderPriceWithTaxes("180.89");
ap.setOrderPrice("180.89");
ap.setShippingCostWithoutTaxe("12", "9.6");
ap.setTaxes("24.77");
ap.setPaymentMethod("1");
ap.setDelivery ("colissimo");
ap.setStatus("1");
ap.setNewCustomer(true);
ap.setPromotionCode("496_UIRT");
ap.setDiscountWithTaxes("12", "9.6");
// ajout du premier produit
ATProductElement prod = newATProductElement();
prod.xt_addProductForCommand(
"12[Rayon_Chaussure]::3[Merazini]::4[Rouge]",
"2",
"18",
"14",
"12",
"9",
"SOLDES");
ap.xt_addProduct(prod);
//ajout du deuxième produit
prod = newATProductElement();
prod.xt_addProductForCommand(
"12[Rayon_Chaussure]::3[Merazini]::28[Bleu]",
"2",
"4",
"12",
"13",
"4",
"PROMO");
ap.xt_addProduct(prod);
ap.xt_sendTag();
Ces informations vous ont-elles été utiles ?
www.atinternet.com/support
© AT Internet - 2014 - All rights reserved