AppMeasurement with Windows Phone
Contents
1. Once selected replace CUSTOMPROPERTY with the custom property name as defined in your Tracker object Each time AppMeasurement collects data it includes the value of the Tracker object s custom property as the value of the AppMeasurement property 7 Save and rebuild the project to incorporate the AppMeasurement for MSAF data collection into the application When you load the application in a browser you can use an HTML debugger such as Firebug to view AppMeasurement data collection as it occurs APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 15 CHAPTER 5 AppMeasurement with ASP NET Adobe AppMeasurement for NET and Silverlight lets you capture user activity on ASP NET websites and pages in the Adobe Digital Marketing Suite AppMeasurement leverages the standard ASP NET development tools to let you integrate ASP NET measurement into both new and existing ASP NET websites and pages This section includes the following topics e Requirements e Install AppMeasurement for ASP NET Libraries e Implementation Examples 5 1 Requirements e AppMeasurement for ASP NET consists of the following software components You can download the AppMeasurement software from SiteCatalyst s Code Manager For information about using Code Manager see Code Manager in the Admin Console User Guide which is available in the Digital Marketing Suite help system AppMeasurement DOotNET dll A Windows library for use in your prod2. ADOBE DIGITAL MARKETING SUITE Adobe AppMeasurement Windows Phone Silverlight and NET IMPLEMENTATION GUIDE Copyright 1996 2011 Adobe Systems Incorporated All rights reserved Omniture is a registered trademark of Adobe Systems Incorporated in the United States Japan and the European Community Terms of Use Privacy Center Omniture products and services are licensed under the following Netratings patents 5 675 510 5 796 952 6 115 680 6 108 637 6 138 155 6 643 696 and 6 763 386 A trademark symbol etc denotes an Adobe trademark An asterisk denotes a third party trademark All third party trademarks are the property of their respective owners 08112011 Table of Contents PREFACE i oan ach Rd eon cR a wee ara ee eee aaa CRT ACC ARR 4 CHAPTER 2 APPMEASUREMENT WITH WINDOWS PHONE nnn nnn nmn 6 REQUIREMENT S e Lux ERG REG ad eec Fi ed XE OSA X We cm RO EG RE RU 6 INSTALL WINDOWS PHONE LIBRARIES ehh hh rrr 7 OFFEINE MEASUREMENT Gea ed A ee AE LE EUR RE E D A eR een UR be ae hs 7 CHAPTER 3 APPMEASUREMENT FOR SILVERLIGHT s nnn Rh nmn hrs 9 REQUIREMENTS hse annnm re dot t ees EUR er A atte Morten A e nr ra ne ute e Ge d o eeu Ue a 9 INSTALL APPMEASUREMENT FOR SILVERLIGHT LIBRARIES 10 SILVERLIGHT SPECIFIC IMPLEMENTATION INFORMATION 11 CHAPTER 4 APPMEASUREMENT WI
3. AppMeasurement Setup application config variables s account myrsid S VvisitorNamespace s trackingServer myco dl sc omtrdc net track Send a Page View Only The most likely place to do this is in the constructor of your page class but can be done anywhere Instantiate instance S new AppMeasurement Setup application config variables S account myrsid S visitorNamespace s trackingServer myco dl sc omtrdc net Set variables and track Page View S pageName Some Page Name s track track Send pageView data using variable overrides Specifies a temporary variable value used only for track call Instantiate instance S new AppMeasurement Setup application config variables s account myrsid S visitorNamespace s trackingServer myco dl sc omtrdc net Set variables and track Page View Dictionary lt string object gt trackData trackData pageName Some page name trackData propl Some Prop Value s track v APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 28 trackLink Send a Custom Link private void someEventHandler object sender RoutedEventArgs e s trackLink http www myco com o Home Link APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 29 CHAPTER 8 Video Measurement in Silverlight Apps AppMeasurement for Silverlight lets you capture data
4. MSAF 1 2 3 4 Log in to the Digital Marketing Suite In the Suite click Admin Admin Console In the left side navigation select Admin Console Code Manager On the Code Manager page select Windows Phone Silverlight and NET in the Select the type of code to generate dropdown list In the Options pane provide the requested information to generate the Silverlight code then click Generate Code Report Suite Select your report suite Character Encoding Select the desired character encoding format for the generated code This should match the character encoding on your Web site Selecting the wrong character encoding might cause permanent data loss because text is improperly converted upon receipt Currency Specify your Web site s base currency for tracking conversion statistics The Base Currency is the currency used to store data in SiteCatalyst All currency amounts are converted the base currency if necessary based on the current conversion rate when SiteCatalylst receives the data Number of periods in Specify the number of periods in your domain name domain name Use https instead of Select to generate code using secure HTTP SSL instead of standard HTTP http The Code Manager generates code based on your selections and allows you to download it for use on your Web site or in your applications On the Generated Code page select the Component Files tab then select AppMeasurement MSAF msi This
5. Page View Dictionary lt string object gt trackData trackData pageName Some page name trackData propl Some Prop Value s track v trackLink Send a Custom Link s trackLink http www myco com o Home Link APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE CHAPTER 6 AppMeasurement with WPF and NET Applications AppMeasurement provides a mechanism to capture usage of native Microsoft WPF or NET applications in the Adobe Digital Marketing Suite AppMeasurement for WPF or NET lets you capture application events so you can monitor and evaluate the use of your WPF or NET applications AppMeasurement for WPF or NET leverages the standard WPF or NET development tools to let you integrate WPF or NET application tracking into both new and existing WPF or NET applications This section includes the following topics e Requirements e Install AppMeasurement for WPF or NET Libraries For information about the variables and methods available for use by WPF and NET applications see N AppMeasurement Library Reference on page 23 6 1 Requirements e AppMeasurement for WPF or NET consists of the following software components You can download the AppMeasurement software from SiteCatalyst s Code Manager For information about using Code Manager see Code Manager in the Admin Console User Guide which is available in the Digital Marketing Suite help system AppMeasurement DOotNET dll A
6. Phone project to enable AppMeasurement for the project using com omniture 4 Create a variable for the AppMeasurement instance in your project For example private AppMeasurement s 5 Create an instance of the AppMeasurement object and add the necessary Digital Marketing Suite variables to the Windows Phone application For example public MainPage InitializeComponent S new AppMeasurement S account myCorp s dc 41 s debugTracking true S pageName myPage s track 6 Build and save the Windows Phone project 7 When you execute the project in Debugging mode you can use Web browser debugger such as Firebug to confirm that the application sends data to Adobe data collection servers as expected 2 3 Offline Measurement AppMeasurement lets you measure application usage even when the Windows Phone is offline When enabled offline measurement does the following e The application generates a hit a track tracklink method call but the data transmission fails e AppMeasurement generates a timestamp for the current hit e AppMeasurement buffers the hit data and backs up buffered hit data to persistent storage to prevent data loss APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE e Ateach subsequent hit or at 5 second intervals whichever is shorter AppMeasurement attempts to send the buffered hit data maintaining the original hit order If the data transmission
7. the part of Adobe Account Support ClientCare is available to e Answer specific product questions e Help you utilize SiteCatalyst reports to the greatest effect e Resolve any technical difficulties you might have e Help you configure SiteCatalyst variables Service and Billing Information Depending on the service level you have purchased some of the options described in this guide might not be available to you Additionally each account has unique billing needs Please refer to your contract for pricing due dates terms and conditions If you would like to add to or otherwise change your service level or if you have questions regarding your current service please contact your Account Manager Adobe welcomes any suggestions or feedback you might have regarding AppMeasurement for Silverlight or the contents of this guide Send comments to your Account Manager APP MEASUREMENT FOR WINDOWS PHONE SILVERLIGHT AND NET 4 Contact Information CORPORATE ADDRESS Adobe Systems Inc 550 East Timpanogos Circle Orem UT 84097 PHONE 1 801 722 7000 FAX 1 801 722 7001 TOLL FREE 1 877 722 7088 support billing and sales SUPPORT E MAIL clientcare omniture com SALES E MAIL sales omniture com INFORMATION E MAIL info omniture com CORPORATE URL http www omniture com LOG IN URL http my omniture com APP MEASUREMENT FOR IPHONE IMPLEMENTATION GUIDE CHAPTER 2 AppMeasurement with Windows Phone Adobe
8. the clicked None link If you do not want to specify a URL use an empty string for the url parameter If no URL is specified trackLink uses the name parameter to identify the clicked link type Required A letter code that specifies the link report that should display the URL or name Supported values include 0 Custom Links report d File Downloads report e Exit Links report name Required The name that appears in the link report If you do not want to specify a name use an empty string for the name parameter If no name is specified trackLink uses the ux1 parameter to identify the clicked link You must provide a value for either name or url APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 27 7 4 Implementation Examples The following examples demonstrate some common use cases for AppMeasurement for WPF or NET e Instance instantiation Declare instance e Instance instantiation Instantiate instance and setup account configuration variables track Send a Page View Only track Send pageView data using variable overrides trackLink Send a Custom Link Instance instantiation Declare instance Declare instance as either a member of your page class AppMeasurement s Instance instantiation Instantiate instance and setup account configuration variables The most likely place to do this is in the constructor of your page class but can be done elsewhere Instantiate instance S new
9. AppMeasurement for Windows Phone Silverlight and NET provides a mechanism to capture usage of native Windows Phone applications in the Adobe Digital Marketing Suite AppMeasurement lets you capture application events SO you can monitor and evaluate the use of your Windows Phone applications AppMeasurement leverages the standard Windows Phone development tools to let you integrate Windows Phone application tracking into both new and existing Windows Phone applications This section includes the following topics e Requirements e Install Windows Phone LibrariesOffline Measurement e Offline Measurement For information about the variables and methods available for use by Windows Phone applications see AppMeasurement Library Reference on page 23 2 1 Requirements e AppMeasurement for Windows Phone consists of the following software components You can download the AppMeasurement software from SiteCatalyst s Code Manager For information about using Code Manager see Code Manager in the Admin Console User Guide which is available in the Digital Marketing Suite help system AppMeasurement Silverlight WP dll A Windows library for use in your shipping Windows Phone application AppMeasurement Silverlight WP Debug dll A testing version of the Windows Phone library that provides debug information to the Visual Studio output console Use this library while developing your Windows Phone application e After downloading the Windows
10. If users access the application through a Web browser leave pageURL blank and AppMeasurement automatically sets pageURL to the Web browser s URL Syntax s charSet UTF 8 Identifies the character encoding used in the application or website For more information about character encoding see the SiteCatalyst Implementation Guide which is available in the Digital Marketing Suite help system Syntax s cookieDomainPeriods 2 Specifies the number of elements in your domain SiteCatalyst uses this variable when setting the visitorID cookie For example s trackingServer www domain co uk has 3 domain periods and s trackingServer www mycorp com has 2 domain periods For more information see the SiteCata yst Implementation Guide which is available in the Digital Marketing Suite help system Syntax s cookieLifetime 600 Specifies the amount of time in seconds to store the visitorID cookie Set cookieLifetime session to have the cookie expire with the Web browser session Syntax s currencyCode USD Specifies the currency code that Adobe uses to denominate purchases or currency events collected in the application or website Syntax s linkLeaveQueryString true Determines whether the query string should be included in the Exit Links and File Download reports By default SiteCatalyst excludes query strings from all reports However for some Exit Links and File Download reports the important portion
11. Phone libraries copy the reference implementation in the Windows Phone Example tab onto your system clipboard or into a text file where you can access it later e The current Windows Phone development tools Currently you can view the Windows Phone tool documentation and link to the tool download site at http msdn microsoft com en us library ff402535 VS 92 aspx APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 6 2 2 Install Windows Phone Libraries Before using AppMeasurement you must install the AppMeasurement libraries into your Windows Phone project and configure it as needed to support your specific data collection needs NOTE The following task uses the Microsoft Web Developer 2008 Express Edition IDE If you are using a different IDE the specifics might vary from what is described here To install and configure the Windows Phone component 1 Launch the Visual Web Developer IDE then open the Windows Phone project To create a new Windows Phone project do the following a Click File New Project b Select Windows Phone Application then click OK 2 Adda reference to AppMeasurement in the Windows Phone project a Inthe Solution Explorer right click References then select Add Reference b Select the Browse tab browse to and select the appropriate AppMeasurement for Windows Phone library then click OK for more information see Requirements on page 6 3 Add the following line to the Windows
12. RLIGHT AND NET IMPLEMENTATION GUIDE iii Preface The Adobe App Measurement for Windows Phone Silverlight and NET implementation guide describes using the AppMeasurement interface to measure the usage of your Microsoft Windows Phone Silverlight and NET applications and websites It lets you capture user activity and forward that data to Adobe data collection servers where it is available for use by Digital Marketing Suite services including SiteCatalyst reports While AppMeasurement offers common measurement variables and methods for Windows Phone Silverlight and NET applications there are some platform specific differences in the AppMeasurement installation and implementation For details on these differences see the platform specific sections of this document This guide is intended for application developers and assumes that you are familiar with both implementing Digital Marketing Suite data collection code Silverlight development and or NET development Terms and Conditions of Use This document and the related software described in this document is proprietary to Adobe Systems Inc and is supplied only under license or nondisclosure agreement The document and software can be used or copied only in accordance with the terms of the agreement Enterprise Terms of Use https sc omniture com p 110n 1 0 terms html The information in this document is subject to change without notice and does not represent a commitment on
13. TH MICROSOFT SILVERLIGHT ANALYTICS FRAMEWORK 12 PREREQUISITES Aue Pie wok e m A Y Ceu Qu Pp AR E SO e UR Vy RR x Ua PUR e RR OR e 12 DOWNLOADING AND INSTALLING APPMEASUREMENT FOR MSAF 0 00 0c eee n nnn 13 USING APPMEASUREMENT WITH MSAF hh rrr 14 CHAPTER 5 APPMEASUREMENT WITH ASP NET 16 REQUIREMENTS ui REGEM Ree Xx Kom ERR eR OU eta RR Ra ba ROC ER EURO RE a 16 INSTALL APPMEASUREMENT FOR ASP NET LIBRARIES 16 ASP NET SPECIFIC IMPLEMENTATION INFORMATION 17 IMPLEMENTATION EXAMPLES nad pi Bas ee Ee a ee E D X RR om e es 19 CHAPTER 6 APPMEASUREMENT WITH WPF AND NET APPLICATIONS 21 REQUIREMENTS fee esegue COR EEUU PS be dax RUE NUN Knee ee 21 INSTALL APPMEASUREMENT FOR WPF OR NET LIBRARIES 22 CHAPTER 7 APPMEASUREMENT LIBRARY REFERENCE nnn nnnm hr 23 APPLICATION CONFIG VARIABLES s s eg e er user ee ee ee eG 23 TRACK CONFIG VARIABLES an ego epe Gy pe Ga eee RON RE ee ea REESE E 26 METHODS feiss b n EGRE LG ORO TOR RED ee POR Rd RR m 3 ee 27 IMPLEMENTATION EXAMPLES ee hh Ei TG 28 CHAPTER 8 VIDEO MEASUREMENT IN SILVERLIGHT APPS e nn n n rrr 30 APP MEASUREMENT FOR SILVE
14. Windows library for use in your shipping WPF or NET application AppMeasurement DotNET Debug dll A testing version of the Windows library that provides debug information to the Visual Studio output console Use this library while developing your WPF or NET application e Adobe recommends the following for developing WPF or NET applications e Microsoft Visual Studio e development system that meets all hardware requirements for Visual Studio APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 21 6 2 Install AppMeasurement for WPF or NET Libraries Before using AppMeasurement for WPF or NET you must install it into your project and configure it as needed to support your specific data collection needs NOTE The following task uses the Microsoft Visual Studio 2010 IDE If you are using a different IDE the specifics might vary from what is described here To install and configure AppMeasurement component 1 Launch the Visual Studio IDE then open the WPF or NET project To create a new project do the following a Click File New Project b Select WPF Application or another appropriate NET application type then click OK Add a reference to AppMeasurement in the project a Inthe Solution Explorer right click References then select Add Reference b Select the Browse tab browse to and select the appropriate AppMeasurement library then click OK for more information see Requirements on pag
15. about video usage in your Silverlight application To do this AppMeasurement for Silverlight gathers basic information from the media player then builds a session of events and sends it to Adobe data collection servers for processing After the collection servers process the video data it is accessible through a set of SiteCatalyst video reports Complete information to implement video measurement using Silverlight is available in the Measuring Video in SiteCatalyst guide APP MEASUREMENT FOR SILVERLIGHT IMPLEMENTATION GUIDE 30
16. alytics Framework The Microsoft Silverlight Analytics Framework provides an Extensible Web Analytics framework for Microsoft Silverlight and WPF Applications For detailed information about the Microsoft Silverlight Analytics Framework visit http msaf codeplex com The Adobe Digital Marketing Suite provides code that lets you use AppMeasurement with the Microsoft Silverlight Analytics Framework This section contains the following topics e Prerequisites e Downloading and Installing AppMeasurement for MSAF e Using AppMeasurement with MSAF 4 1 Prerequisites Using AppMeasurement for Microsoft Silverlight Analytics Framework MSAF requires the following e Microsoft Visual Studio 2010 or Microsoft Visual Web Developer 2010 Express visit www microsoft com express Web e Microsoft Expression Blend 4 visit www microsoft com expression products Blend OverView aspx e Microsoft Silverlight Analytics Framework for Blend 4 visit msaf codeplex com M e AppMeasurement for MSAF see Downloading and Installing AppMeasurement for MSAF on page 13 APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 12 Chapter 4 AppMeasurement with Microsoft Silverlight Analytics Framework 4 2 Downloading and Installing AppMeasurement for MSAF You can download AppMeasurement for Microsoft Silverlight Application Framework from Code Manager in the Digital Marketing Suite Administration Console To download and install AppMeasurement for
17. e 21 Add the following line to the project to enable AppMeasurement using com omniture Create a variable for the AppMeasurement instance in your project For example private AppMeasurement s Create an instance of the AppMeasurement object and add the necessary Digital Marketing Suite variables to the WPF or NET application For example S new AppMeasurement S account myCorp s dc d1 s debugTracking true s pageName myPage s track Build and save the project When you execute the project in Debugging mode you can use the Visual Studio Output Console to confirm that the application sends data to Adobe data collection servers as expected APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 22 CHAPTER 7 AppMeasurement Library Reference Adobe AppMeasurement for Windows Phone Silverlight and NET provides a mechanism to capture usage of native Microsoft Windows Phone Silverlight and NET applications in the Adobe Digital Marketing Suite AppMeasurement lets you capture events so you can monitor and evaluate the use of your applications Regardless of the specific NET platform you are using AppMeasurement provides the following common set of variables and methods that you can use to configure application and website measurement e Application Config Variables e Track Config Variables e Methods e Implementation Examples 7 1 Application Config Variables AppMeasurement sets th
18. e cookie could be set If the cookie cannot be set manageVisitorID continues with the next technique b Using a mobile device unique identifier from several known HTTP headers c Pulling s visitorID from the page query string or POSTed variables This option requires you to use the addVisitorIDToLinksAndForms method If all of these methods fail no visitor ID is generated and visitor identification is left to the server side data collection system Mod Stats This method supports the following optional arguments useFirstPartyCookie Default true Enables setting first party cookies If you set this argument to false technique a above is not attempted forceGeneration Default false Used in conjunction with addVisitorIDToLinksAndForms to force the page to generate a unique ID if s visitorID is not already set and cookies are not being used APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 18 5 4 Implementation Examples The following examples demonstrate some common use cases for AppMeasurement for ASP NET e Instance instantiation Declare instance e Instance instantiation Instantiate instance and setup account configuration variables e track Send a Page View Only e track Send pageView data using variable overrides e trackLink Send a Custom Link Instance instantiation Declare instance Declare instance as either a member of your page class AppMeasurement s Instance instant
19. e following variables when the application or website launches and typically do not need to change However you can change them at any time if necessary Table 7 1 AppMeasurement Configuration Variables account Yes Syntax s account mycompanycom The report suite or report suites multi suite tagging that you want to track dc Yes Syntax s dc d1 or d2 Identifies the Adobe data center Do not change this value unless so instructed by your Adobe Account Manager di San Jose data center d2 Dallas data center For reference the dc variable is also specified in your Web site s core JavaScript file s code js K visitorNamespace Yes Syntax s visitorNamespace mycompany Must match the visitorNamespace used in your JavaScript tracking file 5 code js If your JavaScript file does not have a visitorNamespace variable defined do not define it in the AppMeasurement DLL Using the wrong value for visitorNamespace causes incorrect reporting APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 23 pageName or pageURL Yes charSet No cookieDomainPeriods No cookieLifetime No currencyCode No linkLeaveQueryString No APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE Syntax s pageName Some Page Name S pageURL http www myurl com Specify pageName so that ClickMap can properly overlay data If users do not access the application through a Web browser specify a pageURL as well
20. ee Code Manager in the Admin Console User Guide which is available in the Digital Marketing Suite help system AppMeasurement Silverlight dll A Windows library for use in your shipping Silverlight application AppMeasurement Silverlight Debug dll A testing version of the Windows library that provides debug information to the Visual Studio output console Use this library while developing your Silverlight application e After downloading the Silverlight libraries copy the reference implementation in the Silverlight C4 Example tab onto your system clipboard or into a text file where you can access it later e Adobe recommends the following for developing Silverlight applications e Microsoft Visual Studio e development system that meets all hardware requirements for Visual Studio APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 9 3 2 Install AppMeasurement for Silverlight Libraries Before using AppMeasurement for Silverlight you must install it into your Silverlight project and configure it as needed to support your specific data collection needs NOTE The following task uses the Microsoft Web Developer 2008 Express Edition IDE If you are using a different IDE the specifics might vary from what is described here SilverlipitApplications Visual Web Developer 2008 Express Edition 945 94223014 ss v com om System System System System System System System Sy
21. f it is offline This lets you delay sending hit data during a hardware intensive operation such as video playback Rather you can collect the data offline then send it once the operation completes forceOnline Returns AppMeasurement to normal operating mode after using the forceOffline method APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 8 CHAPTER 3 AppMeasurement for Silverlight Adobe AppMeasurement for Windows Phone Silverlight and NET provides a mechanism to capture usage of native Microsoft Silverlight applications in the Adobe Digital Marketing Suite AppMeasurement for Silverlight lets you capture application events so you can monitor and evaluate the use of your Silverlight applications AppMeasurement for Silverlight leverages the standard Silverlight development tools to let you integrate Silverlight application tracking into both new and existing Silverlight applications This section includes the following topics e Requirements e Install AppMeasurement for Silverlight Libraries e Silverlight Specific Implementation Information For information about the variables and methods available for use by Silverlight applications see AppMeasurement Library Reference on page 23 3 1 Requirements e AppMeasurement for Silverlight consists of the following software components You can download the AppMeasurement software from SiteCatalyst s Code Manager For information about using Code Manager s
22. fails it continues to buffer the hit data Offline measurement uses the following methods and variables Table 2 1 Offline Measurement Variables TYPE trackOffline Boolean false Enables Disables offline AppMeasurement offlineLimit Integer 10 Sets the maximum number of hits to buffer When the number of buffered hits reaches of flineLimit AppMeasurement drops the oldest buffered hit then buffers the newest hit Tune this value based on the number of hits and the amount of data the number of variables per hit sent by your app For example if your app generates a lot of offline server calls lots of link tracking in addition to standard page screen views try increasing of flineLimit offlineThrottleDelay Integer 0 Specifies a cadence or delay in milliseconds for sending buffered hit data when AppMeasurement detects an active network connection Doing so mitigates the performance impact of sending multiple hits on the application For example if of flineThrottleDelay 1000 and it takes 300ms to send the hit data AppMeasurement waits 700ms before sending the next buffered hit timestamp Integer 0 Overrides the default timestamp mechanism in AppMeasurement SO you can integrate the application s offline measurement with an existing queue system Adobe recommends letting AppMeasurement manage timestamps if possible Table 2 2 Offline Measurement Methods forceOffline Forces AppMeasurement to behave as i
23. formation about these tracking variables see the SiteCatalyst Implementation Guide pageName server zip pageURL pageType events referrer dynamicVariablePrefix products purchaseID variableProvider prop 1 75 transactionID campaign eVar 1 75 channel state hier 1 5 WARNING When capturing variables such as campaign that should be set only one time per visit make sure you reset the variable to NULL or empty string immediately after calling track or trackLink Otherwise these variables continue to increment with each subsequent transaction which corrupts your tracking data APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 26 T 3 Methods The AppMeasurement DLL supports the following methods for tracking Windows Phone Silverlight and NET applications and websites e track e trackLink track Sends a standard page view to Adobe data collection servers including any tracking variables that have values The track method takes no parameters and returns no response SYNTAX PARAMETERS LED s track None None trackLink Sends custom download or exit link data to Adobe data collection servers Track all micro level activity that should not capture a page view with trackLink NOTE When using trackLink AppMeasurement sends the pageName variable but SiteCatalyst does not record it as a page view SYNTAX PARAMETERS RESPONSE s trackLink url type url Required The URL that identifies
24. iation Instantiate instance and setup account configuration variables The most likely place to do this is in the constructor of your page class but can be done elsewhere 80 Page Language C Debug true gt 8 Import Namespace com omniture gt lt Instantiate instance S new AppMeasurement Setup application config variables s account myrsid s visitorNamespace myco s trackingServer myco dl sc omtrdc net track Send a Page View Only The most likely place to do this is in the constructor of your page class but can be done anywhere 0 Page Language C Debug true lt S Import Namespace com omniture t Instantiate instance S new AppMeasurement Setup application config variables S account myrsid S visitorNamespace s trackingServer myco dl sc omtrdc net Set variables and track Page View S pageName Some Page Name s track 52 2 x 52 track Send pageView data using variable overrides Specifies a temporary variable value used only for track call 0 Page Language C Debug true 8 Import Namespace com omniture gt lt Instantiate instance S new AppMeasurement APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE Setup application config variables s account myrsid S visitorNamespace myco s trackingServer myco dl sc omtrdc net Set variables and track
25. installer includes the code necessary to integrate AppMeasurement with the Microsoft Silverlight Analytics Framework Launch AppMeasurement MSAF msi to install AppMeasurement for MSAF into your Silverlight development environment For information about using AppMeasurement for MSAF for data collection in your Silverlight application see Using AppMeasurement with MSAF on page 14 APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 13 Chapter 4 AppMeasurement with Microsoft Silverlight Analytics Framework 4 3 Using AppMeasurement with MSAF Once you have installed AppMeasurement for MSAF you can configure data collection your Silverlight applications AppMeasurement for MSAF can capture data about page views and link clicks in your Silverlight application NOTE The following task assumes you are familiar with Microsoft Expression Blend 4 and Microsoft Silverlight Analytics Framework see Prerequisites on page 12 SitverlightApptication sin Micresof Expression Blend 4 CE IB Grid x Namee LayoutRoct Backgocunde White lt i Interaction tehaviors gt quniturerAgpMeasurement LiskNames 1L ese Apptere LinkTypee eset Event jehaviors gt Sutton Morizoetalaligemente Left Macgine 242 212 0 0 Vertical TrackAction gt lt awad TrackAction CustosProperties rtyvalue Propertytteses leby Valure cool mwab Track ction CustoaProperties gt S Gntom T
26. leTypes to determine which links are downloadable files Set trackDownloadLinks to false only if there are no downloadable file links your Web site or if you don t want to track file downloads Syntax s trackExternalLinks true Lets you track clicks on links that lead to Web pages external to your Web site When enabled AppMeasurement uses linkInternalFilters and linkExternalFilters to determine if a clicked link is an exit link Set trackExternalLinks false only if there are no exit links on your Web site or if you don t want to track clicks on exit links Syntax s trackingServer metrics mycompany com s trackingServerSecure smetrics mycompany com Identifies the collection domain when you are using a first party cookie implementation These values should match the collection domain in your s_code js file if one exists Syntax s visitorMigrationKey omniture provided value Specifies the migration key used to migrate visitor cookies from a third party to a first party cookie implementation To get this value contact your Account Manager 25 VARIABLE REQUIRED DESCRIPTION debugTracking No Syntax s debugTracking true Lets you view debug information in your platform s debugger For example the Silverlight editor trace window or a Firebug console Firefox 7 2 Track Config Variables The following variables are typically set before calling one of the track methods For more in
27. m omniture 4 Create a variable for the AppMeasurement instance in your project For example private AppMeasurement s 5 Create an instance of the AppMeasurement object and add the necessary Digital Marketing Suite variables to the Silverlight application For example public MainPage InitializeComponent S new AppMeasurement S account myCorp s dc d1 s debugTracking true S pageName myPage s track 6 Build and save the Silverlight project 7 When you execute the project in Debugging mode you can use a Web browser debugger such as Firebug to confirm that the application sends data to Adobe data collection servers as expected 3 3 Silverlight Specific Implementation Information AppMeasurement provides the following Silverlight specific resources for use with Silverlight applications For information about other AppMeasurement resources available for use with Silverlight applications see AppMeasurement Library Reference on page 23 setinterface method Specifies a root layout that you can use to find the root of the Silverlight application NOTE Using setInterface is required for certain advanced features such as video auto tracking s setInterface interface interface Required The root layout object from None the Silverlight application APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 11 CHAPTER 4 AppMeasurement with Microsoft Silverlight An
28. of the URL might be in the query string For example the download file name might be defined in the query string making the query string necessary for an accurate File Downloads report Note If query strings contain session IDs or other personally identifiable information contact your Account Manager to have SiteCatalyst strip out those query string elements 24 linkTrackEvents No linkTrackVars No trackDownloadLinks No trackExternalLinks No trackingServer No trackingServerSecure visitorMigrationKey No APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE Syntax s linkTrackEvents purchase eventi1 A comma separated list of events to send with a custom exit or download links Populate 1inkTrackEvents in the onClick event If an event is not specified in 1inkTrackEvents AppMeasurement does not send it to SiteCatalyst even if it is populated in the link s onClick event Syntax s linkTrackVars events propl eVar49 A comma separated list of variables to send with custom exit and download links Set linkTrackVars to send all variables that have values To avoid inflation of instances or page views associated with other variables populate 1inkTrackVars in the link s onClick event that is used for link tracking Syntax s trackDownloadLinks true Lets you track links to downloadable files in your application or website When enabled AppMeasurement uses linkDownloadFi
29. raffic TrackActien 6 Gator Convenion To use AppMeasurement for MSAF 1 2 Launch Microsoft Expression Blend 4 Open a Silverlight 4 project where you want to add data collection AppMeasurement for MSAF supports only Silverlight 4 applications In the Assets tab select Categories gt Analytics then drag Adobe AppMeasurement onto your project s LayoutRoot in the Objects and Timeline tab This makes AppMeasurement data collection available to all components of your Silverlight project For data collection to work you must add the Adobe AppMeasurement asset to LayoutRoot Drag the appropriate Tracker object onto each component in your application where you want to collect data AppMeasurement for MSAF supports the following Tracker objects Pulse TrackAction and TrackTouch For more information about each of these objects see the Microsoft Silverlight Analytics Framework documentation Configure each Tracker object as needed For example you might need to create custom property key value pairs to use in the data collection process For more information about the Tracker objects see the Microsoft Silverlight Analytics Framework documentation Assign values to the AppMeasurement properties that you want to collect APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 14 Chapter 4 AppMeasurement with Microsoft Silverlight Analytics Framework This determines what data AppMeasurement collects thro
30. stem System System Linq Net Windows Windovs Windovs Windows Windows Vindows Vindows niture Collections Generic Controls Documents Input Media Media Animation Shapes 146 namespace SilverlightApplicationi 15 166 public partial class MainPage UserControl t private AppMeasurement public InitializeComponent new AppMeasurement account myCorp 9 HNN J AG ONNAN Error List g Output To install and configure the Silverlight component 1 Launch the Visual Web Developer IDE then open the Silverlight project debugTracking true pageName myPage track s s dc di s To create a new Silverlight project do the following a Click File New Project b Select Silverlight Application then click OK C Deselect Host the Silverlight application in a new Web site then click OK APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 10 2 Adda reference to AppMeasurement in the Silverlight project a In the Solution Explorer right click References then select Add Reference b Select the Browse tab browse to and select the appropriate AppMeasurement for Silverlight library then click OK for more information see Requirements on page 9 3 Add the following line to the Silverlight project to enable AppMeasurement for the project using co
31. the data collection with track or trackLink by making an image request to Digital Marketing Suite servers Your application must then write out the returned img tag When true AppMeasurement sends the data collection request itself Note The sendFromServer flag defaults to false when using the ASP NET construc tor addVisitorIDToLinksAndForms Syntax s addVisitorIDToLinksAndForms myHTMLContent Response Write s addVisitorIDToLinksAndForms myHTMLC ontent Adds s visitorID s visitorID to all links and forms in a block of HTML that you pass in then returns the updated HTML to you The response takes the form This method lets you use internal links and forms on the ASP NET website to pass a visitor ID from page to page instead of using a cookie Note After using this method you can call manageVisitorID to identify the visitor based on the s visitorID value added to the HTML links and forms APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 17 manageVisitorID Syntax s manageVisitorID Or s manageVisitorID false true Response Write s addVisitorlIDToLinksAndForms myPageC ontent Attempts to identify the website visitor without using a 3rd party cookie using the following techniques a Using a first party s visitorID cookie containing the value of s visitorID or a generated unique ID When the cookie is set this method causes the page to redirect back to itself to detect if th
32. uction ASP NET site AppMeasurement DotNET Debug dll A testing version of the Windows library that provides debug information to the Visual Studio output console Use this library while developing your ASP NET site e Adobe recommends the following for developing ASP NET applications e Microsoft Visual Studio e A development system that meets all hardware requirements for Visual Studio 5 2 Install AppMeasurement for ASP NET Libraries Once you have downloaded the AppMeasurement for ASP NET library save it into your IIS bin directory so it can be referenced in your ASP NET website or page APP MEASUREMENT FOR SILVERLIGHT AND NET IMPLEMENTATION GUIDE 16 5 3 ASP NET Specific Implementation Information AppMeasurement provides the following ASP NET specific resources for use with ASP NET websites and pages For information about other AppMeasurement resources available for use with ASP NET websites and pages see M AppMeasurement Library Reference on page 23 Table 5 1 AppMeasurement Configuration Variables public Syntax s new AppMeasurement Request Response AppMeasurement HttpRequest The AppMeasurement for ASP NET constructor Use the constructor to request HttpResponse response pass in the request and response objects for your ASP NET page Typically these are Request and Response sendFromServer Syntax s sendFromServer false Response Write s track When false the visitor s Web browser handles
33. ugh the Microsoft Silverlight Analytics Framework Each AppMeasurement for MSAF property corresponds to one of the following e Application Config variable see Application Config Variables on page 23 e A Track Config variable see setInterface method on page 11 e Parameters needed for a trackLink method call see trackLink on page 27 AppMeasurement provides the following UI controls and options for assigning property values Expand or Collapse Categories Click the Arrow icon next to a category name to collapse or expand its property list Display Advanced Properties By default AppMeasurement for MSAF displays only Basic most commonly used properties Click the Expand icon to display all properties in that category Static Value Select a property field to type in a static value for that property Each time AppMeasurement collects data it includes this constant property value Dynamic Value Select the dropdown button in a property field to display a list of MSAF properties to assign to the AppMeasurement property Each time AppMeasurement collects data it includes the current value of the AppMeasurement property Custom Property Select the dropdown button in a property field then select msaf EventArgs CUSTOMPROPERTY to assign a custom property defined in the Tracker object to the AppMeasurement property For more information about custom properties see the Microsoft Silverlight Analytics Framework documentation
Download Pdf Manuals
Related Search