metodo DIL create dil-create

WARNING
A partire da luglio 2023, Adobe ha interrotto lo sviluppo di Data Integration Library (DIL) e dell'estensione DIL.
I clienti esistenti possono continuare a utilizzare l'implementazione DIL. Tuttavia, Adobe non svilupperà DIL oltre questo punto. I clienti sono invitati a valutare Experience Platform Web SDK per la strategia di raccolta dati a lungo termine.
I clienti che desiderano implementare nuove integrazioni di raccolta dati dopo luglio 2023 devono utilizzare Experience Platform Web SDK.

DIL create dil-create-new

Crea un'istanza DIL specifica per il partner.

Firma funzione: DIL.create: function (initConfig) {}

elementi initConfig

IMPORTANT
La proprietà visitorService è always obbligatoria. Le altre proprietà elencate qui sono facoltative, se non diversamente indicato.

initConfig accetta i seguenti elementi:

Nome
Tipo
Descrizione
containerNSID
Intero

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:

Vedere ancheidSyncContainerID.

declaredId
Oggetto

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
Booleano
Se è true, rinvia l'esecuzione di tutte le richieste (IFRAME, chiamate evento, sincronizzazione ID e destinazione) fino all'attivazione dell'evento Page Load . Il valore predefinito è false .
disableDeclaredUUIDCookie
Booleano
False per impostazione predefinita, il che significa che 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 (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
Booleano

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
Booleano
Impostare su true per abilitare la segnalazione errori per tutte le istanze di DIL nella pagina. Funziona solo con true booleano.
iframeAkamaiHTTPS
Booleano

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
Oggetto
Associa il valore da una coppia chiave-valore a un'altra. Vedi mappare i valori delle chiavi ad altre chiavi. Rilasciato con v2.4.
namespace
Stringa

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
Stringa

Obbligatorio.

Nome partner fornito da Audience Manager .

removeFinishedScriptsAndCallbacks
Booleano
Rimuove script e callback. Il valore predefinito è False . Si applica solo all'istanza di DIL corrente. Rilasciato con v3.3.
uuidCookie
Oggetto
Imposta un cookie con l'ID utente univoco restituito da Audience Manager . Vedi proprietà uuidCookie.
visitorService
Oggetto

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à:

Nome
Descrizione
name
Il nome del cookie ( aam_did è predefinito).
days
Durata del cookie (100 giorni è l’impostazione predefinita).
path
Percorso cookie, ad esempio '/test' ( / è il valore predefinito).
domain
Dominio in cui è impostato il cookie. Esempio: 'adobe.com' (impostazione predefinita: '.'+document.domain).
secure
Imposta un flag per inviare dati solo tramite una connessione HTTPS.

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à:

Nome
Tipo
Descrizione
namespace
Stringa
Obbligatorio. Rappresenta L’ID Dell’Organizzazione Experience Cloud. Questo è necessario, ad Experience Cloud, per la funzionalità del servizio core. 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"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695