Funzionamento di at.js

Per implementare Adobe Target sul lato client, devi utilizzare la libreria JavaScript at.js.

In un’implementazione lato client di Adobe Target, Target distribuisce le esperienze associate a un’attività direttamente al browser client. Il browser determina quale esperienza visualizzare e la visualizza. Con un’implementazione lato client, puoi utilizzare un editor WYSIWYG (il Compositore esperienza visivo) o un’interfaccia non visiva (il Compositore esperienza basato su moduli) per creare esperienze di test e personalizzazione.

Che cos’è at.js?

La libreria at.js è la libreria di implementazione per l’implementazione lato client di Adobe Target. La libreria at.js migliora i tempi di caricamento delle pagine per le implementazioni Web e fornisce migliori opzioni di implementazione per le applicazioni a pagina singola. at.js è la libreria di implementazione consigliata e viene aggiornata frequentemente con nuove funzionalità. Si consiglia a tutti i clienti di implementare o eseguire la migrazione alla versione più recente di at.js.

Per ulteriori informazioni, consulta Librerie JavaScript di Target.

In Targetillustrate di seguito, sono implementate le seguenti soluzioni Adobe Experience Cloud: Analytics, Target e Audience Manager. Inoltre, i seguenti elementi Experience Cloud I servizi principali sono implementati: Adobe Experience Platform, Tipi di pubblico, e Servizio ID visitatore.

Qual è la differenza tra i diagrammi dei flussi di lavoro di at.js 1.x e di at.js 2.x?

Consulta Aggiornamento da at.js 1.x a at.js 2.x per informazioni sulle differenze tra 2.0 e 1.x.

Da un punto di vista avanzato, esistono alcune differenze tra le due versioni:

  • at.js 2.x non ha un concetto di richiesta mbox globale, ma una richiesta al caricamento della pagina. Una richiesta di caricamento della pagina si può intendere come una richiesta per recuperare il contenuto da applicare al caricamento iniziale della pagina del sito web.
  • at.js 2.x gestisce un concetto denominato Visualizzazioni, utilizzati per le applicazioni a pagina singola (SPA). at.js 1.x questo concetto non è disponibile.

Diagrammi at.js 2.x

I seguenti diagrammi ti aiutano a comprendere il flusso di lavoro di at.js 2.x con Visualizzazioni e come questo migliori l'integrazione con l'SPA. Per una migliore introduzione dei concetti utilizzati in at.js 2.x, consulta Implementazione di un’applicazione a pagina singola.

(Fare clic sull'immagine per espanderla a larghezza intera.)

Flusso di Target con at.js 2.x

Passaggio
Dettagli
1
La chiamata restituisce il ID EXPERIENCE CLOUD se l’utente è autenticato; un’altra chiamata sincronizza l’ID cliente.
2
La libreria at.js viene caricata in modo sincrono e nasconde il corpo del documento.
at.js si carica anche in modo asincrono con un eventuale snippet prenascosto implementato sulla pagina.
3
Si effettua una richiesta di caricamento della pagina, con tutti i parametri configurati (MCID, SDID e ID cliente).
4
Gli script di profilo vengono eseguiti e quindi inseriti nel Archivio profili. Lo Storichiede nuovamente tipi di pubblico idonei da Libreria tipi di pubblico (ad esempio, pubblici condivisi da Adobe Analytics, Audience Manager, ecc.).
Gli attributi del cliente vengono inviati all’archivio profili in un processo batch.
5
In base ai parametri di richiesta dell’URL e ai dati di profilo, Target determina le attività ed esperienze da restituire al visitatore per la pagina corrente e le visualizzazioni future.
6
Il contenuto di destinazione viene rinviato alla pagina, includendo facoltativamente i valori di profilo per ulteriore personalizzazione.
Il contenuto mirato sulla pagina corrente viene mostrato il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.
Il contenuto mirato per le viste mostrate come risultato delle azioni dell’utente effettuate in un’applicazione a pagina singola viene memorizzato nella cache del browser, in modo da applicarlo immediatamente senza una chiamata al server aggiuntiva quando si attivano le viste tramite triggerView().
7
I dati di Analytics vengono inviati a Raccolta dati server.
8
I dati di destinazione vengono confrontati con i dati di Analytics tramite SDID ed elaborati nel Analytics archiviazione dei rapporti.
AnalyticsI dati di possono quindi essere visualizzati sia in Analytics che in Target tramite i rapporti (A4T).

Ora, ovunque si implementi triggerView() nell’applicazione a pagina singola, le visualizzazioni e le azioni vengono recuperate dalla cache e mostrate all’utente senza una chiamata al server. triggerView() invia anche una richiesta di notifica al backend Target per incrementare e registrare i conteggi delle impression. Per ulteriori informazioni su at.js per applicazioni a pagina singola con viste, consulta Implementazione di un’applicazione a pagina singola.

(Fare clic sull'immagine per espanderla a larghezza intera.)

triggerView at.js 2.x flusso di Target

Passaggio
Dettagli
1
Si richiama triggerView()​ nell’applicazione a pagina singola per eseguire il rendering della visualizzazione e applicare azioni per modificare gli elementi visuali.
2
Il contenuto mirato per la visualizzazione viene letto dalla cache.
3
Il contenuto mirato viene mostrato il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.
4
Si invia la richiesta di notifica all'archivio profili di Target per conteggiare il visitatore nell'attività e nelle metriche incrementali.
5
Analytics dati inviati a Server di raccolta dati.
6
I dati di Target vengono confrontati con i dati di Analytics tramite SDID e vengono elaborati nell’archivio dei rapporti di Analytics. Analytics I dati possono quindi essere visualizzati in entrambi Analytics e Target tramite i rapporti A4T.

Video: diagramma architetturale di at.js 2.x

at.js 2.x migliora il supporto di Adobe Target per le applicazioni a pagina singola e consente l’integrazione con altre soluzioni Experience Cloud. Questo video spiega come tutti questo elementi funzionano insieme.

Consulta la pagina relativa al funzionamento di at.js 2.x per ulteriori informazioni.

Diagramma di at.js 1.x

I seguenti diagrammi ti aiutano a comprendere il flusso di lavoro di at.js 1.x.

(Fare clic sull'immagine per espanderla a larghezza intera.)

Flusso di Target at.js 1.x

Passaggio
Descrizione
Chiamata
Descrizione
1
La chiamata restituisce l’Experience Cloud ID (MCID) se l’utente è autenticato; un’altra chiamata sincronizza l’ID cliente.
2
La libreria at.js viene caricata in modo sincrono e nasconde il corpo del documento.
3
Viene effettuata una richiesta mbox globale, con tutti i parametri configurati, MCID, SDID e ID cliente (facoltativo).
4
Gli script di profilo vengono eseguiti e quindi inseriti nell’archivio profili. L’archivio richiede un pubblico idoneo dalla libreria Pubblico (ad esempio, pubblico condiviso da Adobe Analytics, Audienci Manager, ecc.).
Gli attributi del cliente vengono inviati all’archivio profili in un processo batch.
5
In base all’URL, ai parametri mbox e ai dati di profilo, Target decide quali attività ed esperienze restituire al visitatore.
6
Il contenuto di destinazione viene rinviato alla pagina, includendo facoltativamente i valori di profilo per ulteriore personalizzazione.
L’esperienza viene mostrata il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.
7
I dati Analytics vengono inviati ai server di raccolta dati.
8
I dati di Target vengono confrontati con i dati di Analytics tramite SDID e vengono elaborati nell’archivio dei rapporti di Analytics.I dati di
Analytics possono quindi essere visualizzati sia in Analytics che in Target tramite i rapporti Analytics for Target (A4T).

Video: Office Hours, suggerimenti e panoramica su at.js (26 giugno 2019)

Questo video è una registrazione di "Office Hours", un'iniziativa condotta dal Assistenza clienti Adobe team.

  • Vantaggi dell’utilizzo di at.js
  • Impostazioni di at.js
  • Gestione dello sfarfallio
  • Debug di at.js
  • Problemi noti
  • Domande frequenti

Come avviene il rendering delle offerte con contenuti HTML in at.js

Nel rendering delle offerte con contenuti HTML, at.js applica il seguente algoritmo:

  1. Le immagini vengono precaricate (se nel contenuto HTML sono presenti tag <img>).

  2. Il contenuto HTML viene associato al nodo DOM.

  3. Vengono eseguiti gli script in linea (codice racchiuso tra tag <script>).

  4. Gli script remoti (tag <script> con attributi src) vengono caricati in modo asincrono ed eseguiti.

Note importanti:

  • at.js non garantisce in alcun modo l’ordine di esecuzione di script remoti, poiché questi vengono caricati in modo asincrono.
  • Gli script in linea non devono avere dipendenze da script remoti, poiché questi ultimi vengono caricati ed eseguiti successivamente.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3