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

WARNING
Depuis juillet 2023, Adobe a arrêté le développement de l’extension Data Integration Library (DIL) et DIL.
Les clients existants peuvent continuer à utiliser leur implémentation DIL. Cependant, l’Adobe ne développera pas DIL au-delà de ce point. Nous recommandons aux clients d’évaluer le 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 à la place.

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 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 la forme de paires clé-valeur. Notez également le préfixe c_ situé avant la clé dans la paire clé-valeur. Ce préfixe requis identifie les informations comme 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, le transfert de 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 : envoyer des 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 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 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 effectué une recherche sur le terme "domiciles" 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 requis 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" à partir de dogpile.com. Dogpile n’étant 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, 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 clé-valeur c_ à une clé de niveau plate-forme. Une clé de niveau 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 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’un compte Google Tag Manager, d’une connaissance pratique de ce produit et de votre fichier d’Audience Manager dil.js.

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. Publish 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