Implementare Target senza un sistema per la gestione dei tag
Informazioni sull'implementazione di Adobe Target senza l'utilizzo di uno o più tag in Adobe Experience Platform.
Per accedere alla pagina Implementazione, fare clic su Administration > Implementation.
In questa pagina è possibile specificare le impostazioni seguenti:
- Dettagli dell’account
- Metodi di implementazione
- API profilo
- Strumenti di debug
- Privacy
Dettagli dell’account
Puoi visualizzare i seguenti dettagli dell’account. Queste impostazioni non possono essere modificate.
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, vedere Introduzione alle decisioni sul dispositivo.
(Condizionale) Questa opzione viene visualizzata se abiliti le decisioni sul dispositivo.
Attiva l'opzione se desideri includere automaticamente nell'artefatto tutte le attività live di Target idonee per le decisioni su dispositivo.
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
Seleziona un nome per la mbox globale. Per impostazione predefinita, il nome è target-global-mbox.
Nei nomi delle mbox in at.js è possibile utilizzare caratteri speciali, tra cui il simbolo &.
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 la richiesta viene attivata e si arresta quando Target riceve una risposta dal server. Per ulteriori informazioni, vedere 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 potrebbe essere conteggiato come partecipante a un'attività, perché la raccolta dei dati viene eseguita sul server Edge Target. Se la richiesta raggiunge il server Edge 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 garantisce che Target non attenda troppo a lungo la risposta dell'API visitatore. Questa impostazione e l’impostazione Timeout per at.js qui descritta non entrano in contrasto.
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 della durata del profilo, contattare l'assistenza clienti.
Metodo di implementazione principale
Per scaricare la versione at.js desiderata, fai clic sul pulsante Scarica appropriato.
Per modificare l'impostazione di at.js, fai clic su Edit accanto alla versione di at.js desiderata.
Oltre alle impostazioni spiegate in precedenza, sono disponibili anche le seguenti impostazioni at.js specifiche:
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 entrambi, selezionando enabled
(i browser impostano sia i cookie di prima parte che quelli 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) o disabled
(i browser non impostano cookie di terze parti).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, vedere Impostazioni API profilo.
Strumenti di debug
Generare un token di autorizzazione per utilizzare gli strumenti di debug avanzati di Target. Fare clic su Generate New Authentication Token.
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.
Scaricare at.js
Istruzioni per scaricare la libreria utilizzando l'interfaccia Target o l'API di download.
Scaricare at.js utilizzando l'interfaccia Target
Per scaricare at.js dall'interfaccia Target:
- Fare clic su Administration > Implementation.
- Dalla sezione Metodi di implementazione, fai clic sul pulsante Download accanto alla versione at.js desiderata.
Scarica at.js utilizzando l'API di download Target
Per scaricare at.js utilizzando l’API.
-
Ottieni il tuo codice cliente.
Il codice client è disponibile nella parte superiore della pagina Administration > Implementation dell'interfaccia Target.
-
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.
-
Scarica at.js.
Carica questo URL con la seguente struttura. Il caricamento di questo 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).
- Sostituisci
Implementazione di at.js
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, 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:
- Deve essere utilizzato il Doctype 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. Se utilizzi queste configurazioni, assicurati di sostituire
<client code>
con il tuo codice client, che puoi ottenere dalla pagina Administration > Implementation. - 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. - Le funzioni speciali di Target, come
targetPageParams()
,targetPageParamsAll()
, Data Provider etargetGlobalSettings()
, devono essere definite dopo il livello dati e prima del caricamento di 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 at.js. - Se si utilizzano librerie di supporto di JavaScript, ad esempio jQuery, includerle prima di Target in modo da poterne utilizzare la sintassi e i metodi durante la creazione di 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”.
-
Nella pagina dei dettagli dell’ordine, inserisci lo script mbox secondo il modello indicato di seguito.
-
Sostituisci le parole in lettere maiuscole con valori dinamici o statici provenienti dal catalogo.
note tip TIP È inoltre possibile passare le informazioni sull'ordine in qualsiasi mbox (non deve necessariamente essere denominato 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>
La mbox di conferma d'ordine utilizza i seguenti parametri:
Valore univoco per identificare un ordine per il conteggio di conversione.
L’orderId
deve essere univoco. Gli ordini duplicati vengono ignorati nei rapporti.
Valore monetario dell'acquisto.
Non trasmettere il simbolo di valuta. Utilizza un punto decimale (non la virgola) per indicare i valori decimali.
Elenco degli ID dei prodotti acquistati nell'ordine, separati da virgole.
Questi ID prodotto vengono visualizzati nel rapporto di audit per supportare ulteriori analisi dei rapporti.