Méthode de création DIL dil-create

WARNING
Depuis juillet 2023, Adobe a interrompu le développement du Data Integration Library (DIL) et de l’extension DIL.
Les clients existants peuvent continuer à utiliser leur implémentation DIL. Cependant, Adobe ne développera pas d’DIL au-delà de ce point. Nous recommandons aux clients d’évaluer Experience Platform Web SDK pour leur stratégie de collecte de données à long terme.
Les clients qui souhaitent implémenter de nouvelles intégrations de collecte de données après juillet 2023 doivent utiliser Experience Platform Web SDK à la place.

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

IMPORTANT
La propriété visitorService est always obligatoire. 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 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 et idSyncContainerID .
  • 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
Objet

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
Booléen
Si la valeur est true, reporte l’exécution de toutes les requêtes (IFRAME, appels d’événement, synchronisation des identifiants et destination) jusqu’au déclenchement de l’événement Page Load . 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é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
Booléen

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
Booléen
Définissez cette valeur sur true afin d’activer le rapport d’erreurs pour toutes les instances DIL de la page. Fonctionne uniquement avec les true booléennes.
iframeAkamaiHTTPS
Booléen

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
Objet
Associe la valeur d’une paire clé-valeur à une autre. Voir Mapper des valeurs de clé à d’autres clés. Version v2.4.
namespace
Chaîne

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
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 la version 3.3.
uuidCookie
Objet
Définit un cookie avec l’ID d’utilisateur unique renvoyé par ’ Audience Manager. Voir Propriétés uuidCookie.
visitorService
Objet

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 :

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

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 :

Nom
Type
Description
namespace
Chaîne
Requis. Représente L’ID d’organisation Experience Cloud. Cela est nécessaire pour la fonctionnalité Experience Cloud Core Service. Même paramètre que celui utilisé pour instancier la fonctionnalité d’identifiant visiteur.

Exemple de code :

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695