Cas d’utilisation DIL et exemples de code

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

Envoi des éléments de données à 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 des 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. Pour rappel, transmettez les variables sous la forme de paires clé-valeur. Notez également le préfixe c_ devant la clé dans la paire clé-valeur. Ce préfixe 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 le fait automatiquement pour vous.

Conserver les propriétés de valeur cohérentes

N’oubliez pas de conserver les propriétés de valeur identiques lors de la transmission de 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, transmettre color:blue et color:red définit la valeur renvoyée sur rouge (remplace bleu).

Exemple 1 : Envoi de données en tant que 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 pourrait 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 : Envoi de 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 méthode signals(). DIL Votre code pourrait 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 : Envoi de données de page dans un tableau

Dans ce cas, la variable my_object utilise un tableau pour contenir des 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 pourrait 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.

REMARQUE

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é vers 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 pourrait 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 moteur 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 à Audience Manager.

IMPORTANT

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 variantes internationales) :

  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!

Description

Le code suivant indique comment obtenir le référent de recherche pour l’un des moteurs de recherche pris en charge. Dans ce cas, supposons qu’un utilisateur ait effectué une recherche sur le terme "domiciles" à partir de 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 référent de recherche (à partir de 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" à partir de Google Canada ( www.google.ca). Notez comment le code préfixe le paramètre c_ requis au moteur de recherche ( c_se) et au terme de recherche ( c_st). c_ est un préfixe obligatoire qui identifie ces variables en tant que 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" à partir de dogpile.com. Comme Dogpile n’est pas pris en charge par défaut, vous pouvez configurer DIL pour qu’il reconnaisse ce moteur de recherche et renvoie les termes de recherche à l’Audience Manager. Votre code pourrait 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(); 
}

Mise en correspondance des valeurs clés avec d’autres clés

Associez la valeur d’une paire clé-valeur à une autre clé.

Description

Dans une paire clé-valeur, le préfixe c_ ajouté à la clé identifie le signal comme 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 a transmis les données lors d’un appel d’é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, mappez la valeur d’une paire c_ clé-valeur à une clé de niveau plate-forme. Une clé au niveau de la plateforme est précédée du 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 d’un site particulier, mais souhaitez les cibler sur toutes les propriétés de votre Audience Manager. Pour rendre le code postal disponible au niveau de la plateforme, vous pouvez mapper votre clé de code postal définie par le client (par exemple, c_zip) vers une clé définie par la plateforme comme illustré ci-dessous.

Exemple de code

Votre code pourrait 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

DIL de trafic dans Google Tag Manager (GTM)

Configurez et servez le DIL avec une balise GTM.

Cette procédure suppose que vous disposez d’un compte Google Tag Manager, d’une connaissance pratique de ce produit et de votre fichier dil.js d’Audience Manager.

Pour traiter le fichier dil.js dans GTM, procédez comme suit :

  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.
    • Sélectionnez Custom HTML Tag dans la liste déroulante Tag Type.
    • Dans le champ HTML, placez le code DIL (bibliothèque + code personnalisé) dans les balises de script <script>DIL code</script>.
    • Cliquez sur Save.
  4. Publiez le conteneur.

  5. Générez le code de balise conteneur et placez-le dans votre inventaire.

Sur cette page