méthode de création de DIL dil-create
Création de DIL dil-create-new
Crée une instance DIL spécifique au partenaire.
Signature de fonction : DIL.create: function (initConfig) {}
éléments initConfig
visitorService est always requise. Les autres propriétés répertoriées ici sont facultatives, sauf indication contraire.initConfig accepte les éléments suivants :
containerNSIDCette propriété définit l’ID de conteneur utilisé par l’ Audience Manager pour la synchronisation des identifiants. Vous définiriez containerNSID si DIL est déployé sur plusieurs sites. Chacun de ces sites aura son propre ID de conteneur et sa propre synchronisation des identifiants. Si vous ne disposez que d’un site, l’identifiant du conteneur est 0 par défaut et vous n’avez pas besoin de le définir correctement. Contactez votre consultant pour obtenir la liste de vos sites et de leurs ID de conteneur.
Dans le service Adobe Experience Platform Identity, la propriété idSyncContainerID correspond à containerNSID dans le 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
containerNSIDetidSyncContainerID. - DIL et le service d’ID essaieront tous deux d’envoyer des synchronisations des identifiants à notre iFrame de collecte de données. Cependant, l’iFrame s’assure que DIL ne déclenche pas de synchronisation des identifiants. Cela empêche la duplication.
- Seul DIL envoie des données vers une destination d’URL.
Voir aussi idSyncContainerID.
declaredIddeclaredId est utilisé pour transmettre l’un des éléments suivants :
dpid: identifiant du 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 ID. Le codage crée des identifiants codés deux fois.
Remarque : Si vous utilisez le service Adobe Experience Platform Identity, définissez les ID de client avec la méthode setCustomerIDs au lieu du DIL . Voir ID de client et états d’authentification.
delayAllUntilWindowLoadPage Load . La valeur par défaut est false .disableDeclaredUUIDCookiedisableDestinationPublishingIframeImportant : Cet élément a été abandonné avec la version 8.0 de DIL (publiée en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs dans le service Adobe Experience Platform Identity.
Si true , ne joint pas l’IFRAME de publication de destination au DOM ou aux destinations de déclenchement. La valeur par défaut est false .
disableIDSyncsImportant : Cet élément a été abandonné avec la version 8.0 de DIL (publiée en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs dans le service Adobe Experience Platform Identity.
Désactive la synchronisation des identifiants. Vous devez désactiver les synchronisations des identifiants 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.
enableErrorReportingtrue pour activer la création de rapports d’erreurs pour toutes les instances de DIL sur la page. Fonctionne uniquement avec le booléen true .iframeAkamaiHTTPSImportant : Cet élément a été abandonné avec la version 8.0 de DIL (publiée en août 2018). Utilisez plutôt la fonction visitor.idSyncSSLUseAkamai dans le service Adobe Experience Platform Identity.
Indique si le modèle de publication de destination doit utiliser Akamai pour les connexions HTTPS. Activée par partenaire.
mappingsnamespaceObligatoire.
La paire clé-valeur namespace 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 des autorisations d’administrateur pour afficher ce tableau de bord. Voir les FAQ sur les fonctions et fonctionnalités du produitet Administration - Gestion des utilisateurs et FAQ.
partnerObligatoire.
Nom du partenaire fourni par l’Audience Manager .
removeFinishedScriptsAndCallbacksFalse . S’applique uniquement à l’instance de DIL actuelle. Publié avec la version 3.3.uuidCookievisitorServiceRequis avec DIL 6.2 ou version ultérieure.
DIL s'appuie sur la fonction setCustomerIDs du service Adobe Experience Platform Identity pour transmettre les identifiants déclarés à l'Audience Manager . Voir ID de client et états de l’authentificationpour plus d’informations.
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 manquée renvoie un objet d’erreur (non généré) si votre code est mal configuré ou en cas d’erreur.
Propriétés du cookie uuid uuidcookie-props
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 :
nameaam_did est par défaut).dayspath'/test' ( / est la valeur par défaut).domain'adobe.com' ( '.'+document.domain par défaut).securePropriétés visitorService visitor-service-props
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 :
namespaceExemple de code :
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});