Show Menu
SUJETS×

appendList

Le module externe (plug-in) apl (ou appendList) permet d’ajouter une valeur à toute liste délimitée, avec la possibilité d’effectuer une vérification sensible ou non à la casse afin de s’assurer que la valeur en question ne figure pas déjà dans la liste. Le module externe APL est référencé par plusieurs modules externes standard, mais il peut être utilisé directement dans un éventail de situations.
Ce module externe permet d’effectuer les opérations suivantes :
  • Ajouter un événement à la variable « events » en cours
  • Ajouter une valeur à la variable « list » sans dupliquer une valeur de la liste
  • Ajouter un produit à la variable « products » en cours sur la base d’une logique de page
  • Ajouter des valeurs aux paramètres linkTrackVars et linkTrackEvents
Cas d’utilisation 1
Scénario
Ajouter event1 à la variable « events » en cours, tout en s’assurant que l’événement n’est pas dupliqué.
s.events="scCheckout"
Code
s.events=s.apl(s.events,"event1",",",1)
Résultats
s.events="scCheckout,event1"
Cas d’utilisation 2
Scénario
Ajouter la valeur history à la variable de liste prop1 , avec history et History considérés comme la même valeur.
s.prop1="Science,History"
Code
s.prop1=s.apl(s.prop1,"history",",",2)
Résultats
s.prop1="Science,History"
history n’est pas ajouté, car History figure déjà dans la liste.
Les instructions suivantes vous demandent de modifier le code de collecte de données sur votre site. Cela peut avoir une incidence sur la collecte des données sur votre site. Aussi, cette opération ne doit-elle être réalisée que par un développeur maîtrisant l’utilisation et l’implémentation d’Analytics.

Implémentation

Procédez comme suit pour implémenter le module externe APL.
  1. Demandez le code du module externe au service à la clientèle ou à votre conseiller Adobe attitré.
  2. Ajoutez le ou les appels à la fonction API dans la fonction s_doPlugins .
Le code peut se présenter comme suit sur votre site :
/* Plugin Config */ 
 
s.usePlugins=true 
 
function s_doPlugins(s) { 
 
/* Add calls to plugins here */ 
 
s.events=s.apl(s.events,"event1",",",1) 
 
} 
 
s.doPlugins=s_doPlugins

Navigateurs pris en charge
Pour utiliser ce module externe, il faut que le navigateur prenne en charge JavaScript version 1.0.
Informations sur le module externe
Informations sur le module externe Description
Paramètres
apl((L,v,d,u)
L = Liste source ; une liste vide est acceptée
v = Valeur à ajouter
d = Délimiteur de liste
u (facultatif, 0 par défaut) Vérification de valeur unique. 0 = Pas de vérification de valeur unique ; la valeur est toujours ajoutée. 1 = Vérification non sensible à la casse ; la valeur n’est ajoutée que si elle ne figure pas dans la liste. 2 = Vérification sensible à la casse ; la valeur n’est ajoutée que si elle ne figure pas dans la liste.
Valeur renvoyée
Liste d’origine, avec une valeur ajoutée, le cas échéant
Exemples d’utilisation
s.events=s.apl(s.events,"event1",",",1);
La liste source L peut être vide, comme par exemple L="" . La valeur renvoyée est soit une liste vide, soit une liste ne contenant qu’une seule valeur.
Code du module externe
/******************************************************************** 
 * 
 * Main Plug-in code (should be in Plug-ins section) 
 * 
 *******************************************************************/ 
/* 
 * Plugin Utility: apl v1.1 
 */ 
s.apl=new Function("l","v","d","u","" 
+"var s=this,m=0;if(!l)l='';if(u){var i,n,a=s.split(l,d);for(i=0;i<a." 
+"length;i++){n=a[i];m=m||(u==1?(n==v):(n.toLowerCase()==v.toLowerCas" 
+"e()));}}if(!m)l=l?l+d+v:v;return l"); 
 
/******************************************************************** 
 * 
 * Commented example of how to use this is doPlugins function 
 * 
 *******************************************************************/ 
  
 Not Applicable - Utility function only 
 
/******************************************************************** 
 * 
 * Config variables (should be above doPlugins section) 
 * 
 *******************************************************************/ 
 
 None 
 
/******************************************************************** 
 * 
 * Utility functions that may be shared between plug-ins (name only) 
 * 
 *******************************************************************/ 
  
 s.split