Conversion Counter Guida all'installazione
Introduzione INTRODUZIONE DESCRIZIONE DEL PRODOTTO Conversion Counter di Overture consente di verificare l'efficacia degli account Overture. Questo prodotto tiene traccia del tasso di conversione dei visitatori rispetto alla parola chiave a pagamento che ha condotto i visitatori al vostro sito e che ha portato al completamento di una transazione, quale l'acquisto di un prodotto, la registrazione al sito, la sottoscrizione al contenuto o l iscrizione alla newsletter. Il funzionamento di Conversion Counter è basato sul invio di un cookie a ciascun visitatore nel momento in cui questo seleziona un'inserzione a pagamento. Quando il visitatore raggiunge la pagina di completamento della transazione, il tag Overture legge il cookie per attribuire l evento al click del visitatore sull inserzione. Questa informazione viene quindi inserita e visualizzata nel DirecTraffic Center (DTC) nonché inserita nei report Attività account del DTC stesso. PANORAMICA Per iniziare ad acquisire le conversioni eseguite sul sito Web, è necessario installare diverse righe di codice, che nella presente guida vengono definite tag. Questa guida all'installazione vi fornirà le istruzioni generali relative all aggiunta di tag. È consigliabile leggere interamente le istruzioni prima di avviare la procedura di installazione. Questa guida offre, inoltre, istruzioni relative all'aggiunta di tag specifiche per processori e strumenti di siti dinamici di terze parti: Yahoo! Store EBay / PayPal Microsoft Visual InterDev (ASP) ATG Dynamo (JSP) ColdFusion MX BEA WebLogic (JSP) Una volta completata l'installazione dei tag, i report di Conversion Counter risulteranno disponibili entro le 24 ore successive alla prima conversione relativa al vostro account Overture. Questa guida presume la conoscenza degli strumenti HTML e/o Web necessari per implementare il tag di Conversion Counter. Gli utenti che non possiedono tale requisito possono rivolgersi al proprio Webmaster o a uno sviluppatore Web per ricevere assistenza. 2
Introduzione DEFINIZIONI Tag: Piccola parte di codice HTML che viene inserita nella pagina di completamento delle transazioni del sito Web. Aggiunta di tag: Processo di inserimento del tag Overture nella pagina di completamento delle transazioni. Conversione: Completamento di una transazione, ad esempio un acquisto o una registrazione, in seguito alla selezione, da parte del cliente, di un'inserzione Overture. Pagina di completamento delle transazioni Pagina del sito Web che viene visualizzata per confermare il completamento di una transazione (ad esempio, la pagina dei ringraziamenti). Una transazione equivale a una conversione e può essere rappresentata dall'acquisto di un prodotto, dall'iscrizione a una newsletter, da una registrazione di sottoscrizione o dalla conclusione di altre attività principali di generazione. 3
Istruzioni Generali relative all Aggiunta di Tag ISTRUZIONI GENERALI RELATIVE ALL AGGIUNTA DI TAG TAG OVERTURE Il tag Overture è una piccola parte di codice HTML conosciuta come JavaScript. Dopo essere stato aggiunto alla pagina di completamento delle transazioni del vostro sito Web, JavaScript consente di raccogliere e visualizzare all'interno di report le attività di riferimento del cliente ricavate dalle inserzioni Overture a pagamento e dagli acquisti da esse derivanti. In questo momento dovreste aver già ricevuto il vostro tag Overture, inviato in allegato al messaggio e-mail di benvenuto, e averlo memorizzato definitivamente nella pagina Configurazione account del DirecTraffic Center. Il tag deve essere inserito nella pagina di completamento delle transazioni del vostro sito Web senza subire alcuna modifica. Eventuali modifiche al tag Overture ne provocherebbero, infatti, un malfunzionamento, causando ad esempio imprecisioni nella raccolta dei dati o perdita dei dati stessi. Esempio di tag: Si tratta solo di un esempio. NON utilizzate questo tag! <SCRIPT LANGUAGE= JavaScript > <!--Overture Services Inc. 03/01/2003 var ov_tagversion = 1.0.0 ; var ov_accountid = XXXXXX ; var ov_querystr =? + tv= + ov_tagversion + &ai= + ov_accountid + &rf= + escape(document.referrer); var ov_convimage = new Image(); ov_convimage.src = //oa.overture.com/conversion.gif + ov_querystr; // --> </SCRIPT> PUNTO DI INSERIMENTO DEL TAG Per un corretto monitoraggio delle conversioni, il tag Overture deve essere inserito nella pagina di completamento delle transazioni. Se il tag viene aggiunto a un'altra pagina, il conteggio delle conversioni potrebbe fornire un valore superiore a quello reale. RICERCA CON OVERTURE VISUALIZZAZIONE PRODOTTO AGGIUNTA AL CARRELLO INIZIO VERIFICA INVIO DELL'ACQUISTO COMPLETAMENTO TRANSAZIONE CONVERSION COUNTER è in grado di collegare la Ricerca effettuata dal potenziale cliente con l'acquisto del prodotto (Conversione) 4
Istruzioni Generali relative all Aggiunta di Tag Il tag non provoca alcun impatto visibile sul sito Web, poiché non modifica in alcun modo l'aspetto e il design della pagina a cui viene aggiunto e non influisce sull'esperienza dell'utente. Tuttavia, il corretto posizionamento del tag è di fondamentale importanza per garantire l'accuratezza dei dati di conversione. Il tag Overture deve essere inserito nell'intestazione del documento HTML, tra i tag <HEAD> (che apre l'intestazione) e </HEAD> (che chiude l'intestazione). Esempio: Esempio di documento HTML di base (prima dell'aggiunta del tag) <html> <head> <title>file HTML di esempio</title> </head> <body> Contenuto della vostra pagina Web. </body> </html> Esempio di documento HTML di base a cui è il tag stato aggiunto applicando il metodo consigliato <html> <head> <title>file HTML di esempio</title> <SCRIPT LANGUAGE="JavaScript"> <!-- Overture Services Inc. 03/01/2003 var ov_tagversion = "1.0.0"; var ov_accountid = "XXXX"; var ov_querystr = "?" + "tv=" + ov_tagversion + "&ai=" + ov_accountid + "&rf=" + escape(document.referrer); var ov_convimage = new Image(); ov_convimage.src = "//oa.overture.com/conversion.gif" + ov_querystr; // --> </SCRIPT> </head> <body> Contenuto della vostra pagina Web. </body> </html> 5
Istruzioni Generali relative all Aggiunta di Tag ALCUNI SCENARI DI INSERIMENTO DEL TAG Per creare e gestire le pagine dei siti Web è possibile utilizzare varie tecnologie. Conversion Counter può funzionare correttamente in pagine di completamento delle transazioni generate in modo sia statico che dinamico, a condizione che il browser del visitatore ne esegua il rendering includendo il tag Overture. Aggiunta di tag a una pagina del processore di terze parti L'intero sito Web o una parte di esso potrebbe contenere un processore di terze parti, ad esempio Yahoo! Store o PayPal. Overture supporta l'aggiunta di tag anche in questi ambienti. Questa guida all'installazione fornisce esempi per i seguenti processori di terze parti: Yahoo! Store EBay / PayPal Aggiunta di tag a una pagina generata dinamicamente Quando si implementa il tag Overture in una pagina generata dinamicamente, questo dovrebbe essere inserito nel modello della pagina stessa. Tuttavia, se non è stato utilizzato alcun modello, il tag può essere aggiunto al codice HTML di una pagina statica. Per eseguire questa operazione, è possibile utilizzare un'istruzione include se il server Web consente tali istruzioni sul lato server o semplicemente distribuire il tag JavaScript nella sezione <HEAD> della pagina. Questa guida all'installazione fornisce esempi relativi ai seguenti strumenti: Microsoft Visual InterDev (ASP) ATG Dynamo (JSP) ColdFusion MX BEA WebLogic (JSP) Aggiunta di tag a una pagina contenente frame Se si utilizzano i frame, è consigliabile inserire il tag Overture solo nel codice HTML del frame che contiene la pagina di completamento delle transazioni. Pagine protette e non protette Il tag può essere utilizzato senza problemi all'interno di pagine sia protette (con protocollo URL https:) che non protette (con protocollo URL http:). Il tag è in grado di individuare il tipo di protocollo (https: o http:) e di adattarsi per funzionare in modo coerente con tutte le pagine, indipendentemente dal relativo livello di protezione. 6
Istruzioni Generali relative all Aggiunta di Tag PROCEDURA DI CONFERMA DEL POSIZIONAMENTO DEL TAG Per evitare errori o ritardi nel monitoraggio dei dati di conversione, Overture consiglia di verificare che il tag sia stato posizionato correttamente. Per eseguire questa operazione, applicate la seguente procedura: Passaggio 1 Completate una transazione, ad esempio l'acquisto di un prodotto o una registrazione, dal vostro sito Web (utilizzando, se possibile, un account di prova). Passaggio 2 Dopo aver aperto la pagina di completamento delle transazioni, selezionate Visualizza HTML dal menu del browser. L'esempio sottostante illustra la conferma del tag con un'istantanea della home page overture.com. È necessario visualizzare il codice HTML della pagina di conferma o di completamento delle transazioni. Passaggio 3 Controllare il codice sorgente HTML per verificare che il tag Overture si trovi in un punto della pagina compreso tra il tag <HEAD> di apertura e quello di chiusura </HEAD> dell'intestazione. 7
Istruzioni Generali relative all Aggiunta di Tag REQUISITI I soli requisiti richiesti al sito Web per l'installazione di Conversion Counter sono i seguenti: Supporto di HTML standard Inserimento del tag Overture nella pagina di completamento delle transazioni Non è previsto alcun requisito di sistema specifico per i visitatori. Per consentire alla tecnologia Conversion Counter di monitorare correttamente le conversioni derivate dai click-through della parola chiave, i clienti devono attivare nel browser sia la funzionalità per il download delle immagini che i cookie e javascript. Queste sono le impostazioni predefinite per la maggior parte dei browser Web. Nota: per domande sull'installazione di Conversion Counter la cui risposta non è disponibile nella presente guida e per ulteriori informazioni, visitate la sezione online delle Domande frequenti (FAQ) in DirectTraffic Center (DTC). 8
Istruzioni per l Istallazione in Yahoo! Store ISTRUZIONI PER L'INSTALLAZIONE IN YAHOO! STORE PANORAMICA Di seguito sono riportate le istruzioni di installazione di Conversion Counter per gli inserzionisti che utilizzano Yahoo! Store. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. ISTRUZIONI Passaggio 1 Copiate il tag Overture che vi è stato inviato tramite e-mail. Passaggio 2 Aprite una nuova finestra del browser e accedete alla vostra pagina Yahoo Store Manager. Passaggio 3 Fate click sul link Order Form presente nella sezione Order Settings. Passaggio 4 Scorrete fino alla sezione Order Confirmation, situata all'incirca ai 2/3 di questa stessa pagina verso il basso. Passaggio 5 Incollate il tag Overture nel campo Message della sezione Order Confirmation. Se il campo contiene un altro messaggio di testo, è possibile lasciarlo invariato e incollare il tag alla fine del messaggio stesso. Il messaggio continuerà a essere visibile per i clienti, mentre il tag per il monitoraggio delle conversioni nella pagina Order Confirmation risulterà invisibile. 9
Istruzioni per l Istallazione in EBay/PayPal ISTRUZIONI PER L'INSTALLAZIONE IN EBAY / PAYPAL PANORAMICA Di seguito sono riportate le istruzioni per installare i tag JavaScript di Conversion Counter quando la pagina di conversione corrisponde all'url Success relativo a un pulsante di acquisto di PayPal. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. Le operazioni necessarie sono le seguenti: 1) Definire un URL Successful Payment per il pulsante Buy It di PayPal 2) Installare i tag JavaScript di Conversion Counter forniti in questa pagina Successful Payment. ISTRUZIONI Definizione di un URL "Successful Payment" per un pulsante Buy It di PayPal Se per il pulsante Buy It di PayPal è già stato definito un URL Successful Payment, potete ignorare questo passaggio. Per definire un URL Successful Payment sono disponibili due opzioni: Opzione 1: utilizzo della funzionalità Button Factory di PayPal per creare un nuovo pulsante Buy It. a) Accedete al vostro account PayPal. b) Fate click sulla scheda Merchant Tools. c) Fate click sul link Buy Now Buttons nella sezione Website Payments. d) Compilate il modulo presente in questa prima pagina inserendovi i dati richiesti. e) Fate click sul pulsante Add More Options nella parte inferiore destra della pagina. f) Nella pagina successiva scorrete fino alla sezione Customize Your Buyer s Experience. g) In Successful Payment URL specificate l'url relativo alla vostra pagina dei ringraziamenti. h) Prendete nota dell'url definito come URL Successful Payment. i) Nella pagina Additional Options aggiungete tutte le opzioni che ritenete necessarie. j) Fate click sul pulsante Create Button Now. k) Nel campo a compilazione libera situato accanto a HTML Code for Websites, tagliate e incollate il codice HTML fornito da PayPal nella pagina, o nelle pagine, in cui desiderate posizionare un pulsante Buy It di PayPal. 10
Istruzioni per l Istallazione in EBay/PayPal A questo punto, sia il pulsante Buy It che l'url Successful Payment sono stati definiti. Fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag per installare i tag JavaScript di Conversion Counter nell'url Successful Payment. Opzione 2: modifica del codice HTML di un pulsante Buy It di PayPal esistente. a) Individuate le pagine in cui sono stati inseriti i pulsanti Buy It di PayPal. b) Isolate il codice relativo al pulsante Buy It di PayPal. Il codice inizia con: <form action="https://www.paypal.com/cgi-bin/webscr" method="post"> e termina con: </form> c) Inserite una riga nel modulo come riportato di seguito: <input type="hidden" name="return" value= http://foo/ thankyou.html > d) Accertatevi di sostituire l'url in grassetto sopra indicato con l'url che intendete utilizzare come pagina dei ringraziamenti. e) Inserite la riga di HTML specificata al passaggio c nel codice relativo al pulsante Buy It di PayPal in tutte le pagine in cui è stato definito questo pulsante. A questo punto, l'url Successful Payment per i pulsanti Buy It di PayPal è stato definito. Fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag per installare i tag JavaScript di Conversion Counter nell'url Successful Payment. Definizione di un URL "Successful Payment" per il carrello degli acquisti di PayPal Se per il carrello degli acquisti di PayPal è già stato definito un URL Successful Payment, potete ignorare questo passaggio. Per definire un URL Successful Payment per il carrello degli acquisti di PayPal sono disponibili due opzioni: Opzione 1: utilizzo della funzionalità Button Factory di PayPal per creare un nuovo pulsante Add to Cart. a) Accedete al vostro account PayPal. b) Fate click sulla scheda Merchant Tools. c) Fate click su PayPal Shopping Cart nella sezione Website Payments. d) Compilate il modulo presente in questa prima pagina inserendovi i dati richiesti (PayPal richiede la compilazione dei campi Item Name/Service e Price of Item/Service relativi al carrello degli acquisti prima di poter procedere al passaggio successivo). e) Fate click sul pulsante Add More Options nella parte inferiore destra della pagina. 11
Istruzioni per l Istallazione in EBay/PayPal f) Nella pagina successiva scorrete fino alla sezione Customize Your Buyer s Experience. g) In Successful Payment URL specificate l'url relativo alla vostra pagina dei ringraziamenti o di conferma dell'ordine. h) Prendete nota dell'url definito come URL Successful Payment. i) Aggiungete tutte le opzioni che ritenete necessarie. j) Fate click sul pulsante Create Button Now. k) Nel campo a compilazione libera situato accanto a HTML Code for Websites, tagliate e incollate il codice HTML fornito da PayPal nella pagina, o nelle pagine, in cui desiderate posizionare un pulsante Buy It di PayPal. A questo punto, sia il pulsante Add to Cart che l'url Successful Payment sono stati definiti. Fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag per installare i tag JavaScript di Conversion Counter nell'url Successful Payment. Opzione 2: modifica del codice HTML di un pulsante Add to Cart di PayPal esistente. a) Individuate le pagine in cui sono stati inseriti i pulsanti Add to Cart di PayPal. b) Isolate il codice relativo al pulsante Add to Cart di PayPal. Il codice inizia con: <form target= paypal action= https://www.paypal.com/cgi bin/webscr method="post"> e termina con: </form> c) Inserite una riga nel modulo come riportato di seguito: <input type="hidden" name="return" value= http://foo/ thankyou.html > d) Accertatevi di sostituire l'url in grassetto sopra indicato con l'url che intendete utilizzare come pagina dei ringraziamenti. e) Inserite la riga di HTML specificata al passaggio c nel codice relativo al pulsante Add to Cart di PayPal in tutte le pagine in cui è stato definito questo pulsante. A questo punto, l'url Successful Payment per i pulsanti Add to Cart di PayPal è stato definito. Fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag per installare i tag JavaScript di Conversion Counter nell'url Successful Payment. 12
Istruzioni per l Istallazione con Microsoft Visual InterDev (ASP) ISTRUZIONI PER L'INSTALLAZIONE CON MICROSOFT VISUAL INTERDEV (ASP) PANORAMICA Questa sezione si rivolge agli inserzionisti che hanno sviluppato il proprio sito o, più specificamente, la parte del sito relativa al processo di transazione, utilizzando il prodotto Visual InterDev o le pagine ASP di Microsoft. Visual InterDev consente agli inserzionisti di creare siti Web ricorrendo a strumenti sia statici (HTML) che dinamici (ASP). In genere, il processo di transazione (acquisto, iscrizione) coinvolge pagine ASP, o Active Server, generate dinamicamente durante le sessioni dei visitatori all'interno del sito Web. Queste istruzioni descrivono l'utilizzo delle pagine ASP per implementare il tag Overture in modo da attivare il conteggio delle conversioni. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. Nota: sebbene nel passaggio dalla versione 1.0 alla versione 6.0 l'ambiente di sviluppo integrato IDE (Integrated Development Environment) sia stato modificato, queste istruzioni rimangono valide in tutti i casi. ISTRUZIONI Passaggio 1 Aprite Visual InterDev e individuate la vostra pagina di completamento delle transazioni (ad esempio la pagina dei ringraziamenti o di conferma degli ordini). Se disponete di più pagine generate dalla stessa pagina ASP applicando le istruzioni IF..ELSE, accedete alla sezione utilizzata per generare la pagina di completamento delle transazioni. Passaggio 2 Individuate la sezione relativa all'intestazione del documento, contrassegnata dal tag di apertura <HEAD> e dal tag di chiusura </HEAD>. Passaggio 3 Sono disponibili due opzioni: Opzione 1: Tagliate il tag Overture e incollatelo direttamente nella sezione relativa all'intestazione del documento. Prestate attenzione a non incollare il tag Overture in una struttura di tag <> esistente. Per ulteriori informazioni, fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag. Opzione 2: In alternativa, potete scegliere di utilizzare un'istruzione #include sul lato server. Questa istruzione aggiungerà il tag Overture durante la fase di assemblaggio della pagina che dovrà essere visualizzata dal browser Web dei visitatori. Dopo aver ricevuto il tag Overture, salvate il file (conversion_counter.js) nel vostro server Web e ricordatene la posizione (nell'esempio sottostante, nella directory principale del sito Web è stata creata un'apposita cartella Overture ). A questo punto, tornate alla pagina di completamento delle transazioni e individuate la sezione relativa all'intestazione. In questa sezione inserite un'istruzione #include associata al file del tag Overture. 13
Istruzioni per l Istallazione con Microsoft Visual InterDev (ASP) Esempio <%@ Language=VBScript %> <head> <title>pagina Conferma acquisti</title> <!-- #include file=" /overture/conversion_counter.js" --> </head> <body bgcolor="#ffffff"> <h1>pagina Conferma acquisti</h1> </body> È importante sottolineare che l'istruzione include viene elaborata prima di qualsiasi altra parte della pagina ASP. Di conseguenza, il nome della posizione del file che si desidera inserire non può contenere alcuna variabile. Per ulteriori informazioni sull'utilizzo dell'istruzione #include, visitate il sito Web all'indirizzo: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/iisref/htm/includingfiles.asp Passaggio 4 Salvate la pagina di completamento delle transazioni modificata. È consigliabile eseguire un test del rendering della pagina, per verificare che il tag Overture sia stato posizionato e inserito nel punto corretto del documento ASP/HTML. Per effettuare la convalida, completate una transazione nel vostro sito Web in un ambiente di test/sviluppo. Una volta raggiunta la pagina di completamento delle transazioni, dal browser Web selezionate Visualizza HTML. Individuate il tag Overture nell'intestazione, tra il tag di apertura <HEAD> e il tag di chiusura </HEAD>. Se il tag si trova in questa posizione, l'installazione è stata completata in modo corretto. 14
Istruzioni per l Istallazione con ATG Dynamo (JSP) ISTRUZIONI PER L'INSTALLAZIONE CON ATG DYNAMO (JSP) PANORAMICA Questa sezione si rivolge agli inserzionisti che hanno sviluppato il proprio sito o, più specificamente, la parte del sito relativa al processo di transazione, utilizzando uno o più prodotti 6.0 Suite o pagine JSP (Java Server Pages) ATG. La principale interfaccia di programmazione di ATG utilizza JSP per lo sviluppo a livello di pagina. Le pagine JSP, o Java Server, vengono generate dinamicamente durante le sessioni dei visitatori all'interno del sito Web. Queste istruzioni descrivono l'utilizzo delle pagine JSP per implementare il tag Overture in modo da attivare il conteggio delle conversioni. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. Nota: JSP può essere gestito da Dynamo, BEA WebLogic, WebSphere IBM e altri moduli. Sebbene tra le implementazioni JSP di ogni ambiente esistano lievi differenze, queste istruzioni rimangono valide in tutti i casi. ISTRUZIONI Passaggio 1 Utilizzando l'editor JSP prescelto, individuate la vostra pagina di completamento delle transazioni (ad esempio la pagina di conferma degli acquisti, di conferma dell'iscrizione o dei ringraziamenti). Se disponete di più pagine generate dalla stessa pagina JSP applicando le istruzioni condizionali, accedete alla sezione utilizzata per generare la pagina di completamento delle transazioni. Passaggio 2 Individuate la sezione relativa all'intestazione del documento, contrassegnata dal tag di apertura <HEAD> e dal tag di chiusura </HEAD>. Passaggio 3 Sono disponibili due opzioni: Opzione 1: Tagliate il tag Overture e incollatelo direttamente nella sezione relativa all'intestazione del documento. Prestate attenzione a non incollare il tag Overture in una struttura di tag <> esistente. Per ulteriori informazioni, fate riferimento alla sezione Istruzioni generali relative all aggiunta di tag. Opzione 2: In alternativa, potete scegliere di utilizzare un'istruzione dsp:include sul lato server. Questa istruzione aggiungerà il tag Overture durante la fase di assemblaggio della pagina che dovrà essere visualizzata dal browser Web dei visitatori. Dopo aver ricevuto il tag Overture, salvate il file (conversion_counter.js) nel vostro server Web e ricordatene la posizione (nell'esempio sottostante, nella directory principale del sito Web è stata creata un'apposita cartella Overture ). A questo punto, tornate alla pagina di completamento delle transazioni e individuate la sezione relativa all'intestazione. In questa sezione inserite un'istruzione dsp:include associata al file del tag Overture. 15
Istruzioni per l Istallazione con ATG Dynamo (JSP) Se utilizzate l'ambiente di sviluppo ATG Dynamo, applicate la seguente procedura: 1. Spostate il cursore all'interno della pagina dell'intestazione 2. Fate click sul pulsante Insert Document presente sulla barra degli strumenti. Verrà visualizzata la finestra di dialogo Select a Document, che elenca tutti i file presenti nella directory principale del documento. 3. Selezionate il nome file del tag Overture appena salvato e fate click su OK. Esempio <%@ taglib uri="/dsptaglib" prefix="dsp" %> <dsp:page> <html> <head> <title>pagina Conferma acquisti</title> <dsp:include src="../overture/conversion_counter.js"/> </head> <body bgcolor="#ffffff"> <h1>pagina Conferma acquisti</h1> </body> </html> È importante sottolineare che l'istruzione include viene elaborata prima di qualsiasi altra parte della pagina JSP. Di conseguenza, il nome della posizione del file che si desidera inserire non può contenere alcuna variabile. Per ulteriori informazioni sulla codifica a livello di pagina con ATG, visitate il sito Web all'indirizzo: http://www.atg.com/repositories/contentcatalogrepository_en/manuals/atg6.0.0/pagedev/index.html Passaggio 4 Salvate la pagina di completamento delle transazioni modificata. È consigliabile eseguire un test del rendering della pagina, per verificare che il tag Overture sia stato posizionato e inserito nel punto corretto del documento JSP/HTML. Per effettuare la convalida, completate una transazione nel vostro sito Web in un ambiente di test/sviluppo. Una volta raggiunta la pagina di completamento delle transazioni, dal browser Web selezionate Visualizza HTML. Individuate il tag Overture nell'intestazione, tra il tag di apertura <HEAD> e il tag di chiusura </HEAD>. Se il tag si trova in questa posizione, l'installazione è stata completata in modo corretto. 16
Istruzioni per l Istallazione con ColdFusion MX ISTRUZIONI PER L'INSTALLAZIONE CON COLDFUSION MX PANORAMICA Questa sezione si rivolge agli inserzionisti che hanno sviluppato il proprio sito o, più specificamente, la parte del sito relativa al processo di transazione, utilizzando ColdFusion MX di MacroMedia. Le istruzioni in essa contenute vi guideranno nell'installazione del tag di Conversion Counter Overture nelle pagine ColdFusion. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. ISTRUZIONI Passaggio 1 Salvate il tag Overture nel server Web in una posizione conosciuta, di cui dovrete prendere nota insieme al nome file del tag. Overture suggerisce di assegnare al file il nome conversion_counter.js. Passaggio 2 Utilizzando l'ambiente di sviluppo ColdFusion o l'editor HTML prescelto, individuate la vostra pagina di completamento delle transazioni (ad esempio la pagina di conferma degli acquisti o dei ringraziamenti). Se disponete di più pagine generate dallo stesso modello ColdFusion applicando le istruzioni condizionali, accedete alla sezione utilizzata per generare la pagina di completamento delle transazioni. Passaggio 3 Individuate la sezione relativa all'intestazione del modello del documento, contrassegnata dal tag di apertura <HEAD> e dal tag di chiusura </HEAD>. Passaggio 4 Utilizzate un tag <cfinclude>. Questa istruzione aggiungerà il tag JavaScript di Conversion Counter Overture durante la fase di assemblaggio della pagina che dovrà essere visualizzata dal browser Web dei visitatori. Inserire un tag <cfinclude> associato al file del tag Overture. 17
Istruzioni per l Istallazione con ColdFusion MX Esempio in cui il tag Overture è stato salvato in una directory chiamata scripts e il nome file è conversion_counter.js <head> <title>page de confirmation d'achat</title> <cfinclude src="#request.app.root#/scripts/conversion_counter.js"/> </head> <body bgcolor="#ffffff"> <h1>pagina Conferma acquisti</h1> </body> È importante sottolineare che il tag cfinclude può essere utilizzato singolarmente o all'interno di una coppia di tag <cfoutput></cfoutput>. Per ulteriori informazioni sulla codifica a livello di pagina con ColdFusion MX, visitate il sito Web all'indirizzo: http://www.macromedia.com/support/coldfusion/documentation.html Passaggio 5 Salvate il modello o la pagina di completamento delle transazioni modificata. È consigliabile eseguire un test del rendering della pagina, per verificare che il tag Overture sia stato posizionato e inserito nel punto corretto del documento ColdFusion/HTML. Per effettuare la convalida, completate una transazione nel vostro sito Web in un ambiente di test/sviluppo. Una volta raggiunta la pagina di completamento delle transazioni, dal browser Web selezionate Visualizza HTML.Individuate il tag Overture nell'intestazione, tra il tag di apertura <HEAD> e il tag di chiusura </HEAD>. Se il tag si trova in questa posizione, l'installazione è stata completata in modo corretto. 18
Istruzioni per l Istallazione con BEA WebLogic (JSP) ISTRUZIONI PER L'INSTALLAZIONE CON BEA WEBLOGIC (JSP) PANORAMICA Questa sezione si rivolge agli inserzionisti che hanno sviluppato il proprio sito o, più specificamente, la parte del sito relativa al processo di transazione, utilizzando uno o più prodotti della piattaforma BEA WebLogic 7.0 o pagine JSP (Java Server Pages). La principale interfaccia di programmazione di BEA utilizza JSP per lo sviluppo a livello di pagina. Le pagine JSP, o Java Server, vengono generate dinamicamente durante le sessioni dei visitatori all'interno del sito Web. Queste istruzioni descrivono l'utilizzo delle pagine JSP per implementare il tag Overture in modo da attivare il conteggio delle conversioni. Leggete per intero le Istruzioni generali relative all aggiunta di tag presenti nella parte iniziale della guida prima di applicare la procedura dettagliata descritta in questa sezione. ISTRUZIONI Passaggio 1 Salvate il set di tag di script Overture e prendete nota del relativo percorso di memorizzazione. Overture suggerisce di assegnare al set di tag il nome conversion_counter.js. Passaggio 2 Utilizzando l'editor JSP prescelto, individuate la vostra pagina di completamento delle transazioni (ad esempio la pagina di conferma degli acquisti o dei ringraziamenti). Se disponete di più pagine generate dalla stessa pagina JSP applicando le istruzioni condizionali, accedete alla sezione utilizzata per generare la pagina di completamento delle transazioni. Passaggio 3 Individuate la sezione relativa all'intestazione del documento, contrassegnata dal tag di apertura <HEAD> e dal tag di chiusura </HEAD>. Passaggio 4 Utilizzate un'istruzione <jsp:include> sul lato server. Questa istruzione aggiungerà il tag Overture durante la fase di assemblaggio della pagina che dovrà essere visualizzata dal browser Web dei visitatori. In questa sezione inserite un'istruzione <jsp:include> associata al file del tag Overture. 19
Istruzioni per l Istallazione con BEA WebLogic (JSP) Esempio <html> <head> <title>pagina Conferma acquisti</title> <jsp:include page="/scripts/conversion_counter.js"/> </head> <body bgcolor="#ffffff"> È importante sottolineare che l'istruzione include viene elaborata prima di qualsiasi altra parte della pagina JSP. Di conseguenza, il nome della posizione del file che si desidera inserire non può contenere alcuna variabile. Accertatevi che il percorso di memorizzazione di tale file sia appropriato. Per ulteriori informazioni sulla codifica a livello di pagina con WebLogic, visitate il sito Web all'indirizzo: http://edocs.bea.com/wls/docs70/jsp/index.html Passaggio 5 Salvate la pagina di completamento delle transazioni modificata. È consigliabile eseguire un test del rendering della pagina, per verificare che il tag Overture sia stato posizionato e inserito nel punto corretto del documento JSP/HTML. Per effettuare la convalida, completate una transazione nel vostro sito Web in un ambiente di test/sviluppo. Una volta raggiunta la pagina di completamento delle transazioni, dal browser Web selezionate Visualizza HTML. Individuate il tag Overture nell'intestazione, tra il tag di apertura <HEAD> e il tag di chiusura </HEAD>. Se il tag si trova in questa posizione, l'installazione è stata completata in modo corretto. 20