Show Menu
SUJETS×

Module externe Adobe :inList

Ce module externe est fourni par le service de conseil d’Adobe afin de vous aider à tirer le meilleur parti d’Adobe Analytics. Le service à la clientèle d’Adobe ne fournit pas d’assistance pour ce module externe, y compris l’installation ou le dépannage. Si vous avez besoin d’aide sur ce module externe, contactez le gestionnaire de compte de votre entreprise. Ils peuvent organiser une réunion avec un consultant pour obtenir de l'aide.
Le inList module externe vous permet de vérifier si une valeur existe déjà dans une chaîne délimitée ou dans un objet de tableau JavaScript. Plusieurs autres plug-ins dépendent du inList plug-in pour fonctionner. Ce plug-in fournit un avantage distinct par rapport à la méthode JavaScript indexOf() où vous ne trouvez pas de chaînes partielles. Par exemple, si vous avez utilisé ce plug-in pour vérifier "event2" , il ne correspondra pas à une chaîne contenant "event25" . Ce module externe n’est pas nécessaire si vous n’avez pas besoin de rechercher des valeurs dans des chaînes ou des tableaux délimités, ou si vous souhaitez utiliser votre propre indexOf() logique.

Installation du module externe à l’aide de l’extension Adobe Experience Platform Launch

Adobe propose une extension qui vous permet d’utiliser les plug-ins les plus couramment utilisés.
  1. Connectez-vous à launch.adobe.com à l’aide de vos identifiants AdobeID.
  2. Cliquez sur une propriété.
  3. Accédez à l’onglet Extensions , puis cliquez sur le bouton Catalogue .
  4. Installation et publication de l’extension Plugins Analytics communs
  5. Si ce n’est déjà fait, créez une règle intitulée "Initialiser les modules externes" avec la configuration suivante :
    • Condition : Aucun
    • Événement : Core - Bibliothèque chargée (Haut de la page)
  6. Ajoutez une action à la règle ci-dessus avec la configuration suivante :
    • Extension : Plug-ins Analytics courants
    • Type d'action : Initialiser dansList
  7. Enregistrez et publiez les modifications apportées à la règle.

Installation du module externe à l’aide de l’éditeur de code personnalisé Lancer

Si vous ne souhaitez pas utiliser l’extension du module externe, vous pouvez utiliser l’éditeur de code personnalisé.
  1. Connectez-vous à launch.adobe.com à l’aide de vos identifiants AdobeID.
  2. Cliquez sur la propriété souhaitée.
  3. Accédez à l’onglet Extensions , puis cliquez sur le bouton Configurer sous l’extension Adobe Analytics.
  4. Développez la section Configurer le suivi à l’aide de l’accordéon de code personnalisé, qui affiche le bouton Ouvrir l’éditeur .
  5. Ouvrez l’éditeur de code personnalisé et collez le code du module externe fourni ci-dessous dans la fenêtre de modification.
  6. Enregistrez et publiez les modifications apportées à l’extension Analytics.

Installation du module externe à l’aide d’AppMeasurement

Copiez et collez le code suivant n’importe où dans le fichier AppMeasurement après l’instanciation de l’objet de suivi Analytics (à l’aide s_gi ). La conservation des commentaires et des numéros de version du code dans votre implémentation permet à Adobe de résoudre les éventuels problèmes.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilisation du module externe

La inList méthode utilise les arguments suivants :
  • lv (obligatoire, chaîne ou tableau) : Liste délimitée de valeurs ou objet de tableau JavaScript à rechercher
  • vtc (obligatoire, chaîne) : La valeur à rechercher
  • d (facultatif, chaîne) : Délimiteur utilisé pour séparer les valeurs individuelles dans l’ lv argument. La valeur par défaut est une virgule ( , ) lorsqu’elle n’est pas définie.
  • cc (facultatif, booléen) : Si cette valeur est définie sur true , une vérification sensible à la casse est effectuée. Si la valeur est définie sur false ou omis, une vérification non sensible à la casse est effectuée. Par défaut, false .
L’appel de cette méthode renvoie true s’il trouve une correspondance et false s’il ne trouve pas de correspondance.

Exemples d’appels

Exemple n° 1

Si la variable...
s.events="event22,event24";

...et le code suivant s'exécute...
if(s.inList(s.events,"event22"))

...l’instruction conditionnelle if sera vraie.

Exemple n° 2

Si la variable...
s.events="event22,event24";

...et le code suivant s'exécute...
if(s.inList(s.events,"event2"))

...l’instruction conditionnelle if sera false car l’appel inList n’a pas fait de correspondance exacte entre event2 et l’une des valeurs délimitées de s.events.

Exemple n° 3

Si la variable...
s.events="event22,event24";

...et le code suivant s'exécute...
if(!s.inList(s.events,"event23"))

...l’instruction conditionnelle if sera vraie car l’appel inList n’a pas fait de correspondance exacte entre event23 et l’une des valeurs délimitées de s.events (notez l’opérateur "NOT" au début de l’appel de variable inList).

Exemple n° 4

Si la variable...
s.events = "event22,event23";

...et le code suivant s'exécute...
if(s.inList(s.events,"EVenT23","",1))

...l’instruction conditionnelle if sera false. Bien que cet exemple ne soit pas pratique, il montre la nécessité d’être prudent lors de l’utilisation de l’indicateur sensible à la casse.

Exemple n° 5

Si la variable...
s.linkTrackVars = "events,eVar1";

...et le code suivant s'exécute...
if(s.inList(s.linkTrackVars,"eVar1","|"))

...l’instruction conditionnelle if sera false. Valeur de l’argument d transmise à l’appel (c.-à-d. "|") suppose que les valeurs individuelles dans s.linkTrackVars sont délimitées par un caractère barre verticale, alors qu'en réalité, les valeurs sont délimitées par une virgule. Dans ce cas, le plug-in tente de faire correspondre la valeur entière de s.linkTrackVars (c.-à-d. "events,eVar1") et la valeur à rechercher (c.-à-d. "eVar1").

Historique des versions

v2.1 (26 septembre 2019)

  • Ajout de l’option permettant à l’ cc argument de ne pas être une valeur booléenne. Par exemple, 1 est une valeur de vérification de la casse valide.

v2.0 (17 avril 2018)

  • Publication ponctuelle (recompilée, taille de code réduite).

v1.01 (27 septembre 2017)

  • Code optimisé pour réduire la taille

v1.0 (2009)

  • Version initiale.