DIL create method

DIL create

Crea un'istanza DIL specifica per il partner.

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

initConfig Elements

IMPORTANTE

La proprietà visitorService è 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. È possibile impostare containerNSID se DIL è stato 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 il servizio ID DIL e 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 assicura che DIL non attivi la sincronizzazione ID. Ciò impedisce la duplicazione.
  • Solo i DIL inviano dati a una destinazione URL .

Vedere anche, idSyncContainerID .

declaredId

Oggetto

declaredId viene utilizzato per trasmettere:

  • dpid : ID partner dati assegnato dall’utente per 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 il Adobe Experience Platform Identity Service , impostate gli ID cliente con il metodo setCustomerIDs invece del DIL . Vedere ID cliente e stati di autenticazione .

delayAllUntilWindowLoad

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 . Il valore predefinito è false .

disableDeclaredUUIDCookie

Booleano

False per impostazione predefinita, ovvero 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). Utilizzare la funzione visitor.disableIdSyncs in Adobe Experience Platform Identity Service.

Se true , non allegherà la destinazione che pubblica IFRAME alle destinazioni DOM o Fire. Il valore predefinito è false .

disableIDSyncs

Booleano

Importante: Questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciato nell'agosto 2018). Utilizzare la funzione visitor.disableIdSyncs 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 funzione visitorService (vedere il codice di esempio riportato di seguito) si occupa di questa operazione.

enableErrorReporting

Booleano

Impostare su true per abilitare la segnalazione degli errori per tutte le istanze DIL presenti nella pagina. Funziona solo con booleano true .

iframeAkamaiHTTPS

Booleano

Importante: Questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciato nell'agosto 2018). Utilizzare la funzione visitor.idSyncSSLUseAkamai 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. Vedere Mappare i valori chiave su altre chiavi . Rilasciato con v2.4.

namespace

Stringa

Obbligatorio.

La coppia chiave-valore namespace contiene l'ID organizzazione Experience Cloud . Se non disponete di questo ID, potete trovarlo nella sezione Amministrazione del dashboard Experience Cloud . Per visualizzare questo dashboard è necessario disporre delle autorizzazioni di amministratore. Consulta le Domande frequenti su funzioni del prodotto e Amministrazione - Gestione utente e domande frequenti .

partner

Stringa

Obbligatorio.

Nome del partner come indicato dal Audience Manager .

removeFinishedScriptsAndCallbacks

Booleano

Rimuove script e callback. Il valore predefinito è False . Si applica solo all'istanza corrente DIL . Rilasciato con v3.3.

uuidCookie

Oggetto

Imposta un cookie con l'ID utente univoco restituito dall'Audience Manager . Vedere proprietà uuidCookie .

visitorService

Oggetto

Obbligatorio con DIL 6.2 o superiore.

Il DIL utilizza la funzione setCustomerIDs del Adobe Experience Platform Identity Service per trasmettere gli ID dichiarati in Audience Manager . Consulta ID cliente e stati di autenticazione per ulteriori informazioni.

Codice di esempio

Una chiamata di esempio DIL 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'istanza DIL. 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 variabile uuidCookie. Questa variabile fa parte del metodo DIL.create.

uuidCookie ha le seguenti proprietà:

Nome Descrizione
name Il nome del cookie ( aam_did è il valore predefinito).
days Durata del cookie (100 giorni è il valore predefinito).
path Percorso del cookie, ad esempio '/test' ( / è il valore predefinito).
domain Il dominio in cui è impostato il cookie, ad esempio 'adobe.com' ( '.'+document.domain è il valore predefinito).
secure Imposta un flag per l'invio di dati solo attraverso una connessione HTTPS.

visitorService Properties

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

In questa pagina