Implementare Target senza un sistema per la gestione dei tag

Informazioni sull’implementazione di Adobe Target senza utilizzare un gestore di tag o i tag in Adobe Experience Platform.

NOTE
Tag in Adobe Experience Platform sono il metodo preferito per l'implementazione di Target e la libreria at.js. Le seguenti informazioni non sono applicabili quando si utilizzano i tag in Adobe Experience Platform per implementare Target.

Per accedere alla pagina Implementazione, fai clic su Amministrazione > Implementazione.

In questa pagina è possibile specificare le impostazioni seguenti:

  • Dettagli account
  • Metodi di implementazione
  • API profilo
  • Strumenti di debug
  • Privacy
NOTE
È possibile modificare le impostazioni nella libreria at.js anziché configurarle nella Target Interfaccia utente di Standard/Premium o tramite API REST. Per ulteriori informazioni, consulta targetGlobalSettings().

Dettagli account

Puoi visualizzare i seguenti dettagli dell’account. Queste impostazioni non possono essere modificate.

Impostazione
Descrizione
Codice client
Il codice cliente è una sequenza di caratteri specifica del cliente spesso necessaria quando si utilizzano le API di Target.
ID organizzazione IMS
Questo ID collega l’implementazione al tuo account Adobe Experience Cloud.
Decisioning sul dispositivo

Per abilitare il decisioning sul dispositivo, fai scorrere l’interruttore su "on".

Le attività di decisioning sul dispositivo consentono di memorizzare nella cache le campagne A/B e Targeting esperienza (XT) sul server ed eseguire attività di decisioning in memoria con latenza pressoché pari a zero. Per ulteriori informazioni, consulta Introduzione al decisioning sul dispositivo.

Includi nell’artefatto tutte le attività qualificate per il decisioning sul dispositivo esistenti

(Condizionale) Questa opzione viene visualizzata se abiliti le decisioni sul dispositivo.

Sposta l’interruttore in posizione "attivato" se desideri attivare tutte le attività Target le attività che si qualificano per le decisioni su dispositivo devono essere incluse automaticamente nell’artefatto.

Lasciando questa opzione disattivata, è necessario ricreare e attivare tutte le attività decisionali sul dispositivo affinché vengano incluse nell’artefatto delle regole generato.

Metodi di implementazione

Le seguenti impostazioni possono essere configurate nel pannello Metodi di implementazione:

Impostazioni globali

NOTE
Queste impostazioni vengono applicate a tutti Target librerie .js. Dopo aver apportato le modifiche nella sezione Metodi di implementazione, scarica la libreria e aggiornala nella tua implementazione.
Impostazione
Descrizione
Caricamento pagina abilitato (creazione automatica di una mbox globale)
Seleziona se incorporare la chiamata mbox globale nel file at.js in modo che si attivi automaticamente al caricamento di ogni pagina.
Mbox globale

Seleziona un nome per la mbox globale. Per impostazione predefinita, il nome è target-global-mbox.

Nei nomi delle mbox in at.js puoi usare caratteri speciali, tra cui il simbolo &.

Timeout (secondi)

Se Target non risponde con il contenuto entro il periodo definito, la chiamata al server riceve un timeout e viene visualizzato il contenuto predefinito. Durante la sessione del visitatore vengono ripetuti ulteriori tentativi di chiamata. Il valore predefinito è 5 secondi.

La libreria at.js utilizza l’impostazione di timeout in XMLHttpRequest. Il timeout viene avviato quando parte la richiesta e si interrompe quando Target riceve una risposta dal server. Per ulteriori informazioni, consulta XMLHttpRequest.timeout in Mozilla Developer Network.

Se il timeout specificato si verifica prima della ricezione della risposta, viene visualizzato il contenuto predefinito e il visitatore può essere conteggiato come partecipante a un’attività, poiché la raccolta dei dati viene eseguita sul server Edge di Target. Se la richiesta raggiunge il server Edge di Target, il visitatore viene conteggiato.

Quando configuri l’impostazione di timeout, tieni presente quanto segue:

  • Se il valore è troppo basso, gli utenti potrebbero visualizzare il contenuto predefinito la maggior parte delle volte, nonostante il visitatore venga conteggiato come partecipante all’attività.
  • Se il valore è troppo alto, i visitatori potrebbero visualizzare aree vuote nella pagina web o pagine vuote (se utilizzi la funzione per nascondere il corpo) per periodi di tempo prolungati.

Per comprendere meglio i tempi di risposta della mbox, guarda la scheda Rete negli strumenti di sviluppo del tuo browser. Puoi anche utilizzare strumenti di terze parti per il monitoraggio delle prestazioni web, ad esempio Catchpoint.

Nota: l’impostazione visitorApiTimeout evita che Target attenda troppo a lungo la risposta dell’API visitatore. Questa impostazione e l’impostazione Timeout per at.js qui descritta non entrano in contrasto.

Durata del profilo

Questa impostazione determina per quanto tempo vengono memorizzati i profili visitatore. Per impostazione predefinita, i profili vengono memorizzati per due settimane. Questa impostazione può essere aumentata fino a 90 giorni.

Per modificare l’impostazione Durata del profilo, contatta l’Assistenza clienti.

Metodo di implementazione principale

NOTE
Adobe Target supporta sia at.js 1.x e at.js 2.x. Esegui l’aggiornamento alla versione più recente di una delle versioni principali di at.js per assicurarti di eseguire una versione supportata.

Per scaricare la versione at.js desiderata, fai clic sull’icona appropriata Scarica pulsante.

Per modificare l’impostazione di at.js, fai clic su Modifica accanto alla versione at.js desiderata.

WARNING
Prima di modificare queste impostazioni predefinite, consulta Assistenza clienti in modo da non influenzare l’implementazione corrente.

Oltre alle impostazioni spiegate in precedenza, sono disponibili anche le seguenti impostazioni at.js specifiche:

Impostazione
Descrizione
Tra domini
Per at.js v1.x, specifica se le funzionalità tra domini sono disabled I browser impostano i cookie solo nel tuo dominio (cookie di prime parti), x only (i browser impostano i cookie solo nel dominio di Target), o in entrambi, selezionando enabled (i browser impostano sia cookie di prima parte che di terze parti). Per at.js v2.10 e versioni successive, specifica se le funzionalità tra domini diversi sono enabled (i browser impostano sia cookie di prima parte che di terze parti) oppure disabled (i browser non impostano cookie di terze parti).
Intestazione libreria personalizzata
Aggiungi un JavaScript personalizzato da includere nella parte superiore della libreria.
Piè di pagina libreria personalizzato
Aggiungi un JavaScript personalizzato da includere nella parte inferiore della libreria.

API profilo

Puoi abilitare o disabilitare l’autenticazione per gli aggiornamenti collettivi tramite API e generare un token di autenticazione del profilo.

Per ulteriori informazioni, consulta Impostazioni API del profilo.

Strumenti di debug

Generare un token di autorizzazione per utilizzare le funzionalità avanzate Target strumenti di debug. Clic Genera nuovo token di autenticazione.

Generare un nuovo token di autenticazione

Privacy

Queste impostazioni consentono di utilizzare Target in conformità con le leggi sulla privacy dei dati.

Scegli l’impostazione desiderata dall’elenco a discesa Indirizzo IP visitatore offuscato:

  • Offuscamento dell’ultimo ottetto
  • Offuscamento dell’intero IP
  • None (Nessuno)

Per ulteriori informazioni, consulta Privacy.

NOTE
L’opzione Supporto di browser legacy era disponibile nelle versioni 0.9.3 e precedenti di at.js. Questa opzione è stata rimossa in at.js versione 0.9.4. Per un elenco di browser supportati da at.js, consulta Browser supportati.
I browser legacy sono browser meno recenti che non supportano completamente la condivisione delle risorse tra diverse origini (Cross Origin Resource Sharing, CORS). Questi browser includono: Internet Explorer nelle versioni precedenti alla versione 11; Safari versione 6 e precedenti. Se il supporto di browser legacy è stato disabilitato, Target non ha consegnato contenuti o conteggiato i visitatori nei rapporti di questi browser. Se questa opzione è stata abilitata, si consiglia di eseguire il controllo qualità nei browser più datati per garantire una buona esperienza del cliente.

Scaricare at.js

Istruzioni per scaricare la libreria utilizzando Target o l'API di download.

NOTE
Adobe Experience Platform è il metodo preferito per l'implementazione di Target e la libreria at.js. Le seguenti informazioni non sono applicabili quando si utilizzano i tag in Adobe Experience Platform per implementare Target.
Adobe Target supporta sia at.js 1.x e at.js 2.x. Esegui l’aggiornamento alla versione più recente di una delle versioni principali di at.js per assicurarti di eseguire una versione supportata. Per ulteriori informazioni su ogni versione, consulta Dettagli sulla versione di at.js.

Scaricare at.js utilizzando Target Interfaccia

Per scaricare at.js da Target Interfaccia:

  1. Fai clic su Amministrazione > Implementazione.
  2. Dalla sezione Metodi di implementazione, fai clic su Scarica accanto alla versione at.js desiderata.

Scaricare at.js utilizzando Target Scarica API

Per scaricare at.js utilizzando l'API.

  1. Ottieni il tuo codice cliente.

    Il codice cliente è disponibile nella parte superiore della sezione Amministrazione > Implementazione pagina di Target di rete.

  2. Ottieni il tuo numero di amministratore.

    Carica l'URL:

    code language-none
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    

    Sostituisci client code con il codice client del passaggio 1.

    Il risultato del caricamento dell'URL deve essere simile al seguente:

    code language-none
    {
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
    }
    

    In questo esempio, “6” è il numero di amministratore.

  3. Scaricare at.js .

    Caricare questa URL con la seguente struttura. Il caricamento di questa URL avvia il download del file at.js personalizzato.

    code language-none
    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    
    • Sostituisci admin number con il tuo numero di amministratore.
    • Sostituisci client code con il codice client del passaggio 1.
    • Sostituisci version number con il numero di versione at.js desiderato (ad esempio, 2.2).
WARNING
Il Target team gestisce solo due versioni di at.js: la versione corrente e quella immediatamente precedente. Aggiorna at.js per assicurarti di eseguire una versione supportata. Per ulteriori informazioni su ogni versione, consulta Dettagli sulla versione di at.js.

Implementazione di at.js

at.js dovrebbe essere implementato nell’elemento <head> di ogni pagina del sito Web.

Un’implementazione tipica di Target non utilizzare un gestore di tag, ad esempio i tag in Adobe Experience Platform ha un aspetto simile al seguente:

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title of the Page</title>
    <!--Preconnect and DNS-Prefetch to improve page load time-->
    <link rel="preconnect" href="//<client code>.tt.omtrdc.net">
    <link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
    <!--/Preconnect and DNS-Prefetch-->
    <!--Data Layer to enable rich data collection and targeting-->
    <script>
        var digitalData = {
            "page": {
                "pageInfo": {
                    "pageName": "Home"
                }
            }
        };
    </script>
    <!--/Data Layer-->
    <!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
    <script>
        targetPageParams = function() {
            return {
                "a": 1,
                "b": 2,
                "pageName": digitalData.page.pageInfo.pageName,
                "profile": {
                    "age": 26,
                    "country": {
                        "city": "San Francisco"
                    }
                }
            };
        };
    </script>
    <!--/targetPageParams()-->

    <!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
    <script src="jquery-3.3.1.min.js"></script>
    <!--/jQuery-->
    <!--Target's JavaScript SDK, at.js-->
    <script src="at.js"></script>
    <!--/at.js-->
</head>
<body>
    The default content of the page
</body>
</html>

Considera le seguenti note importanti:

  • Il Doctype HTML5 (ad esempio, <!doctype html>). I tipi di documento non supportati o meno recenti potrebbero causare Target non essere in grado di effettuare una richiesta.
  • Preconnessione e Preacquisizione sono opzioni che potrebbero consentire di caricare più rapidamente le pagine Web. Se utilizzi queste configurazioni, assicurati di sostituire <client code> con il tuo codice cliente, che puoi ottenere dal Amministrazione > Implementazione pagina.
  • Se si dispone di un livello di dati, è ottimale definirlo il più possibile nel <head> delle pagine prima di caricare at.js. Questo posizionamento offre la massima capacità di utilizzare queste informazioni in Target per la personalizzazione.
  • Speciale Target funzioni, come targetPageParams(), targetPageParamsAll(), Fornitori di dati e targetGlobalSettings() deve essere definito dopo il livello di dati e prima di caricare at.js. In alternativa, queste funzioni possono essere salvate nella sezione Intestazione libreria della pagina Modifica impostazioni at.js e salvate come parte della libreria at.js stessa. Per ulteriori informazioni su queste funzioni, vedi Funzioni di at.js.
  • Se utilizzi librerie di supporto JavaScript, come jQuery, includile prima di Target in modo da poterne utilizzare la sintassi e i metodi durante la generazione Target esperienze.
  • Includere at.js nei <head> delle pagine.

Tracciare le conversioni

Con la mbox di conferma dell’ordine è possibile registrare i dettagli sugli ordini sul sito e generare rapporti in base a ricavi e ordini. Con la mbox di conferma dell’ordine è inoltre possibile determinare algoritmi per i consigli, come “Persone che hanno acquistato il prodotto x hanno acquistato anche il prodotto y”.

NOTE
Se gli utenti effettuano acquisti sul tuo sito web, Adobe consiglia di implementare una mbox di conferma d’ordine anche se utilizzi Analytics per Target (A4T) per la generazione di rapporti.
  1. Nella pagina dei dettagli dell’ordine, inserisci lo script mbox secondo il modello indicato di seguito.

  2. Sostituisci le parole in lettere maiuscole con valori dinamici o statici provenienti dal catalogo.

    note tip
    TIP
    Puoi anche trasmettere le informazioni sull’ordine in qualsiasi mbox (non deve per forza chiamarsi). orderConfirmPage). Inoltre, puoi passare le informazioni di ordine in più mbox all'interno della stessa campagna.
    code language-none
    <script type="text/javascript">
    adobe.target.trackEvent({
        "mbox": "orderConfirmPage",
        "params":{
            "orderId": "ORDER ID FROM YOUR ORDER PAGE",
            "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE",
            "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3"
        }
    });
    </script>
    
NOTE
Nella mbox di conferma d'ordine, separa gli ID di più prodotti con la virgola.

La mbox di conferma d'ordine utilizza i seguenti parametri:

Parametro
Descrizione
orderId

Valore univoco per identificare un ordine per il conteggio di conversione.

L’orderId deve essere univoco. Gli ordini duplicati vengono ignorati nei rapporti.

orderTotal

Valore monetario dell'acquisto.

Non trasmettere il simbolo di valuta. Utilizza un punto decimale (non la virgola) per indicare i valori decimali.

productPurchasedId (facoltativo)

Elenco degli ID dei prodotti acquistati nell'ordine, separati da virgole.

Questi ID prodotto vengono visualizzati nel rapporto di revisione per supportare attività aggiuntive di analisi dei rapporti.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3