When you sign up for an Adobe Digital Publishing Suite subscription (Professional or Enterprise), it's necessary to enable Omniture analytics. When Omniture analytics are enabled, you can track user data in your digital publications.

This document describes how you can ensure that the analytics settings have been set up properly before you submit your app to the store.

Set up the report suite

This information only applies to Adobe Digital Publishing Suite Enterprise customers, or DPS Professional customers who have a separate Omniture account. The report suite is established using the Account Administration feature of the Digital Publishing Suite dashboard.

Application Role Settings

If you have an Omniture account, it's necessary to know the "Company Name" used to log in to your Omniture account. Enter that, and the name of the report suite that you want, click Check Availability, and if it is not already in use, click Submit.

For Enterprise customers who don't have an Omniture account, omit the Company Name. Enter only the report suite name and click Check Availability. If it is not already in use, click Submit.

For Professional customers who don't have an Omniture account, leave both the Company Name and Report Suite fields blank and click Submit.

The report suite name you enter is converted into a report suite ID. Any spaces are converted to periods, and then prefixed with "dps." followed by "dl." or "sj." to indicate which data center they are created in. For example, the report suite name "my new report suite" produces a report suite ID "dps.sj.my.new.report.suite". There is a limit to the length of the report suite ID. So, you get an error if you enter a string that is more than 33 characters long, including spaces.

For more information about using the Account Administration tool, see Account Administration tool.

Check the settings

When you use the Viewer Builder to create your custom viewer app, the final step of the process ("Submit Build") displays Omniture information.

Viewer Builder

If you want to examine the settings in the distribution app before submission to Apple, do the following (Mac OS):

1. Unzip the distribution-viewer.zip file that Viewer Builder created.

Look for a file called viewer.app at the main level of the unzipped folder.

2. Control click viewer.app and choose Open Package Contents.

3. Find the file Omniture.plist in the newly opened window. Open it with a plist editor application, such as PList Edit pro.

The following image is from an application that does not have analytics enabled. Notice that the Omniture fields, accountID, trackerDC, trackerServer, and trackerSecureServer, have no values.

Omniture fields

The following image is from an application that does have analytics enabled.

Analytics enabled

Test the reporting

To be certain that the Analytics are working correctly, include a verification in your testing of the viewer app before you submit it to the relevant market place. Install the development viewer on a device as you would for other testing. Then, launch the application while you have a connection from the device to the Internet. Use the application for at least two minutes, by which time the app will have attempted to send usage data to the SiteCatalyst servers. Initial data from this testing can require as much as four to six hours before it becomes viewable in the Analytics service in http://digitalpublishing.acrobat.com. Subsequent data takes about one or two hours to appear.

Note: Test data entered into your Analytics cannot be removed. However, you can screen it from your results by limiting the date range to after the app is live in the marketplace.

Additional Information

For more information on Omniture analytics, see Omniture Analytics.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy