Cas d’utilisation DIL et exemples de code

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

Envoyer les éléments de données à l'Audience Manager avec le 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 en tant qu’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 transmettez les variables sous forme de paires clé-valeur. Notez également le préfixe c_ avant 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 effectue cette opération 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, transmettre color:blue et color:red définit 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 méthode signals(). 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.

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é à 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.

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 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" à partir du 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 (à 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 du 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 comme des variables définies par le client à l’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 le DIL pour qu'il reconnaisse ce moteur de recherche et renvoie 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 préfixe c_ 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, mappez la valeur d'une paire c_ clé-valeur à une clé de niveau plate-forme. Une clé au niveau de la plate-forme est précédée de 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

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 d'Audience Manager dil.js.

Pour acheminer le trafic du fichier dil.js 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.
    • 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 de conteneur et placez-le dans votre inventaire.

Sur cette page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now