Show Menu
SUJETS×

Modules DIL

Décrit les méthodes de l’ DIL.modules espace de nommage. Ces modules vous permettent de collecter des données par programmation et de travailler avec des objets d’Audience Manager.

siteCatalyst.init

Utilisation DIL pour envoyer des éléments de Analytics balise (variables, props, eVars, etc.) à l'Audience Manager. Renvoie des données dans une liste séparée par des virgules. Disponible dans la version 2.6.
Signature de fonction : DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
Vous devez placer ce code sur la page avant la s.t(); fonction.
Paramètres
variables Type Description
names Chaîne
Tableau de chaînes qui contient des variables Analytics non énumérées telles que pageName , channel , campaign , product , etc.
iteratedNames Objet
Tableau d’objets contenant des variables Analytics énumérées , telles que props et evars (ex. prop1 , prop2 , evar3 , evar4 ).
maxIndex Entier
Indique le nombre de noms itérés à renvoyer. Par exemple, pour renvoyer deux props ou evars, définissez maxIndex:2 .
siteCatalystReportingSuite Objet
Objet représentant l’objet Analytics .
dilInstance Objet
Objet représentant DIL .
options Objet
Autres options :
  • replaceContextDataPeriodsWith
    Si vous n’indiquez rien d’autre, les points sont remplacés par le trait de soulignement par défaut ( _ ).
    Par exemple, s.contextData = {abc.def = '123'} résulterait c_contextData_abc_def=123 en une chaîne de requête d’appel de événement.
    Cette option est disponible uniquement dans DIL version 5.0 ou ultérieure.
  • filterFromContextVariables
    Par exemple, filterFromContextVariables: ['email', 'zip', 'accountNumber'] le tableau de chaînes serait filtré à partir de la collecte de données de données contextuelles. Cette option exclut les informations d’identification personnelle.
Données capturées par siteCatalyst.init
Cette fonction renvoie des détails sur les Analytics propriétés suivantes :
  • pageName
  • channel
  • campaign
  • products
  • events
  • eVar (1 - 250)
  • prop (1 - 75)
  • pe
  • pev1
  • pev2
  • pev3
Exemple de code
Ce code crée une liste de Analytics événements séparée par des virgules (props, eVars, etc.) si des valeurs existent pour eux.
// Get the Site Catalyst object instance: 
var s = s_gi(s_account); 
  
// Instantiate DIL code: 
var scDil = DIL.create({ 
        partner: 'adobe', 
        containerNSID: 5 
}); 
 
// Use the module: 
DIL.modules.siteCatalyst.init(s, scDil, { 
        //Specify the Site Catalyst variables you want to capture: 
        names: ['pageName', 'channel', 'campaign'], 
        //Use this to create iterated variable names: 
        iteratedNames: [{ 
               name: 'eVar', 
               maxIndex: 75 
        }, { 
               name: 'prop', 
               maxIndex: 75 
        }] 
});

Pour effectuer le suivi de tous les points de données surveillés sans la fonction supplémentaire illustrée ci-dessus, appelez- Analytics siteCatalyst.init vous de la manière suivante :
DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

La GA.submitUniversalAnalytics(); fonction envoie à l'Audience Manager des données de Google Universal Analytics à l'adresse suivante : Cette DIL fonction est conçue pour fonctionner avec analytics.js , qui est la dernière bibliothèque de code pour Google Universal Analytics.
  • Audience Manager ne dispose d’aucune information sur la bibliothèque de code Google ni d’aucun contrôle sur celle-ci. analytics.js Vous devez vérifier que DIL la collecte de données fonctionne toujours si Google publie de nouvelles versions de analytics.js .
  • Vous ne pouvez pas utiliser GA.submitUniversalAnalytics(); si vous travaillez toujours avec le code de suivi des analyses héritées de Google (par ex. ga.js ou dc.js ). Voir GA.init à la place.
Signature de fonction : DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Propriétés
La GA.submitUniversalAnalytics(); fonction accepte les propriétés suivantes.
Propriété Description
gaObject
Variable globale pour votre instance de Google Analytics . Il s’agit généralement ga par défaut, à moins que vous n’ayez personnalisé votre code Google Analytics.
dilInstance
Variable qui représente votre instance de DIL .
internalPropertyName
(Facultatif) Dans la analytics.js bibliothèque, la propriété interne est la variable minifiée 'b' . Cette variable contient les données Google Analytics .
Cette propriété est facultative, car vous n’avez pas besoin de la définir, sauf si Google modifie le nom de leur variable interne. Par exemple, si cette variable minifiée est remplacée par 'a' , vous appelez GA.submitUniversalAnalytics(); comme suit :
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Exemple
Pensez à définir d’abord l’ Google Analytics objet ga , avant d’appeler DIL et GA.submitUniversalAnalytics(); . Votre code peut ressembler à ceci :
//Instantiate DIL 
var dilInstance = DIL.create({ 
     partner:"adobe" 
}); 
 
//Call the DIL Universal Analytics function 
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init

La GA.init() fonction envoie à l’Audience Manager les données de la version héritée/obsolète de Google Analytics la fonction.
GA.init() fonctionne uniquement avec le code de suivi des analyses hérité de Google, ga.js ou dc.js . Vous ne pouvez pas appeler cette DIL fonction si vous utilisez analytics.js , qui est la dernière bibliothèque de code pour Google Universal Analytics. Audience Manager les clients qui utilisent DIL et Universal Analytics doivent voir GA.submitUniversalAnalytics .
Signature de fonction : DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Paramètres
Nom
Type
Description
_gaq
Tableau
Tableau contenant des commandes GA.
dilInstance
Objet
Objet contenant l’instance DIL.
trackVars
Objet
(Facultatif) Objet constitué de la names propriété. Cette propriété est un tableau de noms de commande GA dont vous souhaitez effectuer le suivi.
Appels de fonction GA pris en charge
Par défaut, GA.init capture les données des fonctions suivantes :
  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial
DIL crée des clés pour les données GA
L'Audience Manager accepte les données sous la forme de paires clé-valeur tandis que GA fonctionne avec les éléments d'une matrice. Pour utiliser des données GA, DIL crée automatiquement une paire clé-valeur et forme une clé comme celle-ci : c_ <key name> . En outre, les éléments des tableaux GA apparaissent dans un ordre spécifique. Par conséquent, vous devez fournir tous les paramètres dans cet ordre, même s’ils ne contiennent aucune donnée. DIL mappe les clés pour les méthodes GA suivantes :
// Tracking Social Interactions 
_gaq.push(['_trackSocial', 
    'facebook',                        // c_socialNetwork 
    'like',                            // c_socialAction 
    'https://www.adobe.com/cool.php',   // c_socialTarget 
    '/cool.php'                        // c_socialPagePath 
]);  
 
// Tracking a Transaction 
_gaq.push(['_addTrans', 
   '1234',           // c_transOrderId 
   'Womens Apparel', // c_transAfflication 
   '28.28',          // c_transTotal 
   '1.29',           // c_tranTax 
   '15.00',          // c_transShipping 
   'San Jose',       // c_transCity 
   'California',     // c_transState 
   'USA'             // c_transCountry 
]); 
 
// Tracking an item 
_gaq.push(['_addItem', 
   '1234',           // c_itemOrderId=1234 
   'DD44',           // c_itemSku 
   'T-Shirt',        // c_itemName 
   'Olive Medium',   // c_itemCategory 
   '11.99',          // c_itemPrice 
   '1'               // c_itenQuantity 
]);

Exemple de code
// DIL JavaScript library needs to be loaded and executed here 
var dilInstance = DIL.create({ 
    partner : "adobe" 
}); 
 
// Assume ga.js has not loaded 
var _gaq = _gaq || []; 
_gaq.push( 
  ['_setAccount', 'UA-XXXXX-X'], 
  ['_setDomainName', 'example.com'], 
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3], 
  ['_trackPageview'] 
); 
_gaq.push([ 
  '_addItem', 
  '1234',         // order ID - necessary to associate item with transaction 
  'DD44',         // SKU/code - required 
  'T-Shirt',      // product name - necessary to associate revenue with product 
  'Olive Medium', // category or variation 
  '11.99',        // unit price - required 
  '1'             // quantity - required 
]); 

Pour effectuer le suivi de toutes les mesures GA surveillées sans la fonction supplémentaire ci-dessus, appelez- GA.init vous de la manière suivante :
DIL.modules.GA.init(_gaq, dilInstance).submit();
Exemple d'appel de Événement
L’appel de événement d’URL à l’Audience Manager peut ressembler à ceci :
https://adobe.demdex.com/event?...c_accountId=UA-XXXXX-X&c_Section=Life%20%26%20Style &c_itemOrderId=1234&c_itemSku=DD44&c_itemName=T-Shirt&c_itemCategory=Olive%20Medium& c_itemPrice=11.99&c_itemQuantity=1