Conversion Counter Asennusopas
Johdanto JOHDANTO TUOTTEEN KUVAUS Overturen Conversion Counter antaa tietoja Overture-tilisi toimivuudesta. Tämä tuote seuraa niiden maksettujen hakutermien kävijäkonversioprosentteja, jotka ovat ohjanneet kävijöitä sivustoosi ja johtaneet loppuun suoritettuun tapahtumaan, kuten tuotteen ostamiseen, sivustoon rekisteröitymiseen tai uutiskirjeen tilaamiseen. Conversion Counter sijoittaa jokaisen kävijän selaimeen evästeen aina, kun kävijä klikkaa maksamaasi hakulistausta. Kun kävijä siirtyy tapahtuman käsittelyn lopetussivulle, Overturen tunniste käynnistää muunto- eli konversiotapahtuman ja liittää evästeen lukemalla konversiotapahtuman kävijän viimeiseen hakulistauksen klikkaukseen. Tämä tieto näytetään DirecTraffic Centre (DTC) -järjestelmän tilitapahtuma- ja DTC-raporteissa. HUOMAUTUS: Conversion Counter Deluxe -käyttäjille: Jos Conversion Counter -tunniste on jo asennettu Conversion Counter -järjestelmään rekisteröitymisen yhteydessä, tunnistetta ei tarvitse asentaa uudelleen Conversion Counter Deluxe -järjestelmää varten. Conversion Counter Deluxe -tiedot alkavat näkyä DirecTraffic Centre -järjestelmässä 24 tunnin kuluessa. YLEISTÄ Konversioiden keräämiseksi Web-sivustosta on ensin asennettava useita koodirivejä, joista käytetään tässä asennusoppaassa nimitystä tunniste. Tässä asennusoppaassa käydään läpi yleiset tunnisteiden lisäysohjeet. Suosittelemme asennusohjeiden lukemista kokonaan ennen asennuksen aloittamista. Lisäksi tässä oppaassa annetaan erityisiä tunnisteiden lisäysohjeita, jotka koskevat kolmansien valmistajien tapahtumankäsittelijöitä sekä dynaamisten sivustojen työkaluja ja tekniikoita: Yahoo! Stores EBay / PayPal Active Server-sivut (Microsoft Visual InterDev) Java Server-sivut (ATG Dynamo, BEA WebLogic, ja ColdFusion MX) PHP: Hypertext Preprocessor Kun tunnisteiden lisääminen on suoritettu, Conversion Counter -raportit tulevat käyttöön 24 tunnin kuluessa ensimmäisestä Overture-tililtä tulleesta konversiosta. Tämä opas edellyttää HTML-kielen ja/tai Web-työkalujen tuntemusta Conversion Counter -tunnisteen asentamiseksi. Jos sinulla ei ole tarvittavaa asiantuntemusta, välitä tämä ohje Web-sivuston vastuuhenkilölle tai Web-kehittäjälle, jotka voivat auttaa tässä asiassa. 2
Johdanto MÄÄRITELMÄT Tunniste: Pieni HTML-koodi, joka lisätään Web-sivuston tapahtuman lopetussivulle. Tunnisteen lisäys: Overture-tunnisteen lisääminen tapahtuman lopetussivulle. Konversio: Tapahtuman (esimerkiksi oston tai rekisteröitymisen) lopettaminen siten, että asiakas siirtyy Overture-hakulistauksen kautta tapahtuman lopetussivulle. Tapahtuman lopetussivu: Web-sivuston sivu, jolla ilmoitetaan tapahtuman suorittamisesta loppuun (esimerkiksi kiitossivu). Tapahtumalla tarkoitetaan samaa asiaa kuin konversiolla. Se voi edustaa tuotteen ostamista, uutiskirjeen tilaamista, tilauksen kirjaamista tai muun asiakasehdokkuuteen johtavan toimenpiteen päättämistä. 3
Yleiset tunnisteiden lisäysohjeet YLEISET TUNNISTEIDEN LISÄYSOHJEET OVERTURE-TUNNISTE Overture-tunniste on pieni katkelma HTML-koodia, joka tunnetaan nimellä JavaScript. Kun JavaScript-koodi sijoitetaan Web-sivuston tapahtuman lopetussivulle tai -sivuille, asiakkaiden ohjautumisia Overturen maksettujen hakulistauksen kautta ja näistä seuranneita ostotapahtumia voidaan kerätä ja tarkastella raporteissa. Tässä vaiheessa olet luultavasti saanut oman Overture-tunnisteesi, joka on lähetetty Tervetuloasähköpostiviestin liitteenä. Lisäksi tunniste on pysyvästi tallennettu DirecTraffic Centre -työkalun Tilin asetukset (Account Set-Up) -sivulle. Tunniste on sijoitettava Web-sivustosi tapahtuman lopetussivulle. Tunnistetta ei saa muuttaa. Jos Overture-tunnistetta muutetaan, se ei toimi oikein. Seurauksena voi olla tietojen katoaminen tai virheellinen tiedonkeruu. Esimerkkitunniste: Esimerkkitunniste (Älä käytä!) <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> MINNE TUNNISTE SIJOITETAAN Jotta konversion seuranta onnistuisi, Overturen tunnistetekniikka on sijoitettava tapahtuman lopetussivulle. Jos tunniste sijoitetaan jollekin muulle sivulle, järjestelmän kirjaamat konversiomäärät voivat olla liian suuria. OVERTURE-HAKU TUOTTEEN KATSELU LISÄYS OSTOSKORIIN SIIRTYMINEN TILAUKSEEN TILAUKSEN VAHVISTUS OSTO SUORITETTU CONVERSION COUNTER mahdollistaa asiakkaan suorittaman haun yhdistämisen loppuun suoritettuun ostotapahtumaan (konversio). 4
Yleiset tunnisteiden lisäysohjeet Tunnisteella ei ole näkyvää vaikutusta Web-sivustoon eikä se muuta merkityn sivun ulkoasua, tyyliä tai käytettävyyttä millään tavoin. Tunniste on kuitenkin sijoitettava oikein, jotta konversiotiedot olisivat paikkansapitäviä. Overture-tunniste on sijoitettava HTML-asiakirjan otsikko-osaan, joka on <HEAD>- ja </HEAD>-tunnisteiden välissä. Esimerkki: Esimerkki tavallisesta HTML-asiakirjasta (ennen tunnisteen lisäämistä) <html> <head> <title>sample HTML File</title> </head> <body> This is the content of your web page. </body> </html> Esimerkki tavallisesta HTML-asiakirjasta, jossa on käytetty suositeltavaa tunnisteenlisäysmenetelmää <html> <head> <title>sample HTML File</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> This is the content of your web page. </body> </html> 5
Yleiset tunnisteiden lisäysohjeet ERILAISIA TUNNISTEENLISÄYSTILANTEITA Web-sivustoissasi voidaan käyttää Web-sivujen luontiin ja hallintaan useita tekniikoita. Conversion Counter toimii yhtä hyvin staattisella tai dynaamisesti muodostetulla tapahtuman lopetussivulla, jos kävijän selaimeen muodostuvassa sivussa vain on mukana Overturetunniste. Kolmannen osapuolen käsittelijän sivun merkitseminen tunnisteella Web-sivusto tai osa siitä saattaa sijaita kolmannen osapuolen käsittelijän, esimerkiksi Yahoo Storesin tai PayPalin, palvelimessa. Overture tukee tunnisteiden käyttöä näissä ympäristöissä. Tässä asennusoppaassa on esimerkkejä, jotka koskevat seuraavia kolmannen osapuolen käsittelijöitä: Yahoo! Stores EBay / PayPal Dynaamisesti muodostetun sivun merkitseminen tunnisteella Kun Overture-tunniste lisätään dynaamisesti muodostettuun sivuun, tunniste pitäisi sijoittaa sivun malliin. Jos mallia ei käytetä, tunniste on lisättävä staattisen sivun HTML-koodiin. Tämä voidaan tehdä käyttämällä include-lausetta, jos Web-palvelin tukee SSI (Server side include) -tiedostoja, tai sijoittamalla JavaScript-koodi sivun <HEAD>-osaan. Tässä asennusoppaassa on esimerkkejä, jotka koskevat seuraavia työkaluja ja tekniikoita: Active Server-sivut (Microsoft Visual InterDev) Java Server-sivut (ATG Dynamo, BEA WebLogic ja ColdFusion MX) PHP: Hypertext Preprocessor Kehyksiä sisältävän sivun merkitseminen tunnisteella Kehyksiä käytettäessä on suositeltavinta sijoittaa Overture-tunniste vain tapahtuman lopetussivun sisältävän kehyksen HTML-koodiin. Client-Side Include -lauseiden käyttäminen JavaScript-kielessä Jos Overture-tunniste sijoitetaan tapahtuman lopetussivulle JavaScriptin includelauseen avulla, on tärkeää poistaa Overture-tunnisteen alussa ja lopussa olevat <SCRIPT>-tunnisteet ennen sen tallentamista tiedostoon. Jos näin ei menetellä JavaScriptin include-lausetta käytettäessä, Overture-tunniste ei toimi oikein. Lisäksi on syytä varmistaa, että Overture-tunnisteen tiedostopolku on oikea. Muussa tapauksessa sisällyttäminen ei onnistu. Esimerkki: <script language= javascript src= conversion_counter.js ></script> Suojatut ja suojaamattomat sivut Tunnistetta voidaan käyttää sekä suojatuilla (URL-protokolla on https:) että suojaamattomilla (URL-protokolla on http:) sivuilla. Tunniste havaitsee käytetyn protokollan (https: tai http:) ja toimii oikein kaikilla sivuilla suojaustasosta riippumatta. 6
Yleiset tunnisteiden lisäysohjeet TUNNISTEEN SIJOITUKSEN VARMISTAMINEN Jotta konversiotietojen seurannassa ei esiintyisi virheitä tai viiveitä, Overture suosittelee, että varmistat tunnisteen sijoituspaikan. Voit tehdä sen suorittamalla seuraavat vaiheet: Vaihe 1 Suorita omassa sivustossasi tapahtuma, kuten tuotteen ostaminen tai rekisteröityminen (voit käyttää tähän testitiliä, jos sellainen on käytettävissä). Vaihe 2 Kun olet tapahtuman lopetussivulla, valitse selaimesi valikosta Näytä Lähdekoodi" (View Source). Tässä ohjeessa on käytetty esimerkkinä overture.com-kotisivun näyttökuvaa (katso alla oleva esimerkki). Sinun on valittava oman sivustosi tapahtuman lopetus- tai vahvistussivu. 7
Yleiset tunnisteiden lisäysohjeet Vaihe 3 Varmista HTML-lähdekoodista, että Overture-tunniste on sivulla jossakin <HEAD>-ja </HEAD>-tunnisteiden välissä. VAATIMUKSET Conversion Counterin asentaminen asettaa Web-sivustolle ainoastaan seuraavat vaatimukset: HTML-vakiokoodin tuki Overture-tunnisteen lisääminen tapahtuman lopetussivulle. Asiakkaita koskevia erityisiä järjestelmävaatimuksia ei ole. Jotta Conversion Counter -järjestelmä voisi seurata hakutermien klikkauksista seuranneita konversioita, seuraavien ominaisuuksien tulee olla käytössä asiakkaiden selaimissa: kuvien näyttäminen, JavaScript ja evästeet. Nämä ovat käytössä oletusarvoisesti useimmissa Web-selaimissa. Huom.: Jos sinulla on Conversion Counter -järjestelmän asentamista koskevia kysymyksiä, joita ei ole käsitelty tässä ohjeessa, saat lisätietoja DirecTrafficCentre (DTC) -järjestelmän Usein kysytyt kysymykset -osasta. 8
Yahoo! Store -asennusohje YAHOO! STORE -ASENNUSOHJE YLEISTÄ Seuraavassa on Conversion Counter -järjestelmän asennusohje mainostajille, jotka käyttävät Yahoo! Stores -järjestelmää. Varmista, että olet lukenut tämän oppaan alussa olevat yleiset tunnisteiden lisäysohjeet, ennen kuin noudatat tässä osassa olevia vaiheittaisia ohjeita. OHJEET Vaihe 1 Kopioi sähköpostitse saamasi Overture-tunniste. Vaihe 2 Avaa uusi selainikkuna ja siirry Yahoo Store Manager -sivullesi. Vaihe 3 Valitse Order Settings (Tilausasetukset) -osan Order Form (Tilauslomake) -linkki. Vaihe 4 Siirry sivulla alaspäin Order Confirmation (Tilausvahvistus) -osaan (noin 2/3 sivun alareunaan päin). Vaihe 5 Liitä Overture-tunnisteesi Order Confirmation -osan Message (Viesti) -kenttään. Jos tässä kentässä on jo tekstiviesti, voit jättää sen ennalleen ja liittää tunnisteen tekstiviestin alapuolelle. Asiakkaat näkevät edelleen viestin, mutta konversioiden seurantaan käytettävä tunniste ei ole näkyvissä Order Confirmation -sivulla. 9
EBay / PayPal -asennusohje EBAY / PAYPAL -ASENNUSOHJE YLEISTÄ Seuraavassa ohjeessa käsitellään Conversion Counterin JavaScript-koodin lisäämistä, kun konversiosivu on PayPal-ostopainikkeen Success (Onnistui) -URL-osoite. Varmista, että olet lukenut tämän oppaan alussa olevat yleiset tunnisteiden lisäysohjeet, ennen kuin noudatat tässä osassa olevia vaiheittaisia ohjeita. Seuraavassa on yhteenveto tarvittavista toimenpiteistä: 1) Määritä PayPal-järjestelmän Buy It (Osta) -painikkeelle Successful Payment (Maksu onnistui) -URL-osoite. 2) Asenna Conversion Counter -järjestelmän JavaScript-koodi määrittämällesi Successful Payment -sivulle. OHJEET: Successful Payment -URL-osoitteen määrittäminen PayPal-järjestelmän Buy It -painikkeelle Voit sivuuttaa tämän vaiheen, jos olet jo määrittänyt PayPal-järjestelmän Buy It -painikkeelle Successful Payment -URL-osoitteen. Successful Payment -URL-osoitteen voi määrittää kahdella vaihtoehtoisella tavalla: Vaihtoehto 1: Uuden Buy It -painikkeen luominen PayPal-järjestelmän Button Factory -toiminnolla. a) Kirjaudu PayPal-tilillesi. b) Valitse Merchant Tools -välilehti. c) Valitse Website Payments -osasta Buy Now Buttons Link. d) Kirjoita ensimmäisellä sivulla olevalle lomakkeelle asianmukaiset tiedot. e) Klikkaa sivun oikeassa alakulmassa olevaa Add More Options -painiketta. f) Siirry seuraavalla sivulla Customize Your Buyer s Experience -osaan. g) Kirjoita Successful Payment URL -kohtaan oman kiitossivusi osoite. h) Merkitse muistiin Successful Payment URL -kohdassa oleva URL-osoite. i) Määritä muut Additional Options -sivun asetukset haluamallasi tavalla. j) Klikkaa Create Button Now -painiketta. k) Kopioi HTML Code for Websites -kohdan vieressä olevan tekstikentän sisältö ja liitä se sivuille, joille haluat sijoittaa PayPal-järjestelmän Buy It (Osta) -painikkeen. Buy It -painike ja Successful Payment URL -osoite on nyt määritetty. Asenna Conversion Counter -järjestelmän JavaScript-koodi Successful Payment URL -kohdassa määritetylle sivulle kohdassa Yleiset tunnisteiden lisäysohjeet annettujen ohjeiden mukaisesti. 10
EBay / PayPal -asennusohje Vaihtoehto 2: PayPal-järjestelmässä valmiiksi määritetyn Buy It -painikkeen HTML-koodin muokkaaminen. a) Etsi sivut, joille olet asentanut PayPal-järjestelmän Buy It -painikkeita. b) Etsi PayPal-järjestelmän Buy It -painikkeen koodi. Koodi alkaa seuraavasti: <form action="https://www.paypal.com/cgi-bin/webscr" method="post"> ja päättyy seuraavasti: </form> c) Lisää lomakkeeseen seuraavanlainen rivi: <input type="hidden" name="return" value= http://foo/ thankyou.html > d) Korvaa yllä oleva lihavoitu URL-osoite sillä URL-osoitteella, jota käytät kiitossivunasi. e) Lisää vaiheen c HTML-rivi PayPal-järjestelmän Buy It -painikkeen koodiin kaikille sivuille, joille olet määrittänyt PayPal-järjestelmän Buy It -painikkeen. Nyt PayPal-järjestelmän Buy It -painikkeisiin on määritetty Successful Payment URL -osoite. Asenna seuraavaksi Conversion Counter -järjestelmän JavaScript-koodi Successful Payment URL -osoitteessa määritetylle sivulle kohdassa Yleiset tunnisteiden lisäysohjeet annettujen ohjeiden mukaisesti. Successful Payment -URL-osoitteen määrittäminen PayPal-ostoskorille Voit sivuuttaa tämän vaiheen, jos olet jo määrittänyt PayPal-järjestelmän ostoskorille Successful Payment -URL-osoitteen. Successful Payment -URL-osoitteen voi lisätä PayPal-ostoskoriin kahdella eri tavalla: Vaihtoehto 1: Uuden Add to Cart (Lisää koriin) -painikkeen luominen PayPal-järjestelmän Button Factory -toiminnolla. a) Kirjaudu PayPal-tilillesi. b) Valitse Merchant Tools -välilehti. c) Valitse Website Payments -osasta PayPal Shopping Cart. d) Kirjoita ensimmäisen sivun lomakkeeseen tarvittavat tiedot (PayPal edellyttää, että Item Name/Service- ja Price of Item/Service -kentät on täytetty, ennen kuin voit jatkaa seuraavaan vaiheeseen). e) Klikkaa sivun oikeassa alakulmassa olevaa Add More Options -painiketta. f) Siirry toisella sivulla Customize Your Buyer s Experience -osaan. g) Kirjoita Successful Payment URL -kohtaan oman kiitossivusi tai tilausvahvistussivusi osoite. h) Merkitse muistiin Successful Payment URL -kohdassa oleva URL-osoite. i) Määritä muut sivun asetukset haluamallasi tavalla. j) Klikkaa Create Button Now -painiketta. k) Kopioi HTML Code for Websites -kohdan vieressä olevan tekstikentän sisältö ja liitä se sivuille, joille haluat sijoittaa PayPal-järjestelmän Buy It (Osta) -painikkeen. 11
EBay / PayPal -asennusohje Add to Cart -painike ja Successful Payment URL -osoite on nyt määritetty. Asenna seuraavaksi Conversion Counter -järjestelmän JavaScript-koodi Successful Payment URL -osoitteessa määritetylle sivulle kohdassa Yleiset tunnisteiden lisäysohjeet annettujen ohjeiden mukaisesti. Vaihtoehto 2: PayPal-järjestelmässä valmiiksi määritetyn Add to Cart -painikkeen HTMLkoodin muokkaaminen. a) Etsi sivut, joille olet asentanut PayPal-järjestelmän Buy It -painikkeita. b) Etsi PayPal-järjestelmän Buy It -painikkeen koodi. Koodi alkaa seuraavasti: <form target= paypal action= https://www.paypal.com/cgi bin/webscr method="post"> ja päättyy seuraavasti: </form> c) Lisää lomakkeeseen seuraavanlainen rivi: <input type="hidden" name="return" value= http://foo/ thankyou.html > d) Korvaa yllä oleva lihavoitu URL-osoite sillä URL-osoitteella, jota käytät kiitossivunasi. e) Lisää vaiheen c HTML-rivi PayPal-järjestelmän Add to Cart -painikkeen koodiin kaikille sivuille, joille olet määrittänyt PayPal -järjestelmän Add to Cart -painikkeen. Nyt PayPal-järjestelmän Add to Cart -painikkeisiin on määritetty Successful Payment URL - osoite. Asenna Conversion Counter -järjestelmän JavaScript-koodi Successful Payment URL -kohdassa määritetylle sivulle kohdassa Yleiset tunnisteiden lisäysohjeet annettujen ohjeiden mukaisesti. 12
Active Server Page (ASP) -asennusohje ACTIVE SERVER PAGE (ASP) -ASENNUSOHJE YLEISTÄ Tämä osa on tarkoitettu mainostajille, jotka ovat kehittäneet sivustonsa tai tarkemmin sanottuna sivustonsa tapahtumienkäsittelyosan käyttäen Microsoftin Visual InterDev -tuotetta tai ASP:tä. Visual InterDev -ympäristössä sivustoja voi luoda joko staattisesti (HTML) tai dynaamisesti (ASP). Yleensä tapahtumankäsittelyprosessi (osto tai kirjautuminen) on toteutettu ASP:llä tai aktiivisilla palvelinsivuilla, jotka muodostetaan dynaamisesti sivustolla kävijän istunnon aikana. Nämä ohjeet keskittyvät konversioiden laskentaan tarvittavan Overture-tunnisteen lisäämiseen ASP:n avulla. Varmista, että olet lukenut tämän oppaan alussa olevat Yleiset tunnisteiden lisäysohjeet, ennen kuin noudatat tässä osassa olevia vaiheittaisia ohjeita. Huomautus: Vaikka kehitysympäristö on muuttunut versiosta 1.0 versioon 6.0, nämä ohjeet toimivat kaikissa versioissa. OHJEET Vaihe 1 Avaa Visual InterDev ja etsi tapahtuman lopetussivu (esimerkiksi ostonvahvistus- tai kiitossivu). Jos samasta ASP-sivusta muodostetaan useita sivuja (IF ELSE -rakenteilla), siirry osaan, jossa muodostetaan tapahtuman lopetussivu. Vaihe 2 Etsi sivun otsikko-osa (tunnisteiden <HEAD> ja </HEAD> välissä). Vaihe 3 Voit menetellä kahdella eri tavalla: Vaihtoehto 1: Leikkaa ja liitä Overture-tunniste suoraan asiakirjan otsikko-osaan. Varo liittämästä tunnistetta siellä ennestään olevaan tunnisteen <>-rakenteeseen. Lisätietoja on kohdassa Yleiset tunnisteiden lisäysohjeet. Vaihtoehto 2: Voit käyttää myös palvelimen #include-lausetta. Tämä include-lause lisää Overture-tunnisteen siinä vaiheessa, kun sivua muodostetaan kävijän selaimeen toimitettavaksi. Saatuasi Overture-tunnisteen tallenna tiedosto (conversion_counter.js) Web-palvelimeesi ja merkitse sen sijainti muistiin (alla olevassa esimerkissä luotiin Websivuston juurihakemistoon Overture-niminen alihakemisto). Siirry takaisin tapahtuman lopetussivulle ja etsi otsikko-osa. Lisää otsikko-osaan #include-lause, joka osoittaa Overture-tunnistetiedostoon. 13
Active Server Page (ASP) -asennusohje Esimerkki <%@ Language=VBScript %> <head> <title>page de confirmation d'achat</title> <!-- #include file=" /overture/conversion_counter.js" --> </head> <body bgcolor="#ffffff"> <h1>page de confirmation d'achat</h1> </body> Huomaa, että include-lause käsitellään ennen kaikkia muita ASP-sivun osia. Tämä tarkoittaa, että lisättävän tiedoston sijaintia ilmoitettaessa ei voi käyttää muuttujia. Lisätietoja #include-lauseen käytöstä on seuraavassa linkissä: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/iisref/htm/includingfiles.asp Vaihe 4 Tallenna muokkaamasi tapahtuman lopetussivu. Sivun muodostumista kannattaa testata sen varmistamiseksi, että Overturen tunniste sijaitsee oikeassa paikassa ASP/HTML-asiakirjassa. Voit suorittaa tarkistuksen suorittamalla tapahtuman loppuun Web-sivustossasi testaus- tai kehitysympäristössä. Kun näkyviin tulee tapahtuman lopetussivu, valitse Web-selaimesta Näytä Lähdekoodi" (View Source). Tarkista, että Overture-tunniste on <HEAD>- ja </HEAD>-tunnisteiden välisessä osassa. Jos tunniste on siellä, asennus on suoritettu oikein. 14
Java Server Page (JSP) -asennusohje JAVA SERVER PAGE (JSP) -ASENNUSOHJE YLEISTÄ Tämä osa on tarkoitettu mainostajille, jotka ovat kehittäneet sivustonsa tai tarkemmin sanottuna sivustonsa tapahtumienkäsittelyosan käyttäen JSP-työkalua, esimerkiksi jotakin seuraavista: ATG Dynamo BEA WebLogic ColdFusion MX Java-palvelinsivut (JSP:t) muodostetaan dynaamisesti kävijän istunnon aikana. Nämä ohjeet keskittyvät konversioiden laskentaan tarvittavan Overture-tunnisteen lisäämiseen JSP:n avulla. Varmista, että olet lukenut tämän oppaan alussa olevat Yleiset tunnisteiden lisäysohjeet, ennen kuin noudatat tässä osassa olevia vaiheittaisia ohjeita. Huomautus: Vaikka JSP-koodin syntaksi voi vaihdella eri ympäristöissä, nämä ohjeet ovat voimassa kaikissa tapauksissa. OHJEET Vaihe 1 Etsi tapahtuman lopetussivu (esimerkiksi ostonvahvistus-, kirjautumisen vahvistus- tai kiitossivu) käyttäen haluamaasi JSP-editoria. Jos samasta JSP-sivusta muodostetaan useita sivuja (ehtolauseita käyttäen), siirry osaan, jossa muodostetaan tapahtuman lopetussivu. Vaihe 2 Etsi sivun otsikko-osa (tunnisteiden <HEAD> ja </HEAD> välissä). Vaihe 3 Voit menetellä kahdella eri tavalla: Vaihtoehto 1: Leikkaa ja liitä Overture-tunniste suoraan asiakirjan otsikko-osaan. Varo liittämästä tunnistetta siellä ennestään olevaan tunnisteen <>-rakenteeseen. Lisätietoja on kohdassa Yleiset tunnisteiden lisäysohjeet. Vaihtoehto 2: Voit käyttää myös palvelimen include-lausetta. Tämä include-lause lisää Overture-tunnisteen siinä vaiheessa, kun sivua muodostetaan kävijän selaimeen toimitettavaksi. Saatuasi Overture-tunnisteen tallenna tiedosto (conversion_counter.js) Web-palvelimeesi ja merkitse sen sijainti muistiin (alla olevassa esimerkissä luotiin Web-sivuston juurihakemistoon Overture-niminen alihakemisto). Siirry takaisin tapahtuman lopetussivulle ja etsi otsikko-osa. Lisää otsikko-osaan include-lause, joka osoittaa Overture-tunnistetiedostoon. 15
Java Server Page (JSP) -asennusohje Jos käytät ATG Dynamo -kehitysympäristöä, suorita seuraavat vaiheet: 1. Siirrä kohdistin sivun otsikko-osaan. 2. Klikkaa työkalurivin Insert Document (Lisää asiakirja) -painiketta. Näyttöön tulee asiakirjan valintaikkuna, jossa näkyvät kaikki asiakirjan juurihakemistossa olevat tiedostot. 3. Valitse tallentamasi Overture-tunnisteen tiedostonimi ja klikkaa OK. Esimerkki (ATG Dynamo -ympäristössä) <%@ taglib uri="/dsptaglib" prefix="dsp" %> <dsp:page> <html> <head> <title>purchase Confirmation Page</title> <dsp:include src="../overture/conversion_counter.js"/> </head> <body bgcolor="#ffffff"> <h1>purchase Confirmation Page</h1> </body> </html> Huomaa, että include-lause käsitellään ennen kaikkia muita JSP-sivun osia. Tämä tarkoittaa, että lisättävän tiedoston sijaintia ilmoitettaessa ei voi käyttää muuttujia. Syntaksin muunnelmat: ATG Dynamo: Dynamo-ympäristön include-lauseen syntaksi on seuraava: <dsp:include src =»»>. Yllä oleva esimerkki on koodattu ATG Dynamo -ympäristössä. Lisätietoa sivutason koodauksesta ATG:ssä on seuraavassa linkissä: http://www.atg.com/repositories/contentcatalogrepository_en/manuals/atg6.0.0/pagedev/index.html BEA Weblogic: Weblogic-ympäristön include-lauseen syntaksi on seuraava: <jsp:include src =»»>. Lisätietoa sivutason koodauksesta Weblogic-ympäristössä on seuraavassa linkissä: <http://edocs.bea.com/wls/docs70/jsp/index.html> Coldfusion MX: ColdFusion-ympäristön include-lauseen syntaksi on seuraava: <cfinclude src =»»>. Lisätietoa sivutason koodauksesta ColdFusion MX - ympäristössä on seuraavassa linkissä: <http://www.macromedia.com/support/coldfusion/documentation.html> 16
Java Server Page (JSP) -asennusohje Vaihe 4 Tallenna muokkaamasi tapahtuman lopetussivu. Sivun muodostumista kannattaa testata sen varmistamiseksi, että Overturen tunniste sijaitsee oikeassa paikassa JSP/HTML-asiakirjassa. Voit suorittaa tarkistuksen suorittamalla tapahtuman loppuun Web-sivustossasi testaus- tai kehitysympäristössä. Kun näkyviin tulee tapahtuman lopetussivu, valitse Web-selaimesta Näytä Lähdekoodi" (View Source). Tarkista, että Overture-tunniste on <HEAD>-ja </HEAD>-tunnisteiden välisessä osassa. Jos tunniste on siellä, asennus on suoritettu oikein. 17
Hypertext Preprocessor (PHP) -asennusohje HYPERTEXT PREPROCESSOR (PHP) -ASENNUSOHJE YLEISTÄ Tässä osassa kerrotaan, miten tunniste voidaan lisätä vahvistus- tai kiitossivulle PHP:n avulla. Kirjautumisvaiheessa saatu (tai DTC:stä noudettu) JavaScript-koodi on tallennettava Web-palvelimeen tiedostoksi ja HTML-koodin <HEAD>-osaan on lisättävä jonkin verran PHP-koodia. OHJEET Vaihe 1 Tallenna saamasi JavaScipt-koodi tiedostoksi. Tässä esimerkissä tiedoston nimi on overture_cc.js. Vaihe 2 Sijoita tiedosto Web-palvelimeen haluamaasi hakemistoon, esimerkiksi polkuun /javascript/overture_cc.js. Vaihe 3 Lisää vahvistus- tai kiitossivulle seuraava PHP-koodi: Tärkeää <?PHP $filename = javascript/overture_cc.js ; $fp = fopen($filename, r ); if ($fp) { $js = fread($fp,filesize($filename)); echo($js); fclose($fp); } <?> Yllä olevan koodin filename-muuttujaan sijoitettava arvo määräytyy kolmesta tekijästä: 1. Overturen toimittamalle JavaScript-kooditiedostolle antamastasi nimestä 2. Overturen toimittaman JavaScript-kooditiedoston sijoituspaikasta 3. JavaScript-tiedoston sijainnista suhteessa vahvistus- tai kiitossivun mallin sijaintiin. Kuten yllä olevasta esimerkistä näkyy, tässä tapauksessa hakemistossa, jossa vahvistustai kiitossivu sijaitsee, on alihakemisto javascript, joka puolestaan sisältää tiedoston overture_cc.js. Kysy neuvoa Web-sivuston vastuuhenkilöltä, jos et ole varma tämän menetelmän toteutustavasta. Lisätietoa PHP-koodauksen periaatteista on seuraavassa linkissä: <http://www.php.net> 18