Show Menu
ARGOMENTI×

Metodo di creazione DIL

DIL create

Crea un’ DIL istanza specifica per il partner.
Firma funzione: DIL.create: function (initConfig) {}
initConfig Elements
La visitorService proprietà è sempre obbligatoria. Altre proprietà elencate sono facoltative, salvo diversa indicazione.
initConfig accetta i seguenti elementi:
Nome Tipo Descrizione
containerNSID
Intero
Questa proprietà imposta l'ID del contenitore utilizzato da Audience Manager per la sincronizzazione degli ID. Impostate containerNSID se avete DIL distribuito su più siti. Ciascuno di questi siti avrà un proprio ID contenitore e sincronizzazioni ID. Se disponete di un solo sito, l'ID del contenitore è 0 per impostazione predefinita e non è necessario impostarlo correttamente. Contatta il tuo consulente per ottenere un elenco dei tuoi siti e dei loro ID contenitore.
Nel servizio Experience Cloud ID , la proprietà idSyncContainerID corrisponde a containerNSID in DIL . Nota quanto segue se utilizzi DIL e il servizio ID su più siti:
  • Per ciascun sito, impostate gli stessi ID contenitore su containerNSID e idSyncContainerID .
  • Sia DIL che il servizio ID cercheranno di inviare le sincronizzazioni ID al nostro iFrame di raccolta dati. Tuttavia, l’iFrame garantisce che DIL non attivi la sincronizzazione ID. Ciò impedisce la duplicazione.
  • Solo DIL invia dati a una destinazione URL .
dichiaratoId
Oggetto
delcaredId viene utilizzato per trasmettere:
  • dpid : ID partner dati assegnato a voi da Audience Manager .
  • dpuuid : L’ID univoco dell’utente.
Importante: Usa solo valori non codificati per gli ID. La codifica crea identificatori con doppia codifica.
Nota: Se utilizzi il servizio Experience Cloud ID , imposta gli ID cliente con il metodo setCustomerIDs invece di DIL . See Customer IDs and Authentication States .
delayAllSinceWindowLoad
Booleano
Se true, differisce l'esecuzione di tutte le richieste (IFRAME, chiamate di eventi, sincronizzazione ID e destinazione) fino all'attivazione dell' evento Page Load. Default is false .
disableDichiaredUIDCookie
Booleano
False per impostazione predefinita, Audience Manager imposta un cookie nel dominio del partner (imposta un cookie di prima parte).
disableDestinationPublishingIframe
Booleano
Importante: Questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciato nell’agosto 2018). Utilizzate invece la funzione visitor.disableIdSyncs mcvid-disableidsync.html nel servizio Experience Cloud ID.
Se true , non allega la destinazione che pubblica IFRAME al DOM o alle destinazioni di attivazione. Default is false .
disableIDSyncs
Booleano
Importante: Questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciato nell’agosto 2018). Utilizzate invece la funzione visitor.disableIdSyncs mcvid-disableidsync.html nel servizio Experience Cloud ID.
Disattiva la sincronizzazione degli ID. Devi disabilitare la sincronizzazione degli ID quando usi DIL v6.2+ e il servizio ID visitatori. La funzione visitorService (vedere il codice di esempio riportato di seguito) si occupa di questa operazione.
enableErrorReporting
Booleano
Impostato su true per abilitare la segnalazione degli errori per tutte le istanze DIL sulla pagina. Funziona solo con booleano true .
iframeAkamaiHTTPS
Booleano
Importante: Questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciato nell’agosto 2018). Utilizzate invece la funzione visitor.idSyncSSLUseAkamai mcvid-idSyncSSLUseAkamai.html nel servizio Experience Cloud ID.
Consente di stabilire se il modello di pubblicazione della destinazione deve utilizzare Akamai per le connessioni HTTPS. Consentito in base al partner.
mappature
Oggetto
Associa il valore da una coppia chiave-valore a un'altra. Consultate Mappare i valori chiave su altri tasti . Rilasciato con v2.4.
namespace
Stringa
Obbligatorio.
La coppia chiave-valore dello spazio dei nomi contiene l’ID organizzazione Experience Cloud . Se non disponi di questo ID, puoi trovarlo nella sezione Amministrazione del dashboard Experience Cloud . Per visualizzare questo dashboard è necessario disporre delle autorizzazioni di amministratore. Consulta le Domande frequenti sulle funzioni del prodotto e sull' amministrazione - Gestione utente e domande frequenti .
partner
Stringa
Obbligatorio.
Nome del partner fornito da Audience Manager .
removeFinishedScriptsAndCallback
Booleano
Rimuove script e callback. Default is False . Si applica solo all’ istanza DIL corrente . Rilasciato con v3.3.
uidCookie
Oggetto
Imposta un cookie con l’ID utente univoco restituito da Audience Manager . Consultate Proprietà uidCookie .
visitorService
Oggetto
Richiesto con DIL 6.2 o versione successiva.
DIL si basa sulla funzione setCustomerIDs presente nel servizio Experience Cloud ID per trasmettere gli ID dichiarati ad Audience Manager . Consulta ID cliente e stati di autenticazione per ulteriori informazioni.
Codice di esempio
Una DIL chiamata di esempio potrebbe essere simile alla seguente:
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 
}); 

Una risposta corretta restituisce l’ DIL istanza. Un tentativo non riuscito restituisce un oggetto errore (non generato) se il codice è configurato in modo errato o se si verifica un errore.

proprietà uidCookie

Definisce le proprietà utilizzate dalla uuidCookie variabile. Questa variabile fa parte del DIL.create metodo.
uuidCookie ha le seguenti proprietà:
Nome
Descrizione
name
The cookie name ( aam_did is default).
days
Durata del cookie (100 giorni è il valore predefinito).
path
Percorso cookie, ad esempio '/test' ( / è predefinito).
domain
Il dominio in cui è impostato il cookie, ad es. 'adobe.com' ( '.'+document.domain è predefinito).
secure
Imposta un flag per inviare i dati solo attraverso una connessione HTTPS.

visitorService Properties

Definisce le proprietà utilizzate dalla visitorService variabile. Questa variabile fa parte del DIL.create metodo.
visitorService ha le seguenti proprietà:
Nome
Tipo
Descrizione
namespace
Stringa
Obbligatorio. Rappresenta L’ID Organizzazione Experience Cloud. È necessario per la funzionalità del servizio di base di Experience Cloud. Stesso parametro utilizzato per creare un'istanza della funzionalità ID visitatore.
Esempio di codice:
var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});