metodo DIL create dil-create

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

DIL create dil-create-new

Crea un partner specifico DIL dell'istanza.

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

elementi initConfig

IMPORTANT
Il visitorService la proprietà è sempre obbligatorio. 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 da Audience Manager per la sincronizzazione degli ID. Impostate containerNSID se ha DIL distribuite su 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.

In Servizio Adobe Experience Platform Identity, la proprietà idSyncContainerID corrisponde a containerNSID in DIL . Nota quanto segue se utilizzi DIL e il servizio ID su più siti:

  • Per ogni sito, imposta gli stessi ID contenitore su containerNSID e idSyncContainerID .
  • Entrambi DIL e il servizio ID tenterà di inviare le sincronizzazioni ID al nostro iFrame di raccolta dati. Tuttavia, l'iFrame assicura che DIL non attiverà una sincronizzazione ID. In questo modo si evitano duplicazioni.
  • Solo DIL invia dati a un Destinazione URL.

Vedi anche, idSyncContainerID.

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, imposta gli ID cliente con setCustomerIDs invece di DIL . Consulta ID cliente e stati di autenticazione.

delayAllUntilWindowLoad
Booleano
Se è true, rinvia l’esecuzione di tutte le richieste (IFRAME, chiamate evento, sincronizzazione ID e destinazione) fino al Page Load l'evento viene attivato. 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 (rilasciata nell’agosto 2018). Utilizza il visitor.disableIdSyncs funzionein Adobe Experience Platform Identity Service.

Se true , non allega 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 (rilasciata nell’agosto 2018). Utilizza il visitor.disableIdSyncs funzionein Adobe Experience Platform Identity Service.

Disattiva la sincronizzazione degli ID. Disattiva le sincronizzazioni ID quando utilizzi DIL v6.2+ e il servizio ID visitatore. Il visitorService questa funzione (vedi il codice di esempio di seguito) si occupa di questa operazione.

enableErrorReporting
Booleano
Imposta su true per abilitare la segnalazione degli errori per tutti DIL sulla pagina. Funziona con il booleano true solo.
iframeAkamaiHTTPS
Booleano

Importante: questo elemento è stato dichiarato obsoleto con DIL versione 8.0 (rilasciata nell’agosto 2018). Utilizza il visitor.idSyncSSLUseAkamai funzionein 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. Consulta Mappare i valori delle chiavi ad altre chiavi. Rilasciato con v2.4.
namespace
Stringa

Obbligatorio.

Il namespace coppia chiave-valore contiene Experience Cloud ID organizzazione. Se non disponi di questo ID, puoi trovarlo in Amministrazione sezione del Experience Cloud dashboard. Per visualizzare questo dashboard sono necessarie le autorizzazioni di amministratore. Consulta la Domande frequenti su funzioni e funzionalità del prodottoe Amministrazione - Gestione utenti e domande frequenti.

partner
Stringa

Obbligatorio.

Nome del partner fornito da Audience Manager .

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

Obbligatorio con DIL 6.2 o superiore.

DIL si basa sulla setCustomerIDs funzione in Servizio Adobe Experience Platform Identity per passare gli ID dichiarati in Audience Manager . Consulta ID cliente e stati di autenticazione per ulteriori informazioni.

Codice di esempio

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

uuidCookie ha le seguenti proprietà:

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

Proprietà visitorService visitor-service-props

Definisce le proprietà utilizzate da visitorService variabile. Questa variabile fa parte del DIL.create metodo.

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