Show Menu
ARGOMENTI×

DIL create, metodo

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. Impostereste 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.
In Adobe Experience Platform Identity Service , la proprietà idSyncContainerID corrisponde a containerNSID in DIL . Nota quanto segue se utilizzi DIL e il servizio ID su più siti:
  • Per ogni sito, impostate gli stessi ID contenitore su containerNSID e idSyncContainerID .
  • Sia il DIL che il servizio ID cercheranno di inviare le sincronizzazioni ID al nostro iFrame di raccolta dati. Tuttavia, l’iFrame garantisce che l’DIL non attivi la sincronizzazione ID. Ciò impedisce la duplicazione.
  • Solo DIL invia dati a una destinazione URL .
Vedi anche idSyncContainerID .
declaredId
Oggetto
delcaredId viene utilizzato per trasmettere:
  • dpid : ID partner dati assegnato dall' 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 utilizzate Adobe Experience Platform Identity Service , impostate gli ID cliente con il setCustomerIDs metodo invece del DIL . See Customer IDs and Authentication States .
delayAllUntilWindowLoad
Booleano
Se true, differisce l'esecuzione di tutte le richieste (IFRAME, chiamate di eventi, sincronizzazione ID e destinazione) fino all'attivazione dell' Page Load evento. Il valore predefinito è false .
disableDeclaredUUIDCookie
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 la versione DIL 8.0 (rilasciata nell’agosto 2018). Utilizzate invece la visitor.disableIdSyncs funzione disableidsync.html in Adobe Experience Platform Identity Service.
Se true , non allegherà la destinazione che pubblica IFRAME al DOM o alle destinazioni di attivazione. Il valore predefinito è false .
disableIDSyncs
Booleano
Importante: Questo elemento è stato dichiarato obsoleto con la versione DIL 8.0 (rilasciata nell’agosto 2018). Utilizzate invece la visitor.disableIdSyncs funzione disableidsync.html in Adobe Experience Platform Identity Service.
Disattiva la sincronizzazione degli ID. Devi disabilitare la sincronizzazione degli ID quando usi DIL v6.2+ e il servizio ID visitatori. La visitorService funzione (vedere il codice di esempio riportato di seguito) si occupa di questa operazione.
enableErrorReporting
Booleano
Impostato true per abilitare la segnalazione degli errori per tutte le istanze di DIL sulla pagina. Funziona true solo con booleano.
iframeAkamaiHTTPS
Booleano
Importante: Questo elemento è stato dichiarato obsoleto con la versione DIL 8.0 (rilasciata nell’agosto 2018). Utilizzate invece la visitor.idSyncSSLUseAkamai funzione idsyncssluseakamai.html in Adobe Experience Platform Identity Service.
Consente di stabilire se il modello di pubblicazione della destinazione deve utilizzare Akamai per le connessioni HTTPS. Consentito in base al partner.
mappings
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 namespace chiave-valore contiene l'ID organizzazione Experience Cloud . Se non disponete di questo ID, potete trovarlo nella sezione Amministrazione del dashboard di Experience Cloud di . 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 dal Audience Manager .
removeFinishedScriptsAndCallbacks
Booleano
Rimuove script e callback. Il valore predefinito è False . Si applica solo all'istanza DIL corrente . Rilasciato con v3.3.
uuidCookie
Oggetto
Imposta un cookie con l'ID utente univoco restituito dal Audience Manager . Consultate Proprietà uidCookie .
visitorService
Oggetto
Obbligatorio con DIL 6.2 o versione successiva.
Il DIL si basa sulla setCustomerIDs funzione di Adobe Experience Platform Identity Service per trasmettere gli ID dichiarati a 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 del 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 l'invio di 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 . Questo è necessario per 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" 
    } 
});