Configurare l’SDK web per Platform

La configurazione dell’SDK viene eseguita con il comando configure .

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

È possibile impostare molte opzioni durante la configurazione. Di seguito sono riportate tutte le opzioni, raggruppate per categoria.

Opzioni generali

edgeConfigId

L'ID di configurazione assegnato, che collega l'SDK agli account e alla configurazione appropriati. Quando configuri più istanze all’interno di una singola pagina, devi configurare un edgeConfigId diverso per ogni istanza.

context

Indica le categorie di contesto da raccogliere automaticamente come descritto in Informazioni automatiche. Se questa configurazione non è specificata, vengono utilizzate tutte le categorie per impostazione predefinita.

debugEnabled

Indica se il debug è abilitato. L'impostazione di questa configurazione su true abilita le seguenti funzionalità:

edgeDomain

Compilare questo campo con il dominio di prime parti. Per ulteriori informazioni, consulta la documentazione.

Il dominio è simile a data.{customerdomain.com} per un sito web all’indirizzo www.{customerdomain.com}.

orgId

L'ID organizzazione Experience Cloud assegnato. Quando configuri più istanze all’interno di una pagina, devi configurare un orgId diverso per ogni istanza.

Raccolta dati

clickCollectionEnabled

Indica se i dati associati ai clic sul collegamento vengono raccolti automaticamente. Per ulteriori informazioni, consulta Tracciamento automatico dei collegamenti . I collegamenti sono anche etichettati come collegamenti di download se includono un attributo di download o se il collegamento termina con un’estensione di file. I qualificatori di collegamento per il download possono essere configurati con un’espressione regolare. Il valore predefinito è "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

Configura un callback chiamato per ogni evento immediatamente prima dell'invio. Un oggetto con il campo xdm viene inviato al callback. Per modificare l'invio, modificare l'oggetto xdm. All'interno del callback, l'oggetto xdm dispone già dei dati passati nel comando evento e delle informazioni raccolte automaticamente. Per ulteriori informazioni sulla tempistica di questo callback e un esempio, vedere Modifica degli eventi a livello globale.

Opzioni privacy

defaultConsent

Imposta il consenso predefinito dell’utente. Utilizza questa impostazione quando non è già stata salvata alcuna preferenza di consenso per l’utente. Gli altri valori validi sono "pending" e "out". Questo valore predefinito non viene mantenuto nel profilo dell’utente. Il profilo dell’utente viene aggiornato solo quando viene chiamato setConsent.

• "in": Quando questa impostazione è impostata o non viene fornito alcun valore, il lavoro procede senza le preferenze di consenso dell’utente.
• "pending": Quando questa impostazione è impostata, il lavoro viene messo in coda fino a quando l’utente non fornisce le preferenze di consenso.
• "out": Quando questa impostazione è impostata, il lavoro viene scartato finché l’utente non fornisce 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, consulta Supporto del consenso .

Opzioni di personalizzazione

prehidingStyle

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 durante il caricamento del contenuto personalizzato, generando potenzialmente una visualizzazione momentanea di altri contenuti.

Ad esempio, se un elemento nella pagina web ha un ID di container, il cui contenuto predefinito da nascondere mentre il contenuto personalizzato viene caricato dal server, utilizza il seguente stile di pre-hiding:

  prehidingStyle: "#container { opacity: 0 !important }"

Opzioni del pubblico

cookieDestinationsEnabled

Abilita le destinazioni dei cookie Audience Manager, che consentono di impostare cookie in base alla qualifica del segmento.

urlDestinationsEnabled

Abilita le destinazioni URL Audience Manager, che consentono di attivare gli URL in base alla qualifica del segmento.

Opzioni di identità

idMigrationEnabled

Se true, l'SDK legge e imposta i cookie AMCV precedenti. Questa opzione aiuta nella transizione all'utilizzo di Adobe Experience Platform Web SDK, mentre alcune parti del sito potrebbero ancora utilizzare Visitor.js. Se nella pagina è definita l’API del visitatore, l’SDK invia una query all’API del visitatore per l’ECID. Questa opzione consente di utilizzare pagine con doppio tag con Adobe Experience Platform Web SDK e di disporre comunque dello stesso ECID.

thirdPartyCookiesEnabled

Abilita l’impostazione di 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 nei diversi siti. Utilizza questa opzione se disponi di più siti o desideri condividere dati con i partner; tuttavia, a volte questa opzione non è desiderata per motivi di privacy.