Table of Contents

TWBS Marketing Campaign Management (MCM) User Guide

MCM Overview

Marketing is critical to your overall business if you want to grow and thrive in today’s economy. Shouldn’t your business management solution provide tools that allow you to accomplish your marketing goals?

Easily track and manage leads and activities:

Third Wave’s Marketing Campaign Management (MCM) enables your team to create, execute and track marketing efforts all in one place. Now you can enter, import and manage marketing prospect lists before you’re ready to add them to your list of active Business Partners.

MCM allows you to import and store your prospect lists and associated activities in a separate, yet related, set of tables. So, you are able to use the simple and elegant SAP® Business One interface to manage your marketing activities without slowing Business Partner reports and queries.

Once you import your prospect list and set up a campaign, you can even establish a bidirectional connection with Constant Contact or use the built-in email blast feature. When you use the power of SAP® Business One queries to select your audience, you’ll easily keep all activities in one place. Finally, when a marketing prospect becomes qualified to enter the sales process, a single click allows you to promote them into your Business Partners tables, pulling all your complete activity history with it.

Expand the functionality and usability of your SAP® Business One feature-set with MCM. Manage a larger volume of prospects, campaigns and programs while developing and tracking distinct marketing campaigns - all in one place.

Finally, a tool that enables you to measure the effectiveness and return on your marketing investment integrated within SAP® Business One.

System Requirements

SAP Business One requirements

Other Software Requirements

Folder permission requirements

Social Media Integration

The ability to post messages to LinkedIn, Twitter, or Facebook.

Marketing Campaign Manager Search Queries

A robust utility screen for searching Marketing Campaign Manager data and saving the search data as a MCM Search-based query for later use in message editing.

Constant Contact

Constant Contact is a web-based application that helps you manage your e-mail marketing activities. It provides you with tools to create e-mail formats to help you present an effective business image, tools to manage your e-mail lists and tools to view and analyze the results of your e-mail efforts. At the same time you have the ability to upload contact lists from your SAP® Business One database and view the results of each e-mail cycle from within the TWBS Marketing Campaign Management application.

Third Wave Business Systems has elected to integrate with Constant Contact as it is a cost-effective and easy to use tool for this purpose. Go to www.constantcontact.com for more information on their e-mail marketing plans.

Installation

The install process for TWBS Marketing Campaign Management consists of the following components:

MCM Server Configuration

The TWBS MCM Server Properties may be configured by a super-user on the SAP® Business One Server machine.

Applying MCM Licenses

Third Wave Business System SAP® Business One add-ons have been updated with an automatic licensing procedure. In order to obtain a permanent license key, the production environment SAP® Business One installation number must first be provided to TWBS Support so that the information can be entered into our systems. The SAP® Business One installation number is a critical component to the new TWBS application license keys. Without this information you will only be able to obtain a 30-day application trial license.

On start up, the application client will verify that a valid license exists for the application having been purchased based on your SAP® Business One installation number. If the license is verified, the application will start. If the application has not been purchased, a 30-day trial license will be issued to allow for limited use of the application. If your trial license has expired and you would like to purchase the application to obtain a full license key, please contact Third Wave Business Systems @ (201) 703-2100.

Creation of MCM Database Objects

The TWBS MCM database objects may be created by a super-user on the SAP® Business One Server machine.

Deleting Document Library Files

The removal of TWBS MCM document library files may be performed by a super-user on the SAP® Business One Server machine.

Applying MCM Updates

Updates for the MCM application will occasionally be released through our TWBS Support Portal either to introduce new features, fix existing issues in the application, or both. Third Wave does not send out automatic notices with updates are available, so we recommend that you periodically check for new releases.

Steps for applying patches to the Chargeback application are…

MCM Uninstall Process

Steps for uninstalling the MCM application are…

If your previous version of TWBS MCM is a version that still utilizes the Database Server.

Configuration

The Marketing Campaign Management application needs to be set up through the SAP® Business One based configurations screen. This can be launched through the following steps…

General Tab

mcmimage23.jpeg

Account screen mode after conversion to BP…

This option determines how the configuration will be saved.

Display Closed Activities on MCM Account Form Load checkbox…

This configuration allows for the display of closed activities on the MCM account screen when an account is loaded. If this display is not selected, only open activities will be displayed.

Constant Contact Login Tab

mcmimage24.jpeg

Constant Contact Login Information…

This is where the credentials for the Constant Contact account should be stored.

This information is required only if you wish to utilize Constant Contact for e-mail marketing management from SAP® Business One via the Marketing Campaign Management application.

Click the Update button to save configuration options.

Delete List Tab

Technical Information

The technical information for TWBS Marketing Campaign Management consists of the following components:

If you find the need to add User Defined Fields to the Marketing Accounts table (@twbs_mk_ocrd), you may find it helpful to create a special Category for your custom fields. This will help you exclude User Defined Fields from the add-on that are also displayed in the UDF window.

You may encounter an issue when trying to add new values to the “List” user field on the Demographics tab of the Account. An error message indicating that the value cannot be updated is displayed. If this occurs contact Third Wave Business Systems support for assistance. This is a known SAP® Business One issue.

Database Objects

The TWBS Marketing Campaign Management application, as part of the installation process, will create the following objects in the SAP database. The following objects are required in order for the application to function.

User Defined Tables

Table NameTable Description
TWBS_MK_OCRDMarketing Account Header and General Tab Information.
TWBS_MK_OCPRMarketing Account Contact Person Tab Information.
TWBS_MK_CRD1Marketing Account Address Tab Information.
TWBS_MK_INTERESTMarketing Account Interest Tab Information.
TWBS_MK_DEMOGRAFMarketing Account Demographics Tab Information.
TWBS_MK_LEADTYPESMarketing Account Type Definitions.
TWBS_MK_INDUSTRYMarketing Account Industry Types.
TWBS_MK_SOURCECODEMarketing Source Codes.
TWBS_MK_CAMPAIGNSMarketing Campaign Header and General Tab Information.
TWBS_MK_CCONTACTMarketing Constant Contact List Selection Information.
TWBS_MK_CCMAPPINGMarketing Constant Contact Mapping Information.
TWBS_MK_ATTACHMENTSMarketing Campaign Attachments Information.
TWBS_MK_CAMPSTATUSMarketing Campaign Status Definitions.
TWBS_MK_CAMPTYPESMarketing Campaign Types Definitions.
TWBS_MK_DOCTEMPMarketing Communication Template Form Header Information.
TWBS_MK_ATTACHMarketing Communication Template Attachment Information.
TWBS_MK_CONFIGMarketing Configuration Information/Constant Contact Login Information.
TWBS_MK_OCRD_INTRSTMarketing Interest Information from Business Partner screen custom tab.

Tables in TWBS_SBO-Common Database

Table NameTable Description
TWBS_COM_DOCLIBDocument Library Information.
TWBS_COM_DOCGROUPDocument Group Master Information.
TWBS_COM_DOCGROUPASSOCDocument Group Association Master Information.

User Defined Fields on SAP Objects

Field NameSAP ObjectTypeField Description
TWBS_LEADCODEActivityAlphanumeric (15)Account Code for the generated Activity.
TWBS_LEADNAMEActivityAlphanumeric (100)Account Name for the Account Code for the generated Activity.
TWBS_CNTCTPRSNActivityAlphanumeric (100)Contact Person for the Account Code for the generated Activity.
TWBS_MK_CAMPCODESales OpportunityAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODESales QuotesAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODESales OrdersAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODEDelivery NotesAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODEA/R InvoiceAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_PREFIXBusiness PartnerAlphanumeric (15)Prefix for the Business Partner
TWBS_FIRSTNAMEBusiness Partner ContactAlphanumeric (25)First Name for the Business Partner Contact
TWBS_MIDDLENAMEBusiness Partner ContactAlphanumeric (25)Middle Name for the Business Partner Contact
TWBS_LASTNAMEBusiness Partner ContactAlphanumeric (25)Last Name for the Business Partner Contact
TWBS_ADDUserAlphanumeric (30)This UDF will determine that after an addition operation in Account form. What should be the mode of
Three Valid Values:
1. OK - Keep last added Lead Info on screen
2. ADD - Clear screen - Add Mode
3. FIND - Clear Acreen - Find Mode
Default Value: Add
TWBS_MODEUserAlphanumeric (15)This UDF will determine the form mode when the form is initially loaded from menu click.
Two Three Valid Values
1. A - Add
2. F - Find
Default Value: F
TWBS_ACTUserAlphanumeric (15)This UDF will determine whether to display all activities or only open activities in Account form under Activities tab
2 valid values
1. 1-Only Open Activities
2. 2-Display All
TWBS_MK_SMUserUserAlphanumeric (15)This UDF will determine whether the user has access to the MCM Social Media screen.
1. Y-Yes
2. N-No

User Defined Objects

Unique IDNameTypeTable Name
TWBS_MARKETINGMarketing CustomersMaster DataTWBS_MK_OCRD
TWBS_CAMPAIGNMarketing CampaignMaster DataTWBS_MK_CAMPAIGNS
TWBS_DOCTEMPLATEDocument TemplateMaster DataTWBS_MK_DOCTEMP

Installed Queries

These queries are automatically installed with the TWBS Marketing Campaign Management application. They can be accessed through the following menu…

mcmimage30.jpeg

Queries include:

Leads from A Campaign

This query generates Leads from a Campaign.

SELECT u_cardname, u_intrdate
FROM [@twbs_mk_interest] t0, [@twbs_mk_ocrd]t1 WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1]

Quotes from A Campaign

This query generates Quotes from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, oqut t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Sales Orders from A Campaign

This query generates Sales Orders from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, oinv t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Sales from A Campaign

This query generates Sales from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, ordr t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Additional Queries

These additional queries can be used for reporting on the TWBS Marketing Campaign Management data. They will also help identify fields that you might want to use in a Crystal Report as well.

Linking Account Tables

Child Marketing Account tables; [@twbs_mk_ocpr] [@twbs_mk_crd1], [@twbs_mk_demograf] and [@twbs_mk_interest], are linked to the Marketing Account Master table on the Code column. Following is an example linking Marketing Account Contacts to the Marketing Account Master.

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.CardName
FROM [@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN[@twbs_mk_ocrd] ON t0.Code = t1.Code

Basic List of All Marketing Accounts

This query generates a list of all Marketing Accounts

SELECT t0.u_CardCode, t0.u_CardName, t2.u_name, t1.SlpName FROM [dbo].[@twbs_mk_ocrd] t0 (NOLOCK)
INNER JOIN [dbo].[OSLP] t1 (NOLOCK) ON t0.u_SlpCode = t1.SlpCode
LEFT JOIN [dbo].[@twbs_mk_LeadTypes] t2 (NOLOCJK) ON t0.u_CardType = t2.u_Code

Basic List of All Marketing Contacts

This query generates a list of all Marketing Account Contacts.

SELECT t0.u_LastNam, t0.u_FirstNam, t0.u_Position, t0.u_E_MailL, t0.u_Tel1, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] t1 (NOLOCK) ON t0.code = t1.code

Basic E-Mail List of Marketing Contacts

This query generates a list of Marketing Account Contacts that have an e-mail address

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code WHERE t0.u_E_mailL IS NOT NULL

Filtered E-Mail List of Marketing Contacts

This query generates a list of Marketing Account Contacts that have an e-mail address and are flagged as “Solicit” = Yes (example 1). The same query can be used to filter based on “Mail” = Yes (example 2)

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code
WHERE t0.u_E_mailL IS NOT NULL
AND t0.u_solicit = ‘Y’
 
SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code
WHERE t0.u_E_mailL IS NOT NULL
AND t0.u_mailOK = ‘Y’

Marketing Campaign Manager Screens

The following section outlines all TWBS Marketing Campaign Management screens and SAP® Business One screens which were modified with custom tabs, user defined fields, or other customized objects.

Accounts Screen

To access the TWBS Marketing Campaign Management Account screen…

The function of the Account screen is the enter and maintain prospective Business Partner accounts of varying types (ex. Customers, Vendors, etc.) in an environment separate from the SAP® Business Partners Master Data. This provides the flexibility to remove potential customers as needed which is not possible once the Business Partner record has been created in SAP. These accounts allow for the tracking of the potential Business Partners for the purposes of marketing without needlessly adding records to the SAP system that may never be used.

Once a Business Partner record has been created in the SAP® Business One system, it cannot be removed. It can only be deactivated.

mcmimage33.jpeg

Account Screen Fields

Field NameField DescriptionData Size
Code*An Account's unique identification code. This value cannot be changed once the Account record has been added.15 characters
Prospect TypeAccount prospect type. The value can be selected from the dropdown list or select Define New to add a new value.
NameAccount company name.100 characters
Foreign NameAccount foreign or additional company name.100 characters
GroupAccount customer group value can be selected from the dropdown list. This is the standard SAP Business One set of customer groups.
CurrencyAccount currency value can be selected from the dropdown list. This is the standard set of currencies active in SAP Business One.
Federal Tax IDAccount federal tax ID.32 characters
StatusAccount status value can be selected from the dropdown list. Available values are Active, Inactive and Converted as Lead. The status will be changed to “Converted” automatically when the “Convert to BP” function is used.
BP CodeThis field displays the Business Partner code assigned to this Account record when converted. It is a display-only field
Consolidating BPEither select or enter an active SAP Business Partner code that will act as the consolidation Business Partner for this Account. This value is used for reporting purposes only in the TWBS Marketing function It is not transferred as the “Consolidating BP” for accounting purposes to the Business Partner record.

*= Required Field

Account Screen Buttons

Button CaptionButton Function
OK/Find/Add/UpdateStandard SAP® Business One button to find, add, and update records.
CancelStandard SAP® Business One button to close the form with no further user interaction.
Convert to BPClick this button to convert a TWBS Marketing Account to a standard SAP® Business One Business Partner (Customer).
ActivityClick this button to add a standard SAP® Business One Activity associated with this TWBS Marketing Account.

General Tab Fields

Field NameField DescriptionData Size
Tel1Account main company telephone number.20 characters
Mobile PhoneAccount mobile phone number.20 characters
FaxAccount main company fax number.20 characters
E-EmailEmailAccount e-mail address.20 characters
Web SiteAccount company website address.100 characters
PasswordAccount password (if it is part of your existing Business Partner definition process).32 characters
ProjectSelect an Account project from the dropdown list. This is the standard set of projects active in SAP Business One.
Contact PersonThis field displays the name of the default Contact defined for this lead (on the Contact Person tab).
ID No. 2A field to contain any information that is appropriate for your business process.18 characters
RemarksA field to contain any notes or comments about this Account.100 characters
Sales EmployeeSelect a sales employee from the dropdown list. This is the standard set of sales employees active in SAP Business One.
BP Channel CodeEither select or enter an active Business Partner code for a Business Partner that may service this lead.
TechnicianEither select or enter an employee that may deal with this lead for service issues. The values shown in this list are employees (identified in the Human Resources module) that are identified as a “technician.”
TerritoryEither select or enter a territory for this lead. This is the standard set of territories active in SAP Business One.

mcmimage35.jpeg

Contact Person Tab Fields

Field NameField DescriptionData Size
NameThe contact person’s full name.100 characters
PrefixThe contact person’s title (Mr., Mrs., Ms., Dr., etc.).30 characters
First NameThe contact person’s first name.50 characters
Middle NameThe contact person’s middle name or initial.50 characters
Last NameThe contact person’s last name.50 characters
Solicit OKSelect a value from the dropdown list. Valid values are Yes or No. This value can be used to develop queries to extract marketing communication lists.
Mail OKSelect a value from the dropdown list. Valid values are Yes or No. This value can be used to develop queries to extract marketing communication lists.
TitleThe contact person’s title. In standard SAP Business One this value is used to hold the same value as “Prefix” noted above.20 characters
PositionThe contact person’s business function or position.20 characters
AddressThe contact person’s address. Like standard SAP Business One this value is simply a long text string. Your business process will determine how this value is used.200 characters
TelephoneThe contact person’s telephone number.40 characters
Mobile PhoneThe contact person’s mobile telephone number.100 characters
FaxThe contact person’s fax number.40 characters
E_mailThe contact person’s e-mail address.200 characters
PagerThe contact person’s pager number.60 characters
Remarks1A field to contain any notes or comments about this contact.200 characters
Remarks2A field to contain any notes or comments about this contact.200 characters

Contact Person Tab Buttons

Button CaptionButton Function
Set DefaultWill designate a Contact Person as the default for the Account.

mcmimage36.jpeg

Address Tab Fields

Field NameField DescriptionData Size
Address NameThe address's name.100 characters
StreetThe address's street address.100 characters
BlockThe address's block/second line of address.100 characters
CityThe address's city name.200 characters
Zip CodeThe address's zip/postal code.40 characters
StateSelect the state/province code from the dropdown list. Note that the Country code must be selected before the state code can be selected. This is the standard set of states/provinces active in SAP Business One.
CountrySelect the country code from the dropdown list. This is the standard set of countries active in SAP Business One.

Address Tab Buttons

Button CaptionButton Function
Set as DefaultWill designate an Address as the default for the Account.

Field NameField Description
Display Only Open ActivitiesControls the display of SAP Activity information related to the Account. If the checkbox is selected, only open status Activity data will be displayed.

mcmimage39.jpeg

Interest Tab Fields

Field NameField Description
Item CodeEither select or enter a specific item of interest for this lead. This is the standard set of items active in SAP® Business One.
DescriptionIf a specific item has been selected its description is displayed.
Item GroupSelect a value from the dropdown list. This is the standard set of item groups active in SAP® Business One. In a specific item has been selected its corresponding item group is displayed
Interest DateEnter an approximate date when a sale might occur. Your business process will determine how you assign this date.
Source CodeSelect a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value. Your business process will determine how this value is used.
Campaign CodeEither select or enter a campaign code that generated interest in this product. The list of codes is based on TWBS Marketing Campaigns

mcmimage40.jpeg

Demographics Tab Fields

Field NameField DescriptionData Size/Constraints
IndustryCode Select a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value.
SIC CodeEnter a value for the SIC (Standard Industrial Classification) code for this company.100 characters
Text1Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text2Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text3Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text4Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
ListSelect a value from the dropdown list. This is a user defined list of values. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Number1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double- click on the field label to change the name displayed on the form.Range -32,768 to 32,767
No of EmployeesEnter the number of employees for this company. Annual Revenue Enter the annual revenue for this company.
Number2Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Amount1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Amount2Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Quantity1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Date1Enter a date. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.
Date2Enter a date. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.

Campaign Screen

To access the TWBS Marketing Campaign Management Campaign screen…

TWBS Marketing Campaign Management email delivery requires the use of an internal SMTP server. An external SMTP server cannot be used.

mcmimage42.jpeg

Marketing Campaign Screen Fields

Field NameField DescriptionData Size
Campaign Code*Enter a unique identification code for this campaign. This value is required. This value cannot be changed once the record has been50 characters
Campaign NameEnter a name for this campaign.100 characters
Campaign TypeSelect a value from the dropdown list. Two standard values of “E-mail” and “Print” are provided, and additional values can be added. Click “Define New” to add a new value.
ObjectivesEnter a short description of the objectives of this campaign.100 characters
Campaign IDThis numeric value is assigned by the system and cannot be changed.
Call to ActionEnter a short description of the “call to action” (e.g. what you want the prospect to do) for this campaign.100 characters
Campaign DescriptionEnter a description of the campaign.254 characters
Constant ContactSelect this checkbox if e-mail communications for this campaign will be managed through Constant Contact. Note that you must have previously defined your Constant Contact login information to enable this option. Selecting the option will enable the Campaign Lists field and the Constant Contact Lists field in the List Selection tab of the Lists tab.
Campaign ListsA Campaign List refers to a list of e-mail formats that is defined in your Constant Contact account. Select the desired format from the dropdown list. This field is available only when the Constant Contact option is enabled.

Marketing Campaign Screen Buttons

Button CaptionButton Function
OK/Find/Add/UpdateStandard SAP® Business One button to find, add, and update records.
CancelStandard SAP® Business One button to close the form with no further user interaction.
Post to SocialLaunches the **Social Media** screen and populates the Message Name with the Campaign Name value.

General Tab Fields

Field NameField Description
StatusSelect a value from the dropdown list. Four standard values of “Draft”, “Approved”, “Canceled”, and “Closed” are provided, and additional values can be added. Click “Define New” to add a new value.
Potential ResponsesEnter the number of potential responses for this campaign.
Forecast BudgetEnter the planned budget for this campaign.
Expected ResultsEnter the expected results for this campaign. This value can be used to measure any value that is appropriate for your company. An example might be that your “call to action” is for people to request a catalog. Your expected results would then be the number of catalog requests you expect to receive. This can then be measured against the Actual Responses value.
Task BudgetThis value is for future use.
Actual LaunchEnter the date the campaign is actually launched.
Units CreatedEnter the number of units created for this campaign. This could represent the number of mailers produced or the number of e-mails sent out.
Actual ResponsesEnter the number of actual responses for this campaign.
Actual CostEnter the actual cost for this campaign. At this time this value must be updated manually. You may consider using the SAP Business One Projects function to track the costs incurred for this campaign.
Task Actual AmtThis value is for future use.
Actual ResultsEnter the actual results for this campaign. See the Expected Results field for more explanation.

mcmimage46.jpeg

List Tab - List Selection Sub tab Fields

Field NameField DescriptionData Size
Phase NameEnter the name of the campaign phase.254 characters
DateEnter the scheduled date of this campaign phase.
StatusSelect a value from the dropdown list. Three values of “Draft”, “Scheduled”, and “Sent” are available.
Query ListSelect a value from the dropdown list. This value identifies the SAP® Business One query to be used to provide the contact list for this phase of the campaign. The query must be created prior to use in this function.
Constant Contact ListSelect a value from the dropdown list. This field is available only when the Constant Contact option is enabled.The options in this list correspond to e-mail lists defined in your Constant Contact account. Click “Define New” to create a new list.

Due to the way the dropdown list is created a query that will be used here must exist before the Marketing Campaign form is opened. If you create a query after the form is opened you will need to close and reopen the form to see the query in the list.

List Tab - CC Mapping Sub tab Fields

This tab is used to map the fields in your query (Query List) to corresponding field in Constant Contact. This tab is only available when the “Constant Contact” option in the header has been selected. To map fields, please follow these steps…

  1. Select (highlight) the desired row on the List Select tab. An error will be raised if you do not select a row before continuing.
  2. Select a Constant Contact field from the dropdown list in the Constant Contact Fields column.
  3. Select the corresponding field in your query from the dropdown list in the Query Fields column.
  4. Continue this process until all Constant Contact fields are mapped.
Field NameField Description
Constant Contact FieldsThe field as defined on Constant Contacts.
Query FieldsThe field as defined in the utilized Query.

CC Mapping Buttons

Button CaptionButton Function
Update Constant Contact ListUpdate your contact list in Constant Contact with the results of your query.

List Tab - List Data Sub tab Fields

This tab displays the results of the query associated with a row selected on the List Selection tab.

mcmimage48.jpeg

Email Message Tab Fields

This tab is used to create your e-mail when you are not using Constant Contact. The tab is available only when the Constant Contact option is not selected.

Field NameField DescriptionData Size
Phase NameSelect a value from the dropdown list. A list of the phases associated with this campaign is displayed.
Create ActivitySelect this checkbox to have the system create an SAP Business One Activity when the e-mail is sent.
From EmailEnter the e-mail address that will be used as the “sender” for the e-mail.100 characters
To Email AddressSelect a value from the dropdown list.
Message Customization Tags
Email MsgEnter the text of your e-mail message in this area. If you enter text directly in this area the e-mail will be treated as a text message. You can also enter create and edit HTML text in this window if you wish, but using the Edit HTML Msg option will make the process much easier.

Only one e-mail message can be stored for a specific campaign at a time. If you want to use one format for Phase A and a different format for Phase B you will need to manually redo the format for each phase.

Button CaptionButton Function
Edit HTML MsgClick to open the editor used to create and edit the HTML code for your message. When this option is selected you will also have the ability to personalize your message using fields from the query associated with the Phase. You will see the HTML text that was created when you save and return to the main form.
Send MailClick this button to send the e-mails created for this phase of the campaign.
Insert
Copy

Statistics Tab

These tabs display information from Constant Contact about the Campaign identified in the “Campaign Lists” dropdown in the campaign header. This information is retrieved directly from Constant Contact. It is not stored in your local database. This tab is only available when the Constant Contact option is enabled.

Statistics – Campaign Statistics Tab

This tab displays general information about the Constant Contact campaign.

Statistics – Contact Statistics Tab

This tab displays information contacts included in the Constant Contact campaign. Enter a number of contact records to retrieve and click Get Data .

Results Tab

These tabs display information from SAP® Business One that result from the Campaign. There are sub-tabs displaying information for…

Social Media Screen

To access the TWBS Marketing Campaign Management Social Media screen…

Access to the Social Media screen is controlled through the Social Media User user defined field on the Users screen in SAP® Business One.

Use of the screen will generate an Activity in SAP® Business One with an Activity Type of Social Media to allow for later tracking and analysis.

mcmimage52.jpeg

Social Media Screen Fields

Field NameField DescriptionData Size
Message NameTitle associated with the message being posted.60 characters
MessagesThe content of the message being posted.500 Charcaters
URLThe website URL associated with the message being posted.100 characters
Via URLThe via website URL associated with the message being posted.100 characters

Social Media Screen Buttons

Button CaptionButton Function
Posting the message information through LinkedIn.
Posting the message information through Twitter.
Posting the message information through Facebook.

Clicking one of the social media outlet buttons will launch a browser window for the appropriate site and pre-populate the fields with the information from the Social Media screen.

MCM Search Screen

To access the TWBS Marketing Campaign Management Search screen…

The MCM Search screen is a robust utility screen for searching Marketing Campaign Manager data and saving the search data as a MCM Search-based query for later use.

General Tab

mcmimage56.jpeg

Data Columns on General Tab

Contact Person Tab

mcmimage58.jpeg

Data Columns on Contact Person Tab

Address Tab

mcmimage59.jpeg

Data Columns on Address Tab

mcmimage60.jpeg

Interest Tab

mcmimage61.jpeg

Data Columns on Interest Tab

Demographics Tab

mcmimage62.jpeg

Data Columns on Demographics Tab

Display Order Tab

mcmimage63.jpeg

Data Columns on Display Order Tab

Communication Templates Screen

To access the TWBS Marketing Campaign Management Communication Templates screen…

Message Editor Screen

To access the TWBS Marketing Campaign Management Message Editor screen…

Document Library Screen

To access the TWBS Marketing Campaign Management Document Library screen…

SAP User Screen

To access the SAP® Business One Users Setup screen and set specific Marketing configuration options by user…

Add Button After Action...

mcmimage69.jpeg

This option determines what happens in the Marketing Accounts form when a new record is added.

Config for Marketing Mode...

mcmimage70.jpeg

This option determines if the Marketing Accounts form opens in Add or Find mode.

mcmimage71.jpeg

This option determines what happens when the Related Activities tab in the Marketing Accounts form is selected. The options available are “Display All” or “Only Open.” The option can then be changed on the tab itself as needed.

Document Management Admin Access...

mcmimage72.jpeg

This option determines if the Communication Template and Document Library options are available to the user.

SAP Business Partner Master Data Screen

To access the SAP® Business One Business Partners Master Data screen…

mcmimage73.jpeg

Interest Tab Fields

Field NameField Description
Item CodeEither select or enter a specific item of interest for this lead. This is the standard set of items active in SAP® Business One.
Item DescriptionIf a specific item has been selected its description is displayed.
Item GroupSelect a value from the dropdown list. This is the standard set of item groups active in SAP® Business One. In a specific item has been selected its corresponding item group is displayed.
Interest DateEnter an approximate date when a sale might occur. Your business process will determine how you assign this date.
Source CodeSelect a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value. Your business process will determine how this value is used.
Campaign CodeEither select or enter a campaign code that generated interest in this product. The list of codes is based on TWBS Marketing Campaigns.

SAP Marketing Document Screen

To access the SAP® Business One marketing document screens…

Using Marketing Campaign Manager

The following section outlines different real-world application scenarios utilizing the TWBS Marketing Campaign Management application.

How to Setup your Constant Contact Credentials

This information is required only if you wish to utilize Constant Contact for e-mail marketing management from SAP® Business One via the Marketing Campaign Management application.

mcmimage77.jpeg

How to Delete a Constant Contact List

How to Add/Update Accounts

Adding an Account

Updating an Account

How to Remove Accounts

How to Import Accounts

Identify Your Import Source File

In this step you will define the type and location of your input data file.

Deduping (Handling Duplicates)

At the bottom of the screen are found the “Deduping” options. “Deduping” describes how you want the import process to handle situations where a duplicate record is found. The way you approach this may be different for each type of import data.

Deduping Criteria

Select the field from the dropdown list that you want to test for an existing record. The fields presented in the list are the fields you have included in your import file.

Update or Skip

Select the desired action to be taken when a duplicate is found. Use “Update existing record with file details” if you are deliberately intending to update existing records. Use “Skip record if duplicate is found” if you are loading a new set of lead information and you don’t want to duplicate a record that already exists.

Map Import Fields

In the next step you will tell the application how the fields in your import file relate to the fields in the database.

The mapping process must be completed each time the import function is executed. The Save Mapping process simply saves a file that is used for the current import cycle.

Execute the Import

Click Finish to execute the actual import process. A message box is displayed when the import process is complete. Click OK to close the message box.

When the import process is complete you can click Cancel to exit the import function or click Back to move to previous steps.

How to Format Data for Importing Accounts

The TWBS Marketing Campaign Management application provides a tool to import Marketing Accounts from an external text (tab delimited) or Excel file. In version 1 of the tool it is necessary to import this information in three separate cycles. Information that can be imported includes Master information, Contact information and Address information.

This utility can be used to both import new records and update existing records, subject to some limitations. A description of how the update process can be used is found in the “Execute the Import Process” that follows.

Create the Import Files

The import file can be either at tab delimited text file or a standard Excel workbook. If you use an Excel workbook only the first worksheet can be used for import data. The following tables describe the information for each data set (master, contact and address).
The first row of the import file should contain the column name. The information in this row is presented in the import mapping process to allow you to “connect” data in your file to the appropriate field in the Marketing database.
It is not necessary to have data for all columns listed in the tables. Your file can consist of columns for only the data you are going to import. So your file may only have five or six columns.

Master Information

The following table identifies the data that can be imported for a Marketing Account Master record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the **Marketing Campaign Manager Screens** sections of this User Guide.

Col #Marketing Column (field)DescriptionMax SizeRequired
1Lead CodeMarketing Lead Code15✔
2Business Partner CodeSystem generated: do not importXXX
3Consolidating BPStandard Business Partner Code: use CardCode value from OCRD15
4Lead NameCompany Name100
5Contact PersonSystem Generated: do not importXXX
6Lead TypeCode for Lead Type: use u_Code value from @twbs_mk_leadtypes15
7Foreign NameCompany Name, Foreign100
8Group CodeCustomer Group code: use GroupCode value from OCRG where GroupType = ‘C’6
9CurrencyCurrency Code: use CurrCode value from OCRN3
10Federal Tax IDTax ID32
11Phone1Telephone number20
12Phone2Telephone number20
13MobileTelephone number50
14FaxFax number20
15E-mailE-mail address100
16Web SiteWebsite URL100
17Ship TypeNot currently used6
18PasswordPassword32
19Factoring IndicatorNot currently used2
20Project CodeProject Code: use PrjCode value from OPRJ8
21Contact PersonSystem generated: do not import90
22ID NoID 218
23NotesNotes/Remarks100
24Sales EmployeeSales Employee Code: use SlpCode value from OSLP6
25BP Channel CodeStandard Business Partner Code: use CardCode value from OCRD15
26EmployeeService Technician: use EmpID from OHEM where HEM6.RoleID = -215
27TerritoryTerritory Code: Use territryID from OTER15
28StatusLead status: 1 = Active, 2 = Inactive. Do not use 3 (Converted)6
29BillDefDefault Bill-To address: system generated – do not import50
30ShipDefDefault Ship-To address: system generated – do not import50
Contact Information

The following table identifies the data that can be imported for a Marketing Account Contacts record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the previous sections of this document.

Col #Marketing Column (field)DescriptionMax SizeRequired
1NameContact full name50✔
2PrefixContact prefix15
3First NameContact First Name25
4Middle NameContact Middle Name25
5Last NameContact Last Name25
6Solicit OKOK to contact: valid values are ‘Y’ and ‘N’25
7Mail OKOK to contact: valid values are ‘Y’ and ‘N’25
8TitleContact title10
9PositionContact position90
10AddressContact address100
11TelephoneContact telephone number20
12Mobile PhoneContact mobile/cell number50
13FaxContact fax number20
14E_mailContact e-mail address100
15PagerContact pager number30
16Remarks1Contact remarks/notes 1100
17Remarks2Contact remarks/notes 2100
18PasswordPassword8
19Customer CodeMarketing Lead code: this must refer to a Lead Code that already exists in the Marketing database15✔
20DefaultDefault contact flag: value = 1 if this is the default. Only one contact can be a default per Marketing Lead6
21CrystalWave Contact TypeNot currently used253
22CrystalWave Report DeliveryNot currently used253
Address Information

The following table identifies the data that can be imported for a Marketing Account Address record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the previous sections of this document.

Col #Marketing Column (field)DescriptionMax SizeRequired
1Address NameAddress Name50✔
2StreetStreet address100
3BlockStreet address 2100
4CityCity100
5Zip CodeZip/Postal Code20
6StateState/Province code: use Code value from OCST where Country = Country (item 10) below3
7Tax CodeNot currently used8
8Address TypeType of address: valid values are ‘B’ (Bill-To) or ‘S’ (Ship-To) ✔
9Card CodeMarketing Lead code: this must refer to a Lead Code that already exists in the Marketing database15✔
10CountryCountry: use Name value from OCRY - MCM import will match the country name and associate the appropriate country code from the table.100

How to Add/Remove Contact People from an Account

Adding a Contact Person
Removing a Contact Person

How to Add/Remove Addresses from an Account

Adding an Address
Removing an Address

How to Copy a Bill To Address to a Ship To Address

How to Add/Remove an Interest from an Account

Adding an Interest to an Account
Removing an Interest from an Account

How to Convert an Account to an SAP Business Partner

How to Create an Activity from an Account

How to Add a Document to the Document Library

To access the TWBS Marketing Campaign Management Document Library screen…

How to Remove a Document from the Document Library

To access the TWBS Marketing Campaign Management Document Library screen…

How to Review Document Usage

To access the TWBS Marketing Campaign Management Document Library screen…

How to Setup a Communication Template

To access the TWBS Marketing Campaign Management Communication Template Setup screen…

How to Edit a Communication Template Message

To access the TWBS Marketing Campaign Management Communication Template Setup screen…

How to Access an Email Communication Template

To access an Email Communication Template…

How to Access an Print Communication Template

To access a Print Communication Template…

How to Add/Update a Marketing Campaign

Adding an Marketing Campaign
Updating an Marketing Campaign

How to Remove a Marketing Campaign

How to Post a Social Media Message

Posting the message to Linked In

The Linked In website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Linked In.

mcmimage135.jpeg

Posting the message to Twitter

The Twitter website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Twitter.

mcmimage136.jpeg

Posting the message to Facebook

The Facebook website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Facebook.

mcmimage138.jpeg

Viewing the Activity created by the Click of the Social Media button

The Activity will be generated in SAP® Business One on the click of the social media button, regardless of if the message is completed through the social media website.

How to Post a Social Media Message from the Campaign Manager

Posting the message to Linked In

The Linked In website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Linked In.

mcmimage135.jpeg

Posting the message to Twitter

The Twitter website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Twitter.

mcmimage136.jpeg

Posting the message to Facebook

The Facebook website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Facebook.

mcmimage138.jpeg

Viewing the Activity created by the Click of the Social Media button

The Activity will be generated in SAP® Business One on the click of the social media button, regardless of if the message is completed through the social media website.

How to Use the MCM Search Screen

Viewing the Search Results Data

mcmimage143.jpeg

Saving the Search as an MCM Search Query

mcmimage145.jpeg