DIL create method

Création DIL

Crée une instance DIL spécifique au partenaire.

Signature de fonction : DIL.create: function (initConfig) {}

Éléments initConfig

IMPORTANT

La propriété visitorService est toujours requise. Les autres propriétés répertoriées ici sont facultatives, sauf indication contraire.

initConfig accepte les éléments suivants :

Nom Type Description

containerNSID

Entier

Cette propriété définit l’identifiant du conteneur utilisé par Audience Manager pour la synchronisation des identifiants. Vous pouvez définir containerNSID si DIL est déployé sur plusieurs sites. Chacun de ces sites aura son propre conteneur ID et ID synchronisés. Si vous ne disposez que d’un site, l’ID de conteneur est 0 par défaut et vous n’avez pas besoin de définir cette valeur correctement. Contactez votre consultant pour obtenir une liste de vos sites et de leurs ID de conteneur.

Dans Adobe Experience Platform Identity Service , la propriété idSyncContainerID correspond à containerNSID dans DIL . Notez ce qui suit si vous utilisez DIL et le service d’ID sur plusieurs sites :

  • Pour chaque site, définissez les mêmes ID de conteneur sur containerNSID et idSyncContainerID .
  • Le DIL et le service d’ID essaieront tous deux d’envoyer des synchronisations d’ID à notre iFrame de collecte de données. Cependant, l’iFrame s’assure que le DIL ne déclenche pas de synchronisation d’ID. Cela permet d'éviter les doublons.
  • Seul le DIL envoie des données à une destination URL .

Voir aussi idSyncContainerID .

declaredId

Objet

declaredId est utilisée pour transmettre l’une des valeurs suivantes :

  • dpid : ID de partenaire de données qui vous a été attribué par Audience Manager .
  • dpuuid : Votre identifiant unique pour un utilisateur.

Important : Utilisez uniquement des valeurs non codées pour vos identifiants. Le codage crée des identifiants codés par doublon.

Remarque : Si vous utilisez Adobe Experience Platform Identity Service , définissez les ID de client avec la méthode setCustomerIDs au lieu du DIL . Voir ID de client et états d’authentification .

delayAllUntilWindowLoad

Booléen

Si la valeur est true, empêche l’exécution de toutes les requêtes (IFRAME, appels de événement, synchronisation des identifiants et destination) jusqu’à ce que le événement Page Load se déclenche. La valeur par défaut est false .

disableDeclaredUUIDCookie

Booléen

False par défaut, ce qui signifie Audience Manager définit un cookie dans le domaine du partenaire (définit un cookie propriétaire).

disableDestinationPublishingIframe

Booléen

Important : Cet élément a été abandonné avec DIL version 8.0 (publié en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs dans le service d’identité Adobe Experience Platform.

Si true , ne joint pas la destination de publication IFRAME au DOM ou aux destinations de feu. La valeur par défaut est false .

disableIDSyncs

Booléen

Important : Cet élément a été abandonné avec DIL version 8.0 (publié en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs dans le service d’identité Adobe Experience Platform.

Désactive la synchronisation des ID. Vous devez désactiver les synchronisations d’ID lors de l’utilisation de DIL v6.2+ et du service d’identification des Visiteurs. La fonction visitorService (voir l'exemple de code ci-dessous) s'occupe de cette opération.

enableErrorReporting

Booléen

Définissez sur true pour activer le rapports d’erreur pour toutes les instances DIL de la page. Fonctionne uniquement avec Boolean true .

iframeAkamaiHTTPS

Booléen

Important : Cet élément a été abandonné avec DIL version 8.0 (publié en août 2018). Utilisez plutôt la fonction visitor.idSyncSSLUseAkamai dans le service d’identité Adobe Experience Platform.

Indique si le modèle de publication de destination doit utiliser Akamai pour les connexions HTTPS. Activée par partenaire.

mappings

Objet

Associe la valeur d’une paire clé-valeur à une autre. Voir Faire correspondre les valeurs clés aux autres clés . Publié avec v2.4.

namespace

Chaîne

Obligatoire.

La paire namespace clé-valeur contient votre Experience Cloud ID d'organisation. Si vous ne possédez pas cet ID, vous pouvez le trouver dans la section Administration du tableau de bord Experience Cloud . Vous avez besoin d'autorisations d'administrateur pour vue ce tableau de bord. Voir les FAQ sur les fonctionnalités et les fonctionnalités du produit et Administration - Gestion des utilisateurs et FAQ .

partner

Chaîne

Obligatoire.

Nom du partenaire fourni par l'Audience Manager .

removeFinishedScriptsAndCallbacks

Booléen

Supprime les scripts et les rappels. La valeur par défaut est False . S'applique uniquement à l'instance actuelle du DIL . Publié avec v3.3.

uuidCookie

Objet

Définit un cookie dont l’ID utilisateur unique est renvoyé par l’Audience Manager . Voir Propriétés uuidCookie .

visitorService

Objet

Requis avec DIL 6.2 ou supérieur.

Le DIL s'appuie sur la fonction setCustomerIDs du service d'identité Adobe Experience Platform pour transmettre les identifiants déclarés à l'Audience Manager . Pour plus d’informations, voir ID de client et états de l’authentification.

Exemple de code

Un exemple d'appel DIL peut ressembler à ce qui suit :

var partnerObject1 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-ORGANIZATION-ID-HERE" 
  }, 
  containerNSID: 3, 
  uuidCookie:{ 
    name:'ad_uuid', 
    days:200, 
    path:'/test', 
    domain:'adobe.com', 
    secure:true 
  } 
}); 
 
var partnerObject2 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-MCORG-ID-HERE" 
  }, 
  containerNSID: 3 
}); 

Une réponse réussie renvoie l'instance DIL. Une tentative infructueuse renvoie un objet d'erreur (non renvoyé) si votre code est mal configuré ou en cas d'erreur.

Propriétés du cookie uuid

Définit les propriétés utilisées par la variable uuidCookie. Cette variable fait partie de la méthode DIL.create.

uuidCookie possède les propriétés suivantes :

Nom Description
name Le nom du cookie ( aam_did est par défaut).
days Durée de vie du cookie (100 jours est par défaut).
path Chemin d’accès au cookie, par exemple '/test' ( / est la valeur par défaut).
domain Domaine dans lequel le cookie est défini, par exemple 'adobe.com' ( '.'+document.domain est par défaut).
secure Définit un indicateur pour envoyer uniquement des données via une connexion HTTPS.

Propriétés de visitorService

Définit les propriétés utilisées par la variable visitorService. Cette variable fait partie de la méthode DIL.create.

visitorService possède les propriétés suivantes :

Nom Type Description
namespace Chaîne Requis. Représente L’ID D’Entreprise Experience Cloud. Ceci est nécessaire pour la fonctionnalité Experience Cloud Core Service. Paramètre identique à celui utilisé pour instancier la fonctionnalité d’ID de Visiteur.

Exemple de code:

var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});

Sur cette page