méthode de création de DIL dil-create

WARNING
Depuis juillet 2023, l’Adobe a cessé de développer la Data Integration Library (DIL) et la variable DIL extension .
Les clients existants peuvent continuer à utiliser leurs DIL implémentation. Cependant, l’Adobe ne se développera pas. DIL au-delà de ce point. Les clients sont encouragés à évaluer SDK Web Experience Platform pour leur stratégie de collecte de données à long terme.
Les clients qui souhaitent mettre en oeuvre de nouvelles intégrations de collecte de données après juillet 2023 doivent utiliser SDK Web Experience Platform au lieu de .

Création DIL dil-create-new

Crée un partenaire spécifique DIL instance.

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

Éléments initConfig

IMPORTANT
La variable 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 du conteneur utilisé par Audience Manager pour la synchronisation des identifiants. Vous pouvez définir containerNSID si vous avez DIL 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 in 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 .
  • Les deux DIL et le service d’ID tentera d’envoyer des synchronisations d’ID à notre iFrame de collecte de données. Toutefois, l’iFrame s’assure que DIL ne déclenche pas de synchronisation des identifiants. Cela empêche la duplication.
  • Uniquement DIL envoie des données à un Destination de l’URL.

Voir aussi idSyncContainerID.

declaredId
Objet

declaredId est utilisé pour transmettre :

  • 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 la variable Service Adobe Experience Platform Identity, définissez les ID de client avec la variable setCustomerIDs au lieu de DIL . Voir ID de client et états d’authentification.

delayAllUntilWindowLoad
Booléen
Si la valeur est true, empêche toutes les requêtes (IFRAME, appels d’événement, synchronisation des identifiants et destination) de s’exécuter jusqu’à la fonction 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ée en août 2018). Utilisez la variable visitor.disableIdSyncs functiondans le service Adobe Experience Platform Identity à la place.

If 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 .

disableIDSyncs
Booléen

Important : Cet élément a été abandonné avec DIL version 8.0 (publiée en août 2018). Utilisez la variable visitor.disableIdSyncs functiondans le service Adobe Experience Platform Identity à la place.

Désactive la synchronisation des ID. Vous devez désactiver les synchronisations des identifiants lors de l’utilisation de DIL v6.2+ et du service d’identification des visiteurs. La variable visitorService (voir l’exemple de code ci-dessous) prend en charge cette opération.

enableErrorReporting
Booléen
Définissez sur . true pour activer la création de rapports d’erreurs pour tous DIL sur la page. Fonctionne avec le booléen true uniquement.
iframeAkamaiHTTPS
Booléen

Important : Cet élément a été abandonné avec DIL version 8.0 (publiée en août 2018). Utilisez la variable visitor.idSyncSSLUseAkamai functiondans le service Adobe Experience Platform Identity à la place.

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 Mise en correspondance des valeurs clés avec d’autres clés. Publié avec la version 2.4.
namespace
Chaîne

Obligatoire.

La variable namespace La paire clé-valeur contient votre Experience Cloud ID d’organisation. Si vous ne possédez pas cet identifiant, vous pouvez le trouver dans la variable Administration de la Experience Cloud tableau de bord. Vous avez besoin des autorisations d’administrateur pour afficher ce tableau de bord. Voir FAQ sur les fonctions et fonctionnalités de produitet 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 au DIL uniquement. Publié avec la version 3.3.
uuidCookie
Objet
Définit un cookie avec l’identifiant utilisateur unique renvoyé par Audience Manager . Voir Propriétés du cookie uuid.
visitorService
Objet

Requis avec DIL 6.2 ou version ultérieure.

Le DIL repose sur la variable setCustomerIDs dans la fonction Service Adobe Experience Platform Identity pour transmettre des identifiants déclarés à Audience Manager . Pour plus d’informations, voir ID de client et états de l’authentification.

Exemple de code

Un exemple 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 la variable DIL instance. Une tentative manquée renvoie un objet d’erreur (non généré) si votre code est mal configuré ou en cas d’erreur.

Définit les propriétés utilisées par la variable uuidCookie Variable . Cette variable fait partie du DIL.create .

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

Nom
Description
name
Nom du cookie ( aam_did est la valeur par défaut).
days
Durée de vie du cookie (100 jours par défaut).
path
Chemin du 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 la valeur par défaut).
secure
Définit un indicateur pour envoyer des données sur une connexion HTTPS uniquement.

Propriétés visitorService visitor-service-props

Définit les propriétés utilisées par la variable visitorService Variable . Cette variable fait partie du DIL.create .

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

Nom
Type
Description
namespace
Chaîne
Requis. Représente L’ID De L’Organisation Experience Cloud. Ceci est nécessaire pour la fonctionnalité Core Service Experience Cloud. Même paramètre 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