Installazione dell’SDK

Il modo migliore per utilizzare Adobe Experience Platform Web SDK è tramite Adobe Experience Platform Launch. Cercare AEP Web SDK nel catalogo delle estensioni, installare e configurare l'estensione.

Adobe Experience Platform Web SDK è disponibile anche su una rete CDN da usare. È possibile fare riferimento a questo file o scaricarlo e ospitarlo nella propria infrastruttura. È disponibile in una versione ridotta e non minificata. La versione non limitata è utile per il debug.

Struttura URL: https://cdn1.adoberesources.net/alloy/[VERSION]/alloy.min.js OR alloy.js per la versione non minificata.

Esempio:

Aggiunta del codice

Il primo passaggio nell’implementazione di Adobe Experience Platform Web SDK consiste nel copiare e incollare il seguente "codice base" il più possibile nel <head> tag del codice HTML:

<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/2.3.0/alloy.min.js" async></script>

Il codice di base crea una funzione globale denominata alloy. Utilizzate questa funzione per interagire con l'SDK. Se si desidera assegnare un altro nome alla funzione globale, è possibile modificare il alloy nome nel modo seguente:

<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["mycustomname"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/2.3.0/alloy.min.js" async></script>

In questo esempio, la funzione globale viene rinominata mycustomname, anziché alloy.

IMPORTANTE

Per evitare potenziali problemi, utilizzare un nome contenente almeno un carattere che non sia una cifra e che non sia in conflitto con il nome di una proprietà già trovata in window.

Questo codice di base, oltre a creare una funzione globale, carica anche il codice aggiuntivo contenuto all'interno di un file esterno (alloy.js) ospitato su un server. Per impostazione predefinita, questo codice viene caricato in modo asincrono per consentire alla pagina Web di essere il più performante possibile. Questa è l'implementazione consigliata.

Supporto di Internet Explorer

Questo SDK fa uso delle promesse, che è un metodo per comunicare il completamento delle attività asincrone. L’implementazione Promise utilizzata dall’SDK è supportata in modo nativo da tutti i browser di destinazione, tranne Internet Explorer. Per utilizzare l’SDK su Internet Explorer, è necessario disporre di un window.Promise riempimento polivalente.

Per determinare se è già presente un window.Promise polivaletto:

  1. Apri il tuo sito Web in Internet Explorer.
  2. Aprite la console di debug del browser.
  3. Digitate window.Promise la console, quindi premete Invio.

Se undefined appare qualcosa di diverso da quello, probabilmente avete già polilizzato window.Promise. Un altro modo per determinare se window.Promise è polivalente è caricare il sito Web dopo aver completato le istruzioni di installazione di cui sopra. Se l’SDK genera un errore che indica qualcosa di una promessa, probabilmente non hai ripieno window.Promise.

Se avete stabilito che è necessario eseguire il polifugo window.Promise, includete il seguente tag script sopra il codice di base fornito in precedenza:

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

Questo carica uno script che verifica che window.Promise sia un'implementazione Promise valida.

NOTA

Se scegli di caricare un'implementazione Promise diversa, assicurati che sia supportata Promise.prototype.finally.

Caricamento sincrono del file JavaScript

Come spiegato nella sezione Aggiunta del codice, il codice di base copiato e incollato nell’HTML del sito Web carica un file esterno con codice aggiuntivo. Questo codice aggiuntivo contiene le funzionalità di base dell’SDK. Qualsiasi comando che si tenta di eseguire durante il caricamento del file viene messo in coda e quindi elaborato dopo il caricamento del file. Questo è il metodo di installazione più performante.

In alcune circostanze, tuttavia, potrebbe essere utile caricare il file in modo sincrono (ulteriori dettagli su queste circostanze verranno documentati più avanti). In questo modo il resto del documento HTML non viene analizzato ed eseguito dal browser fino a quando il file esterno non viene caricato ed eseguito. Questo ritardo aggiuntivo prima della visualizzazione del contenuto principale agli utenti è generalmente scoraggiato, ma può avere senso a seconda delle circostanze.

Per caricare il file in modo sincrono invece che asincrono, rimuovete l’ async attributo dal secondo script tag come mostrato di seguito:

<script>
  !function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
  []).push(o),n[o]=function(){var u=arguments;return new Promise(
  function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
  (window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/2.3.0/alloy.min.js"></script>

In questa pagina