Pega® Web Analytics Component Overview Component
Total Page:16
File Type:pdf, Size:1020Kb
Pega® Web Analytics Component PEGASYSTEMS PROVIDES THIS SOFTWARE 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NONINFRINGEMENT. IN NO EVENT WILL PEGASYSTEMS, THE AUTHORS, OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THIS SOFTWARE OR THE USE OR OTHER DEALINGS IN THIS SOFTWARE. Overview In order to provide a basic Web Analytics configuration as an interface between Pega7 and individual vendors, Pega has created a component with a Web Analytics Landing page and configuration. This document describes how to install and configure your application to use and configure the Web Analytics component. We have examples for 2 vendors: Google and Matomo (Piwik). Component Installation 1. Download the Web Analytics component from Exchange 2. Import the component a. Designer Studio > Application > Distribution > Import i. Local file PegaWebAnalytics_XXXX_010101_XXXX.zip 3. This is a Component containing 2 vendors: Google, Matomo (Piwik). Most of the vendor info will be valid, but you will have register with either vendor's server and update the vendor code with the correct vendor url and the unique token you receive. This is discussed below in the Vendor section. 4. Verify you have the component a. Designer Studio > Application > Components i. You should see PegaWebAnalytics as a component Pega Exchange – Web Analytics Component 1 Copyright © 2018 Pegasystems Inc. All Rights Reserved. 5. Open your application and add PegaWebAnalytics 01.01.01 as a component Preflight Optimization IMPORTANT: If you are using Preflight Optimization, you need to turn it off to test and then re-optimize once you have created a Web Analytic Configuration that you are happy with. So, for now, just turn this off. Once you have a working web analytics test, you can run re-optimization and turn it back on. Additional Information After installing the Web Analytics component, you need to log off and back on. Pega Exchange – Web Analytics Component 2 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Landing Page With the component installed, Web Analytics can be found under "User Interface" on the Designer Studio menu. Selecting Web Analytics will bring up the Web Analytics Landing Page. It is here that you will be able to add, edit, and remove web analytics configurations for different access groups/portals or globally. You can also choose different vendors and use them simultaneously. Initial display before adding configurations Pega Exchange – Web Analytics Component 3 Copyright © 2018 Pegasystems Inc. All Rights Reserved. After adding configurations Modifying Existing Configurations Use Web Analytics Selecting this checkbox will turn on/off web analytics for the given configuration. NOTE: Changing this setting requires you to log off and log back in to the application(s) in order to for this change to be applied. Edit The edit icon will bring up the configuration dialog (same as add analytics) to change the analytics configuration. NOTE: With edit, you can NOT change the AccessGroup/Portal. Delete The delete icon will delete this configuration. It will also remove the Data record associated with this configuration. NOTE: Delete will NOT remove the Data Vendor record that was used or created with this configuration. Pega Exchange – Web Analytics Component 4 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Configuration Add analytics To add an analytics configuration, on the Web Analytics Landing Page, press "Add new". Access Group The initial configuration dialog will require you to select an Access Group. The list of Access Groups is limited to the current application you are logged in as. Whichever access group you select, Web Analytics will only be applied to that access group and its default portal. NOTE: You can have multiple configurations for the SAME access group but for DIFFERENT vendors active that the same time. Pega Exchange – Web Analytics Component 5 Copyright © 2018 Pegasystems Inc. All Rights Reserved. All As an alternative, you can select "All". This will apply this Web Analytics configuration to ALL applications and ALL portals. Similar, to access groups, you can have multiple ALL configurations for different vendors active at the same time. NOTE: When any “All” configuration(s) are in use, all Access Group specific configurations will be ignored. NOTE: At present, “All” will only be applied to those applications that have added this web analytics component. (ie. if the Pega application doesn’t have PegaWebAnalytics component specified on the application rule, no analytics will be taken) Web Analytics Vendor After you have selected an Access group, you will need to select a Vendor. For other vendors, you will need to create a new vendor. Create New Vendor To create a new vendor, select "Create new vendor". A small overlay will appear for the name of the vendor. Enter this and press "Submit". Pega Exchange – Web Analytics Component 6 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Now if you go back to selecting a Vendor, your new Vendor should appear. New Vendor Logo Once you create a new vendor, you can add a Vendor logo, to appear in the landing page. (You can jump to "Select a Vendor", section of this document and come back to this later if you don’t have a logo.) Pega Exchange – Web Analytics Component 7 Copyright © 2018 Pegasystems Inc. All Rights Reserved. A logo can be added at any time. • You must capture the vendor's logo image o preferably with a white background o preferably as a "png" file • Next, create a new Data-Content-Image rule o File Name - should be your vendor's name (as created, without spaces), plus "_logo" (vendorco_logo) o File Type - type of file (preferably "png") o File Path - MUST be "/webanalytics/" • Once created, upload the image and save Pega Exchange – Web Analytics Component 8 Copyright © 2018 Pegasystems Inc. All Rights Reserved. There are currently 8 common vendors already included in the PegaWebAnalytics ruleset: Google, Piwik, Matomo, Woopra, IBM, Clicky, Adobe, and WebTrends. These will be used if you select the corresponding vendor. You can use these as examples to create your own. Select a Vendor Once you select a vendor, you will be presented with an array of Tabs to enter data to configure this Web Analytics for this Vendor and Access group. Meta Tags Tab If Web Analytics is turned on for this access group or “All”, then Meta tags <meta> will be inserted in the header if any of the tags Name/Content pairs have values. The Meta tags configuration starts with 5 standard tag names. Others can be added or deleted. Pega Exchange – Web Analytics Component 9 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Generation of the above will look like the following: App Data Tab On the Application Data tab, you can select what kind of data will be sent to the web analytics vendor for each page that is displayed/updated. The data sent is determined by what is selected on this tab, along with the technical configuration on the Page Tab. Use Select "Use" if the data on this page will be sent to the web analytics vendor Pega Exchange – Web Analytics Component 10 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Add In Case Info Select "Add in Case Info" if you want some generic Case Data to be sent to the web analytics vendor. This includes the following, if available: • Action • Harness • Flow • Task • ID • Activity • Page • Page Class • Section Name Specific values In addition, you can specify other values from the clipboard that you want to send. If these values are present at the time the page is loaded, they will be sent. Each entry (Event, Name, Property) can be a string, property or page.property value. The entries correspond to {1}, {2} and {3}, which will be replacement values for the technical configuration on the "Page" tab. Event gives the vendor a classification of “event”, so this data will be found under “events” with the given name (Both Google and Matomo use this classification) Name provides the second level of classification – “for this event, we have this element”. Property corresponds to specific data that found for the “Name”. In the above example: For the Classification of “Case-Info”, “Stage” has a value of “X” (whatever we find on the clipboard page pyWorkPage.pyCurrentStageLabel”) Pega Exchange – Web Analytics Component 11 Copyright © 2018 Pegasystems Inc. All Rights Reserved. Vendor Specific Tabs The following tabs (Page, Click, Click Post) are vendor-specific functionality. Each vendor has a specific API for usage in the header (page) and other JavaScript (JS) API that we can use for clicks and events. First Time When updating the data on these tabs for the first time with a new vendor, the data will be copied to the vendor data record for subsequent uses. After the first update, subsequent updates will only update this configuration (access group/vendor) but NOT the vendor data record. To update the vendor data record, press the edit button next to the vendor drop down. Edit the default configuration for that vendor and submit (see below and in the section “Editing Vendor”). We create the vendor default record so that if you create new configurations, you can get the default configuration and then modify it per web configuration as needed. Page Tab For each page that is loaded, determine what data is sent to specific web analytics vendors. Most vendors provide at least 2 pieces of data. Header Snippet A snippet of code for the header. This must be enclosed in one or more <script> tags. Snippet(s) usually set up the data transfer to the vendor and usually includes some JS as well.