DocumentationAudience ManagerGuide d’utilisation d’Audience Manager

Outils de DIL

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
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.

Décrit les méthodes dans l’espace de noms DIL.tools. Ces fonctions d’utilitaire vous aident à effectuer des tâches spécifiques.

getSearchReferrer

Renvoie les termes de recherche utilisés pour atteindre la page active.

Objectif de getSearchReferrer

En DIL, getSearchReferrer renvoie les résultats de la recherche (noms et mots-clés) utilisés pour accéder à votre site. Vous pouvez transmettre des termes de recherche spécifiques à cette fonction ou la laisser rechercher par défaut les moteurs de recherche pris en charge ( AOL, Ask, Bing, Google et Yahoo) par rapport à document.referrer.

Signature de fonction

Signature de fonction : DIL.tools.getSearchReferrer(uri, initConfig)

Paramètres de fonction

getSearchReferrer accepte :

  • {string} : (Facultatif) Chaîne contenant l’URL de recherche (utilise document.referrer s’il n’est pas défini).
  • {object} : (Facultatif) Objet contenant la configuration pour hostPattern, queryParam ou queryPattern.

Et renvoie :

  • {object} Objet contenant des noms et des mots-clés valides.

Exemples

Type de recherche
Description
Exemple de code
Recherche par défaut
Renvoie les termes de recherche par mot-clé utilisés par les moteurs de recherche AOL, Ask, Bing, Google et Yahoo.
var results = DIL.tools.getSearchReferrer();
Transmission d’une URL personnalisée
Renvoie le référent de recherche en fonction d’une URL personnalisée.
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/search.aspx?q=adobe+rules");
Faire correspondre le nom d’hôte de l’URL avec un regex personnalisé
Transmettez une expression régulière personnalisée pour correspondre au nom d’hôte de l’URL de référence.
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/ search.aspx?q=adobe+rules",{    hostPattern:/ehow\./,    queryParam:"p" });
Faire correspondre des modèles de recherche avec un regex personnalisé
Transmettez une expression régulière personnalisée pour effectuer une recherche personnalisée.
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/search.aspx?q=adobe+rules, {    hostPattern:/ehow\./,    search_pattern:/[&\?]p=([^&]+/ });

décomposerURI

Déassemble un identifiant de ressource unique ( URI) en ses composants constitutifs : hash, host, href, pathname, protocol, search et uriParams.

Signature de fonction : DIL.tools.decomposeURI

Paramètres de fonction

decomposeURI accepte :

  • uri {string} : (Facultatif) Chaîne contenant l’URI. La valeur par défaut est document.location.href si elle n’est pas spécifiée.

Et renvoie :

  • {object} : objet contenant des noms et des mots-clés valides.

Exemple de code

var uriData = DIL.tools.decomposeURI('https://www.adobe.com/?arg1=123&arg2=456#am');
{
  hash : "#am",
  host : "www.adobe.com",
  hostname : "www.adobe.com",
  href : "https://www.adobe.com/?arg1=123&arg2=456#am",
  pathname : "",
  protocol : "https:",
  search : "?arg1=123&arg2=456",
  uriParams : {
    arg1 : "123",
    arg2 : "456"
  }
}

getMetaTags

Recherche du contenu spécifique défini dans les balises META d’une page web et renvoie ces données dans un objet.

Signature de fonction

Signature de fonction : DIL.tools.getMetaTags( 1 or more parameters)

Paramètres de fonction

getMetaTags accepte un ou plusieurs paramètres de nom (type chaîne) à rechercher. Elle renvoie un objet composé de paires clé-valeur.

Exemple de code


var dataLib = DIL.create({
     partner: 'partnerName',
     containerNSID: containerNSID
});

dataLib.api.signals(DIL.tools.getMetaTags('application', 'keywords',  'description'), 'c_').submit();


var dataLib = DIL.create({
     partner: `partnerName',
     containerNSID: containerNSID
});

dataLib.api.signals(DIL.tools.getMetaTags('application','keywords', 'description'), 'c_').submit();
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695