Documentazione Target Guida per gli sviluppatori di Target

Inizializzare gli SDK

5 maggio 2025

Argomenti:
APIs/SDKs

Creato per:

Esperto
Sviluppatore

Segui i passaggi descritti nel diagramma Initialize SDK per assicurarti che tutte le attività necessarie per caricare la libreria at.js JavaScript di Adobe Target vengano eseguite nella sequenza corretta.

TIP

Fare clic sulle immagini in questo argomento per espandere a schermo intero.

Inizializza diagramma SDK

Per le applicazioni multipagina, questo flusso si verifica ogni volta che la pagina si ricarica o il visitatore passa a una nuova pagina del sito web.

NOTE

I numeri dei passi nella figura seguente corrispondono alle sezioni riportate di seguito. I numeri dei passaggi non sono in un ordine particolare e non riflettono l'ordine dei passaggi eseguiti nell'interfaccia utente Target durante la creazione dell'attività.

Inizializza diagramma SDK

Fai clic sui seguenti collegamenti per passare alle sezioni desiderate:

1.1: Caricare l’SDK dell’API visitatore
1.2: Imposta ID cliente
1.3: Configurare la richiesta di caricamento pagina automatico
1.4: Configurare la gestione dello sfarfallio
1.5: Configurare la mappatura dei dati
1.6: Promozione
1.7: Criteri basati sul carrello
1.8: Criteri basati sulla popolarità
1.9: Criteri basati sugli articoli
1.10: Criteri basati sugli utenti
1.11: Criteri personalizzati
1.12: Fornire gli attributi utilizzati nelle regole di inclusione
1.13: Fornire excludedIds
1.14: passa il parametro entity.event.detailsOnly=true
1.15: Configurare la mappatura dei dati remoti
1.16: Caricare at.js

1.1: Caricare l’SDK dell’API visitatore

Questo passaggio garantisce che la libreria VisitorAPI.js sia caricata, configurata e inizializzata correttamente.

Consulta i dettagli

Carica diagramma SDK API visitatore

Prerequisiti

Per utilizzare il servizio ID visitatore/API, la società deve essere abilitata per Adobe Experience Cloud e disporre di Organization ID. Per ulteriori informazioni, consulta Requisiti di Experience Cloud: ID organizzazione nella Guida del servizio Identity.
È necessario il file VisitorAPI.js. Questo file dovrebbe essere già presente se sono stati implementati Adobe Analytics. Questo file può anche essere aggiunto tramite l'estensione Adobe Experience Platform tags o scaricato da Adobe Analytics Code Manager.

Configura e fai riferimento a VisitorAPI.js

Per ulteriori informazioni, vedere Implementare il servizio Experience Cloud per Target.

Letture

Azioni

Incorporare il file VisitorAPI.js nelle pagine Web.
Scopri le configurazioni disponibili per il servizio ID visitatore/API.
Dopo il caricamento del file VisitorAPI.js, utilizzare il metodo Visitor.getInstance per inizializzare utilizzando le configurazioni necessarie.
Acquisisci familiarità con i metodi disponibili.

Torna al diagramma nella parte superiore di questa pagina.

1.2: Imposta ID cliente

Questo passaggio garantisce che gli ID noti dei visitatori (ID CRM, ID utente e così via) siano associati all'ID anonimo di Adobe per la personalizzazione tra dispositivi diversi.

Consulta i dettagli

Imposta ID cliente

Prerequisiti

L’ID noto dei visitatori deve essere disponibile nel livello dati.

Imposta ID cliente
Per ulteriori informazioni, vedere setCustomerIDs.

Letture

Sincronizzazione dei profili in tempo reale per mbox3rdPartyId

Azioni

Utilizza visitor.setCustomerIDs per impostare l'ID noto del visitatore.

Torna al diagramma nella parte superiore di questa pagina.

1.3: Configurare la richiesta di caricamento pagina automatico

Questo passaggio consente a at.js di recuperare tutte le esperienze di cui è necessario eseguire il rendering sulla pagina durante il caricamento del file della libreria JavaScript at.js.

Consulta i dettagli

Configura richiesta di caricamento pagina automatico

Prerequisiti

Non tutti i dati nel livello dati devono essere inviati a Target. Rivolgiti al team aziendale (team di marketing digitale) per determinare quali dati sono utili per la sperimentazione, l’ottimizzazione e la personalizzazione. Solo questi dati devono essere inviati a Target.
Assicurarsi di non inviare dati PII (Personally Identifiable Information) a Target.

Configura richiesta di caricamento pagina automatico

Per ulteriori informazioni, consulta targetGlobalSettings().

Letture

Informazioni sull'impostazione pageLoadEnabled in targetGlobalSettings().

Azioni

Modificare l'oggetto window.targetGlobalSettings per abilitare le richieste di caricamento pagina automatico.

Torna al diagramma nella parte superiore di questa pagina.

1.4: Configurare la gestione dello sfarfallio

Questo passaggio consente di evitare la visualizzazione momentanea di altri contenuti della pagina durante la distribuzione delle esperienze.

Consulta i dettagli

Configura diagramma gestione sfarfallio

Prerequisiti

Discuti con il team responsabile delle prestazioni delle pagine web dei pro e dei contro del controllo della visualizzazione momentanea di altri contenuti utilizzando il metodo predefinito utilizzato da at.js. È possibile cercare modelli di progettazione che consentano di utilizzare soluzioni personalizzate per la gestione dello sfarfallio, ad esempio l'animazione del caricatore. Se non trovate un pattern, potete richiederne uno nuovo.

Configura gestione sfarfallio

Per ulteriori informazioni, consulta targetGlobalSettings().

Se si imposta bodyHidingEnabled su true, verrà nascosto l'intero corpo della pagina mentre è in corso la richiesta di caricamento della pagina. Se non hai attivato la richiesta di caricamento pagina automatico per nessun motivo (ad esempio, se i dati non sono pronti in un secondo momento), conviene impostare questa impostazione su false.

Se bodyHidingEnabled è stato disabilitato perché non si desidera attivare l'APLR e si desidera attivare la richiesta di pagina in un secondo momento oppure non è necessario gestire la visualizzazione momentanea di altri contenuti, è necessario implementare la gestione della visualizzazione momentanea di altri contenuti. È possibile gestire la visualizzazione momentanea di altri contenuti in due modi: nascondendo le sezioni in fase di test o visualizzando un pulsante sulle sezioni in fase di test.

Letture

Gestione at.js della visualizzazione momentanea di altri contenuti
Scopri gli oggetti bodyHiddenStyle e bodyHidingEnabled in targetGlobalSettings().

Azioni

Modificare l'oggetto window.targetGlobalSettings per impostare bodyHiddenStyle e bodyHidingEnabled.

Torna al diagramma nella parte superiore di questa pagina.

1.5: Configurare la mappatura dei dati

Questo passaggio garantisce che tutti i dati che devono essere inviati a Target siano impostati.

Consulta i dettagli

Diagramma mappatura dati

Prerequisiti

Il livello dati deve essere pronto con tutti i dati che devono essere inviati a Target.
Recommendations: arricchisci profilo.
- Passa entity.id per acquisire i dati per gli elementi e i criteri visualizzati di recente in base ai criteri dell'ultimo prodotto visualizzato.
- Passa entity.id per acquisire i dati per i criteri di popolarità in base alla categoria preferita.
- Passa l’attributo di profilo se i criteri personalizzati sono basati su di esso o utilizzati nel filtro della regola di inclusione in qualsiasi criterio.
Recommendations: acquisire i dati di prodotto.
- Altri parametri di entità (riservati e personalizzati) possono essere passati per acquisire o aggiornare il catalogo prodotti in Recommendations.
- È inoltre possibile aggiornare il catalogo prodotti utilizzando feed di entità tramite l'interfaccia utente o l'API Target.

Mappa i dati suTarget

Per ulteriori informazioni, vedere targetPageParams().

Letture

Azioni

Utilizzare la funzione targetPageParams() per impostare tutti i dati richiesti da inviare a Target.

Torna al diagramma nella parte superiore di questa pagina.

1.6: Promozione

Aggiungi elementi promossi e controllane il posizionamento nelle Target Recommendations progettazioni.

Consulta i dettagli

Opzioni disponibili

Parametri di entità richiesti

L'attributo dell'articolo nella promozione deve essere passato quando si utilizza l'opzione "Promuovi per attributo".

Torna al diagramma nella parte superiore di questa pagina.

1.7: Criteri basati sul carrello

Creare consigli in base al contenuto del carrello dell’utente.

Consulta i dettagli

Criteri disponibili

People Who Viewed These, Viewed Those
People Who Viewed These, Bought Those
People Who Bought These, Bought Those

Parametri di entità richiesti

cartIds

Letture

Basato su carrello

Torna al diagramma nella parte superiore di questa pagina.

1.8: Criteri basati sulla popolarità

Puoi formulare raccomandazioni in base alla popolarità complessiva di un elemento nel tuo sito o in base alla popolarità degli elementi nella categoria, nel brand, nel genere e così via preferiti o più visualizzati di un utente.

Consulta i dettagli

Criteri disponibili

Most Viewed Across the Site
Most Viewed by Category
Most Viewed by Item Attribute
Top Sellers Across the Site
Top Sellers by Category
Top Sellers by Item Attribute
Top by Analytics Metric

Parametri di entità richiesti

entity.categoryId o l'attributo dell'elemento per la popolarità se il criterio è basato sull'elemento corrente o sull'attributo dell'elemento.
Non è necessario trasmettere nulla per i Più visualizzati/Più venduti nel sito.

Letture

Basato sulla popolarità

Torna al diagramma nella parte superiore di questa pagina.

1.9: Criteri basati sugli articoli

Puoi formulare raccomandazioni in base alla ricerca di elementi simili a quelli di un elemento che l’utente sta visualizzando o che ha recentemente visualizzato.

Consulta i dettagli

Criteri disponibili