Show Menu
ARGOMENTI×

(Beta) Configurazione dell’SDK

L’SDK Web per Adobe Experience Platform è attualmente in versione beta e non è disponibile per tutti gli utenti. La documentazione e la funzionalità sono soggette a modifiche.
La configurazione per l’SDK viene effettuata con il configure comando.
alloy("configure", {
  "configId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

È possibile impostare diverse opzioni durante la configurazione. Tutte le opzioni sono disponibili di seguito, raggruppate per categoria.

Opzioni generali

configId

Tipo
Obbligatorio
Valore predefinito
Stringa
none
L’ID di configurazione assegnato, che collega l’SDK agli account e alla configurazione appropriati. Quando si configurano più istanze all'interno di una singola pagina, è necessario configurare un'altra istanza configId per ciascuna.

context

Tipo
Obbligatorio
Valore predefinito
Matrice di stringhe
No
["web", "device", "environment", "placeContext"]
Indica le categorie di contesto da raccogliere automaticamente come descritto in Informazioni (Beta) Informazioni raccolte automaticamente automatiche. Se questa configurazione non è specificata, per impostazione predefinita vengono utilizzate tutte le categorie.

debugEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
false
Indica se il debug deve essere abilitato. Impostando questa configurazione si true abilitano le seguenti funzionalità:
| Funzione | | | | ---------------------- | ------------------ | | Convalida sincrona | Convalida i dati raccolti rispetto allo schema e restituisce un errore nella risposta sotto la seguente etichetta: collect:error OR success | | Registrazione della console | Abilita la visualizzazione dei messaggi di debug nella console JavaScript del browser |

edgeDomain

Tipo
Obbligatorio
Valore predefinito
Stringa
No
beta.adobedc.net
Dominio utilizzato per interagire con Adobe Services. Questo viene utilizzato solo se disponete di un dominio di prime parti (CNAME) che esegue il proxy delle richieste all'infrastruttura periferica di Adobe.

errorsEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Indica se gli errori devono essere eliminati. Come descritto in Esecuzione di comandi , gli errori non rilevati vengono registrati nella console dello sviluppatore, indipendentemente dal fatto che il debug sia abilitato in Adobe Experience Platform Web SDK. Impostando errorsEnabled su false , le promesse restituite dall’SDK Web di Adobe Experience Platform non vengono mai rifiutate, anche se gli errori vengono comunque registrati nella console se la registrazione è abilitata nell’SDK Web di Adobe Experience Platform.

orgId

Tipo
Obbligatorio
Valore predefinito
Stringa
none
L’ID organizzazione Experience Cloud assegnato. Quando si configurano più istanze all'interno di una pagina, è necessario configurare un'altra istanza orgId per ciascuna.

Raccolta dati

clickCollectionEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Indica se i dati associati ai clic del collegamento devono essere raccolti automaticamente. Per i clic considerati come clic del collegamento, vengono raccolti i seguenti dati di interazione webinteraction.schema.md Web:
Proprietà
Nome collegamento
Nome determinato dal contesto del collegamento
URL collegamento
URL normalizzato
Tipo di collegamento
Impostato per scaricare, uscire o altro

onBeforeEventSend

Tipo
Obbligatorio
Valore predefinito
Funzione
No
() => non definito
Impostate questa opzione per configurare un callback che viene chiamato per ogni evento appena prima che venga inviato. Un oggetto con il campo xdm viene inviato al callback. Modificare l'oggetto xdm per modificare l'elemento inviato. All'interno del callback, l' xdm oggetto avrà già i dati passati nel comando dell'evento e le informazioni raccolte automaticamente. Per ulteriori informazioni sui tempi di questa callback e un esempio, vedere Modifica degli eventi a livello globale .

Opzioni sulla privacy

defaultConsent

Tipo
Obbligatorio
Valore predefinito
Oggetto
No
{"general": "in"}
Imposta il consenso predefinito dell'utente. Questo viene utilizzato quando non è già stata salvata alcuna preferenza di consenso per l'utente. L'altro valore valido è {"general": "pending"} . Una volta impostato, il lavoro verrà messo in coda fino a quando l'utente non fornirà le preferenze di consenso. Dopo aver fornito le preferenze dell'utente, lavorare procede o viene interrotto in base alle preferenze dell'utente. Per ulteriori informazioni, consultate Supporto .

Opzioni di personalizzazione

prehidingStyle

Tipo
Obbligatorio
Valore predefinito
Stringa
No
none
Utilizzato per creare una definizione di stile CSS che nasconde le aree contenuto della pagina Web mentre il contenuto personalizzato viene caricato dal server. Se non viene fornita questa opzione, l’SDK non tenta di nascondere alcuna area di contenuto mentre viene caricato del contenuto personalizzato, generando potenzialmente uno "sfarfallio".
Ad esempio, se nella pagina Web era presente un elemento con un ID del container cui contenuto predefinito si desidera nascondere mentre il contenuto personalizzato viene caricato dal server, un esempio di stile di prenascondere è il seguente:
  prehidingStyle: "#container { opacity: 0 !important }"

Opzioni Pubblico

cookieDestinationsEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Abilita le destinazioni dei cookie, che consentono di impostare i cookie in base alla qualifica del segmento.

urlDestinationsEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Abilita le destinazioni URL, che consentono di attivare gli URL in base alla qualifica del segmento.

Opzioni identità

idSyncContainerId

Tipo
Obbligatorio
Valore predefinito
Numero
No
none
L'ID contenitore che specifica quali sincronizzazioni ID vengono attivate. Si tratta di un numero intero non negativo che può essere ottenuto dal consulente.

idSyncEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Abilita la funzione di sincronizzazione ID, che consente di attivare gli URL per sincronizzare l’ID utente univoco Adobe con l’ID utente univoco di un’origine dati di terze parti.

thirdPartyCookiesEnabled

Tipo
Obbligatorio
Valore predefinito
Booleano
No
true
Abilita l'impostazione dei cookie di terze parti di Adobe. L’SDK può mantenere l’ID visitatore in un contesto di terze parti per consentire l’utilizzo dello stesso ID visitatore in più siti. Questa funzione è utile se si dispone di più siti o si desidera condividere i dati con i partner; tuttavia, a volte questo non è desiderato per motivi di privacy.