Show Menu
SUJETS×

Méthode de création DIL

Création DIL

Crée une DIL instance spécifique au partenaire.
Signature de fonction : DIL.create: function (initConfig) {}
Éléments initConfig
La visitorService propriété 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 le code 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 le service d’identité d’Adobe Experience Platform , la propriété idSyncContainerID correspond à containerNSID dans DIL . Notez les points suivants 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 code DIL et le service d’ID tenteront d’envoyer des synchronisations d’ID à notre iFrame de collecte de données. Cependant, l’iFrame s’assure que DIL ne déclenche pas de synchronisation des identifiants. Cela permet d'éviter les doublons.
  • Seul DIL envoie des données vers une destination URL .
Voir aussi idSyncContainerID .
declaredId
Objet
delcaredId 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 setCustomerIDs méthode au lieu de DIL . See Customer IDs and Authentication States .
delayAllUntilWindowLoad
Booléen
Si la valeur est true, empêche toutes les requêtes (IFRAME, appels de événement, synchronisation des identifiants et destination) de s’exécuter jusqu’au déclenchement du Page Load événement. La valeur par défaut est false .
disableDeclaredUUIDCookie
Booléen
False par défaut, ce qui signifie que l’Audience Manager définit un cookie dans le domaine du partenaire (définit un cookie propriétaire).
disableDestinationPublishingIframe
Booléen
Important : Cet élément est devenu obsolète avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la visitor.disableIdSyncs fonction dans Adobe Experience Platform Identity Service.
Si true vous le souhaitez, n’associez pas la publication de destination IFRAME au DOM ou aux destinations de feu. La valeur par défaut est false .
disableIDSyncs
Booléen
Important : Cet élément est devenu obsolète avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la visitor.disableIdSyncs fonction dans Adobe Experience Platform Identity Service.
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 visitorService fonction (voir l'exemple de code ci-dessous) s'occupe de cette opération.
enableErrorReporting
Booléen
Définissez cette variable sur true pour activer le rapports d’erreur pour toutes les instances DIL sur la page. Fonctionne avec Boolean true uniquement.
iframeAkamaiHTTPS
Booléen
Important : Cet élément est devenu obsolète avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la visitor.idSyncSSLUseAkamai fonction dans Adobe Experience Platform Identity Service.
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 ID d’organisation Experience Cloud. Si vous ne possédez pas cet identifiant, 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. Reportez-vous aux 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 Audience Manager .
removeFinishedScriptsAndCallbacks
Booléen
Supprime les scripts et les rappels. La valeur par défaut est False . S’applique uniquement à l’instance DIL actuelle . Publié avec v3.3.
uuidCookie
Objet
Définit un cookie dont l’ID utilisateur unique est renvoyé par Audience Manager . Voir Propriétés uidCookie .
visitorService
Objet
Requis avec DIL 6.2 ou version ultérieure.
Le code DIL s'appuie sur la setCustomerIDs fonction du service d'identité d'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’ DIL appel peut se présenter comme 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’ DIL instance. 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 uuidCookie variable. Cette variable fait partie de la DIL.create méthode.
uuidCookie possède les propriétés suivantes :
Nom
Description
name
The cookie name ( aam_did is default).
days
Durée de vie du cookie (100 jours est par défaut).
path
Chemin d’accès au cookie, par exemple '/test' ( / 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 visitorService variable. Cette variable fait partie de la DIL.create méthode.
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" 
    } 
});