Documentazione Guida per gli sviluppatori di Target

Inizializzare gli SDK

Last update: Fri Sep 29 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
APIs/SDKs

Creato per:

Experienced
Developer

Segui i passaggi descritti in Inizializza SDK per garantire che tutte le attività necessarie per caricare Adobe Target La libreria JavaScript at.js viene eseguita nella sequenza corretta.

TIP

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

Inizializza diagramma SDK diagram

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 nel Target Interfaccia utente durante la creazione dell’attività.

Inizializza diagramma SDK {width="600" modal="regular"}

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 load

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

Consulta i dettagli

Caricare il diagramma SDK dell’API visitatore

Prerequisiti

Per utilizzare il servizio ID visitatore/API, la società deve essere abilitata per Adobe Experience Cloud e hanno un ID organizzazione. Per ulteriori informazioni, consulta Requisiti di Experience Cloud: ID organizzazione nel Guida del servizio Identity guida.
Hai bisogno di VisitorAPI.js file. Dovresti avere già questo file, se Adobe Analytics implementato. Questo file può essere aggiunto anche tramite Adobe Experience Platform estensione tag or can be downloaded from the Adobe Analytics Code Manager.

Configurare e consultare VisitorAPI.js

Per ulteriori informazioni, consulta Implementazione del servizio Experience Cloud per Target.

Letture

Azioni

Incorpora il VisitorAPI.js nelle pagine Web.
Leggi informazioni su configurazioni disponibili per il servizio ID visitatore/API.
Dopo il VisitorAPI.js è caricato, utilizza Visitor.getInstance per inizializzare utilizzando le configurazioni necessarie.
Acquisisci familiarità con metodi disponibili.

Torna al diagramma nella parte superiore di questa pagina.

1.2: Imposta ID cliente set

Questo passaggio ti aiuta a garantire 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.

Consulta i dettagli

Imposta ID cliente

Prerequisiti

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

Imposta ID cliente
Per ulteriori informazioni, consulta setCustomerIDs.

Letture

Sincronizzazione dei profili in tempo reale per mbox3rdPartyId

Azioni

Utilizzare 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 automatic

Questo passaggio consente a at.js di recuperare tutte le esperienze che devono essere sottoposte a rendering sulla pagina durante il caricamento del file di libreria JavaScript at.js.

Consulta i dettagli

Configurare la 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.
Assicurati di non inviare dati personali (PII, Personally Identifiable Information) a Target.

Configurare la richiesta di caricamento pagina automatico

Per ulteriori informazioni, consulta targetGlobalSettings().

Letture

Scopri di più su pageLoadEnabled impostazione in targetGlobalSettings().

Azioni

Modifica il 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 flicker

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

Consulta i dettagli

Configurare il diagramma di gestione della visualizzazione momentanea di altri contenuti

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.

Configurare la gestione dello sfarfallio

Per ulteriori informazioni, consulta targetGlobalSettings().

Impostazione bodyHidingEnabled a true nasconde 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 qualsiasi motivo (ad esempio, se i dati non sono pronti in un secondo momento), è meglio impostare questa impostazione su false.

Se hai disabilitato bodyHidingEnabled poiché 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

Modifica il window.targetGlobalSettings oggetto da impostare bodyHiddenStyle e bodyHidingEnabled.

Torna al diagramma nella parte superiore di questa pagina.

1.5: Configurare la mappatura dei dati data-mapping

Questo passaggio garantisce che tutti i dati che devono essere inviati a Target è impostato.

Consulta i dettagli

Diagramma di mappatura dei dati

Prerequisiti

Il livello dati deve essere pronto con tutti i dati che devono essere inviati a Target.
Recommendations: arricchisci profilo.
- Superato entity.id per acquisire dati per articoli e criteri visualizzati di recente in base a criteri basati sull’ultimo prodotto visualizzato.
- Superato entity.id per acquisire 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 trasmessi per acquisire o aggiornare il catalogo dei prodotti in Recommendations.
- Il catalogo dei prodotti può essere aggiornato anche utilizzando i feed di entità utilizzando Target Interfaccia utente o API.

Mappa dati suTarget

Per ulteriori informazioni, consulta targetPageParams().

Letture

Azioni

Utilizza il targetPageParams() per impostare tutti i dati richiesti da inviare a Target.

Torna al diagramma nella parte superiore di questa pagina.

1.6: Promozione promotion

Aggiungi articoli in promozione e controllane il posizionamento nel tuo Target Recommendations progetti.

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 cart

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

Consulta i dettagli

Criteri disponibili

Chi ha visualizzato questi ha visualizzato anche quelli
Chi ha visualizzato questi ha acquistato anche quelli
Chi ha comprato questi ha acquistato anche quelli

Parametri di entità richiesti

cartIds

Letture

Basato su carrello

Torna al diagramma nella parte superiore di questa pagina.

1.8: Criteri basati sulla popolarità popularity

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

Articoli più visualizzati nel sito
Più visualizzati per categoria
Più visualizzati per attributo articolo
Articoli più venduti in tutto il sito
Articoli più venduti per categoria
Attributo Articoli più venduti
Primi per metrica di Analytics

Parametri di entità richiesti

entity.categoryId o l'attributo dell'articolo in base alla popolarità, se il criterio è basato sull'articolo corrente o sull'attributo dell'articolo.
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 item

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