méthode de création de DIL

Création DIL

Crée une instance DIL spécifique au partenaire.

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

Éléments initConfig

IMPORTANT

La propriété visitorService est always 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. Définissez 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 containerNSID et idSyncContainerID .
  • DIL et le service d’ID tenteront tous deux d’envoyer des synchronisations d’ID à notre iFrame de collecte de données. Cependant, l’iFrame s’assure que le DIL ne déclenche pas de synchronisation des identifiants. Cela empêche la duplication.
  • Seul le DIL envoie des données vers une destination d’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 identifiants. 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 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’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 la version 8.0 du 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 ni aux destinations de déclenchement. La valeur par défaut est false .

disableIDSyncs

Booléen

Important : Cet élément a été abandonné avec la version 8.0 du 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 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 fonction visitorService (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 reporting des erreurs pour toutes les instances de DIL de la page. Fonctionne uniquement avec la valeur booléenne true .

iframeAkamaiHTTPS

Booléen

Important : Cet élément a été abandonné avec la version 8.0 du 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.

mappings

Objet

Associe la valeur d’une paire clé-valeur à une autre. Voir Mise en correspondance des valeurs de clés avec d’autres clés . Publié avec la version 2.4.

namespace

Chaîne

Obligatoire.

La paire namespace clé-valeur contient votre ID d’organisation Experience Cloud. Si vous ne possédez pas cet ID, 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 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 de DIL actuelle. Publié avec la version 3.3.

uuidCookie

Objet

Définit un cookie avec l’identifiant utilisateur unique renvoyé par l’Audience Manager . Voir Propriétés uidCookie .

visitorService

Objet

Obligatoire avec DIL 6.2 ou version ultérieure.

DIL s’appuie sur la fonction setCustomerIDs du service Adobe Experience Platform Identity pour transmettre les ID déclarés dans l’Audience Manager . Pour plus d’informations, voir ID de client et états de l’authentification.

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

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 par défaut).
days Durée de vie du cookie (100 jours est la valeur par défaut).
path Chemin d’accès au 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

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 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"
    }
});

Sur cette page