DocumentazioneExperience PlatformMigrare Target da at.js 2.x a Web SDK

Confronto di at.js con Platform Web SDK

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Intermedio
  • Esperto
  • Sviluppatore

La libreria autonoma di Adobe Target at.js è molto diversa da Platform Web SDK. Le tabelle seguenti sono un riferimento per valutare le aree dell’implementazione su cui potrebbe essere necessario concentrarsi durante il processo di migrazione.

Dopo aver esaminato le informazioni riportate di seguito e valutato l’implementazione tecnica di at.js in corso, dovresti essere in grado di comprendere quanto segue:

  • Quali funzioni di Target sono supportate da Platform Web SDK
  • Quali funzioni at.js hanno equivalenti all’SDK per web di Platform
  • Applicazione delle impostazioni di Target con Platform Web SDK
  • Differenze tra il flusso di dati di at.js e Platform Web SDK

Se hai poca esperienza con Platform Web SDK, non preoccuparti: gli elementi riportati di seguito vengono trattati più dettagliatamente in questa esercitazione.

Confronto delle funzioni

Target at.js 2.x
SDK Web per Platform
Aggiorna profilo Target
Supportato
Supportato
Visualizzazione attivatore per SPA
Supportato
Supportato
Recommendations di destinazione
Supportato
Supportato
Recuperare offerte basate su moduli
Supportato
Supportato
Tracciare gli eventi
Supportato
Supportato
A4T: applicazione a pagina singola
Supportato
Supportato
A4T: Tracciamento dei clic
Supportato
Supportato
A4T: registrazione lato client
Supportato
Supportato
A4T: registrazione lato server
Supportato
Supportato
Applicare le offerte
Supportato
Supportato
Visualizza di nuovo il rendering in SPA senza notifiche
Supportato
Supportato
Applicazioni ibride
Supportato
Supportato
URL di controllo qualità
Supportato
Supportato
ID di terze parti Mbox
Supportato
Supportato
Attributi del cliente
Supportato
Supportato
Offerte remote
Supportato
Supportato
Offerte di reindirizzamento
Supportato
Supportato. Tuttavia, non è supportato il reindirizzamento da una pagina con Platform Web SDK a una pagina con at.js (e nella direzione opposta).
Decisioning sul dispositivo
Supportato
Non attualmente supportato
Preacquisizione di Mbox
Supportato per ambiti personalizzati e Compositore esperienza visivo SPA
La preacquisizione è la modalità predefinita per Web SDK
Eventi personalizzati
Supportato
Non supportato. Per informazioni sullo stato corrente, consulta la roadmap pubblica.
Token di risposta
Supportato
Supportato. Consulta la documentazione sui token di risposta dedicati per esempi di codice e differenze tra at.js e Platform Web SDK
Fornitori di dati
Supportato
Non supportato. Il codice personalizzato può essere utilizzato per attivare un comando Platform Web SDK sendEvent dopo il recupero dei dati da un altro provider.

Callout rilevanti

Target at.js 2.x
SDK Web per Platform
Attenuazione dello sfarfallio
Il frammento pre-hiding per le implementazioni asincrone utilizza un ID di stile di at-body-style. at.js cerca questo ID elemento per rimuovere lo stile una volta ricevuta una risposta.
Lo snippet predefinito per il pre-hiding utilizza un ID di stile di alloy-prehiding. L’SDK per web non è compatibile con il frammento pre-hiding di at.js, pertanto deve essere modificato come parte del processo di migrazione.
Rendering automatico del contenuto al caricamento della pagina
Controllato con un’impostazione globale di Target. Abilitato quando pageLoadEnabled è impostato su true.
Specificato nel comando Platform Web SDK sendEvent. Attivato impostando l'opzione renderDecisions su true.
Rendering manuale del contenuto
Le funzioni applyOffer() e applyOffers() supportano l'impostazione solo di HTML
Il comando applyPropositions supporta l'impostazione, la sostituzione o l'aggiunta di HTML per una maggiore flessibilità
Tracciamento degli eventi personalizzati
Supportato con trackEvent() e sendNotifications() funzioni. Queste funzioni sono specifiche di Target e non influiscono sulle metriche di Adobe Analytics.
Tutti i dati dalle chiamate Platform Web SDK sendEvent vengono inoltrati a Target. I dati supplementari necessari specificatamente per Target devono essere inclusi con il comando sendEvent con eventType decisioning.propositionDisplay o decisioning.propositionInteract per garantire che le metriche di Adobe Analytics non siano interessate.
CNAME di destinazione
Supportato. Questo è separato dal CNAME utilizzato per Analytics e dal servizio ID Experience Cloud.
Non più rilevante. Un singolo CNAME può essere utilizzato per tutte le chiamate dell’SDK web di Platform.
Debug
I parametri URL mboxDisable, mboxDebug e mboxTrace possono essere utilizzati per il debug con gli strumenti di sviluppo del browser.

L'Adobe Experience Platform Debugger è anche uno strumento di debug supportato.
I parametri URL mboxDisable, mboxDebug e mboxTrace non sono supportati.

Puoi attivare il debug di Web SDK aggiungendo alloy_debug=true alla stringa di query o eseguendo alloy("setDebug", { "enabled": true }); nella console per sviluppatori.

L'estensione del browser Adobe Experience Platform Debugger può essere utilizzata per avviare una traccia Edge per il debug.

Per ulteriori informazioni, consulta la documentazione sul debug di Platform Web SDK.
Analytics for Target (A4T)
Utilizza i valori SDID per unire le chiamate di Target e Analytics
Supportato in modalità nativa senza necessità di unione
NOTE
La migrazione di Target a Platform Web SDK durante il mantenimento di un’implementazione AppMeasurement Adobe Analytics esistente per una determinata pagina non è supportata.
È possibile migrare l’implementazione at.js (e AppMeasurement.js) a Platform Web SDK una pagina alla volta. Se si utilizza questo approccio, è consigliabile impostare le opzioni idMigrationEnabled e targetMigrationEnabled su true con il comando configure.

Funzioni di at.js ed equivalenti di Platform Web SDK

Molte funzioni di at.js hanno un approccio equivalente utilizzando Platform Web SDK descritto nella tabella seguente. Per ulteriori dettagli sulle funzioni at.js, consulta la Guida per gli sviluppatori di Adobe Target.

Funzione at.js 2.x
Equivalente di Platform Web SDK
getOffer() e getOffers()
Per richiedere e eseguire automaticamente il rendering delle esperienze basate sul Compositore esperienza visivo di Target, utilizzare il comando sendEvent e impostare l'opzione renderDecisions su true.

Per richiedere esperienze basate su moduli o per eseguire manualmente il rendering del contenuto, specifica una matrice di decisionScopes (mbox) con il comando sendEvent.
applyOffer() e applyOffers()
Utilizzare il comando applyPropositions per applicare il contenuto. Puoi scegliere di impostare, sostituire o aggiungere HTML a un selettore specifico.
triggerView()
Platform Web SDK attiva automaticamente una modifica della visualizzazione ai fini del Compositore esperienza visivo per SPA se la proprietà web.webPageDetails.viewName è impostata nell'opzione xdm del comando sendEvent.
trackEvent() e sendNotifications()
Utilizza il comando sendEvent con un set eventType🔗 specifico:

decisioning.propositionDisplay segnala il rendering di un'attività

decisioning.propositionInteract segnala un'interazione dell'utente con un'attività, come un clic del mouse.
targetGlobalSettings()
Nessun equivalente diretto. Per ulteriori dettagli, consulta il confronto delle impostazioni di Target.
targetPageParams() e targetPageParamsAll()
Tutti i dati passati nell'opzione xdm del comando sendEvent sono mappati ai parametri mbox di Target. Poiché i parametri mbox sono denominati utilizzando la notazione con punto serializzato, la migrazione a Platform Web SDK potrebbe richiedere l’aggiornamento dei tipi di pubblico e delle attività esistenti per utilizzare i nuovi nomi dei parametri mbox.

I dati passati come parte di data.__adobe.target del comando sendEvent sono mappati al profilo di destinazione e ai parametri specifici di Recommendations.
Eventi personalizzati at.js
Non supportato. Per informazioni sullo stato corrente, consulta la roadmap pubblica. I token di risposta sono esposti come parte di propositions nella risposta della chiamata sendEvent.

Impostazioni di at.js ed equivalenti di Platform Web SDK

La libreria at.js può essere configurata e scaricata con varie impostazioni nell’interfaccia utente di Target. Queste impostazioni possono anche essere aggiornate con la funzione targetGlobalSettings(). La tabella seguente confronta queste impostazioni con quelle disponibili con Platform Web SDK.

Impostazione at.js
Equivalente di Platform Web SDK
bodyHiddenStyle
Imposta prehidingStyle con il comando configure
bodyHidingEnabled
Se un prehidingStyle è definito con il comando configure, questa funzione è abilitata. Se non è definito uno stile, Platform Web SDK non tenta di nascondere alcun contenuto.
clientCode
Configurazione automatica
cookieDomain
Non applicabile
crossDomain
Imposta l'opzione thirdPartyCookiesEnabled su true con il comando configure per abilitare i cookie di prime e terze parti per i casi di utilizzo tra domini diversi
cspScriptNonce e cspStyleNonce
Consulta la documentazione per configurazione di un CSP
dataProviders
Non supportato
decisioningMethod
Tutti i comandi di Platform Web SDK sendEvent utilizzano le decisioni lato server. Le decisioni ibride e su dispositivo non sono supportate.
defaultContentHiddenStyle e defaultContentVisibleStyle
Applicabile solo con at.js 1.x. Simile a at.js 2.x, qualsiasi mitigazione della visualizzazione momentanea di altri contenuti per esperienze basate su moduli può essere ottenuta utilizzando un codice personalizzato.
deviceIdLifetime
Non supportato. Se targetMigrationEnabled è impostato su true con il comando configure, il cookie mbox viene impostato con la durata del dispositivo impostata su 2 anni. Valore non configurabile.
enabled
La funzionalità di destinazione è abilitata o disabilitata con la configurazione del flusso di dati
globalMboxAutoCreate
Imposta l'opzione renderDecisions su true con il comando sendEvent per recuperare ed eseguire automaticamente il rendering delle esperienze basate sul Compositore esperienza visivo.

Richiedi decisionScope per __view__ se preferisci eseguire manualmente il rendering delle esperienze basate su Compositore esperienza visivo.
imsOrgId
Imposta orgId con il comando configure
optinEnabled e optoutEnabled
Consulta le opzioni per la privacy di Platform Web SDK. L'opzione defaultConsent si applica a tutte le soluzioni Adobe supportate da Platform Web SDK.
overrideMboxEdgeServer e overrideMboxEdgeServerTimeout
Non applicabile. Tutte le richieste di Platform Web SDK utilizzano la rete Adobe Experience Platform Edge.
pageLoadEnabled
Imposta l'opzione renderDecisions su true con il comando sendEvent
secureOnly
Non supportato. Platform Web SDK imposta tutti i cookie con gli attributi secure e sameSite="none".
selectorsPollingTimeout
Non supportato. Platform Web SDK utilizza un valore di 5 secondi. Se necessario, è possibile utilizzare il codice personalizzato per eseguire manualmente il rendering del contenuto.
serverDomain
Utilizza l'impostazione edgeDomain con il comando configure
telemetryEnabled
Non applicabile
timeout
Non supportato. È consigliabile assicurarsi che qualsiasi codice di mitigazione della visualizzazione momentanea di altri contenuti includa un timeout appropriato.
viewsEnabled
Non supportato. Il contenuto per le visualizzazioni di Target viene sempre recuperato alla prima chiamata sendEvent() se renderDecisions è impostato su true o se il decisionScope __view__ è incluso nella richiesta.
visitorApiTimeout
Non applicabile

Confronto dei diagrammi di sistema

I seguenti diagrammi sono utili per comprendere le differenze di flusso di dati tra un’implementazione di Target con at.js e un’implementazione con Platform Web SDK.

Diagramma del sistema di at.js 2.x

Comportamento di at.js 2.0 al caricamento della pagina {modal="regular"}

Chiamata
Dettagli
1
La chiamata restituisce l’ID Experience Cloud (ECID). 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 può anche essere caricato in modo asincrono con un eventuale snippet prenascosto implementato sulla pagina).
3
Viene effettuata una richiesta di caricamento della pagina, con tutti i parametri configurati, ECID, SDID e ID cliente.
4
Gli script di profilo vengono eseguiti e inseriti nell’archivio profili. L’archivio richiede un pubblico idoneo dalla libreria Pubblico (ad esempio, pubblico condiviso da Analytics, Audience Manager e così via). Gli attributi del cliente vengono inviati all’archivio profili in un processo batch.
5
In base all’URL, ai parametri di richiesta e ai dati di profilo, Target decide quali attività ed esperienze restituire al visitatore per la pagina corrente e le viste future.
6
Contenuto di destinazione rinviato alla pagina, includendo facoltativamente i valori di profilo per ulteriore personalizzazione.

Il contenuto di destinazione nella pagina corrente viene mostrato il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.

Il contenuto di destinazione per le viste future di un'applicazione a pagina singola è memorizzato nella cache del browser, quindi può essere applicato immediatamente senza una chiamata al server aggiuntiva quando si attivano le viste.
7
Dati di Analytics inviati dalla pagina 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 rapporti A4T.

Per ulteriori informazioni su come implementare Target utilizzando at.js per applicazioni a pagina singola, consulta la guida per sviluppatori.

Diagramma del sistema di Platform Web SDK

Diagramma di Adobe Target Edge Decisioning con Platform Web SDK

Chiamata
Dettagli
1
Il dispositivo carica l’SDK web di Platform. Platform Web SDK invia una richiesta alla rete Edge con dati XDM, l’ID dell’ambiente Datastreams, i parametri immessi e l’ID cliente (facoltativo). La pagina (o i contenitori) è nascosta anticipatamente.
2
La rete Edge invia la richiesta ai servizi Edge di per arricchirla con l’ID visitatore, il consenso e altre informazioni contestuali sul visitatore, come la geolocalizzazione e i nomi descrittivi dei dispositivi.
3
La rete Edge invia la richiesta di personalizzazione arricchita al server Edge di Target con l’ID visitatore e i parametri immessi.
4
Gli script di profilo vengono eseguiti e quindi inseriti nell’archiviazione del profilo di Target. L’archiviazione dei profili recupera i segmenti dalla libreria Pubblico (ad esempio, i segmenti condivisi da Adobe Analytics, Adobe Audience Manager e Adobe Experience Platform).
5
In base ai parametri di richiesta dell’URL e ai dati di profilo, Target determina le attività ed esperienze da visualizzare per il visitatore per la visualizzazione della pagina corrente e per le visualizzazioni preacquisite future. Target quindi lo invia nuovamente alla rete Edge di.
6
a. La rete Edge invia nuovamente la risposta di personalizzazione alla pagina, includendo facoltativamente i valori di profilo per ulteriore personalizzazione. Il contenuto personalizzato nella pagina corrente viene mostrato il più rapidamente possibile senza che venga visualizzato momentaneamente il contenuto predefinito.

b. Il contenuto personalizzato per le viste mostrate come risultato delle azioni dell’utente in un’applicazione a pagina singola (SPA) viene memorizzato nella cache per il rendering immediato senza chiamate al server aggiuntive.

c. La rete Edge invia l’ID visitatore e altri valori nei cookie (ad esempio consenso, ID sessione, identità, controllo dei cookie, personalizzazione e così via).
7
La rete Edge inoltra i dettagli di Analytics for Target (A4T) (metadati di attività, esperienza e conversione) al server Edge di Analytics.

Per ulteriori informazioni su come implementare Target utilizzando Platform Web SDK per applicazioni a pagina singola, consultare la guida per gli sviluppatori.

Dopo aver acquisito una buona conoscenza tecnica dell'implementazione corrente di Target e delle funzionalità utilizzate, il passaggio successivo consiste nell'eseguire la configurazione iniziale.

NOTE
Ci impegniamo ad aiutarti con la migrazione di Target da at.js a Web SDK. Se incontri ostacoli con la migrazione o pensi che in questa guida manchino informazioni critiche, inviaci questa discussione della community.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110