Méthode de création DIL dil-create
Création DIL dil-create-new
Crée une instance de DIL spécifique au partenaire.
Signature de fonction : DIL.create: function (initConfig) {}
éléments initConfig
visitorService
est always obligatoire. Les autres propriétés répertoriées ici sont facultatives, sauf indication contraire.initConfig
accepte les éléments suivants :
containerNSID
Cette propriété définit l’identifiant de conteneur utilisé par ’ Audience Manager pour les synchronisations des identifiants. Il est préférable de définir containerNSID
si DIL est déployé sur plusieurs sites. Chacun de ces sites aura ses propres synchronisations des ID et des conteneurs. Lorsque vous n’avez qu’un seul site, l’ID de conteneur est 0 par défaut et vous n’avez pas besoin de le définir correctement. Contactez votre consultant pour obtenir une liste de vos sites et de leurs ID de conteneur.
Dans le 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
etidSyncContainerID
. - DIL et le service d’ID tenteront d’envoyer les synchronisations des identifiants à notre iFrame de collecte de données. Cependant, l’iFrame garantit que DIL ne déclenchera pas de synchronisation des identifiants. Cela évite la duplication.
- Seul DIL envoie des données à un de destination d’URL.
Voir aussi idSyncContainerID.
declaredId
declaredId
est utilisé pour transmettre l’un des éléments suivants :
dpid
: ID de partenaire de données qui vous est attribué par ’ Audience Manager.dpuuid
: ID unique d’un utilisateur.
Important : utilisez uniquement des valeurs non codées pour vos identifiants. L’encodage crée des identifiants codés en double.
Remarque : si vous utilisez l’ Adobe Experience Platform Identity Service, définissez les ID de client avec la méthode setCustomerIDs
au lieu de l’ DIL. Voir les ID de client et les états d’authentification.
delayAllUntilWindowLoad
Page Load
. La valeur par défaut est false
.disableDeclaredUUIDCookie
disableDestinationPublishingIframe
Important : cet élément a été abandonné avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs
dans le service d’identités Adobe Experience Platform.
Si true
, ne joint pas l’IFRAME de publication de destination aux destinations DOM ou déclenche des erreurs. La valeur par défaut est false
.
disableIDSyncs
Important : cet élément a été abandonné avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la fonction visitor.disableIdSyncs
dans le service d’identités Adobe Experience Platform.
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) prend en charge cette opération.
enableErrorReporting
true
afin d’activer le rapport d’erreurs pour toutes les instances DIL de la page. Fonctionne uniquement avec les true
booléennes.iframeAkamaiHTTPS
Important : cet élément a été abandonné avec DIL version 8.0 (publiée en août 2018). Utilisez plutôt la fonction visitor.idSyncSSLUseAkamai
dans le service d’identités Adobe Experience Platform.
Indique si le modèle de publication de destination doit utiliser Akamai pour les connexions HTTPS. Activée par partenaire.
mappings
namespace
Obligatoire.
La paire clé-valeur namespace
contient l’identifiant d’organisation Experience Cloud . Si vous ne disposez pas de cet identifiant, vous pouvez le trouver dans la section d’administration du tableau de bord de l’ d’ Experience Cloud. Vous avez besoin d’autorisations d’administrateur pour afficher ce tableau de bord. Consultez les FAQ sur les fonctionnalités du produit et Administration deset des - Gestion des utilisateurs et FAQ.
partner
Obligatoire.
Nom du partenaire fourni par ’ Audience Manager.
removeFinishedScriptsAndCallbacks
False
. S’applique uniquement à l’instance DIL actuelle. Publié avec la version 3.3.uuidCookie
visitorService
Requis avec DIL 6.2 ou une version ultérieure.
DIL s’appuie sur la fonction setCustomerIDs
du Adobe Experience Platform Identity Service pour transmettre les identifiants déclarés à ’ Audience Manager. Pour plus d’informations, voir les ID de client et les états d’authentification.
Exemple de code
Un exemple d’appel DIL pourrait 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 généré) si votre code n’est pas correctement configuré ou si une erreur se produit.
Propriétés uuidCookie 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 :
name
aam_did
est la valeur par défaut).days
path
'/test'
( /
est la valeur par défaut).domain
'adobe.com'
('.'+document.domain
est la valeur par défaut).secure
visitorService Properties 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 :
namespace
Exemple de code :
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});