Décrit les méthodes de l'espace de nommage DIL.modules
. Ces modules vous permettent de collecter des données par programmation et de travailler avec des objets d’Audience Manager.
Fonctionne avec DIL pour envoyer des éléments de balise Analytics (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 fonction s.t();
.
Paramètres
variables | Type | Description |
---|---|---|
names |
Chaîne | Tableau de chaînes contenant des variables Analytics non énumérées telles que |
iteratedNames |
Objet | Tableau d’objets contenant des variables Analytics énumérées telles que props et evars (ex. |
maxIndex |
Entier | Indique le nombre de noms itérés à renvoyer. Par exemple, pour renvoyer deux props ou evars, définissez |
siteCatalystReportingSuite |
Objet | Objet représentant l’objet Analytics . |
dilInstance |
Objet | Objet représentant DIL . |
options |
Objet | Autres options :
|
Données capturées par siteCatalyst.init
Cette fonction renvoie des détails sur les propriétés Analytics 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 séparée par des virgules de Analytics événements (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 suivre tous les points de données Analytics surveillés sans la fonction supplémentaire illustrée ci-dessus, appelez siteCatalyst.init
seul comme suit :
DIL.modules.siteCatalyst.init(s, scDil);
La fonction GA.submitUniversalAnalytics();
envoie à l'Audience Manager des données de Google Universal Analytics. Cette fonction DIL 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 analytics.js
code Google ni d’aucun contrôle sur celle-ci. Vous devez vérifier que la collecte de données DIL 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é de Google (par exemple, ga.js
ou dc.js
). Voir GA.init à la place.
Signature de fonction : DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Propriétés
La fonction GA.submitUniversalAnalytics();
accepte les propriétés suivantes.
Propriété | Description |
---|---|
|
Variable globale pour votre instance de Google Analytics . Il s’agit généralement de |
|
Variable qui représente votre instance de DIL . |
|
(Facultatif) Dans la 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 devient |
Exemple
N'oubliez pas de définir d'abord l'objet Google Analytics 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);
La fonction GA.init()
envoie à l'Audience Manager des données de la version héritée/obsolète de Google Analytics.
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 fonction DIL 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 de 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é de ce type : 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
seul comme suit :
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