Plug-in Adobe : pt

IMPORTANT
Ce plug-in est fourni par le service Adobe Consulting 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 plug-in, pas même pour l’installation ou le dépannage. Si vous avez besoin d’aide sur ce plug-in, contactez l’équipe de compte Adobe de votre organisation. Elle peut organiser une réunion avec un consultant ou une consultante pour obtenir de l’aide.

Le plug-in pt exécute une fonction ou une méthode dans une liste de variables Analytics. Par exemple, vous pouvez exécuter la fonction clearVars de manière sélective sur plusieurs variables sans avoir à lʼappeler manuellement à chaque fois. Plusieurs autres plug-ins dépendent de ce code pour s’exécuter correctement. Ce plug-in n’est pas nécessaire si vous n’avez pas besoin d’exécuter une fonction spécifique sur plusieurs variables Analytics à la fois, ou si vous n’utilisez aucun plug-in dépendant.

Installation du module externe à l’aide du SDK Web ou de l’extension SDK Web

Ce module externe n’est pas encore pris en charge pour une utilisation dans le SDK Web.

Installation du module externe à l’aide de l’extension Adobe Analytics

Adobe propose une extension qui vous permet d’utiliser les plug-ins les plus couramment utilisés avec Adobe Analytics.

  1. Connectez-vous à la collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.

  2. Cliquez sur la propriété de balise de votre choix.

  3. Accédez à l’onglet Extensions, puis cliquez sur le bouton Catalogue.

  4. Installez et publiez l’extension Plug-ins Analytics communs.

  5. Si ce n’est pas déjà fait, créez une règle intitulée « Initialiser les plug-ins » avec la configuration suivante :

    • Condition : aucune
    • É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 communs
    • Type d’action : initialisation de pt
  7. Enregistrez et publiez les modifications apportées à la règle.

Installation du plug-in à l’aide de l’éditeur de code personnalisé

Si vous ne souhaitez pas utiliser l’extension de plug-in Plugins Analytics communs, vous pouvez utiliser l’éditeur de code personnalisé.

  1. Connectez-vous à la collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.
  2. Cliquez sur la propriété de votre choix.
  3. Accédez à l’onglet Extensions, puis cliquez sur le bouton Configurer sous l’extension Adobe Analytics.
  4. Développez l’accordéon Configurer le suivi à l’aide d’un code personnalisé, qui affiche le bouton Ouvrir l’éditeur.
  5. Ouvrez l’éditeur de code personnalisé et collez le code de plug-in fourni ci-dessous dans la fenêtre de modification.
  6. Enregistrez et publiez les modifications apportées à l’extension Analytics.

Installation du plug-in à 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 de s_gi). La conservation des commentaires et des numéros de version du code dans votre mise en œuvre permet à Adobe de résoudre les éventuels problèmes.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilisation du plug-in

La fonction pt utilise les arguments suivants :

  • l (obligatoire, chaîne) : liste des variables sur lesquelles la fonction contenue dans l’argument cf peut s’exécuter.
  • de (facultatif, chaîne) : délimiteur qui sépare la liste des variables dans l’argument l. Par défaut, il s’agit d’une virgule (,).
  • cf (obligatoire, chaîne) : nom de la fonction de rappel contenue dans l’objet AppMeasurement à appeler par rapport à chacune des variables contenues dans l’argument l.
  • fa (facultatif, chaîne) : si la fonction de l’argument cf appelle des arguments supplémentaires lors de son exécution, incluez-les ici. La valeur par défaut est undefined.

Lʼappel de cette fonction renvoie une valeur si la fonction de rappel (dans lʼargument cf) en renvoie une.

Exemples d’appels

Exemple 1

Le code suivant fait partie du plug-in getQueryParam. Il exécute la fonction d’assistance getParameterValue sur chacune des paires clé-valeur contenues dans la chaîne de requête de l’URL (fullQueryString). Pour extraire chaque paire clé-valeur, la chaîne fullQueryString doit être délimitée et séparée par une esperluette « & ». parameterKey fait référence au paramètre de chaîne de requête que le plug-in cherche spécifiquement à extraire de la chaîne de requête.

returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)

La ligne ci-dessus est un raccourci pour exécuter un code semblable à celui présenté ci-dessous :

var returnValue = "",
  parameters = fullQueryString.split("&"),
  parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
  returnValue = getParameterValue(parameters[i], parameterKey);
  if(returnValue !== "") break;
}

Historique des versions

3.0 (19 mars 2021)

  • Ajout du numéro de version comme donnée contextuelle.

2.01 (24 septembre 2019)

  • Modifications mineures du code pour réduire la taille globale.

2.0 (17 avril 2018)

  • Nouvelle version (recompilé, taille de code réduite).
  • Ajout de la prise en charge du code H et d’AppMeasurement.

1.0 (23 septembre 2013)

  • Version initiale.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690