Google Analytics Tracking for VirtueMart Google Analytics For Joomla! administrators version 1.0 Monday, October 1, 2007 User Manual for Google Analytics Tracking for VirtueMart Estime Oy 1 Table Of Contents 1 Introduction..................................................................................................................................................................2 2 Requirements...............................................................................................................................................................2 2.1 Software requirements.............................................................................................................................................................2 2.2 Other knowledge ......................................................................................................................................................................2 3 Installing the module...................................................................................................................................................3 4 Uninstalling the module..............................................................................................................................................3 5 Joomla! settings and template edits ........................................................................................................................4 5.1 Check, that you have position called debug in Joomla CMS.................................................................................................4 5.2 Make changes to your template file.........................................................................................................................................5 6 Configuring the module..............................................................................................................................................7 7 Configuring Google Analytics profile for VirtueMart tracking..............................................................................9 7.1 Changes to profile settings ......................................................................................................................................................9 7.2 Make a goal ............................................................................................................................................................................10 8 Configuring Google Analytics profile to have a goal for registered users in Joomla! ...................................11 9 About goals and funnels ..........................................................................................................................................11 10 FAQ............................................................................................................................................................................12 11 Links..........................................................................................................................................................................13 User Manual for Google Analytics Tracking for VirtueMart Estime Oy 2 1 Introduction Google Analytics is one of the world's leading visitor tracking systems and it is free of charge. Google Analytics offers uniform service for companies both large and small. Google Analytics gathers information about the users of your website and their actions. With Google Analytics you can find out how your visitors found your website and how they interacted with it. Google Analytics is a product of Google Inc. More information about Google Analytics is available at: http://www.google.com/analytics/en-GB/support_overview.html. Google Analytics Tracking for Virtuemart is a Joomla module created by Estime Oy, which makes it possible to collect Virtuemart merchant information in order to analyze the data with Google Analytics software. This guide is an installation tutorial for installing the Google Analytics Tracking for Virtuemart module for Joomla cms. Please note, that Estime Oy is not responsible for Google Analytics and therefore Estime Oy does not give free support for using Google Analytics. Please refer Google Analytics support site, if you experience problems with Google Analytics. If you have problems with installing and configuring our module, read our fag?s or visit our forum at http://www.estimtemplates.com. We don?t give support for using Joomla administration or Virtuemart component in general. If you need help with your Joomla, please use the official Joomla forum. 2 Requirements 2.1 Software requirements In order to start collecting information with our module, you will need: ? Joomla cms 1.0.X installed ? Virtuemart 1.0.10 installed, (if you want to track e-commerce) ? Google Analytics account created 2.2 Other knowledge ? You know, what is a Joomla. You probably are an administrator and you know, what is a module. You have the ability to install and uninstall modules in your Joomla. ? You know, what is Virtuemart and you have used Virtuemart. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 3 ? You have created a Google Analytics account and you know the basics of Google Analytics. 3 Installing the module 1. Download the module zip file from Joomla! extensions or from our site. 2. Unzip the zip file. You will have two files, installation guide and Joomla! installation zip file. 3. Login to you Joomla! admin panel. 4. Choose Installers » Modules. 5. Click Browse and find the Joomla! installation zip file you just downloaded. Press Upload File & Install. 6. If the installation was successful, you?ll see the following information. Image 1. Upload Module Successful Note! If you already have Google Analytics tracking code in your Joomla! cms as a script in a template file or another module or even mambot (plugin), make sure, that you set it unpublished. You can?t have two tracking codes fro one site. 4 Uninstalling the module 1. Login to your Joomla! admin panel. 2. Choose Installers » Modules. 3. Find Google Analytics Tracking for Virtue Mart in the list below and check it. 4. Press Uninstall button on the top of the page. 5. You have uninstalled the module. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 4 Image 2. Uninstalling the module 5 Joomla! settings and template edits 5.1 Check, that you have position called debug in Joomla CMS. 1. Login to your Joomla! admin panel. 2. Choose Site » Template Manager » Module positions. 3. New page will open and you will have a list of the module positions available in your Joomla!. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 5 Image 3. Debug position in the module positions list. 4. Check, that you have position called debug. If you don?t add it by typing debug in the next free field and press Save from the bottom of the page. Otherwise press Cancel. 5.2 Make changes to your template file 1. Choose Site » Template Manager » Site templates. 2. Choose your current template in use from the list and press Edit HTML button from the top of the page. 3. Find you r <body> tag in the template. 4. Change the code from: <body> to: <?php if ($option == 'com_virtuemart' && $page == 'checkout.thankyou') { ?> <body onLoad="javascript:__utmSetTrans()"> <?php }else{ ?> <body> <?php } ?> User Manual for Google Analytics Tracking for VirtueMart Estime Oy 6 Image 4. Template edit 5. Roll down the template source. Find your closing body tag </body>. 6. If you don?t have the following line in the source html, add it. <?php mosLoadModules( 'debug', -1 );?> User Manual for Google Analytics Tracking for VirtueMart Estime Oy 7 Image 5. Module position debug inside template 7. Press Save button from the top of the page. 6 Configuring the module 1. Choose Modules Site » Modules. 2. Find module called Google Analytics Tracking Module in the module list. Click the module name or click the checkbox and press edit button from the top of the page. Image 6. Google Analytics Tracking Module in the list. 3. Fill in the information as typed in the figure below. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 8 Image 7. Configuring the module ? Title use default or change if you like. ? Show title select No ? Position choose position, debug is the recommended position. ? Module Order use default ? Access Level choose Public ? Published select Yes ? Analytics _uacct code Type the code you received from Google. ? Analytics _udn site Type, if you have different domains. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 9 ? Module published? Choose Yes. ? https Choose Yes, if your site uses https partly or through the whole site, otherwise choose No. ? Tracking Choose Yes, if you want to track Joomla users. ? VM Choose Yes, if you want to enable VirtueMart tracking. ? Regis Choose Yes, if you want to set up a goal to track, how many registered users you have achieved. ? affiliation If you have one, type your shop name, otherwise default name will be used. ? Pages Choose All, if you want to collect information through your site. This is recommended setting. If you only want to collect data from specific sites, choose those sites. 4. Press Save. 5. The module is ready to collect information. Remember to check with Google panel, that your Analytics is collecting data. Note, that it will take time (24-48 hours), when data is available. Refer to Google Analytics site for more information. 7 Configuring Google Analytics profile for VirtueMart tracking You need to enable E-Commerce Tracking and set up a goal for your website's profile. To do so, follow the steps below. 7.1 Changes to profile settings 1. Log in to your account. 2. Click Edit next to the profile that you would like to enable. 3. On the Profile Settings page, click edit next to Main Website Profile Information. 4. Change the E-Commerce Website radio button from No to Yes. 5. Save changes. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 10 7.2 Make a goal 1. Log in to your Google Analytics account and click Analytics Settings 2. Find the profile for which you will be creating goals and click Edit 3. Select one of the four goal slots available for that profile and click Edit 4. Enter the Goal URL. Specify a page that can only be reached by achieving a goal. For VirtueMart e-commerce transactions with Estime Google Analytics tracking module, the url is usually: http://www.yousite.com/funnel_G1/checkout.thankyou.htm. 5. Enter the Goal name. Specify a name that you will recognise when viewing reports. 6. Turn the goal On in order to track this conversion goal. 7. Enter the URL of the first page of your conversion funnel. This page should be common to all users working their way towards your Goal. You can leave it empty and fill in later on. 8. Enter a Name for this step. If this step is a Required step in the conversion process, select the checkbox to the right of the step. If this checkbox is selected, users reaching your goal page without travelling through this funnel page will not be counted as conversions. You can fill this later on, when you have first ensured, that your mail goal is working. 9. Continue entering funnel steps until your funnel has been completely defined. You may enter up to 10 steps or only a single step 10. If the URLs entered above are Case sensitive, select the checkbox. For VirtueMart tracking you can skip this. 11. Enter a Goal value. If you want to use dynamic value from your e-commerce receipt page, leave the goal value blank, so that Google can calculate it. Otherwise, type your goal value. 12. Click Save. You are ready! Wait for 24-48 hours and check your E-commerce reports. Google Analytics Tracking for Virtuemart module has partly predefined funnels for you. Some of the pages in VirtueMart can be set to funnelling process. Unfortunately the VirtueMart technique doesn?t make it possible to distinguish all Virtuemart pages a different pageview. If you follow up the order process, you will note, that your url index.php during the process. Therefore you need to define the funnel steps with dynamic pageview names. The predefined pageviews for Estime Google Analytics Tracking Module are: urchinTracker("/funnel_G1/shop.browse.htm"); This is the page, when user has clicked some of the main categories. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 11 urchinTracker("/funnel_G1/shop.cart.htm"); This is the page for shopping cart. urchinTracker("/funnel_G1/checkout.index.htm"); All the pages of checkout process will form only one page view. urchinTracker("/funnel_G1/checkout.thankyou.htm"); This is the receipt page. You probably want to make this your goal page. 8 Configuring Google Analytics profile to have a goal for registered users in Joomla! 1. Log in to your Google Analytics account and click Analytics Settings 2. Find the profile for which you will be creating goals and click Edit 3. Select one of the four goal slots available for that profile and click Edit 4. Enter the Goal URL: http://www.yoursite.com/funnel_G1/registration.htm. 5. Enter the Goal name. Specify a name that you will recognise when viewing reports. 6. Turn the goal On in order to track this conversion goal. 7. Enter the URL of the first page of your conversion funnel. This page should be common to all users working their way towards your Goal. You can leave it empty and fill in later on, when you have ensured, that your main goal is working. This applies to next field also. 8. If the URLs entered above are Case sensitive, select the checkbox. For VirtueMart tracking you can skip this. 9. Enter a Goal value. If you want to use dynamic value from your e-commerce receipt page, leave the goal value blank, so that Google can calculate it. Otherwise, type your goal value. 10. Click Save. You are ready! Wait for 24-48 hours and check your E-commerce reports. 9 About goals and funnels A funnel is a series of pages, which a visitor must go through before reaching the goal. The goal can be any page, which you consider important conversion, such as a ?thank you? page after registration, purchase confirmation page in e-commerce sites or contact form. A funnel at an e-commerce site might include the following ?steps? 1) shopping cart page, 2) registration/sign up page 3) purchase confirmation page. We recommend, that you first set up the goal and after you ensure, that your goal is working, only then add funnels. User Manual for Google Analytics Tracking for VirtueMart Estime Oy 12 The purpose of goals and funnels is to see how efficiently your site is working and directing visitors to your goal. You are able to see, how many visitors drop out of the funnel and where they go. This helps you to make improvements to your site and increase revenue later on. If you are using Joomla!, you could consider your contact form as a goal for starters. If you are using VirtueMart, your goal is of course the confirmation order page. Other ideas for using goals in Joomla! could be the polls and newsletter subscriptions. If you are using polls, your goal could be the polls result page. If you are using an extension for newsletters, a goal could be the page, where a user has submitted information in order to receive newsletter emails. The rest is up to you. Decide your goals and set the up. 10 FAQ What module position to use? Google recommends, that you will add the code before the closing body tag </body>. This is why, it is recommended to use the module position, that is right before the body tag. In default Joomla 1.0.x template the position is debug. If you are using some other template, choose the position, which is before body tag or at the end of the template code. Why should I use Google Analytics Tracking module, why don?t I just add the code inside my template php file? If you add the code inside you template file, the tracking will be done for all pages for this template. Benefits of using module are E.g. that you can choose the pages you want to track with Analytics. Other benefit is that, when you change your site template, you don?t have make changes to you template php file, the only thing you might have to do, is choose another module position, if the one you were using, does not exist in your new template. How to use module with ssl sites? If your site includes secure web pages using the https protocol, you will need to make sure that your tracking code is tailored for secure access. If your Website URL includes https, your tracking code will already be customised for secure pages. If not, you will need to make changes to your profile. 11. Log in to Google Analytics 12. Find the profile for which you are obtaining tracking code and click Edit User Manual for Google Analytics Tracking for VirtueMart Estime Oy 13 13. In the Main Website Profile Information bar, click Edit 14. Edit the Website URL field by specifying https:// rather than http:// 15. Click Save Changes To obtain the secure tracking code, click the Check Status link above the Main Website Profile Information bar. Also remember to check Yes to https tab in the module settings. 11 Links Google Analytics http://www.google.com/analytics/en-GB/index.html Google Analytics Help Center http://www.google.com/support/googleanalytics/?hl=en_GB Joomla cms http://www.joomla.org Virtuemart http://www.virtuemart.net Estime Oy http://www.estime.fi/en/