Implementare Target senza un sistema per la gestione dei tag

Information about implementing Adobe Target without using a tag manager (Adobe Launch or Dynamic Tag Manager).

Nota

Adobe Launch è il metodo preferito per l’implementazione di Target e della libreria at.js. Le seguenti informazioni non sono applicabili quando si utilizza Adobe Launch per implementare Target.

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

In questa pagina potete specificare le seguenti impostazioni:

  • Dettagli account
  • Metodi di implementazione
  • API profilo
  • Strumenti debugger
  • Privacy
Nota

È possibile modificare le impostazioni nella libreria at.js anziché configurare le impostazioni nell’interfaccia utente di Target Standard/Premium o con le API REST. Per ulteriori informazioni, consulta targetGlobalSettings().

Dettagli account

Potete visualizzare i seguenti dettagli account. Queste impostazioni non possono essere modificate.

Impostazione Descrizione
Codice cliente 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.

Metodi di implementazione

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

Impostazioni globali

Nota

Queste impostazioni vengono applicate a tutte le librerie Target .js. Dopo aver apportato le modifiche nella sezione Metodi di implementazione è necessario scaricare la libreria e aggiornarla nell'implementazione.

Impostazione Descrizione
Caricamento pagina abilitato (creazione automatica di 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 operazione può essere prolungata fino a 90 giorni.
Per modificare l’impostazione Durata del profilo, contatta l’Assistenza clienti.

Metodo di implementazione principale

IMPORTANTE

Il team Target supporta entrambi at.js 1.x e at.js 2.x. Esegui l'aggiornamento all'aggiornamento più recente di una delle versioni principali di at.js per assicurarti che sia in esecuzione una versione supportata.

Per scaricare la versione at.js desiderata, fate clic sul pulsante Scarica appropriato.

Per modificare le impostazioni at.js, fate clic su Modifica accanto alla versione at.js desiderata.

IMPORTANTE

Prima di modificare queste impostazioni predefinite, consulta Client Care per non influenzare l'implementazione corrente.

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

Impostazione Descrizione
Intestazione libreria personalizzata Aggiungi un JavaScript personalizzato da includere nella parte superiore della libreria.
Piè di pagina libreria personalizzata 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.

For more information, see Profile API settings.

Strumenti debugger

Generare un token di autorizzazione per utilizzare strumenti Target di debug avanzati. Click Generate New Authentication Token.

Genera nuovo token di autenticazione

Privacy

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

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

  • Ultima offuscamento ottetto
  • Intera offuscamento IP
  • None (Nessuno)

Per ulteriori informazioni, consulta Privacy.

Nota

L'opzione Supporto browser legacy era disponibile in at.js versione 0.9.3 e precedenti. 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 l'opzione Supporto browser legacy è stata disabilitata, Target non distribuiva il contenuto o non contava i visitatori nei rapporti su questi browser. Se questa opzione è stata attivata, si consiglia di garantire la qualità tra i browser più datati per garantire una buona esperienza cliente.

Scaricare at.js

Instructions to download the library using the Target interface or the Download API.

Nota
  • Adobe Launch è il metodo preferito per l’implementazione di Target e della libreria at.js. Le seguenti informazioni non sono applicabili quando si utilizza Adobe Launch per implementare Target.

  • Il team Target supporta entrambi at.js 1.x e at.js 2.x. Esegui l'aggiornamento all'aggiornamento più recente di una delle versioni principali di at.js per assicurarti che sia in esecuzione una versione supportata. Per ulteriori informazioni su ogni versione, consulta Dettagli sulla versione di at.js.

Download at.js using the Target interface

Per scaricare at.js dall'interfaccia di Target:

  1. Fate clic su Amministrazione > Implementazione.
  2. Nella sezione Metodi di implementazione, fate clic sul pulsante Scarica accanto alla versione at.js desiderata.

Download at.js using the Target Download API

Per scaricare at.js utilizzando l'API.

  1. Ottieni il tuo codice cliente.

    Your client code is available at the top of the Administration > Implementation page of the Target interface.

  2. Ottieni il tuo numero di amministratore.

    Carica l'URL:

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

    Replace client code with the client code from Step 1.

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

    { 
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" 
    }
    

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

  3. Scarica at.js.

    Caricare questa URL con la seguente struttura:

    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    
    • Replace admin number with your admin number.
    • Replace client code with the client code from Step 1.
    • Replace version number with the desired at.js version number (for example, 2.2).
    IMPORTANTE

    Il team di Target 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.

    Il caricamento di questa URL avvia il download del file at.js personalizzato.

at.js implementation

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

Un’implementazione tipica di Target che non utilizza un gestore di tag come Adobe Launch o Dynamic Tag Management 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:

  • Deve essere utilizzato il tipo di documento HTML5 (ad esempio, <!doctype html>). I doctype non supportati o meno recenti potrebbero impedire a Target di effettuare una richiesta.
  • Preconnessione e Preacquisizione sono opzioni che potrebbero consentire di caricare più rapidamente le pagine Web. If you use these configurations, ensure that you replace <client code> with your own client code, which you can obtain from the Administration > **Implementation page.
  • 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 sfruttare queste informazioni in Target per la personalizzazione.
  • Funzioni speciali di Target, come ad esempio targetPageParams(), targetPageParamsAll(), Data Providers e targetGlobalSettings() devono essere definite dopo il livello di dati e prima di caricare at.js. In alternativa, possono venire 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 si utilizzano librerie di supporto di JavaScript, come ad esempio jQuery, includerle prima di Target così da poterne sfruttare la sintassi e i metodi durante la creazione di esperienze Target.
  • Includere at.js nei <head> delle pagine.

Track conversions

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”.

Nota

Se gli utenti effettuano acquisti sul tuo sito web, ti consigliamo di implementare una mbox di conferma d’ordine anche se per generare rapporti usi Analytics for Target (A4T).

  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.

    Nota

    Utilizza le virgole per separare i diversi ID prodotto.

    Suggerimento: è possibile, inoltre, passare le informazioni di 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.

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

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.

In questa pagina