Summary of Contents for Sun Microsystems Sun Java Content Delivery Server 5.0
Page 1
Sun Java™ System Content Delivery Server 5.0 Administration Guide 2005Q4 Sun Microsystems, Inc. www.sun.com Part No.: 819-3209-10 2005Q4 Submit comments about this document at: http://docs.sun.com/app/docs/form/comments...
Page 2
Cette distribution peut comprendre des composants développés par des tierces parties. Sun, Sun Microsystems, le logo Sun, Java, et J2ME sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats- Unis et dans d'autres pays.
Contents Preface xv Introduction 1 Sun Java System Content Delivery Server 1 Catalog Manager 3 Catalog Manager Processes 4 Automated Content Validation 5 Content Management 5 Device Management 6 Account Management 6 Plan Management 6 Fulfillment Manager 7 Vending Manager 7 Vending Manager Processes 9 Content Management 9 Plan Management 9...
Page 4
Accessing the Administration Consoles 11 ▼ Logging in to the Catalog Manager 11 ▼ Logging in to the Vending Manager 12 Catalog Manager 13 Managing Content 13 Managing Content Categories 14 ▼ Viewing Categories 14 ▼ Adding a Category 16 ▼...
Page 5
▼ Editing a Content Type 34 ▼ Creating a Pricing Option 35 ▼ Editing a Pricing Option 37 ▼ Deleting a Content Type 39 ▼ Disabling a Pricing Option 39 ▼ Registering a MIME Type 40 ▼ Editing a MIME Type 41 ▼...
Page 7
▼ Editing a Vending Manager Account 99 ▼ Deleting a Vending Manager Account 100 Managing Developer Accounts 101 ▼ Viewing Developer Accounts 101 ▼ Adding a Developer Account 101 ▼ Editing a Developer Account 103 ▼ Deleting a Developer Account 104 Managing Catalog Manager Administrator Accounts 104 ▼...
Page 8
▼ Adding a Developer Plan 119 ▼ Editing a Developer Plan 120 ▼ Viewing Developer Licensees 121 ▼ Adding a Developer Licensee to a Developer Plan 122 ▼ Removing a Developer Licensee from a Developer Plan 123 ▼ Setting the Default Developer Plan 123 ▼...
Page 9
Checking the Status of a Stocking Job 151 ▼ Updating the Catalog for Stocked Content 152 Pricing for Content for a Locale 153 ▼ Setting Local Pricing 153 Price Update Notification 155 ▼ Changing the Price of Individual Content Items 156 Managing Stocked Content 156 Viewing Stocked Content 156 ▼...
Page 10
▼ Creating a Campaign 185 ▼ Specifying a Campaign Type 185 ▼ Specifying Campaign Options and Target Audience 186 ▼ Specifying a Campaign Message 187 ▼ Specifying Content for the Campaign 188 ▼ Specifying Campaign Pricing Characteristics 189 ▼ Specifying Campaign Scheduling 190 ▼...
Page 11
Managing Subscriber Accounts 209 ▼ Viewing Subscriber Accounts 210 ▼ Adding a Subscriber Account 210 ▼ Editing a Subscriber Account 212 ▼ Viewing a Subscriber’s Download History 213 ▼ Managing Subscriber Licenses 213 ▼ Extending Trial Usage 214 ▼ Issuing a Refund 215 ▼...
Page 12
▼ Deleting an MMS Message 230 ▼ Using the MMS Test Log 231 Device Capabilities 233 Descriptions of the Capabilities 233 System Capabilities 233 Mandatory Capabilities 234 Content Delivery Server-Specific Capabilities 234 Browser Capabilities 235 User Interface and Software Capabilities 235 Specifying a Capability Value 236 List 237 Integer 237...
Page 13
Tables DRM Types 20 TABLE 2-1 CDS DRM Agents TABLE 2-2 OMA DRM 1.0 Formats 23 TABLE 2-3 Required MIME Types for OMA DRM 1.0 24 TABLE 2-4 DRM Options and Associated DRM Types and Content Types 25 TABLE 2-5 Content Delivery Server Pricing Models 27 TABLE 2-6 DRM Options and Pricing Models 28...
Page 14
Nokia 6310i Device Specifications 238 TABLE A-4 Device Specifications for a User-Defined Device 1 239 TABLE A-5 Device Specifications for a User-Defined Device 2 239 TABLE A-6 Associated DRMs, Content Types, and Pricing Models 241 TABLE B-1 Initial Pricing Set for Items 1 and 2 244 TABLE B-2 Resulting Pricing for Items 1 and 2 in Scenario 1 244 TABLE B-3...
Preface This guide provides an overview of the Sun Java™ System Content Delivery Server. It describes how to administer the Catalog Manager and Vending Manager components. It describes the device capabilities and the content pricing models supported by the Sun Java System Content Delivery Server. Before You Read This Document This guide is written for system administrators who are responsible for administering the Catalog Manager or Vending Manager.
Chapter 2 describes how to administer the Catalog Manager. It provides ■ instructions on how to review, categorize, and publish content. It describes how to define the mobile devices supported and their capabilities. It also describes how to manage access for developers and Vending Managers. Chapter 3 describes how to administer the Vending Manager.
Related Documentation The Sun Java System Content Delivery Server manuals are available as Portable Document Format (PDF) and Hypertext Markup Language (HTML) files. These files are available in the Documentation subdirectory of the directory where the Content Delivery Server is installed as well as online at http://docs.sun.com. The following table summarizes the books included in the Content Delivery Server documentation set.
Accessing Sun Documentation Online The Sun Product Documentation web site enables you to access Content Delivery Server documentation on the web at http://docs.sun.com. Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to and click Send Comments.
C H A P T E R Introduction This chapter provides an overview of the Sun Java™ System Content Delivery Server. It describes the content lifecycle and provides an overview of the Catalog Manager, Fulfillment Manager, and Vending Manager components. It describes the automatic content validation process that takes place when content is submitted to the Content Delivery Server.
Page 20
Content Java Applications Ringtones Wallpapers Providers Music Videos Games Extensible... Operator Java System Content Delivery Server Catalog Manager Vending Manager Vending Manager Vending Manager Subscriber Subscriber Subscriber Portal Portal Portal Fulfillment Fulfillment Fulfillment Manager Manager Manager Subscriber 1. The content provider creates an application and submits it to the Catalog Manager using the web-based Developer Portal.
3. The Catalog Manager administrator publishes the content, making it available to the Vending Manager. 4. The Vending Manager administrator selects content published from the Catalog Manager and stocks the content, making it available to subscribers. Catalog Manager The Catalog Manager is the content aggregator or warehouse. It manages all the content coming from the developer community.
1. Developers submit content to the Catalog Manager. The Catalog Manager runs an automated validation process on the content to ensure there is no malicious content and that the content matches the supported devices. 2. The content goes to the Submitted Content section of the Catalog Manager for review by the administrator.
Automated Content Validation The Sun Java System Content Delivery Server performs an automated validation of content. If an application fails at any stage of validation, it is not submitted to the Catalog Manager. Note – The default implementation of content validation performs automated validation on MIDlets only.
Submitted Content. The administrator reviews submitted content and, if ■ required, edits the content and modifies the pricing and category assignments. The administrator can accept or reject the content. Published Content. After accepting the content, the administrator publishes the ■ content to make it available to the Vending Manager.
Vending Plans. Vending Plans define the categories that a Vending Manager can ■ access. Vending Plans can contain a nested hierarchy of other Vending Plans. Each Vending Manager Account is associated with one or more Vending Plans. Developer Plans. Developer Plans define the set of APIs that developers can use ■...
Page 26
The Vending Manager administrator manages the following functions: Stocked content ■ Subscriber access and subscriber licenses ■ Purchase pricing and trial periods ■ Administrator access ■ Statistical reports ■ In addition to the Vending Manager administrator, the Content Delivery Server can have Vending Manager Customer Care Agents.
Vending Manager Processes The previous figure illustrates the Vending Manager processes. The Vending Manager is responsible for the following practices: Content Management ■ Plan Management ■ Account Management ■ Reporting ■ Content Management The Catalog Manager publishes content to the Vending Manager. The Vending Manager is responsible for stocking this content to make it available to the subscriber.
Customer Care Agent for administrators with privileges for viewing content and managing subscribers. Administrator Accounts can be disabled when you do not want an individual accessing the Vending Manager. See “Managing Vending Manager Administrator Accounts” on page 201 for more information. Reporting The Vending Manager provides daily statistical reports that enable you to view and track application download information and usage statistics downloads.
Accessing the Administration Consoles To access the Catalog Manager and Vending Manager administration consoles for the first time, use the default login ID and password that were created when you installed the Sun Java System Content Delivery Server. The default values for the Login ID and Password are admin and admin.
3. Enter your administrator name and password. 4. Click Log In. Logging in to the Vending Manager ▼ 1. Start the Vending Manager. For information on starting the Vending Manager, see the Sun Java System Content Delivery Server Installation Guide. 2.
C H A P T E R Catalog Manager This chapter describes how to administer the Catalog Manager. Following are some of the responsibilities of the Catalog Manager administrator: Managing Content ■ Accepting or rejecting content submitted by developers ■ Creating and managing categories ■...
The following content management tasks are described in this section: Managing Content Categories ■ Managing Content Types ■ Managing Submitted Content ■ Managing Published Content ■ When an operation is performed (editing, deleting, adding, and so on), the Content Deliver Server puts a background job notification in the main menu bar. You can click on the notice to see details of jobs that were or are running in the current session.
Page 33
3. Click a category to view its subcategories. The Categories page displays a list of the subcategories for the selected category. The menu bar at the top of the page displays the hierarchy level of the selected category. Chapter 2 Catalog Manager...
To return to the list of main categories, click Home in the category navigation bar. To display any level of your current category hierarchy, click the category name in the category navigation bar. 4. Click the arrow keys to move a category up or down the list to change the display order.
3. Enter a name and short description of the category. The name must be unique within the category. You cannot have two categories of the same name under the same level of hierarchy. 4. Click Add Category. The Add New Category confirmation page is displayed. Note –...
The Edit Category page is displayed. 3. Modify the name or short description as needed, and click OK. The category is updated in the database. Deleting a Category ▼ 1. From the Categories page, navigate to the category you want to delete. You can only delete categories that do not contain content.
Managing Content Types The default content types supported by the Content Delivery Server are MIDlets, ring tones, and images. You can define additional content types as needed. Each content type must be associated with one or more MIME types. MIME types specify the format of the content and enable information to be exchanged between applications.
Defining the metadata and price for all content formats is done once ■ Publishing and stocking for all content formats is done once ■ Choosing and delivering compatible content formats to subscribers is ■ automatically done for them For example, a content provider has a ring tone, Melody, to submit. The content is submitted with the ringtone content type.
Inapplicable Content Short Messaging Service (SMS) content types (monophonic ringtone, operator logo, group logo, and sms picture) are supported in the Content Delivery Server. Due to the delivery format for SMS content, DRM protection cannot be applied. The No DRM option is associated by default for all SMS content types. Remotely hosted copyrighted content also cannot have DRM associated with it.
Page 40
CDS DRM Agents (Continued) TABLE 2-2 Title Description Small Connected Supports all pricing models. Use and Time Note: To prevent runtime errors, do not use this DRM agent with Sensitive applications that perform the following actions: • Show an alert before calling the startApp method. •...
Using OMA DRM 1.0 OMA DRM 1.0 offers three different formats for applying protection, as described in TABLE 2-3 OMA DRM 1.0 Formats TABLE 2-3 DRM Type Description Forward Lock Content is delivered with basic copy protection. Content cannot be forwarded to another device.
OMA DRM 1.0 and Non-Compliant Devices For devices that are not compliant with OMA DRM 1.0, the Catalog Manager administrator can configure the Content Delivery Server with one of the following options to deliver content with a free always, first download only, or every download pricing model: Deliver all content to non-compliant devices as unprotected original content (that ■...
Associating Content Types with DRMs When assigning a DRM type to a content type, be aware that CDS DRM can only be used with MIDlets. Be aware also that SMS content types and remotely hosted copyrighted content cannot be assigned a DRM. Other than these restrictions, the choice of no DRM, CDS OMA DRM 1.0 Forward Lock, and OMA DRM 1.0 can be used with any content type.
You can assign the DRM options to the associated content types given in TABLE 2-5 but you are not restricted to those combinations, for instance, you can apply None to all content types if you wish. For steps on how to assign a DRM, see “Adding a Content Type”...
Page 45
Content Delivery Server Pricing Models TABLE 2-6 Pricing Model Definition Free always No charge for downloading content. Content can be downloaded any number of times for however long content is available. Trial No charge for content on initial download. Subscriber must purchase content for subsequent downloads.
Page 46
The Content Delivery Server supports the combinations of DRM options and pricing models as shown in TABLE 2-7 DRM Options and Pricing Models TABLE 2-7 DRM Type Pricing Model None (no DRM protection) Free always First download only Every download CDS DRM Agents Free always Trial...
Pricing Options At the same time that you select a pricing model, you have the option of creating pricing options for it. Having predefined pricing options gives you more control over the pricing of content and can make managing content easier. You can set up predefined pricing options for content providers to choose from instead of having them decide content pricing and usage terms.
Edit the pricing option ■ Create a customized price for a published content item ■ Changing the pricing of content is dependent on several factors, such as the content item status, the DRM assigned, and whether the content item is copyrighted. For a copyrighted content item, the pricing options you can choose from are dependent on the item’s content type preferences alone because copyrighted content cannot have a DRM associated with it.
has the content type picture and a pricing option of $0.75 for first download only. You determine that Roses is priced at $.50 for first download only. When you edit the content and change its price, Roses becomes disassociated from other content of type picture with that pricing option.
Content Type - The type of content that the MIME type is associated with. ■ MIME Type - The string that identifies the MIME type. ■ File Extensions - The file extensions that are associated with the MIME type. ■ ▼...
Page 51
4. Enter the following information: Content Type - Enter the name of the content type that you are adding. ■ Description - Enter a brief description of the content type. ■ Preview - Choose whether content type of this type can have a preview available ■...
5. Select a DRM. Administrators must know which DRMs are applicable for specific content types. Appendix B for a table of DRMs and associated pricing models. If an inapplicable DRM is assigned, submission of content with that DRM fails. For instance, if you erroneously assign CDS DRM Agent to the image content type and a content provider attempts to submit a content item of type image, the content provider receives an error message that the submission failed.
Pricing Options - This section addresses two items: ■ Required Pricing Options - Enables or disables content providers to set their ■ own pricing options for content. This option is only available when a pricing option is defined for the content type. Clicking the option restricts content providers to selecting the predefined pricing options you have enabled.
Page 54
The fields displayed are relevant to the selected pricing models on the previous page. If no existing pricing options exist yet for the content type, the Available Pricing Options section is not displayed. 5. Enter a unique Option ID. The Option ID identifies this specific pricing option for this content type. 6.
7. Select free usage or non-free usage or enter the number of free trials. The fields shown are dependent on the pricing models you made available for this content type when creating or editing the content type. lists and defines the TABLE 2-6 supported pricing models.
Page 56
5. Change the following fields as needed: Option ID - Unique identifier for this option. Values can consists of numbers, ■ characters, or a combination of both. Option Name - Name of option. Values can consists of numbers, characters, or a ■...
7. Click Done. 8. Click OK to close the Confirmation page. To create a custom price for an individual item of content, see “Editing Content” on page 52. To create a custom price for multiple content items at once, see “Setting Custom Prices for Published Content”...
1. From the Catalog Manager administration console, click Content on the main menu bar. 2. Click the MIME Types tab. The MIME Types page is displayed. 3. Click the content type with the pricing option you want to disable. The Content Type Preferences page is displayed. 4.
4. Enter the following information: Content Type - Select from the list the type of content with which the MIME type ■ is associated. MIME Type - Enter the string that identifies the MIME type, for example, ■ image/jpeg. Description - Enter a brief description of the MIME type. ■...
Page 60
application/java-archive ■ application/x-jam ■ When associated with other content types, the MIME types previously listed are treated as any other MIME type. To edit a MIME type, follow these steps: 1. From the Catalog Manager administration console, click Content on the main menu bar.
7. Click OK. The MIME Type Properties page is displayed. 8. Click OK to close the confirmation message. ▼ Deleting a MIME Type You cannot delete a MIME type if content with that MIME type is submitted or if a device references it.
Managing Submitted Content Developers submit content in packages that consist of their created content and XML files with support and description information. Developers submit content through the Developer portal. When content is submitted to the Catalog Manager, the Catalog Manager runs an automated validation process on the content to ensure there is no malicious content and the content matches the Catalog Manager’s supported devices.
Page 63
To view submitted content by state, follow these steps: 1. From the Catalog Manager administration console, click Content on the main menu bar. The Content Database Management page is displayed for submitted content. 2. Click the title of the state that you want to view. For example, click New to view all new content.
Page 64
The following information is displayed for each item: Title - The name of the content. ■ Developer - The name of the developer who submitted the content. ■ Categories - The categories in which the content is defined. ■ Catalog Price - The price specified by the Catalog Manager administrator. By ■...
▼ Viewing Submitted Editions The Editions Database Management page displays the total number of submitted editions, and, of that total, how many editions are in a New, Pending, or Denied state. 1. From the Catalog Manager administration console, click Content on the main menu bar.
The following information is displayed for each edition: Title - The name of the parent item with which the edition is associated. ■ Edition Name - The name of the edition. ■ Edition Description - A short description of the edition. ■...
1. From the Submitted Content page, select the status of the edition you want to disable. 2. Click the title of the content. 3. Go to the Editions section of the View Content Properties for the selected content. 4. Click on the instrumented version of the edition. 5.
▼ Changing the Status of Content You can change that status of submitted content to one of the types described in TABLE 2-9 Content Status Types TABLE 2-9 Status Definition Published Content available for use by subscribers. Pending Content requiring further review before being made available. Denied Content rejected.
Page 69
6. Click GO. The Confirm: Change Status page is displayed. You can enter a message to the developer to provide an explanation of the status of the content. 7. Click OK in the Change Status page to confirm the status change. The status of the content is updated.
▼ Changing the Status of Editions 1. From the Catalog Manager administration console, click Content on the main menu bar. The Content Database Management page is displayed for submitted content. 2. Select Edition Updates. The Editions Database Management page is displayed. 3.
Page 71
3. Click Edit from the View Content Properties page. The Edit Content page is displayed. An asterisk (*) beside a field indicates that it is a required field. This page allows you to edit the following fields: Chapter 2 Catalog Manager...
Page 72
General Information - Contains content status and any additional messages ■ displayed to the content provider. Pricing - Shows the price specified by the content provider. ■ The pricing options designated by the content provider are displayed just above the Catalog Price section. You can change the purchase price in the Catalog Price section.
Create a custom price for this content item. ■ Be aware that by creating a custom price, you are disassociating this item for its pricing option. If you need to reapply a pricing option to the content later, you can do so, however, you must select a pricing model that is compatible with the pricing model used with the custom price.
Note – If you change a content’s status from Published to another state, the content is removed from the Published Content list and is not included in the list of published categories. ▼ Viewing Published Content 1. From the Catalog Manager administration console, click Content on the main menu bar.
To view the properties for an item, click the title of the item. The View Content Properties page is displayed. If icons, documentation, or screen shots were submitted with the content, click the View button for the item to see what was submitted.
3. Navigate to the item that you want to work with. You can use the search feature or view the list of content for the category that contains the item. You can sort the display of the content items by clicking on a highlighted column title on the Browse and Search Result page.
Page 77
3. Click Copy/Move Content. The Copy/Move Content page is displayed. The default selection is Category/Categories. Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4.
Page 78
you cannot copy or move a parent category into one of its child categories. You must click the check box to select an item in the tree. See “Copying or Moving Content Items” on page 62 for more information. Note that an X indicates a selected category. A dot (.) indicates that at least one category has been selected in the column.
Page 79
6. Click Copy or Move. The Copy and Move buttons only become active when at least one selection is made in both the source and destination trees. If one category tree does not have a selection, for instance, if you clear all selections in a tree, the buttons are inactive. 7.
Page 80
The preceding figure shows the results of moving the Mobile Mail, Investment, and Accounting categories to the Business and Professional category. All content items in Mobile Mail, Investment, and Accounting were also moved. If you copy or move a category to another category and decide you no longer want that category in its new location, you can take one of the following actions: If the category is empty, that is, it contains no content items or subcategories, you ■...
▼ Copying or Moving Content Items By selecting Individual items on the Copy/Move Content page, you can select specific content items to copy or move to other categories. Note – When scheduling a copy or move operation, be aware that if large numbers of categories and content are being copied or moved, the operation can take some time to complete.
Page 82
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Click Individual Items. 5. Select the content items in one or more categories that you want to copy or move. Under the source column on the left, you can select one or more content items to copy or move but you cannot select categories.
Page 83
6. Select one or more destination categories. Under the source column on the right, the destination categories you select must be terminal categories. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree. 7.
The preceding figure shows the results of copying the content items, N_Ringer and Splash Screen to the Personal Productivity category. The content items are still available in the Mobile Mail category. If you copy a content item to a category and decide that you do not want the item in that category, you can edit the content to change the category assignment.
Page 85
For instance, if you select the Featured and Entertainment categories, you can change the purchase price for all the content in those categories or specific content items in those categories. You set a specific purchase price, apply a percentage increase or decrease, or increase or decrease the price by a set amount. Note –...
Page 86
4. Select the category or subcategories of content or specific contents. To change the purchase price of all the contents of a category, simply click the category itself. To change the purchase price of specific content items in a category, navigate through the category to select individual content items.
5. Change the purchase price in one of the following ways: Enter a new purchase price. ■ Increase or decrease the purchase amount by N per cent. ■ Increase or decrease the purchase price by a dollar amount. ■ The price is applied to all selected content regardless of their pricing models. For example, if SpruceDraw is $5.00 per monthly subscription and Launch Screen is $0.50 per download, increasing the purchase price by 10% results in SpruceDraw being offered at $5.50 per monthly subscriptions and Launch Screen at $0.55 per...
System capabilities - Capabilities primarily used by the Content Delivery Server. ■ They define capabilities that a device must have to perform Content Delivery Server functionality. For instance, system capabilities define whether a device supports Short Message Service (SMS) or Wireless Application Protocol (WAP) Push.
Device libraries are based on the Java class library. When you define a device library to the Content Delivery Server, you submit the JAR or ZIP file that contains the APIs that you want to support. ▼ Viewing Device Libraries 1.
2. When you are done viewing the properties, click OK to close the properties page. ▼ Adding a Device Library 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Libraries tab. The list of libraries is displayed. 3.
Page 91
4. Enter the following information: Name - A name for the new library. ■ Description - A brief description of the library and its contents. ■ Select JAR File - The path of the class library that you want to submit or click ■...
6. Select the items in the tree that you want to include in the library. Clear any items that you do not want to include. To select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package. 7.
5. Make the necessary changes. You can edit only the name and description of a library that is in use. A library is in use if it is assigned to a device or a Developer Profile. 6. Click OK. A confirmation page is displayed. 7.
Page 94
The Content Delivery Server provides descriptor templates for Content Object Descriptor (COD) and General Content Descriptor (GCD). You can define other templates as needed. shows the Content Delivery Server content attributes that you can use to TABLE 2-11 customize the template for your needs. Content Attributes for Content Descriptor Templates TABLE 2-11 Attribute...
▼ Adding a Content Descriptor Template 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Templates tab to display the list of templates. 3. Click New Template. The Content Descriptor Template Definition page is displayed. 4.
▼ Editing a Content Descriptor Template 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Templates tab. The list of templates is displayed. 3. Click the name of the template that you want to edit. The template properties are displayed.
Page 98
The following information is displayed for each device. Model Name - The name of the device model. ■ Model Number - The model number of the device. ■ Manufacturer - The name of the company that manufactured the device. ■ User-agent - The unique identifier for the device.
Quarantined - An auto-provisioned device whose capabilities are not ■ completely known and is unavailable to subscribers. Developers cannot submit content to quarantined devices. Determine the device’s capabilities before changing its status. Change the status of a device from Quarantined to Active by clicking the Activate button on the selected quarantined device’s Device View page.
Page 100
2. Specify the following fields: Name - The name of the device. ■ Description - A description of the device. ■ Manufacturer - The name of the manufacturer. ■ Manufacturer Number - The number of the manufacturer. ■ User-agent - The unique identifier for the device. The user-agent is a regular ■...
Page 101
pattern, SAMSUNG-SGH-E700.*, matches it. The expressions, SAMSUNG-SGH- E700 and .*SAMSUNG-SGH-E700, do not match as they only partially match the user-agent coming from the device. Supported Libraries - The libraries that the device supports. Libraries define the ■ API sets supported by the device. To select multiple libraries, hold the Control key down and click the libraries with the left mouse button.
▼ Specifying Device Capabilities 1. From the Device Management page, click the device name to select it. The properties page for the device is displayed. 2. Click Edit. The Device Management page for editing device capabilities is displayed. An asterisk (*) beside a field indicates that it is a required field. Administrator Guide •...
Page 103
If the Edit button is not available, wait a few minutes for the previous edit request to complete before attempting to make more changes. When you change the capabilities of a device, the capability matching process is run to update the list of content that matches the device.
5. Click OK. The Device Management page is displayed that shows the list of devices. ▼ Activating New or Quarantined Devices When you are sure a newly detected device is capable of supporting content, you can make that device available to developers and subscribers by changing its status from New or Quarantined to Active.
Page 105
Identify other MIME types that are accepted as alternatives to the selected MIME ■ type. Indicate the extension associated with the MIME type. ■ Indicate whether the device supports one step or two step download for that ■ MIME type, and indicate if the device supports Multimedia Message Service (MMS).
Page 106
If the Manage MIME Types button is not available, wait a few minutes for the previous edit request to complete before attempting to make more changes. When you change the MIME types supported by a device, the capability matching process is run to update the list of content that matches the device.
a. Alternative MIME types to be handled as if they were the MIME type supported for the device. For example, if the device supports ZIP files with the MIME type application/zip, you can specify application/x-compressed as an alternative MIME type. Content that specifies either MIME type is passed to the device with application/zip specified in the content header.
4. Click OK to save your changes. 5. Click OK in the confirmation page. Note – When a new version of an existing device becomes available, you can add it to the list of devices and designate the previous version of the device as compatible to it.
3. Click Modify This Device. A confirmation dialog box asks you to confirm that you want to update the device. 4. Click OK. The Device Management page is displayed that shows the capabilities of the device. 5. Click OK. The Device Management page is displayed that shows the list of devices. ▼...
The device is now set as the default device in the database. All new Subscriber Accounts will be assigned this device as a default upon creation. ▼ Deleting a Device You cannot delete the default device. You also cannot delete a device that a subscriber account references.
4. Click Import. The device is listed on the Device Management page. Unless the Quarantine option was selected, the device has a status of Active. Exporting Devices ▼ To export a device, that is to create a device definition file (in .xml format) for an existing device: 1.
Page 112
3. Enter the language code, the country code, and the name of the language in the empty row for the new locale. A locale code is comprised of the language code and the country code separated by a dash (-), for example, en-US is the locale designation for English, United States while en-AU is the designation for English, Australia.
▼ Changing a Locale To edit or update a locale or locale information, follow these steps: 1. Select the value for the locale you want to change and enter the new value. For instance, to change the English to Australian English, replace the Country Code with AU and replace the Description with Australian or Australian English.
The Catalog Manager does not administer subscriber accounts; these are administered through the Vending Manager. See “Managing Subscriber Accounts” on page 209 for more information. describes the purpose each account type serves: TABLE 2-12 Account Types TABLE 2-12 Account Type Description Vending Manager A Vending Manager account is for a specifically branded Vending...
Page 115
2. Click Developers or Administrators. The list of defined Developer or Administrator accounts is displayed. Each account type has its own page or view. describes the operations you TABLE 2-13 can perform on any of the three views. Search and Display Operations TABLE 2-13 Operation Implementation...
Managing Vending Manager Accounts Vending Manager accounts define the Vending Managers to which the Catalog Manager publishes content. Because a single Catalog Manager can serve multiple Vending Managers, you can have many Vending Manager accounts. Each Vending Manager account must be assigned to one or more vending plans. Vending Managers are generally configured to serve separate enterprises, so each account generally has a specific Vending Plan.
Page 117
3. Enter the required information. An asterisk (*) beside a field indicates that it is a required field. Account ID - Specify a unique designation for the account. The Account ID is ■ automatically converted to lowercase. The ID can contain a combination of characters and numbers.
Select the radio button to specify whether the URI contains a domain name or IP address. Use the format hostname:port for domain names. Use the format xxx.xxx.xxx.xxx:port for IP addresses. To avoid data inconsistency or notification failure, ensure that the Network ID specified is a valid address.
3. Click Edit. The Edit Account Details page displays the same fields as those described in “Adding a Vending Manager Account” on page 4. Modify the fields as required, then click OK. A confirmation page asks whether you want to save the changes. 5.
4. Click OK. The account is deleted and it is removed from any vending plan with which it was associated. Managing Developer Accounts Developer accounts are for corporations or individuals that submit content to the Catalog Manager. Each developer is associated with one or more Developer plans. Before you begin creating a Developer account, you might want to ensure an appropriate Developer plan exists that you can assign to the account.
Page 121
3. Enter the required information. An asterisk (*) beside a field indicates that it is a required field. Login ID - Specify the Login ID, which must be unique. The Login ID is ■ automatically converted to lowercase. Password - Enter a password. ■...
6. Click OK again to close the confirmation message. ▼ Editing a Developer Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Developers. The Accounts page displays a list of Developer accounts. 2. Click the Developer account you want to modify. The Developer Account Details page is displayed.
4. Modify the fields as required, then click OK. A confirmation page is displayed asking whether you want to save the changes. ▼ Deleting a Developer Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Developer.
▼ Adding a Catalog Manager Administrator Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Administrators. The Accounts page displays a list of Administrator accounts. 2. Click Add New Account. The Add New Administrator page is displayed. 3.
4. Click OK to add the Administrator account. A confirmation message asks you to confirm you want to add the account. 5. Click OK to confirm the addition. 6. Click OK to close the confirmation message. ▼ Editing a Catalog Manager Administrator Account 1.
Managing Plans Vending Manager and Developer accounts are assigned to plans. The Catalog Manager uses plans to control content submission for developers and content access for Vending Managers. describes the two types of plans used by the TABLE 2-14 Catalog Manager. Plan Types TABLE 2-14 Plan Type...
2. Click a Vending plan name to view the properties of the plan. The Vending Plan Properties page displays the properties of the plan. From this page you can edit, delete, add, or remove members from the Vending plan. ▼ Adding a Vending Plan 1.
3. Enter the name of the plan and a short description of the plan. 4. Select any existing plans that are to be included in this plan. 5. Specify the categories you want to offer to the Vending Managers that are assigned to this plan.
Page 129
To edit a Vending plan, follow these steps: 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default. 2. Click the plan that you want to modify. The Vending Plans Management page is displayed. 3.
4. Modify the fields as required, then click OK. The Properties page appears displaying the changed information. 5. Click OK. The Vending Plan is updated in the database. ▼ Viewing Vending Plan Members Members are the Vending Manager accounts assigned to a vending plan. You can add and remove members from a Vending plan.
2. Click the plan you want to view. The Vending Plan Management page is displayed. 3. Click the Members tab. The list of Vending Manager accounts associated with the Vending plan is displayed. 4. Click Add. A list of Vending Manager accounts is displayed. Vending Manager accounts that are already assigned to the account are not displayed.
3. Select the plan that you want to set as the default. 4. Click OK. The default plan is assigned to all new Vending Manager accounts until a new Vending plan is assigned. ▼ Deleting a Vending Plan 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default.
Managing Developer Plans Developer plans define the set of APIs that developers can use in applications that they submit. Profiles define the classes in a specific library that developers can use. A Developer plan contains one or more profiles. The Content Delivery Server provides a default Developer plan. You can customize this default Developer plan for your needs, or you can assign a different plan as the default.
4. Click a profile name. The Profile Definition page is displayed. ▼ Adding a Profile 1. From the Catalog Manager administration, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3.
Page 135
4. Provide the information requested. Name - Enter a name for the profile. ■ Description - Enter a description of the profile. ■ Select Library - Select the library that you want to include. ■ 5. Click Next. The second page for defining a profile is displayed. Chapter 2 Catalog Manager...
6. Select the items from the library that you want this profile to support. To select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package. 7. Click Finish. The new profile is added to the database. 8.
5. Click Edit. The edit page displays the same fields as those described in “Adding a Profile” on page 115. 6. Modify the profile as required and click OK. 7. Click OK to close the Confirmation page. The Properties page for the profile is displayed. 8.
6. Click OK. The profile is deleted from the database and from any developer plans in which it was included. 7. Click OK to close the confirmation message. ▼ Viewing Developer Plans 1. From the Catalog Manager administration console, click Plans in the main menu bar.
4. Specify a name and description for the Developer plan and select the profiles to be included in this plan. 5. Click OK to save the new Developer plan. A confirmation message is displayed. 6. Click OK to close the confirmation message. You can now add Developer accounts to the plan.
4. Click the Developer plan that you want to modify. The Developer Plan Definition page is displayed. 5. Click Edit. The Developer Plan Definition page displays the same fields as those described in “Adding a Developer Plan” on page 119. 6.
4. Click the Developer plan that you want to view. The Developer Plan Definition page is displayed. 5. Click the Developer Licensees tab. The list of Developer accounts associated with the Developer plan is displayed. ▼ Adding a Developer Licensee to a Developer Plan 1.
8. Click Add. The Developer accounts are added as licensees of the Developer plan. 9. Click OK to confirm the addition. ▼ Removing a Developer Licensee from a Developer Plan 1. From the Catalog Manager administration console, click Plans in the main menu bar.
4. Select the plan that you want to set as the default. 5. Click OK. The default plan is automatically assigned to new Developer accounts until alternative assignments are made. ▼ Deleting a Developer Plan Before you delete a Developer plan, you might want to review the Developer accounts that are associated with the plan.
6. Click OK to close the confirmation message. The Developer plan is deleted from the database, and the plan is deleted from the Developer accounts to which it was assigned. If a Developer account is not assigned to any other Developer plan, the default Developer plan is assigned. Getting Background Job Status The time it takes for an operation or job such as changing status or editing device characteristics, to complete can vary greatly.
▼ Getting Job Status ● Click on the Background Jobs notice in the main menu bar. The Background jobs listing pages lists the completed, pending, and failed background jobs. The following information for each job is available: The job number, which is a unique ID automatically assigned to the job at the ■...
To clear the listing of successfully completed jobs, click Clean completed. Only pending jobs and failed jobs remain in the list. Pending job status changes when the job successfully completes or fails. Clear the jobs listings regularly to reduce memory usage and to make it easier to review the most recent jobs. Clicking OK leaves the job listings as is and displays the list of submitted contents.
If a job has no additional information, the Detailed Information section states that no other information is available. Clearing a Failed Job Failed jobs remain on the jobs listing page until they are manually cleared. You can do this in the following ways: Click Delete this job to remove the job from the list.
C H A P T E R Vending Manager This chapter describes the tasks for administering the Vending Manager. There are two administration roles: Administrator and Customer Care agent. The role is assigned when the Administrator account is created. Only Vending Manager administrators can perform the following tasks: Managing Categories ■...
Resetting trials ■ Issuing refunds ■ Managing Subscriber Plans ■ Creating and managing Subscriber plans Viewing Reports ■ Viewing statistical data Customer Care Agents can also edit their own accounts. They cannot edit other Administrator accounts. Administrator Tasks As a Vending Manager administrator, you are responsible for administering all features of the Vending Manager.
Page 150
2. From the Stocked Content tab, click Manage Categories. The Catalog Management page is displayed showing the Vending Manager Categories. 3. If you want to create a main category, go to Step If you want to define a subcategory of an existing category, click the category name and then proceed to Step For example, if you want to create a category that is a subcategory of “Business and...
Note – The maximum number of category levels that can be added in a session is set in the CommonConsole.properties file in the $CDS_HOME/deployment/deployment_name/conf/ directory. The default number of levels of categories is set to 10. That is, top-level and sublevel categories can be created but sub-sublevel categories cannot.
4. If you want to edit a main category, go to Step 5, otherwise, click the category name to navigate to the subcategory you want to edit. For example, if you want to edit the Legal subcategory of the Business and Professional category, click Business and Professional.
3. Click the delete category button for the category that you want to delete. The category and all its subcategories are deleted and are removed from all plans and content with which they are associated. To delete a subcategory, click the category name to display its list of subcategories. For example, to delete the Small Business subcategory of the Business and Professional category, click Business and Professional.
Page 154
3. See a list of content by following one of these steps: a. Click a category name that has no subcategories to see the list of content in that category. b. Expand a category with subcategories by clicking the category name, then click the subcategory name to see its content list.
Page 155
The following information is displayed for each item. Click the Status, the Title, or the Type column title to sort content by that information type. Status - Provides a graphical indication of whether or not the item is stocked and ■...
Title - Displays the title of the content in the catalog. ■ Catalog Price - Displays the amount that the Vending Manager has to pay the ■ Catalog Manager for every sale they make to a subscriber. Categories - Displays the multiple categories (and their complete paths) that are ■...
Page 157
General Information - Indicates whether the content is stocked, or if an update to ■ the property information associated with the item is available. The following items appear on this page: If the content is not stocked, a Stock Content button is displayed at the top of ■...
Catalog Description - A description of the content. If icons, documentation, or ■ screen shots were submitted with the content, click the View button for the item to see what was submitted. If the item is a ring tone and a preview was submitted, click the Listen button to hear the preview.
Page 159
The following information is shown for each edition: Edition ID ■ Name ■ Version ■ Edition Type ■ Original Edition ■ Modified Date ■ The Edition Type, Original, indicates the initally submitted content, while Final indicates the actual content that is delivered to subscribers. If the content item has OMA DRM protection, a Trial type indicates a content item that is delivered to subscribers for trial usage.
6. When you are done viewing the Edition Properties, click OK. If no devices are listed in both the Supported Devices and Matched Devices fields, the Catalog Manager administrator made the edition unavailable to subscribers. Setting Stocking Options From the Catalog tab, you can specify stocking options. The current status of the stocking options is displayed after the title of the tab.
To enable auto-stocking, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Catalog tab if it is not the active tab. 3. Click Stocking Options. The Stocking Options page is displayed. 4.
Page 162
To stock content, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Catalog tab if it is not the active tab. The Content Management page displays a list of the main categories. 3.
Keyword - You can create a unique keyword to identify this content item. This ■ keyword is used by subscribers when ordering content. Keywords are used when content is requested through mobile originated (MO) push. Keywords can contain spaces, underscores, and dashes, but cannot contain special characters, such as an asterisk (*).
Page 164
Note – When scheduling a stocking operation, be aware that if large numbers of content are being stocked, the operation can take some time to complete. 1. From the Vending Manager administration console, click Catalog on the main menu bar. 2.
Page 165
An asterisk (*) beside a field indicates that it is a required field. Only unstocked content items are selectable. Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 3.
Page 166
4. Select one or more destination categories under the Vending Categories column. Under the Vending Manager categories column on the right, you can select one or more terminal categories in which you want the content to be stocked. A terminal category is the lowest level category and contains only content items.
Page 167
6. Click Stock. Click Clear to remove all selections in both trees and reselect categories and content items. Clicking the Cancel button clears all selections and displays the top-level Catalog page. 7. Confirm or cancel the operation. The Stocking Job Status page appears. 8.
To stop a stocking job from this page, see the next section. Viewing Stocking Jobs At the bottom of the Stock Content page, you can see a list of executing, pending, and failed stocking jobs: The following information is shown for each job: ID - Content ID ■...
▼ Stopping a Stocking Job You can stop a stocking job with an Executing or Pending status from the Stocking Jobs Status page or the Stocking Jobs section of the Stock Content page. 1. From the Stocking Job Status page, click Stop. 2.
Checking the Status of a Stocking Job You can check on the status of a stocking job in one of the following ways: Click Stock to see the status of the current stocking job. ■ Click on a job ID in the Stocking Jobs list to check the status of a specific stocking ■...
Pending - Number of items that are pending is displayed in the header bar ■ above the columns. Stopped - Number of items that are stocked, failed to stock, or not stocked ■ when the job was stopped is displayed in the header bar above the columns. Content Tile - Name of the content item ■...
6. Click OK. The View Content Properties page is displayed showing the updated information. Pricing for Content for a Locale Vending Managers can be widely distributed geographically. In such cases, multiple currencies are involved in pricing content. The system administrator configures the currencies and initial price equivalents for a Vending Manager’s locale.
Page 173
The page displays the following information: General Pricing Rule set by the system administrator at deployment. ■ List of content types. Click the column head to sort the list alphabetically. ■ List of option IDs associated with a content type. Click the column head to sort ■...
3. Enter the value for your local currency equal to the one currency unit. If the one currency unit is one Euro and your local currency is Yen, enter the current equivalent value in Yen. 4. Enter the percentage markup by which you want to increase the purchase price, if desired.
1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab. 3. Click View by Title to list all content. 4. Click the content name to go to the content’s property page. 5.
3. Enter the search term in the Search field. 4. Select the category that you want to search from the Category drop-down list. 5. Select the status of the content from the Status drop-down list. 6. Click Search. The Stocked Content page shows a list of stocked content that meets the search criteria that you specified.
1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Stocked Content tab if it is not the active tab. 3. Navigate to the item with which you want to work. You can use the search feature or view the list of content for the category that contains the item.
▼ Editing Stocked Content 1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Stocked Content tab if it is not the active tab. 3. Navigate to the stocked item that you want to edit. You can use the search feature or view the list of content for the category that contains the item.
Page 179
You can edit the following fields: Status - Content can be active (available to subscribers) or inactive (unavailable to ■ subscribers). Vending Price - Purchase price for the content item charged to the subscriber. ■ The Catalog Price shows the pricing option for the content item in the Catalog Manager.
Enter the External Group ID that your billing system uses to identify this ■ content or select it from the list provided. This field can be blank if your system does not use group IDs. Categories - The categories to which the content is assigned. ■...
4. Select the items that you want to edit. 5. Click Edit External ID. The Edit External Content page is displayed. 6. Select the items that you want to change. 7. Enter or select the external content ID and external group ID in the fields for an item to change individual items.
▼ Copying or Moving Categories of Content You can move or copy whole categories of content at a single time in the Vending Manager. By copying or moving one or more categories, you are copying or moving all the content items within those categories. Note –...
Page 183
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Select the categories you want to copy or move. Under the source column on the left, select one or more categories to copy or move. If you select a higher level category, all of its subcategories, including their content items, are also copied or moved.
Page 184
5. Select one or more destination categories. Under the destination column on the right, you can select one or more higher levelcategories. The destination category you select cannot be a terminal category. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree.
Page 185
7. Confirm or cancel the operation. If copied, categories and their associated content are duplicated under each destination category. If moved, categories and their content are removed from the original location and placed in the destination category. If more than one destination category is selected, categories and content are duplicated under each destination category.
If the category is empty, that is, it contains no content items or subcategories, you ■ can delete the category from its new location. See “Deleting a Category” on page 133 for more information. If the category is not empty, you must remove its subcategories and content items ■...
Page 187
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Click Individual Items. 5. Select the content items of content in one or more categories that you want to copy or move.
Page 188
6. Select one or more destination categories. Under the source column on the right, the destination categories you select must be terminal categories. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree. 7.
The preceding figure shows the results of copying the content items, SpruceClock and Technopop to the Mobile Mail and Instant Messages categories. The content items are still available in the Featured category. If you copy a content item to a category and decide that you do not want the item in that category, you can edit the content to change the category assignment.
Page 190
changing the price in this manner, dissociates the selected content items from their pricing options. See “Disassociating Content From Pricing Options” on page 30 more information. Note – Customizing content pricing has no Undo operation. Before enacting any changes, be sure to review the changes to ensure that the correct changes apply only to the intended contents.
Page 191
4. Select the category or subcategories of content or specific contents. To change the purchase price of all the contents of a category, simply click the category itself. To change the purchase price of specific content items in a category, navigate through the category to select individual content items.
6. Change the purchase price in one of the following ways: Enter a new purchase price. ■ Increase or decrease the purchase amount by N per cent. ■ Increase or decrease the purchase price by a dollar amount. ■ The price is applied to all selected content regardless of their pricing models. For example, if SpruceDraw is $5.00 per monthly subscription and Launch Screen is $0.50 per download, increasing the purchase price by 10% results in SpruceDraw being offered at $5.50 per monthly subscriptions and Launch Screen at $0.55 per...
If the Vending Manager’s Auto-stocking option is turned on, the content is ■ immediately reactivated. The bundle’s property page shows a status of Active for the content and the content is available to subscribers again. If the Auto-stocking option is turned off, you must restock the content in the ■...
Per interval - After initial download, the subscriber is not is not charged for using ■ this content item for the stated time interval. Subscriber cannot purchase this item again as it is only offered for a specific time. Per subscription - No content items with this pricing model are allowed in a ■...
Page 195
3. Click Create Bundle. The Create Bundle page is displayed. Administrator Guide • 2005Q4...
Page 196
An asterisk (*) beside a field indicates that it is a required field. 4. Specify the following information: General Information ■ Status - Select whether the bundle is active or inactive to subscribers. Items ■ within a bundle cannot be inactivated. To inactive an item, it must first be removed from the bundle.
Page 197
Bundle Price ■ Provide the bundle at no charge to the subscriber for the content. ■ Set the bundle purchase price. ■ Bundle price overrides the pricing assigned to individual content items for first download. The pricing models for individual content items still apply. External Content ID ■...
▼ Viewing Bundle Information 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3. Click View by Title. The Browse Vending Content By Title page is displayed. For each bundle in the list, its status, title, content ID, retail price, and vending categories are displayed.
Page 199
Note – If the status of a content item that is part of a bundle is changed to Inactive or Unpublished by the Catalog Administrator, the content is removed from the bundle and is not available to subscribers who purchase the bundle after the status change.
▼ Deleting a Bundle 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3. Click View By Title. 4. Select the check box for the desired bundle in the list. 5.
6. Select the items that you want to change. 7. Enter a value or select the External Content ID or the External Group ID in the for each selected bundle. To change all selected items to the same external content ID, select Content IDs and enter a value or select the value to be assigned to all items.
▼ Editing a Bundle You can modify a bundle by changing its status, contents, retail price, and so on. To edit a bundle, follow these steps: 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3.
Stocking Testing Content ▼ If the auto-stocking option is set to OFF, you can manually stock content items with Testing status to make them available to subscribers with testing roles. 1. Click Content on the Vending Manager administration console’s main menu. 2.
▼ Creating a Campaign The Content Download Server provides a wizard to help you define a marketing campaign. The wizard leads you through the steps of specifying the campaign type, the target audience, the marketing message, content and pricing details, and scheduling and duration.
▼ Specifying Campaign Options and Target Audience The Campaign Options page lets you define the name and description of the campaign, and the market segment that receives it. You can also assign a coupon to the campaign. If you are creating an event-driven campaign, you can define the event that triggers the campaign.
3. Choose the Subscriber Segment from the drop-down list. The Subscriber Segment is the target audience for the campaign. The list contains all of the subscriber segments that are currently defined. See “Creating a Subscriber Segment” on page 195 for more information. Only subscribers who selected the option of “Notify me for update or promotions”...
1. Enter the subject of the advertisement. This string is also used as the subject line for advertisements sent as email. Note that though you can enter as much text you like in the Subject and Text fields, a character limit might apply when sending the message depending on the template that might be applied to it (for example, SMS).
To specify content for a campaign, follow these steps: 1. Set the content in one of the following ways: a. Click All Active Content. This action enables all currently valid content, including newly stocked content, to be included in existing campaigns. b.
To specify pricing characteristics for a campaign, follow these steps: 1. Select the Discount on Items check box and enter a value by which the price of the item is to be discounted. 2. Set a duration for the discount offer: Offer valid for - Enter the number of days for which the offer is valid.
To create a schedule for a campaign, follow these steps: 1. Set up the campaign schedule. Choose one of the following schedules: Process and send the message immediately. ■ Defer processing, in which case, enter the time and date when the message is to ■...
Page 211
This page enables you to review the information for your advertisement. To view the items that are included in the campaign, click View List in the ■ Promotional Content section. To view the subscribers to whom the advertisement is sent, click View List in the ■...
To see the format of the message that is sent to the subscribers, click Preview in ■ the Promotional Message section. The format is determined by the notification template set up by your system administrator. See “Working with Campaign Templates” on page 197 for more information.
Working with Subscriber Segments A subscriber segment defines the criteria for separating subscribers into groups. The Subscriber Segment List page displays the current list of subscriber segments, a short description of each segment, and an estimated number of subscribers. The number of subscribers is only an estimate because some segments need to know the content list to determine whether a subscriber matches a criterion.
▼ Displaying Subscriber Segments 1. Click Campaigns in the Vending Manager administration console menu bar. The Campaign List page is displayed. 2. Click the Segments tab in the Campaign List page. The Subscriber Segments page is displayed. ▼ Creating a Subscriber Segment 1.
Page 215
3. Specify the following information: Enter a name and description for the subscriber segment. ■ The name must be unique to other segment names and it must not exceed 255 characters. Select the check box if a subscriber must match all of the specified criteria in this ■...
The subscriber plan to which the subscriber belongs. ■ The device a subscriber uses. ■ ▼ Editing a Subscriber Segment 1. Open the Subscriber Segment List page. “Displaying Subscriber Segments” on page 195 for more information. 2. Click a subscriber segment name or description. The Segment Details page is displayed.
Page 217
You can write code that presents the same general format for the message but allows for variations suitable for each delivery method. If you define a style sheet for MMS, specify the name of the MMS message to which it applies. 4.
Page 218
Properties Available for Notification Templates (Continued) TABLE 3-2 Property1 Definition Campaign ID The email subject line. Subject The defined coupon code. Coupon The message that the administrator wants to Message include in the notification. The URL the subscriber should use to CampaignURL purchase from the campaign.
Page 219
Properties Available for Notification Templates (Continued) TABLE 3-2 Property1 Definition The version of the item. ContentItem/ConfigurationVersion For MIDlets and iAppli applications only. The API set used in the application. ContentItem/ProfileVersion For MIDlets and iAppli applications only. The name of the iAppli application file. ContentItem/Classname For iAppli applications only.
▼ Editing a Campaign Template 1. Open the Campaign Templates page. “Displaying Available Campaign Templates” on page 197 for more information. 2. Click the name or description of the template you want to edit. 3. Edit the values in the Campaign Template Details page. 4.
3. To view an individual Administrator Account, click the administrator name. If you are a Customer Care Agent, you can view your own account by clicking the My Account tab on the Account Management page. The Administrator Account Details page is displayed. From here you can edit or delete an Administrator Account.
Page 222
Complete the following fields: Login ID - Enter the Login ID the administrator uses to access the Vending ■ Manager. It must be unique and at least three characters. Password - Enter a password of at least four characters. ■ Confirm Password - Reenter the password.
▼ Editing a Vending Manager Administrator Account To edit all Administrator Accounts, you must be an administrator. Customer Care Agents can edit only their own account. To edit an Administrator Account, follow these steps: 1. From the Vending Manager administration console, click Accounts on the main menu bar.
5. Modify the information as required. 6. Click OK. The Edit Administrator confirmation page is displayed. 7. Click OK again to close the confirmation message. The Administrator Account is updated in the database. ▼ Deleting a Vending Manager Administrator Account 1.
Viewing Stocked Content ▼ 1. From the Vending Manager administration console, click Content on the main menu bar. The Stocked Content page displays a list of the main categories defined. A number beside each category indicates the number of stocked items. 2.
Note – The Edit External ID button appears only if your billing system requires something other than the Content Delivery Server content ID to identify the content. The following information is displayed for each item: Status - The status of the item. It can have the following values: ■...
To set the display of stocked content, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab if it is not the active tab. The Vending Preferences page is displayed. 3.
▼ Viewing Editions of Stocked Content 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab if it is not the active tab. The Content Management page displays a list of the main categories defined. 3.
▼ Viewing Subscriber Accounts 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Subscribers tab. The list of Subscriber accounts is displayed. If no device is specified to be used, the Device field is blank. 3.
Page 230
3. Click Add New Subscriber. The Add New Subscriber page is displayed. 4. Enter the required information: An asterisk (*) beside a field indicates that it is a required field. Login ID - Enter the unique subscriber ID that the subscriber uses to log in to the ■...
Subscriber’s role - Select Test subscriber for a subscriber who is testing content ■ only. Select Regular subscriber for a subscriber who is accessing published content. Contact Information - Specify contact information for the subscriber. ■ Complete the other fields on the page as desired. 5.
5. Modify the information as required, then click OK. The Edit Subscriber confirmation page is displayed. 6. Click OK again to close the Confirmation page. The Subscriber account Is updated in the database. ▼ Viewing a Subscriber ’s Download History To view the list of content that a subscriber has downloaded, follow these steps: 1.
3. Click the Login ID for the subscriber account with which you want to work. The Subscriber Account page is displayed. 4. Click Content List. The list of content that the subscriber has downloaded is displayed. 5. Click Edit License for the content with which you want to work. 6.
▼ Issuing a Refund 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Subscribers tab. The list of Subscriber accounts is displayed. 3. Click the login ID for the subscriber that you want to work with. The Subscriber Account Details page is displayed.
Managing Subscriber Plans Subscriber accounts are assigned to Subscriber plans. Subscriber plans determine which content a subscriber can access and download. A Subscriber plan is mapped to selected categories in the Vending Manager. The content in the selected categories is made available to plan members. If content is in a category that is not supported by the Subscriber plan, the subscriber cannot access it for download.
Parent plan information. Parent plans are listed alphabetically (includes the name ■ of the plan, any subplans it contains, and a description of the plan). The category paths. All category paths associated with the plan are listed in the ■ order in which they appear in the Vending Manager Category.
3. Enter the following information Specify a name and description of the plan. ■ Check the plans to be included within the plan. ■ Select the categories you want to offer to subscribers that are assigned to this ■ plan. Content stocked in these categories is made available to the subscribers assigned to this plan.
3. Click Edit. The Subscriber Plan Management page displays the same fields as those described in “Adding a Subscriber Plan” on page 217 4. Modify the plan as required, then click OK. The plan is updated in the database. 5. Click OK. The list of subscriber plans is displayed.
1. From the Vending Manager administration console, click Plans on the main menu bar. The Subscriber Plan Management page displays all the Subscriber plans defined. 2. Click the plan whose list of members you want to see. The Subscriber Plan Management page for the selected plan is displayed. 3.
▼ Removing Members from a Subscriber Plan 1. From the Vending Manager administration console, click Plans on the main menu bar. The Subscriber Plan Management page displays all defined Subscriber plans. 2. Click the Subscriber Plan name to view the properties of a Subscriber plan. The Subscriber Plan Properties page is displayed.
3. Check the plan you require, then click OK. The default plan is automatically assigned to new Subscriber accounts until alternative plan assignments are made. ▼ Deleting a Subscriber Plan Before you delete a plan, you might want to review the Subscriber accounts that are assigned to the plan.
Editing Your Administrator Account ▼ This function is available only to Customer Care Agents. Vending Manager administrators edit their account the same way that they edit the account of another Vending Manager administrator. See “Editing a Vending Manager Administrator Account” on page 204.
Page 243
2. Select a content type from the Select Content Type drop-down list to display reports for other content types. Reports display the following information: Application Download Reporting - The number of downloads and applications: ■ Total Downloads - The total number of downloads for the application type. ■...
Sending MMS Messages The Vending Manager’s MMS feature lets you send messages containing video, image, and audio files. This section covers the following actions: Choosing MMS as the Content Delivery System ■ Displaying MMS Messages ■ Creating an MMS Message ■...
Creating an MMS Message ▼ 1. Click MMS in the main menu of the Vending Manager administration console. 2. Click New MMS Message. The MMS wizard opens and the Edit MMS page is displayed. 3. Enter a name for the message and the message text. A maximum of 256 characters are allowed for the message text.
Page 246
5. Select one or more device types in the table. The device type table lists the MMS-capable devices from your chosen list of supported devices. The table has navigation buttons that enables you to display additional device entries. 6. Click Next to proceed. 7.
11. Click Save to save the MMS message to the server. Alternatively, you can click Save and Test to save the message and to perform a test send. See “Testing a New MMS Message” on page 229 for more Information. 12.
4. Click Save to save the MMS message to the server or Save and Test to save the message and to perform a test send. “Testing an MMS Message” on page 229 for more information. 5. Click OK to close the Confirmation page. Testing an MMS Message ▼...
Test status is either Passed, Failed, or Not Tested. Enter any comments regarding the test in the Comments field. 6. Click Save. “Using the MMS Test Log” on page 231 for more information. ▼ Testing an Existing MMS Message To perform a test send of an existing MMS message, follow these steps: 1.
Select the check box next to the messages you want to delete ■ Choose All from the drop-down list ■ 3. Click Delete. 4. Click OK to close the confirmation dialog box. Using the MMS Test Log ▼ The MMS Test Log enables you to record the results of sending a test MMS message for a particular device.
A P P E N D I X Device Capabilities This appendix describes the device capabilities that you can specify for the devices that you use with the Sun Java System Content Delivery Server. It also provides a sample specification for a common device. See “Managing Devices”...
Mandatory Capabilities Mandatory capabilities are capabilities that must be specified for a device to accept MIDlet applications. lists the mandatory capabilities for devices used with TABLE A-1 the Content Delivery Server. Mandatory Capabilities TABLE A-1 Name Type Description Example Value MicroEdition- String Software Platform specific: Connected...
Browser Capabilities Browser capability refers to the browser type specified for a device. A string value specifying the browser that is rendering markup on the device is given. For example, Browser Type can have one of the following values: ■ WML-1_2 XHTML-NokiaSeries40 ■...
User Interface and Software Capabilities (Continued) TABLE A-3 Name Type Description Example Value Confirm Boolean Software platform-specific: Yes or No Capable Confirm Capable Defines whether or not the device sends a confirmation (MIDlet-Install-Notify) after a MIDlet is installed. Delivery Type List Software platform-specific: Delivery Type...
List A list value can contain one or more values. To select multiple values from the list provided, hold the Control key while clicking on each item that you want to include. Each value is shown on a separate line when the items are displayed as a string. For example, Supported Libraries takes a list value that can be either DOJA-1.0, MIDP- 1.0, or MIDP-2.0.
Nokia 6310i shows the specifications for the Nokia 6310i device. TABLE A-4 Nokia 6310i Device Specifications TABLE A-4 Capability Value Browser Type WML-1_2 Bits Per Pixel Ccpp Accept Language en_US Ccpp Accept String application/java-archive image/gif image/vnd.wap.wbmp text/plain text/vnd.sun.j2me.app-descriptor Color Capable Confirm Capable Delivery Type Image Capable...
User-Defined Devices The following blank tables are provided for you so you can enter information for the devices that you add to the Content Delivery Server. Device Specifications for a User-Defined Device 1 TABLE A-5 Capability Value Browser Type Bits Per Pixel Ccpp Accept String Ccpp Accept Language MicroEdition-Configuration...
Page 259
Device Specifications for a User-Defined Device 2 (Continued) TABLE A-6 Capability Value Color Capable Confirm Capable Delivery Type Image Capable Input CharSet Maximum Application Size MicroEdition-Profile Number of softkeys Output CharSet Push Type Screen Height Screen Width Administration Guide • 2005Q4...
Page 260
A P P E N D I X Content Pricing Content types are assigned a DRM type in the Catalog Manager along with the possible pricing models that can be used for that content type. lists the TABLE B-1 possible pricing models that can be used for content types with the corresponding DRM types: Associated DRMs, Content Types, and Pricing Models TABLE B-1...
Page 261
Associated DRMs, Content Types, and Pricing Models (Continued) TABLE B-1 DRM Type DRM Agent or Format Content Type Pricing Model CDS DRM Disconnected Time Sensitive Free always midlet Agents First download only Every download Per period Per subscription Disconnected Use Sensitive Free always midlet Trial...
Associated DRMs, Content Types, and Pricing Models (Continued) TABLE B-1 DRM Type DRM Agent or Format Content Type Pricing Model CDS OMA DRM 1.0 Free always ringtone Forward Lock image First download only midlet Every download iappli video OMA DRM 1.0 Forward Lock Free always ringtone...
Page 263
Initial purchase price for Item 1 and Item 2 are shown as they exist in the Catalog Manager and the Vending Manager. The currency type is the same for both the Catalog Manager and Vending Manager ($). The General Pricing Rule is $1.00 is equivalent to $1.00 and no markup is applied.
Page 264
Scenario 3: Two changes to Item1 occur: The Vending Manager administrator edits the property of Item 1 by changing the ■ purchase price from $1.00 to $0.75. Item 1 is now disassociated from pricing option 1A in the Vending Manager. Later, the Catalog Manager administrator edits pricing option 1A by changing the ■...
Page 265
Scenario 6: Item1 is never associated with a pricing option. The Catalog Manager administrator assigns a price of $2.00 to it. Later the administrator changes the price to $2.50. Resulting Pricing for Items 1 and 2 in Scenario 6 TABLE B-8 Catalog Manager Vending Manager Item1...
Glossary This glossary defines the terms and acronyms used in the context of this guide. Accounts The individuals who have access to the Sun Java System Content Delivery Server . Four types of accounts are available: Developer Accounts, Vending Manager Accounts, Subscriber Accounts, and...
Page 267
Campaign Coupon A sequence of characters and numbers used to identify a campaign. With a coupon, a subscriber can purchase content that has been promoted or discounted for a specific campaign. Capabilities Criteria that the Catalog Manager uses to define the devices that can download specific content.
Page 268
Content Descriptor A description of content other than MIDlets (such as Ring Tones, Pictures, and Template Symbian applications) similar to the way a JAD File describes a MIDlet. Content Provider The individual or corporation who submits content to the Catalog Manager.
Page 269
Locale A geographic or political region or community that shares the same language, customs, or cultural convention. In software, a locale is a collection of files, data, and code, which contains the information necessary to adapt software to a specific geographical location. Mandatory Capabilities Required capabilities for a device to accept MIDlet applications.
Page 270
Profile A Profile defines a set of APIs that a developer can use in applications submitted to the Content Delivery Server . See also Developer Plans. Purchase Price A monetary value assigned to an item of content. The currency type as seen by subscribers is determined by individual Vending Managers.
Page 271
Testing Content Content currently undergoing or requiring testing prior to being published. The status of Testing is assigned by the Catalog Manager administrator. Testing content is available to Vending Managers for distribution only to subscribers with testing roles (assigned by the Vending Manager). Unavailable Content Stocked content on the Vending Manager that is unpublished by the Catalog Manager.
Index subscriber managing, 209 about this guide, xv searching, 209 account management vending manager catalog manager, 94 to 106 adding, 97 catalog manager administrator accounts, 104 to assigning to a vending plan, 111 deleting, 100 developer accounts, 101 to 104 description, 95 overview editing, 99...
Need help?
Do you have a question about the Sun Java Content Delivery Server 5.0 and is the answer not in the manual?
Questions and answers