Cas d’utilisation DIL et exemples de code dil-use-cases-and-code-samples

WARNING
Depuis juillet 2023, l’Adobe a cessé de développer la Data Integration Library (DIL) et la variable DIL extension .
Les clients existants peuvent continuer à utiliser leurs DIL implémentation. Cependant, l’Adobe ne se développera pas. DIL au-delà de ce point. Les clients sont encouragés à évaluer SDK Web Experience Platform pour leur stratégie de collecte de données à long terme.
Les clients qui souhaitent mettre en oeuvre de nouvelles intégrations de collecte de données après juillet 2023 doivent utiliser SDK Web Experience Platform au lieu de .

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 send-data-elements-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 indique 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 comme paires clé-valeur. Notez également que c_ avant la clé dans la paire clé-valeur. Ceci 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.

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 le bleu).

Exemple 1 : envoyer des 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 à Audience Manager. Lorsque vous utilisez cette méthode, DIL permet de transmettre un objet en tant que paramètre de fonction dans la variable 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 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 capture-referring-url

Capturez et envoyez une URL de référence à l’Audience Manager.

NOTE
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 capture-search-engine-types

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 variations 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 recherché 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

Code de base pour obtenir le référent de recherche (à partir de google.com, par exemple) se présente comme suit :

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" dans Google Canada ( www.google.ca). Notez comment le code préfixe les c_ paramètre du moteur de recherche ( c_se) et le terme de recherche ( c_st). c_ est un préfixe requis qui les identifie 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" dans dogpile.com. Parce que 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 map-key-values

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

Description

Dans une paire clé-valeur, la variable c_ le préfixe 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 dans une c_ paire clé-valeur à une clé au niveau de la plateforme. Une clé de niveau plate-forme 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) à 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) traffic-dil-gtm

Configurez et servez le DIL avec une balise GTM.

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

Pour le trafic de la variable 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électionner Custom HTML Tag de la Tag Type liste déroulante.
    • Dans le champ HTML , placez la variable DIL code (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.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695