metodo DIL create dil-create
DIL create dil-create-new
Crea un'istanza DIL specifica per il partner.
Firma funzione: DIL.create: function (initConfig) {}
elementi initConfig
visitorService
è always obbligatoria. Le altre proprietà elencate qui sono facoltative, se non diversamente indicato.initConfig
accetta i seguenti elementi:
containerNSID
Questa proprietà imposta l'ID del contenitore utilizzato dall'Audience Manager di per le sincronizzazioni ID. Impostare containerNSID
se sono stati distribuiti DIL in più siti. Ognuno di questi siti avrà il proprio ID contenitore e le sincronizzazioni ID. Se hai solo 1 sito, l’ID 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 Adobe Experience Platform Identity di , la proprietà idSyncContainerID
corrisponde a containerNSID
in DIL . Se usi DIL e il servizio ID in più siti, tieni presente quanto segue:
- - Per ogni sito, impostare gli stessi ID contenitore su
containerNSID
eidSyncContainerID
.- Sia DIL che il servizio ID tenteranno di inviare sincronizzazioni ID all'iFrame della raccolta dati. Tuttavia, l'iFrame assicura che DIL non attivi una sincronizzazione ID. In questo modo si evitano duplicazioni. Solo DIL invia dati a una destinazione URLdi tipo .
declaredId
declaredId
viene utilizzato per trasmettere:
dpid
: ID partner dati assegnato da Audience Manager .dpuuid
: ID univoco per un utente.
Importante: utilizza solo valori non codificati per gli ID. La codifica creerà identificatori con doppia codifica.
Nota: se utilizzi il servizio Adobe Experience Platform Identity di , imposta gli ID cliente con il metodo setCustomerIDs
invece di DIL . ConsultaID cliente e stati di autenticazione.
delayAllUntilWindowLoad
Page Load
. Il valore predefinito è false
.disableDeclaredUUIDCookie
disableDestinationPublishingIframe
Importante: questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciata ad agosto 2018). Utilizzare la funzione visitor.disableIdSyncs
nel servizio Adobe Experience Platform Identity.
Se true
, non allegherà la destinazione di pubblicazione IFRAME alle destinazioni DOM o Fire. Il valore predefinito è false
.
disableIDSyncs
Importante: questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciata ad agosto 2018). Utilizzare la funzione visitor.disableIdSyncs
nel servizio Adobe Experience Platform Identity.
Disattiva la sincronizzazione ID. Disattiva le sincronizzazioni ID quando utilizzi DIL v6.2+ e il servizio ID visitatore. La funzione visitorService
(vedi il codice di esempio di seguito) si occupa di questa operazione.
enableErrorReporting
true
per abilitare la segnalazione errori per tutte le istanze di DIL nella pagina. Funziona solo con true
booleano.iframeAkamaiHTTPS
Importante: questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciata ad agosto 2018). Utilizzare la funzione visitor.idSyncSSLUseAkamai
nel servizio Adobe Experience Platform Identity.
Specifica se il modello di pubblicazione di destinazione deve utilizzare Akamai per le connessioni HTTPS. Consentito in base al partner.
mappings
namespace
Obbligatorio.
La coppia chiave-valore namespace
contiene l'ID organizzazione Experience Cloud . Se non disponi di questo ID, puoi trovarlo nella sezione dell'amministrazione del dashboard dell'Experience Cloud . Per visualizzare questo dashboard sono necessarie le autorizzazioni di amministratore. Vedere le Domande frequenti sulle funzioni e le funzionalità del prodotto e Amministrazione - Gestione utente e domande frequenti.
partner
Obbligatorio.
Nome partner fornito da Audience Manager .
removeFinishedScriptsAndCallbacks
False
. Si applica solo all'istanza di DIL corrente. Rilasciato con v3.3.uuidCookie
visitorService
Richiesto con DIL 6.2 o versione successiva.
DIL si basa sulla funzione setCustomerIDs
nel servizio Adobe Experience Platform Identity di per passare gli ID dichiarati nell'Audience Manager di . Per ulteriori informazioni, vedere ID cliente e stati di autenticazione.
Codice di esempio
Una chiamata DIL 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
});
In caso di esito positivo, la risposta restituisce l’istanza DIL. Un tentativo non riuscito restituisce un oggetto errore (non generato) se il codice non è configurato correttamente o ogni volta che si verifica un errore.
Proprietà uuidCookie uuidcookie-props
Definisce le proprietà utilizzate dalla variabile uuidCookie
. Questa variabile fa parte del metodo DIL.create
.
uuidCookie
ha le seguenti proprietà:
name
aam_did
è predefinito).days
path
'/test'
( /
è il valore predefinito).domain
'adobe.com'
(impostazione predefinita: '.'+document.domain
).secure
Proprietà visitorService visitor-service-props
Definisce le proprietà utilizzate dalla variabile visitorService
. Questa variabile fa parte del metodo DIL.create
.
visitorService
ha le seguenti proprietà:
namespace
Esempio di codice:
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});