Roadmap for Developing Campaign Infrastructure

 

Developing campaign infrastructure is a collaborative effort between a Business Analyst (BA) and a Commerce Business Engineer (CBE). A BA develops the strategy and goals for individual campaigns, and uses the BEA E-Business Control Center to run and evaluate them. A CBE develops the infrastructure to support campaigns and modifies the infrastructure as individual campaigns require.

This topic provides an overview of developing campaign infrastructure from the CBE perspective. It includes the following sections:

• What Is a Campaign?

• How Data Flows in a Campaign

• Workflow for Developing Campaign Infrastructure

• Viewing Campaign Messages in WebLogic Server Administration Console

 

---

What Is a Campaign?

A campaign coordinates several WebLogic Personalization Server, WebLogic Commerce Server, and Campaign Manager for WebLogic services to create and track marketing goals on an e-commerce Web site. For example, your Marketing organization can use campaigns to sell 100 ACME saws during the month of June. To reach this goal, Marketing can target advertising, e-mail, and discounted product pricing to customers who match a set of criteria, such as customers who have previously purchased ACME hardware from your site.

Campaigns coordinate the following services:

• Events and Behavior Tracking Services, which identify how a customer interacts with your site. By default Campaign Manager for WebLogic tracks only a specific set of customer interactions (events), but you can add to this set by customizing the Event Service.

• Customer Segments, which categorize customers based on information in a customer's profile. Each customer must create a profile to log in to your site. The profile includes information that the customer provides, such as shipping addresses, and information that Campaign Manager for WebLogic provides, such as number of visits and total value of products the customer has purchased on the site. A BA creates customer segments in the E-Business Control Center.

• Scenarios, which trigger actions if a specific event occurs or if a specific customer matches a customer segment. A BA creates scenarios in the E-Business Control Center.

  Scenarios can engage any of the following services:

  • Ad Placeholders, which query the content management system for an ad and display the query results on the Web site. A BA creates a placeholder in the E-Business Control Center, and you create a placeholder JSP tag in the location in which the BA wants to display ads. For example, if a customer logs in and the customer's profile matches the SailingEnthusiast customer segment, then a scenario displays an ad for sailboats in the Web site's top banner.

  • The E-mail Service, which uses a JSP to generate e-mail and provides a utility for sending the e-mail in batches. Because the Mail Service uses a JSP to generate e-mail, you can use JSP tags to personalize the e-mail.

  • Discounts, which offer reduced prices for specific products or product categories. A BA creates discounts in the E-Business Control Center.

 

---

How Data Flows in a Campaign

In a typical campaign, data flows as follows (see Figure 1-1):

1. An event is generated by a trigger. For example, a customer logs in.

   In general, an event is a notification that something has happened in a computer program. For more information about the Event Service, refer to the Guide to Events and Behavior Tracking.

   Note: In addition to events that the Event Service detects, a date or range of dates can initiate actions in a campaign.

2. The Event Service creates an event object to encapsulate information about the event. If a customer triggers the event, the event object includes the customer ID.

3. The Event Service notifies all Event Listeners that it has detected an event. The event listener for the Campaign Service determines whether the event object is one of the following types:

   • Session: The start time, end time, and if executed, the login time of the customer's session.

   • Registration: The customer registers on the e-commerce site.

   • Product: The customer is presented with a product or clicks (selects) the presented product.

   • Content: The customer is presented some content, such as an ad, or clicks (selects) the presented content.

   • Cart: An item is added, removed, or updated to the customer's shopping cart.

   • Buy: The customer completes the purchase of one or more items.

   • Campaign: The events generated within the context of a campaign.

     Note: For a description of the events that belong to these event types, refer to "Event Details" under "Overview of Events and Behavior Tracking" in the Guide to Events and Behavior Tracking.

4. If the event is one of the types described in the previous step, the Campaign Listener notifies the Campaign Service.

5. For each active campaign, the Campaign Service attempts to match the event with a scenario. For example, customer Pat Gomes is a Gold Customer who added a handsaw to the shopping cart. Scenario 1 in Campaign Z specifies actions for Gold Customers who add handsaws to the shopping cart.

6. For any scenario that matches the event, the Scenario Service finds an action to initiate. For example, If a Gold Customer adds a handsaw to the shopping cart, run a query for documents that advertise drills and display the results in the shopping cart JSP.

   Then the Campaign Service initiates the action. Ad Placeholders, the E-mail Service, and the Discount Service operate independently of the Campaign Service. The following sections describe how these services process the data that a campaign gives to them:

   • How Placeholders Select and Display Ads for Campaigns

   • How Campaigns Use the Mail Service

   • How Campaigns Offer Discounts

     Figure 1-1 Data Flow in a Campaign

     
      

How Placeholders Select and Display Ads for Campaigns

Placeholders use the following process to select and display ads in a given JSP (see Figure 1-2):

1. As part of carrying out a campaign action, the Campaign Service adds queries to the placeholder.

2. When a user requests a JSP that contains a placeholder, if the ad placeholder contains more than one ad query, the Ad Service calls the Ad Conflict Resolver to select an ad query.

   For more information, refer to "Resolving Ad Query Conflicts" under "Working with Ad Placeholders" in the Guide to Building Personalized Applications.

3. The Ad Service does the following:

   1. It forwards the query to the content management system. If the query returns more than one ad, the ad placeholder uses the adWeight attribute of each ad to determine which one to retrieve.

   2. If the ad is associated with an active campaign, it determines whether the campaign has fulfilled its goal of displaying the ad a specific number of times. If the ad has already been displayed the specified number of times, the Ad Service selects another ad.

   3. It sends data to the Event Service indicating that the placeholder has displayed the ad.

      For more information, refer to "How an Ad Placeholder Chooses from Ad Query Results" under "Working with Ad Placeholders" in the Guide to Building Personalized Applications and "Campaign Service Properties" under "The Server Configuration" in the Deployment Guide.

4. The ad placeholder generates the HTML that the browser requires to display the ad content and places it in the JSP at the location of the placeholder tag.

5. If a customer clicks on the ad, the Ad Service redirects the URL and notifies the Event Service that a customer clicked the ad.

   Figure 1-2 How Placeholders Display Ads for Campaigns

   
    

How Campaigns Use the Mail Service

Business Analysts (BAs) can specify that a scenario within a campaign sends an e-mail to a customer. For example, when a customer buys a flashlight, a scenario can send an e-mail that contains special offers for batteries.

When BAs create scenarios, they provide the URI of a JSP file that contains the e-mail content. When a customer triggers the scenario action, the following processes occurs:

1. The Campaign Service uses HTTP to request the JSP URI that the scenario action specifies. In the request, it passes parameters to identify the name of the scenario and the identity of the customer who triggered the scenario action.

2. The JSP invokes any JSP tags that it contains, uses MIME types to encode non-ASCII output, and stores its output in the Campaign Manager for WebLogic data repository. The data repository organizes the e-mails into batches; one batch for each campaign.

3. You issue a command to the Mail Service that specifies which batch of messages you want to send. The Mail Service uses the JavaMail API to send the messages.

   Figure 1-3 The Mail Service for Campaigns

   
    

How Campaigns Offer Discounts

A BA creates discounts while defining actions for a scenario. When an event triggers a scenario to activate a discount the following process occurs:

1. The scenario action sends the following information to the Discount Association Service:

   • The customer's ID (customer PK), which is an identifier of the customer who the scenario determines is eligible for a discount

   • The discount's ID

   • The description for the discount, which a BA creates in the E-Business Control Center and which can be displayed in the shopping cart or other JSPs

   • The number of orders to which this discount has been applied

     For example, a scenario states that between May 1 and May 10, all customers are eligible to purchase an ACME hand saw for $20. When the system clock reaches May 1 and Pat Gomes (a customer) logs in, the scenario engages and notifies the Discount Association Service that Pat Gomes is eligible for the discount.

     Another scenario states that all Gold Customers are eligible for a 10% discount on ACME drills. When Pat Gomes logs in, the Event Service sends a message to the Campaign Service. The Campaign Service determines that Pat Gomes is a Gold Customer. The scenario then engages and notifies the Discount Association Service that Pat Gomes is eligible for a 10% discount on ACME drills.

2. When a customer adds an item to the shopping cart, removes an item from the shopping cart, checks out, or confirms an order, the shopping cart places its data in a ShoppingCart Pipeline component.

3. The ShoppingCart Pipeline component contacts the Pricing Service.

4. Using data from the Discount Association Service, the Shopping Cart Pipeline component, and from any third-party tax-calculation service, the Pricing Service calculates the total price of the customer's order. For more information on how the Pricing Service calculates the price of a customer's order, refer to the Guide to Managing Purchases and Processing Orders.

5. The Pricing Service sends its results to the PriceOrder Pipeline component.

6. Then the shopping cart JSP displays information from the Pipeline component.

   Figure 1-4 How a Campaign Offers Discounts

   
    

 

---

Workflow for Developing Campaign Infrastructure

To develop campaign infrastructure, you set up data structures that the BA uses to define and run individual campaigns. To support a specific campaign, a BA might require you to add or update data structures and remove them when the campaign ends.

The following steps outline the process for developing campaign infrastructure:

1. Define Custom Events. Campaign Manager for WebLogic includes a set of default events that trigger campaign actions. If a BA wants a campaign to respond or react to other events, you must define custom events. For more information, refer to "Creating Custom Events" in the Guide to Events and Behavior Tracking.

2. Set Up Ads and Ad Attributes. You must load any advertising documents (ads) that a campaign displays into your content management system. To support ad placeholder queries, you must define attributes for each ad. To support ad clickthroughs and popup windows for clickthrough targets, and to set preferences for Shockwave movie files, you must attach an additional set of attributes to the image and Shockwave advertising documents.

3. Create JSP Tags. On any JSP that generates or reacts to events for a campaign, you must create a <um:getProfile> JSP tag to retrieve the customer's profile. A customer profile is a key piece of information for determining whether a campaign scenario applies to a specific event. You may have already added this JSP tag to support other personalization or behavior tracking features.

   On any page that displays ads for a campaign, you must create a <ph:placeholder> JSP tag. Placeholder tags run queries that a BA constructs in the E-Business Control Center and display the query results.

4. Set Up the E-mail Service Properties and Campaign E-mail JSPs. If the campaign sends e-mail, you must set properties for the e-mail service. Then you set up JSPs to contain the campaign's e-mail messages. You can use JSP tags and APIs to personalize the letter. Instead of using the Campaign Manager for WebLogic, you can set up an integration with a third-party e-mail service.

5. Send Bulk E-mails. The Campaign Manager for WebLogic places all e-mails in a batch. You must periodically use a command to send the batch. You can also use cron or any other scheduler that your operating system supports to issue the send-mail command.

6. Clean Up. After the campaign ends, you can remove any campaign-specific placeholders, JSPs, and JSP tags.

 

---

Viewing Campaign Messages in WebLogic Server Administration Console

To provide an audit trail of their activities, campaigns send messages to the WebLogic Server messaging system. Campaigns also send error and warning messages to this system.

You can view these messages from the WebLogic Server Administration Console. To view only messages that campaigns generate, use the following string to filter messages:
Campaign and Scenarios

To view campaign messages from the WebLogic Server Administration Console, do the following:

1. Start the Administration Console. For more information, refer to "The Server Configuration," in the Deployment Guide.

2. In Administration Console, in the left pane, click Servers --> wlcsServer.

3. On the wlcsServer page, click the Logging tab. (See Figure 1-5.)

   Figure 1-5 The Logging Tab

   
    

4. On the Logging tab, click View Server Log.

   The Administration Console displays the Log page, which contains all Campaign Manager for WebLogic messages.

5. To view only messages that campaigns generate, on the Log page click Search and Customize.

   The Administration Console displays another window titled Search and Customize.

6. In the Search and Customize window, in the Search By Message Text box, enter the following string:
   Campaign and Scenarios

7. Click View. (See Figure 1-6.)

   Figure 1-6 The Search and Customize Window

   
    

   The Administration Console closes the Search and Customize window and displays any campaign related messages in the Log window.