DocumentazioneGuida per gli sviluppatori di Target

Funzionamento di at.js

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

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à. È consigliabile che tutti i clienti implementino o eseguano la migrazione alla versione più recente di at.js.

Per ulteriori informazioni, consulta Librerie JavaScript di Target.

Nell'implementazione di Target illustrata di seguito sono implementate le seguenti soluzioni Adobe Experience Cloud: Analytics, Target e Audience Manager. Inoltre, sono implementati i seguenti servizi di base Experience Cloud: Adobe Experience Platform, Audiences e Visitor ID Service.

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 Views, utilizzato 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 Views 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 l'Experience Cloud ID 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 in Profile Store. Store richiede tipi di pubblico idonei da Audience Library (ad esempio, tipi di pubblico condivisi da Adobe Analytics, Audience Manager, ecc.).
Gli attributi del cliente vengono inviati al Profile Store 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 ai server Data Collection.
8
I dati di destinazione vengono confrontati con i dati di Analytics tramite SDID ed elaborati nell'archivio dei rapporti di Analytics.I dati di
Analytics possono quindi essere visualizzati sia in Analytics che in Target tramite i report (A4T).

Ora, ovunque triggerView() sia implementato nel tuo SPA, le azioni e Views vengono recuperati dalla cache e mostrati 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
Chiamata di triggerView() nell'SPA per eseguire il rendering di View e applicare azioni per modificare gli elementi visivi.
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
Richiesta di notifica inviata a Target Profile Store per conteggiare il visitatore nell'attività e nelle metriche incrementali.
5
Analytics dati inviati a Data Collection Servers.
6
I dati di Target corrispondono ai dati di Analytics tramite SDID ed vengono elaborati nell'archivio dei report di Analytics. I dati di Analytics possono quindi essere visualizzati sia in Analytics che in 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.

https://video.tv.adobe.com/v/26250/?quality=12

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’ID Experience Cloud (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, Audience 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 ed elaborati nell’archivio dei rapporti di Analytics.I dati di
Analytics possono quindi essere visualizzati sia in Analytics che in Target tramite i report 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 team Adobe Customer Care.

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

https://video.tv.adobe.com/v/27959/?quality=12

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