Show Menu
SUJETS×

Cas d’utilisation DIL et exemples de code

Exemples de code et descriptions pour des cas d’utilisation DIL spécifiques.

Envoyer des éléments de données à l’Audience Manager avec DIL

Créez une variable d’objet qui envoie des informations sur les éléments de page à l’Audience Manager. Cela s’avère utile pour la collecte générale de données ou comme alternative à la collecte de données avec des variables Analytics.
Description
Le code suivant montre comment collecter des données de page et les envoyer à l'Audience Manager avec DIL. Ces exemples utilisent une variable pour contenir des éléments de données dans une liste plate ou un tableau. N’oubliez pas que transmettre des variables sous forme de paires Explication des paires clé-valeur clé-valeur. Notez également le c_ préfixe avant la clé dans la paire clé-valeur. Ce préfixe Exigences de préfixe pour les variables clés requis identifie les informations en tant que données définies par l’utilisateur. Dans le premier exemple, vous devez ajouter manuellement c_ la clé. Dans le deuxième exemple, DIL faites-le automatiquement.
Conserver la cohérence des propriétés de valeur
N’oubliez pas de conserver les propriétés de valeur de la même manière lors de la transmission des données. Par exemple, si vous disposez de deux clés identiques avec des valeurs différentes, la valeur de la dernière paire clé-valeur est prioritaire sur les objets valeur précédents. Par exemple, en transmettant color:blue et en color:red définissant la valeur renvoyée sur rouge (remplace bleu).
Exemple 1 : Envoyer des données sous forme de paires clé-valeur
Cet exemple de base envoie des données de couleur et de prix à l'Audience Manager sous la forme de paires clé-valeur. Votre code peut ressembler à ce qui suit :
				
var sample_dil = DIL.create({partner:"
				

partner name


				"}); 
sample_dil.api.signals({ 
   c_color:"blue", 
   c_price:"900" 
}); 
sample_dil.api.submit();

			

Exemple 2 : Envoyer des données dans un objet
Cet exemple avancé montre comment envoyer des données dans un objet à l'Audience Manager. Lorsque vous utilisez cette méthode, DIL vous permet de transmettre un objet en tant que paramètre de fonction dans la signals() méthode. DIL Votre code peut ressembler à ce qui suit :
				
var my_object = { 
   color : "blue", 
   price : "900" 
}; 
 
var sample_dil = DIL.create({ partner : "
				

partner name


				" }); 
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager. 
sample_dil.api.signals(my_object,"c_").submit();

			

Exemple 3 : Envoyer des données de page dans un tableau
Dans ce cas, la variable my_object utilise un tableau pour contenir les données. Cet exemple s'appuie sur les informations transmises par la méthode recommandée ci-dessus, mais ajoute une couche supplémentaire pour s'adapter à un type de produit et à un modèle. Votre code peut ressembler à ce qui suit :
				
var my_objects = [{ 
   color : "blue", 
   price : "900" 
}, { 
   type : "acura", 
   model : "tl" 
}]; 
 
var sample_dil = DIL.create({ partner : "
				

partner name


				" }); 
 
for (var i = 0; i < my_objects.length; i++) 
//Load the object and append "c_" to all the keys in the key-value pairs.  
{ 
    sample_dil.api.signals(my_objects[i], "c_"); 
} 
sample_dil.api.submit();

			

Capturer l’URL de référence

Capturez et envoyez une URL de référence à l’Audience Manager.
Cette méthode fonctionne uniquement lorsque les utilisateurs se déplacent entre des pages avec des protocoles similaires (HTTP ou HTTPS). Par exemple, le navigateur conserve une URL de référence lorsque vous naviguez d’un site sécurisé à un autre site sécurisé. Les navigateurs ne conservent pas l’URL de référence lorsque vous vous déplacez entre des sites sécurisés et non sécurisés. Ce comportement est une fonctionnalité normale du navigateur et ne peut pas être contourné par DIL.
Exemple de code
Votre code peut ressembler à ce qui suit :
				
var adobe_dil = DIL.create({ partner : "
				

partner name


				" }); 
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

			

Capturer les types de moteurs de recherche et les termes de recherche de mots-clés

Envoyez des informations sur le type de moteur de recherche et les recherches de mots-clés à l'Audience Manager.
Cette section décrit les fonctionnalités héritées, qui ne sont pas prises en charge dans les dernières versions de DIL.
Moteurs de recherche pris en charge
Par défaut, DIL.getSearchReferrer reconnaît les recherches issues de ces moteurs de recherche (y compris les variations internationales) :
  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!
Description
Le code suivant montre comment obtenir le parrain de recherche de l'un des moteurs de recherche pris en charge. Dans ce cas, supposons qu'un utilisateur ait recherché le terme "domiciles" au Google Canada ( www.google.ca ). Ce code vous aidera à capturer ces termes de recherche et à les envoyer à l'Audience Manager.
Code de base
Le code de base pour obtenir le parrain de recherche ( google.com par exemple) ressemble à ceci :
var search_referrer = DIL.tools.getSearchReferrer();

Exemple de code de moteur de recherche répertorié
Dans ce cas, supposons qu’un utilisateur ait recherché le terme "domiciles" au Google Canada ( www.google.ca ). Notez comment le code préfixe le c_ paramètre requis sur le moteur de recherche ( c_se ) et le terme de recherche ( c_st ). c_ est un préfixe Exigences de préfixe pour les variables clés obligatoire qui identifie ces variables comme des variables définies par le client à Audience Manager.
				
var adobe_dil = DIL.create({partner:"
				

partner name


				"}); 
var search_referrer = DIL.tools.getSearchReferrer(); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

			

Exemple de code de moteur de recherche non répertorié
Dans ce cas, supposons qu’un utilisateur ait recherché le terme "domiciles" dogpile.com . Étant donné que Dogpile la fonction DIL n’est pas prise en charge par défaut, vous pouvez configurer DIL pour reconnaître ce moteur de recherche et renvoyer les termes de recherche à l’Audience Manager. Votre code peut ressembler à ce qui suit :
				
var adobe_dil = DIL.create({partner:"
				

partner name


				"}); 
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {  
    hostPattern:/dogpile\./, 
    queryParam:"q" 
}); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

			

Faire correspondre les valeurs clés aux autres clés

Associez la valeur d’une paire clé-valeur à une autre clé.
Description
Dans une paire clé-valeur, le c_ préfixe ajouté à la clé identifie le signal comme des données définies par le client. Les données définies par le client sont utilisées pour le ciblage sur le site spécifique qui transmet les données lors d’un appel de événement. Cependant, il arrive que vous souhaitiez que ces informations soient disponibles dans toutes les propriétés de votre compte d’Audience Manager. Pour ce faire, faites correspondre la valeur d’une paire c_ clé-valeur à une clé de niveau plate-forme. Une clé au niveau de la plate-forme est préfixe d_ et rend le signal disponible pour le ciblage sur toutes les propriétés de votre compte.
Par exemple, vous collectez des données de code postal à partir d’un site particulier mais souhaitez les cible à toutes vos propriétés d’Audience Manager. Pour rendre le code postal disponible au niveau de la plate-forme, vous pouvez mapper votre clé de code postal définie par le client (ex. c_zip ) à une clé définie par la plateforme, comme illustré ci-dessous.
Exemple de code
Votre code peut ressembler à ce qui suit :
var adobe_dil = DIL.create({ 
    partner : "adobe", 
    mappings : { 
        c_zip : 'd_zip', 
        d_key2 : 'h_dil_key2' 
    } 
}); 
adobe_dil.api.signals({c_zip : '10010'}).submit(); 
// Request will look like /event?c_zip=10010&d_zip=10010

Trafic DIL dans Google Tag Manager (GTM)

Configurez et diffusez DIL avec une balise GTM.
Cette procédure suppose que vous disposez d’un Google Tag Manager compte, d’une connaissance pratique de ce produit et de votre dil.js fichier d’Audience Manager.
Pour acheminer le trafic vers le dil.js fichier dans GTM :
  1. Créez un conteneur ou ouvrez un conteneur existant.
  2. Ajoutez une nouvelle balise au conteneur.
  3. Ouvrez la balise pour la modifier et :
    • Attribuez un nom à la balise.
    • Select Custom HTML Tag from the Tag Type drop-down list.
    • Dans le champ HTML, placez le DIL code (bibliothèque + code personnalisé) entre les balises de script <script>DIL code</script> .
    • Cliquez sur Save .
  4. Publiez le conteneur.
  5. Générez le code de balise de conteneur et placez-le dans votre inventaire.