Marketing System Data Management Objects

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

The following figure shows the relationships between the public classes in the Microsoft.CommerceServer.Marketing namespace.

Orange colored objects are manager classes, they do not hold any data. You only use these manager classes to access and manipulate other objects. Blue objects contain business data and are transmitted through the Web service.

Marketing System Data Management Diagram

Data Management Objects

The Marketing System data management implementation consists of several key objects. The following table describes each key object and its role.

Object

Description

Advertisement

Defines a single advertisement within a campaign.

Campaign

A Campaign is a marketing program that represents one or more contracts or orders from a customer. For example, you might have a campaign to introduce new products, retain existing users, or increase market share.

CampaignItem

A CampaignItem is a communication vehicle that contributes to the specified result of a campaign. You can create three types of campaign items in Commerce Server: ads, direct mail, or discounts.

CampaignItemManager

Manages storage and retrieval of CampaignItem objects.

CampaignManager

Manages storage and retrieval of the Campaign objects.

Customer

A Customer is the owner of your marketing campaigns. A customer can be an advertiser, an agency, or yourself.

CustomerManager

Manages storage and retrieval of Customer objects.

DirectMail

Describes an e-mail that can be sent to a predefined set of subscribers (recipients).

Discount

The Discount class defines details of a discount. A Discount object contains information such as the condition, award, offer amount, offer type, and eligibility requirements of a discount.

DisplayableCampaignItem

Represents the base class for campaign item types that may have some display associated with them.

DisplayProperty

A substitution property of DisplayTemplate.

DisplaySize

Defines a size in which a DisplayableCampaignItem can be displayed.

DisplayPropertyValue

A value assigned to DisplayProperty.

DisplaySizeManager

Manages DisplaySize-related operations.

DisplayTemplate

Represents a template that describes how a campaign item should be displayed.

DisplayTemplateManager

Manages DisplayTemplate-related operations.

Expression

You use an Expression to specify some condition that must be met. For example, you can use an Expression to specify which items a customer must have in the shopping basket for a discount to apply (ConditionExpression).

ExpressionList

You use an ExpressionList to dynamically obtain a list of users from the Profiles System based on a marketing Expression.

ExpressionManager

Manages Expression-related operations.

ExpressionRef

Associates Expression objects with CampaignItem objects.

ExpressionTarget

The ExpressionTarget class contains a set of expression/action pairs that you can use to select a single content item (an ad for example) for display when several items fit the criteria.

GlobalExpressionRef

Associates a global expression with a campaign item. Unlike local Expression objects, you can share global Expression objects across different CampaignItem objects.

IndustryCode

Represents a code for a type of industry, for example, aviation or food. By using IndustryCode, you can categorize your campaigns based on industry so that competitor advertisements do not appear together.

IndustryCodeManager

IndustryCodeManager contains the methods for working with IndustryCode objects.

LocalExpressionRef

Associates a local Expression object with a campaign item. Local Expression objects only exist within the scope of the CampaignItem in which they were created.

MailingList

Direct Mailer uses MailingList to send pieces of mail to selected recipients in a list.

MailingListManager

Manages MailingList-related operations.

MarketingContext

Contains the top level object that you use to interact with the Marketing System API.

MarketingServiceAgent

A ServiceAgent object that you use to run against the Marketing Web service.

PageGroup

The PageGroup class defines a set of pages on which you can display a DisplayablaCampaignItem.

PageGroupManager

Manages PageGroup-related operations.

PromoCodeDefinition

Contains the definition of a promotion code or set of promotion codes.

PromoCodeDefinitionManager

Manages storage and retrieval of PromoCodeDefinition objects.

StaticList

Describes a static mailing list in the Marketing System. This type of mailing list has all of its users explicitly listed in the Marketing database.

See Also

Other Resources

Marketing System Object Model