IBM Campaign Version-independent Integration with IBM Watson Campaign Automation Version 1 Release 1.5 February, Integration Guide IBM

Transcription

1 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation Version 1 Release 1.5 February, 2018 Integration Guide IBM

2 Note Before using this information and the product it supports, read the information in Notices on page 123. This document describes procedures and features that are supported by IBM Campaign version to x. Copyright IBM Corporation 2014, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents Chapter 1. Overview What you can do with the integration What you cannot do with the integration New in this release Resources to support the integration Chapter 2. Planning Security considerations for Campaign and Watson Campaign Automation Security in Campaign Security in IBM Watson Campaign Automation.. 8 Data management for Campaign and Watson Campaign Automation Integration database tables, ETL, and partitioning 9 Chapter 3. Prerequisites Integration prerequisites for Watson Campaign Automation IBM Watson Campaign Automation organization account Creating the integration user SMS enablement Mobile push enablement Integration prerequisites for Campaign IBM Campaign installation requirements Integration prerequisites for UBX Integration prerequisites for the UBX Toolkit Chapter 4. Installation and configuration Installing the integration files CS_HOME directory Upgrading an existing integration Configuring access to JDBC Creating tables for data download Configuring connections between Campaign and Watson Campaign Automation Firewall preparations Configuring data exchange properties Configuring access to Watson Campaign Automation Proxy server connections Connecting through an HTTP proxy Connecting through an FTP proxy server Encrypting the integration configurations Creating a custom encryption key Removing encryption from configuration properties UBX Toolkit installation Preparing UBX endpoints for the integration Chapter 5. Data upload - Campaign to Watson Campaign Automation What to upload from Campaign Where to put uploaded data in Watson Campaign Automation Finding contact list, database, and relational table IDs in Watson Campaign Automation Finding mailing IDs in Watson Campaign Automation How to upload data to Watson Campaign Automation contactupload tableupload Create database - Campaign to WCA rest API.. 40 Upload preparation and requirements Uploading data by running a script Uploading data by running a flowchart Flowchart design for data upload to Watson Campaign Automation Requirement to match Campaign fields to Watson Campaign Automation fields Mapping field names in a flowchart Mapping fields with a custom XML file Requirement to match date formats Default date format for uploads Uploading dates with derived fields Chapter 6. Contact data download - Watson Campaign Automation to Campaign Contact data available from Watson Campaign Automation Where to download contact data How to download contact data contactdownload Downloading contact data by running a script.. 58 Scheduling contact data downloads by running a flowchart Flowchart design for downloading contact data 59 Chapter 7. Tracking data download - Watson Campaign Automation to Campaign Tracking data provided by Watson Campaign Automation Adding additional tracking information Tracking data available through the UBX Toolkit 65 Where to download tracking data How to download tracking data trackingdownload Downloading tracking data with a script Scheduling tracking data downloads Tracking data download with the UBX Toolkit.. 70 Error reporting for tracking data Copyright IBM Corp. 2014, 2018 iii

4 Chapter 8. messaging Uploading contact data to Watson Campaign Automation Sending messages after uploading contact data Downloading contact data Downloading tracking data Support for Send Time Optimization Filter mailing templates Chapter 9. SMS messaging General requirements for SMS messaging Consent requirements for SMS messaging Data required for SMS consent Uploading SMS contact and consent data to Watson Campaign Automation Sending SMS messages after uploading SMS contact and consent data Downloading SMS consent data SMS Opt-in and Opt-out synchronization between Campaign and Watson Campaign Automation Downloading SMS message tracking data Chapter 10. Mobile app messaging.. 95 Mobile push contact synchronization between Campaign and Watson Campaign Automation Uploading mobile push contact data to Watson Campaign Automation Sending push notifications after uploading contact data Downloading mobile push contact data Downloading mobile push tracking data Chapter 11. Reference: Mapping files 101 Chapter 12. Custom tracking tables 107 Event types Report IDs Reasons for contact suppression SP_Attachment SP_BounceReply SP_Click SP_Conversion SP_Forward SP_Open SP_OptIn SP_OptOut SP_Sent SP_Suppressed SP_UploadAudit Before you contact IBM technical support Notices Trademarks Privacy Policy and Terms of Use Considerations 125 iv IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

5 Chapter 1. Overview The integration of IBM Campaign with IBM Watson Campaign Automation combines the precision segmentation tools in Campaign with the robust, cloud-based messaging capabilities of IBM Watson Campaign Automation. IBM Watson Campaign Automation is part of the IBM Watson Campaign Automation. Use the integration to upload Campaign segmentation and contact data to Watson Campaign Automation databases, contact lists, and relational tables. You can then apply the information from Campaign and messaging tools in Watson Campaign Automation to target specific audiences, individually personalize each message, and reach current and potential customers through , SMS, and mobile push notifications. When the message recipients respond to Watson Campaign Automation, you can download contact and tracking data back to Campaign to retarget message responders so that you can maintain contact throughout the customer journey. How it works The integration is based on a package of scripts that interact with Campaign flowcharts and Watson Campaign Automation application programming interfaces (API). Download and configure the integration package to enable a secure, automated exchange of segmentation, contact, and tracking data between Campaign and Watson Campaign Automation. Run the data upload and download scripts from a command line or automate the data exchange by adding a script to the configuration of a Campaign flowchart. v Configure the integration package to establish the connection between Campaign and Watson Campaign Automation. v Design and run flowcharts in Campaign to determine what to send to Watson Campaign Automation. v Design and run upload scripts to determine how to send the data to Watson Campaign Automation and determine where the data goes. v Run download scripts to bring responses back to Campaign. The integration also takes advantage of IBM Universal Behavior Exchange (UBX) and the UBX Toolkit to bring tracking data from Watson Campaign Automation into Campaign. Use the version-independent integration of Campaign with Watson Campaign Automation with Campaign versions through If you install or upgrade to Campaign 10.0, you do not need to use the integration that is described here. The integration at a glance. The following diagram illustrates the various elements of the integration and the flow of data between them. Copyright IBM Corp. 2014,

6 Watson Campaign Automation WCA Database A Campaign. Select message recipients. B Integration scripts in a flowchart trigger, which you add to a Mail List process. Upload data to Watson Campaign Automation. C Watson Campaign Automation. Receive data in Watson Campaign Automation databases, contact lists, and relational tables. D Use the data from Campaign with Watson Campaign Automation message templates to create , SMS, and mobile app messages. E Send messages in various channels. F Recipients receive the messages and respond. G Return contact and tracking data to Campaign. Depending on channel, use download scripts or UBX and the UBX Toolkit. In UBX, register Watson Campaign Automation as an events publisher. H Use the integration download scripts and the UBX Toolkit to receive the downloaded data and add it to Campaign tables. In UBX, register Campaign as an events subscriber. 2 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

7 What you can do with the integration The integration of Campaign with Watson Campaign Automation gives Campaign users a way to use Watson Campaign Automation messaging tools and gives Watson Campaign Automation users access to segmentation tools in Campaign. You can use the integration software and procedures to perform the following tasks. v Use flowcharts and integration scripts in Campaign to select and automatically upload data to Watson Campaign Automation. Use existing Campaign scheduling features to schedule the data upload for a specific time or on a recurring basis. v Upload segmentation data from Campaign and automatically trigger outbound messaging based on pre-configured , SMS, or mobile push templates. v When you trigger outbound messages with a data upload, you can add a campaign code or other label to the mailing name for better response tracking. v Upload the output of a Campaign flowchart to update the contents of one or more existing contact lists, databases, or relational tables in Watson Campaign Automation. You can specify a contact list or database by ID or by name. v Define a new contact list in Watson Campaign Automation when you upload the output of a Campaign flowchart. v Use flowcharts and scripts in Campaign to select and upload SMS contact and consent data to Watson Campaign Automation. In Watson Campaign Automation, send SMS messages that are addressed and personalized with the uploaded segmentation data. v Use integration download scripts and existing Campaign scheduling features to download contact data and tracking data from Watson Campaign Automation. Schedule the data download for a specific time or on a recurring basis. v Use IBM Universal Behavior Exchange (UBX) and the UBX Toolkit to download SMS and mobile push tracking data from Watson Campaign Automation. What you cannot do with the integration Some aspects of the integration of Campaign with Watson Campaign Automation limit what you can do in each application with the data that you share between them. v You cannot upload offer information from Campaign to Watson Campaign Automation. The integration of Campaign with Watson Campaign Automation does not support Campaign offers. v You cannot use the integration to send SMS messages until you purchase SMS messaging for IBM Watson Campaign Automation and IBM provisions your Watson Campaign Automation organization for SMS messaging. See Chapter 3, Prerequisites, on page 11. v You cannot use the integration to send mobile app messages until you enable your IBM Marketing Cloud account for mobile push and implement your mobile app with IBM Watson Campaign Automation. See Chapter 3, Prerequisites, on page 11. v You cannot use the integration as a data migration tool. The integration is designed only to upload the output of a single Campaign flowchart to Watson Campaign Automation and to download selected contact and tracking data from Watson Campaign Automation to Campaign. Chapter 1. Overview 3

8 New in this release IBM periodically updates the integration of IBM Campaign and Watson Campaign Automation to improve and expand what you can do with the integration of the two applications. What's new in v1.5 This release introduces the following new features and capabilities. v Increased flexibility in customizing contact upload from Campaign to WCA During the contact upload process, you can customize your IBM Campaign to WCA mapping file by issuing the -v or --listinfo command in the contactupload.bat script. By issuing the -v or --listinfo command, you generate and define parameters for the mapping file to that is to be used in the upload. v Support for database creation in WCA We've added support for the WCA Create Database REST API. Now you can create a database for contact lists in WCA without having to log in to WCA. This API is used in conjunction with the contactupload.bat or contactupload.sh scripts. v Support for CampaignAudienceId By using the contactupload script, marketers can upload Campaign's audience ID to WCA in as a column a TSV file. When WCA receives the TSV file, it marks the data with a tracking number. To track the data in IBM Campaign, use the trackingdownload script. v Enhanced control of mailings in WCA In the v1.5 of this integration, you now have the ability to specify a Virtual Mail Transport Agent (VMTA) while scheduling mailings during the contact upload process. Ergo, you can allocate specific mailing servers to contact lists as you upload them from IBM Campaign to WCA. v Addition of a API Connection Retry feature You can now configure the config.properties file to initiate a connection retry attempt when an API encounters a HTTP 503 connection error. What's new in previous releases v Expanded support for SMS messaging This release enables you to upload contact data without the need few a custom mapping file. You can send SMS messages automatically after you upload SMS contact data. v Expanded support for mobile push notifications. This release enables you to upload contact data with configurable sync fields. You can send push notifications automatically after you upload contact data. v Configurable sync fields for contact upload to support non-keyed databases in Watson Campaign Automation You can define a synchronization field in the integration configuration properties and selectively override the field settings when you run an integration script from the command line or as part of a flowchart trigger. v Send Time Optimization support for When you upload contact data to Watson Campaign Automation, you can now include a parameter that instructs Watson Campaign Automation to enable Send Time Optimization. 4 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

9 v Separate proxy server support for HTTP and FTP If your corporate data security plans demand separation between your corporate data and the public Internet, you can connect to IBM Watson Campaign Automation through either an HTTP proxy or an FTP proxy. Your choice. v SMTP Authentication for sending error logs As part of the integration configuration, you can now specify the credentials that are required to access the SMTP server that you use to send error reports for tracking download. v Expanded response tracking through the UBX Toolkit You can now download tracking data for all messaging channels through the UBX Toolkit and IBM Universal Behavior Exchange (UBX). Resources to support the integration The Campaign to Watson Campaign Automation integration provides various types of support to help you use the products together and resolve problems that might occur. v The IBM Campaign and IBM Watson Campaign Automation Version-independent Integration Guide provides descriptions and procedures for concepts and tasks that are specific to the integration. For concepts and tasks that apply to Campaign, Watson Campaign Automation, UBX, or the UBX Toolkit separately from the integration, see the general product documentation that is available for each application. v Product documentation for IBM Watson Campaign Automation is available in the IBM Watson Campaign Automation Knowledge Base at You must provide valid login credentials to access the IBM Watson Campaign Automation Support Portal. v Product documentation for Campaign is available on the IBM Knowledge Center at product_welcome_kc_campaign.dita v Product documentation for IBM Universal Behavior Exchange (UBX) is available on the IBM Knowledge Center at kc_welcome_ubx.dita v Product documentation for the UBX Toolkit is available on the IBM Knowledge Center at v The integration scripts include detailed help on the command line through the -h or -help option. v The property files and example files that are provided as part of the integration contain detailed comments that explain how to customize the integration for your working environment. Chapter 1. Overview 5

10 6 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

11 Chapter 2. Planning The first phase of integrating IBM Campaign with IBM Watson Campaign Automation requires satisfying requirements in both product environments for network communication, application access, and data management. To ensure a successful integration in your environment, review and complete all system and security requirements for Campaign and Watson Campaign Automation before you install and configure the integration files. Consider the effort, user permissions, and resources that are required to satisfy these requirements in your working environment. Security considerations for Campaign and Watson Campaign Automation IBM Campaign and IBM Watson Campaign Automation control application access in slightly different ways. Planning how to control access to the integration of Campaign and Watson Campaign Automation requires an understanding of both products and how they can operate together. As you plan to implement the integration of Campaign and Watson Campaign Automation in your environment, consider the following issues. v User accounts, roles, and permissions that are defined in Campaign are separate from users and permissions that are defined in Watson Campaign Automation. There is no single sign-on between the two products. Marketing users require separate user accounts to access Campaign and Watson Campaign Automation. v The integration scripts require a special user account so that they can operate automatically. This user is referred to as the integration user. v In Watson Campaign Automation, use shared databases instead of private databases so that all members of your organization can access them. Content in private databases is not available to other users or to the integration scripts. Related concepts: Firewall preparations on page 21 Security in Campaign IBM Campaign installs with IBM Platform. Security for both applications is based on user permissions that are set for each application. In IBM Campaign and IBM Marketing platform, you define logins for individual marketing users and set permissions on them. The permissions limit what each user can do within Campaign. You can create various security policies and roles to manage user permissions. You set policies on top level folders within Campaign. the top-level policies, in combination with user permissions, restrict which objects in Campaign users can access and what they can do with them. Copyright IBM Corp. 2014,

12 For more information on security in IBM Campaign, see the IBM Campaign Administrator's Guide. Security in IBM Watson Campaign Automation For more information on security in IBM Watson Campaign Automation, see the IBM Watson Campaign Automation Knowledgebase. Related tasks: Configuring access to Watson Campaign Automation on page 22 Data management for Campaign and Watson Campaign Automation To use Campaign and Watson Campaign Automation together, you must understand where your data lives. You need to know what your IT security and privacy officers are comfortable uploading to the Cloud and publishing in . You also need to anticipate the types of segmentation and personalization that you need to effectively reach your customers. The integration of IBM Campaign and IBM Watson Campaign Automation depends heavily on the exchange of information between the two applications and how that data exchange is managed. It is important to remember that IBM Campaign is installed locally, behind corporate security firewalls. Watson Campaign Automation is a cloud-based service that is accessed through secure login. In Campaign, you can design flowcharts to create rich segmentation over the data in any database to which Campaign is connected. The segmentation includes data from external data imports and activity from multiple channels, such as direct mail, call center activity, and . You can send the segmentation output to a file or database table, where fulfillment processes for different channels can pick up the list of contacts and use them. The output can also contain other database fields for personalization purposes. Watson Campaign Automation mailings and programs work with either queries or contact lists. A contact list is a list of rows within an Watson Campaign Automation database. The database can be populated manually, through an API, or through web forms. A query is a set of criteria that can be based on any data that is available to Watson Campaign Automation, whether in databases or relational tables. Programs in Watson Campaign Automation can also use Universal Behaviors to decide whether to add a particular contact to the program. The Campaign integration with Watson Campaign Automation allows marketing users to upload or download database data from Watson Campaign Automation, upload relational table data, and download tracking events from Watson Campaign Automation tracking. Flowcharts can also add contacts to a contact list based on Campaign segmentation and integration scripts. Some local Campaign data must be uploaded to the cloud in order for Watson Campaign Automation to work. The following examples are typical of the kind of data that either exists in the cloud-based systems or must be uploaded to those systems. v Data for keys that you define in your Watson Campaign Automation database. 8 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

13 v Data that is required to personalize the messages that you send. For example, if you want to address the contact by first name and title in your messages, you need to have first name and title stored in your database. v Any Universal Behavior data that you are planning on taking advantage of in programs. Universal behavior data is stored in Watson Campaign Automation and cannot be downloaded to the Campaign database. v Any data that is collected through Watson Campaign Automation web forms. Note: If you plan to use data from Campaign in messages that involve SMS, Mobile Push Notification, CRM integration, or Watson Campaign Automation Universal Behaviors you must upload the data to a non-keyed Watson Campaign Automation database. Data that does not need to go into the cloud includes any data that is not in the categories that are described above. For example, you might need a postal code to determine whether an individual contact is near a participating retail outlet, or you might want to check purchase history to determine whether an individual is a high, medium, or low value customer. You can use Campaign to make those determinations locally, behind the firewall, and upload only the contact list that results from the query. You do not need to upload the postal code or the purchase history to Watson Campaign Automation to use that data in your segmentation criteria. Related concepts: What to upload from Campaign on page 30 Where to put uploaded data in Watson Campaign Automation on page 31 Integration database tables, ETL, and partitioning The Campaign integration with Watson Campaign Automation populates different database tables for auditing and tracking. Consult with your database administrator to discuss how long you need to keep the data for querying. Depending on the volume of activity for your account, the tables can grow large over time. Each integration table shares some characteristics. v The primary key is an identity or sequence column. The IDs in the primary keys reflect the order in which rows were inserted. v The tables have a datetime/timestamp column to indicate the time at which a particular event happened. v The rows in each table are inserted once and the integration does not update them after the initial insert. v There are no predefined indexes, foreign keys, or check constraints other than the primary key. If you are not using recipient address as the audience level in Campaign, you can add one or more columns to the tracking tables. However, your data must include a way to look up audience level for any contact. You must configure the integration to download the values for those columns from your Watson Campaign Automation database. When you add columns, do not use unique indexes or constraints because you might prevent data from being inserted. Chapter 2. Planning 9

14 The integration scripts do not automatically purge or archive the tables. Your administrator can schedule archiving or purging of the data. A typical purging scheme might set up range partitioning on the datetime/timestamp field, with partitions for each month or quarter. The purging plan can drop partitions when they become outdated. However, different database capabilities and performance characteristics can affect your strategy for partitioning and purging of data. How you query the data might also affect your strategy. When you download events by using ETL, Campaign processes events for populating detailed contact history and response history. Campaign runs these ETL events: Mailing Sent Event and Mailing Bounce Event to populate the detailed contact history and Mailing Open Event and Mailing Clickthru Event to populate the response history. This ETL process runs in the background of the Campaign web application. You can configure the schedule and frequency for ETL under: "Settings for 'contactandresponsehisttracking' (Affinium Campaign partitions partition1 Watson Campaign Automation contactandresponsehisttracking)". As Watson Campaign Automation runs ETL events on the Campaign web application, a cluster user can control Watson Campaign Automation ETL execution on individual nodes by specifying JVM option: -Dengage.etl.disabled=true. When -Dengage.etl.disabled=true. This option disables Watson Campaign Automation ETL on the specified cluster node. 10 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

15 Chapter 3. Prerequisites The various components that play a role in the integration of Campaign and Watson Campaign Automation each have a set of prerequisites that you must satisfy before you install and operate the integration. You must satisfy each set of prerequisites separately. Information that you might need to complete the prerequisites for Campaign or Watson Campaign Automation is included here or in the supporting documentation for each product. Integration prerequisites for Watson Campaign Automation Before you can use Watson Campaign Automation with Campaign, you must establish access to Watson Campaign Automation. You must create an IBM Watson Campaign Automation user account to gain access on behalf of your organization and configure a system user with access to Watson Campaign Automation to perform integration tasks. Learn more about IBM Watson Campaign Automation and how to request a user account at Related concepts: Integration prerequisites for Campaign on page 15 IBM Watson Campaign Automation organization account To access IBM Watson Campaign Automation, you must provide a valid user name and password. You must have an IBM Marketing Cloud account to receive a login. IBM Watson Campaign Automation manages user and application access to Watson Campaign Automation through organizations that are created in Watson Campaign Automation. You can designate one or more members of your marketing or IT team as organization administrators. An organization administrator can configure organization settings, manage users, supervise mailings, and monitor and assess mailing results. The organization administrator is also granted the user permissions within Watson Campaign Automation that are required to configure the integration of Campaign with Watson Campaign Automation. If you are a current IBM Watson Campaign Automation customer, you can use your existing account login to access Watson Campaign Automation to configure the integration. If you are a Campaign user who wants to use IBM Watson Campaign Automation, your business organization must establish an account with IBM Watson Campaign Automation. To request credentials to access IBM Watson Campaign Automation, contact your IBM representative. Copyright IBM Corp. 2014,

16 Creating the integration user IBM Campaign automatically accesses data management and messaging features in the Watson Campaign Automation environment as a standard Watson Campaign Automation user over a secure HTTPS connection. In the context of the IBM Campaign and IBM Watson Campaign Automation integration, this user is referred to as the integration user. Before you begin Access IBM Watson Campaign Automation to complete this task. You must have a valid IBM Watson Campaign Automation login to access Watson Campaign Automation. You must be an organization administrator to create the integration user. About this task Accessing Watson Campaign Automation as the integration user provides IBM Campaign with a way to submit access credentials to IBM Watson Campaign Automation without the need for manual intervention. To fully configure the integration user, you must manually log in as the integration user at least once so that you can define a persistent user password. You must configure the integration user to have permissions to upload and download data, add and remove contacts, and to send mailings. You must also associate the user with an account that can receive system notifications and credentials. Specify an account that you can access easily and monitor frequently. The integration user does not require access to the IBM Watson Campaign Automation Support Portal. Procedure 1. In Watson Campaign Automation, go to Settings > User Accounts. Click Create User Account. Accept the default settings except as noted in the following steps. 2. On the Create User page, complete the User Information fields. a. In the User section, enter a user name and enter a password that conforms to the password standards that are defined on the page. Select Do not enforce password expiration policies for this user. Note: The password is a temporary password that is valid for 7 days. After you configure the integration user, you must log in to Watson Campaign Automation within 7 days to define a permanent password. b. Enter a name for the integration user. The name can be any name. c. In the Role field, select Standard User. d. In the Contact fields, provide contact information that the system uses to provide notifications. Enter an address that you can access and monitor readily. Important account credentials are delivered to the address that you specify. e. In the Localization section, enter a time zone and default language. Enter the time zone that is appropriate for where the Campaign Analytic server is located. 12 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

17 f. In the Defaults section, enter a name, address, and reply address that the system uses to define the sender of the marketing that you send. 3. Click Save. After you save, you can define other aspects of the integration user. 4. In the User Permissions section, select the following options to define permissions for the integration user. v Data access. For this permission, select Add/Remove Contacts from Contact Lists and Edit Queries. v Allow user to upload content to Stored Files and Mailing Templates 5. Click Save. 6. Go to Settings > Organization Settings. You must be an organization admin to access this menu. The Organization Settings window opens. 7. In the Application Account Access section, click Add Application. Enter Campaign Integration as the name to identify the integration as an external application that can access Watson Campaign Automation data. Click Add. 8. Click Add Account Access. The Add Account Access window opens. 9. In the Application field, select Campaign Integration, which is the name that you assigned for the integration in Step 7. In the User Account field, select the user name that you entered in Step 2. Click Add. 10. Monitor the notification address that you defined for the integration application until you receive an notification. The notification contains the application name that you defined the integration application and a refresh token. 11. In the Application Account Access section, click the name that you assigned to the integration application. A Client ID and Client Secret display. Record the values for future use. 12. Log out of Watson Campaign Automation. Log back in to Watson Campaign Automation with the user name and password that you defined for the integration user in Step 2. a. Go to Settings > User Profile. b. In the User section, enter the current password for the integration user and define a new password. The new password is the permanent password for the integration user. c. Click Save. Results The new integration user displays as a standard user on the Enabled tab of the User Accounts page. Following information is defined for the integration user. v User name v Password v Client ID v Client Secret v Refresh token Record the information in a secure location. The information is required to configure access between Campaign and Watson Campaign Automation. Chapter 3. Prerequisites 13

18 If you configured the user to ignore password expiration policies as required in Step 2, you are not prompted to change this password again. What to do next The integration user runs the integration scripts. You must specify the user name and password that you define for the integration user in the sp.properties configuration file. The integration user can operate only on shared objects in Watson Campaign Automation. When you create objects in Watson Campaign Automation, such as databases, contact lists, or mailings, be certain to create them as shared objects. SMS enablement To send SMS messages from IBM Watson Campaign Automation, you must complete certain preparations to enable your Watson Campaign Automation organization for SMS. You must be an organization administrator to complete some of the steps in the process. The Provisioning Team for the IBM Watson Campaign Automation must enable your organization for SMS. Then, you must log into Watson Campaign Automation and complete additional steps to prepare your organization for SMS messaging. v Create and enable an Watson Campaign Automation database for SMS. The database must be a non-keyed database. v Configure SMS integration between Watson Campaign Automation and the SMS Campaign Manager. Each Watson Campaign Automation organization can have only one database that is enabled for SMS. If you also plan to send mobile push notifications you can enable a single database for SMS and Mobile App Messages. However, you can also enable one database for SMS and another database for Mobile App Messages. For more information regarding how to enable your IBM Watson Campaign Automation organization for SMS messaging, see the description of SMS in the IBM Watson Campaign Automation Knowledge Base at kb/engage/mobile/sms_-_silverpop_mobile_messaging. Mobile push enablement To send mobile push notifications from IBM Watson Campaign Automation, you must complete certain preparations to enable your Watson Campaign Automation organization for Mobile App Messages. You must be an organization administrator to complete some of the steps in the process. The Provisioning Team for the IBM Watson Campaign Automation must enable your organization for Mobile App Messages. Various individuals contribute to making it possible to send mobile push notifications from Watson Campaign Automation, including mobile app developers, the Watson Campaign Automation organization administrator, and mobile marketers. The entire process includes the following general steps. 14 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

19 v The Provisioning Team enables Mobile App Messages for your organization. v Mobile app developers build and register your mobile app. v Download the SDK. Implement the SDK within the mobile app. v Customize the app, as needed. v Create an Watson Campaign Automation database for Mobile App Messaging. The database must be a non-keyed database. v Set up the mobile app in IBM Watson Campaign Automation. Each Watson Campaign Automation organization can have only one database that is enabled for Mobile App Messaging. If you also plan to send SMS messages, you can enable a single database for SMS and Mobile App Messaging. However, you can also enable one database for SMS and another database for Mobile App Messages. For more information regarding how to enable your IBM Watson Campaign Automation organization for Mobile App Messages, see the description of the process in the IBM Watson Campaign Automation Knowledge Base at Integration prerequisites for Campaign Before you can use Watson Campaign Automation with Campaign, you must update the IBM Marketing Software environment, including the installations of IBM Platform and IBM Campaign. If you are an Watson Campaign Automation user who is beginning to use IBM Campaign, you must install and configure IBM Campaign in your local computing environment. Campaign requires that you also install and configure IBM Marketing Platform. v If Campaign is not installed in your local environment, you must install Campaign. v Define Campaign users with appropriate roles and permissions. v Identify the data that you need to upload to Watson Campaign Automation. v Download and install the integration package on the Campaign Analytics Server. For a full list of installation and configuration requirements for Campaign, see the IBM Campaign Installation Guide or the IBM Campaign Upgrade Guide. Related concepts: Integration prerequisites for Watson Campaign Automation on page 11 IBM Campaign installation requirements To use Watson Campaign Automation messaging tools with Campaign segmentation tools, you must install and configure IBM Campaign. Campaign requires that you also install and configure IBM Marketing Platform. The IBM Campaign integration with IBM Watson Campaign Automation is supported on IBM Campaign version to For more information about how to install Campaign, see the IBM Campaign Installation Guide. Chapter 3. Prerequisites 15

20 To integrate Campaign with Watson Campaign Automation, you must complete the following tasks. v Configure the Campaign system tables and schema. v Define roles and permissions for Campaign users. For information on installing and configuring IBM Campaign, see the IBM Campaign Installation Guide and the IBM Campaign Administrator's Guide. Integration prerequisites for UBX You can use UBX and the UBX Toolkit to download tracking data from Watson Campaign Automation. To use UBX you must have a UBX user account. Access to UBX user accounts requires entering a user name and password that IBM creates for each UBX user account. Contact IBM to request a UBX user account. As part of the installation and configuration process, you register Campaign and Watson Campaign Automation as endpoints in UBX and configure event syndication between them. Integration prerequisites for the UBX Toolkit The UBX Toolkit depends on UBX and on files that you install in your local environment. You must establish the UBX account and complete the UBX Toolkit installation and configuration before you can download tracking data for SMS messages and mobile push notifications. To access UBX, IBM must create and provision a UBX account on your behalf. To request that IBM to create and provision your UBX account, contact the UBX Account Provisioning team by at ubxprovisioning@wwpdl.vnet.ibm.com or request access to UBX at signup.do?source=ibm-ubxprovision. Installing and operating the UBX Toolkit requires access to various systems in your local network environment. Establishing this access typically requires network or database administrative privileges. For a full list of installation and configuration requirements for the UBX Toolkit, see the UBX Toolkit Users Guide on IBM Knowledge Center here: 16 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

21 Chapter 4. Installation and configuration Installing the integration files The integration of Campaign with Watson Campaign Automation depends on a collection of files that you download from IBM developerworks to the environment in which Campaign is installed. You install the files on the Campaign Analytics server. You perform all of the installation and configuration tasks, except for firewall modifications, in the local Campaign environment. To install the IBM Campaign integration with IBM Watson Campaign Automation, download the integration package from IBM DevWorks and extract the archive into a directory in your existing Campaign installation. Before you begin Complete the integration planning and prerequisites for Campaign and Watson Campaign Automation. Procedure 1. Go to IBM devworks and download the installation package for your operating system. Table 1. Integration Installation Packages Operating System Windows UNIX or Linux Installation download package IBM_Campaign_Integration_with_IBM_Engage_1.3_Windows.zip IBM_Campaign_Integration_with_IBM_Engage_1.3_Unix-Linux.tar.gz 2. On the Campaign Analytics server, extract the compressed archive into a folder under../campaign/partition/partition1/. The folder where you install the files is considered the <CS_HOME> directory. 3. In <CS_HOME>, configure the setenv file. This file is in the bin directory. a. Copy and rename example_setenv.bat to setenv.bat or example_setenv.sh to setenv.sh. b. Configure the setenv file as instructed by comments in the file. 4. In <CS_HOME>, configure jdbc.properties. This file is in the conf directory. a. Copy and rename example_jdbc.properties to jdbc.properties. b. Configure jdbc.properties as instructed by comments in the file. 5. In <CS_HOME>, configure config.properties. This file is in the conf directory. a. Copy and rename example_config.properties to config.properties. b. Configure config.properties as instructed by comments in the file. 6. In <CS_HOME>, configure sp.properties. This file is in the conf directory. You must be familiar with the configuration of the integration user to complete this step. a. Copy and rename example_sp.properties to sp.properties. Copyright IBM Corp. 2014,

22 b. Configure sp.properties as instructed by comments in the file. 7. In <CS_HOME>, make a copy of example_logback.xml. This file is in the conf directory. a. Rename the copy as logback.xml. b. (Optional) Update the <max History> tag. By default, this tag is set to 14. This setting maintains a log history of 14 days. You can change this value to suit your requirements. 8. For UNIX or Linux environments only, change directory to the bin directory, then run chmod +x *.sh. What to do next Create database tables to accept data that is downloaded from Watson Campaign Automation. Related tasks: Creating tables for data download on page 19 Configuring connections between Campaign and Watson Campaign Automation on page 21 CS_HOME directory The directory where you install the scripts, property files, and other software to support the Campaign integration with Watson Campaign Automation files is referred to as <CS_HOME>. The integration files must be installed in a folder under../campaign/partition/ partition1/, on the Campaign Analytic server. Note the path to the <CS_HOME> folder. You specify an absolute or relative path to this folder when you run the integration scripts. Related tasks: Downloading tracking data with a script on page 69 Related reference: contactupload on page 33 tableupload on page 38 contactdownload on page 56 trackingdownload on page 68 Upgrading an existing integration IBM periodically upgrades the Campaign to Watson Campaign Automation integration to fix observed issues and to introduce new capabilities. Before you begin To preserve your current configurations, back up your existing Campaign to Watson Campaign Automation integration installation. The upgrade replaces the existing files with new files. 18 IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide

23 Procedure Configuring access to JDBC 1. Backup the current <$CS_HOME> directory. You will need to use the backup files to replicate your configuration settings. 2. Download the compressed installation file archive and extract the files into <$CS_HOME>. The new files overwrite the existing files. Windows: IBM_Campaign_Integration_with_IBM_Marketing_Cloud_1.3_Windows.zip Linux or UNIX: IBM_Campaign_Integration_with_IBM_Marketing_Cloud_1.3_Unix-Linux.tar.gz 3. In the conf directory, open example_sp.properties. Add the new proxy properties to your sp.properties file. v v v v v v sp.proxy.url URL for the web proxy server. sp.proxy.username User name to access the web proxy server. sp.proxy.password Password to access the web proxy server. sp.proxy.ftp.url=url for the FTP proxy server. sp.proxy.ftp.username= User name to access the FTP proxy server. sp.proxy.ftp.password= Password to access the FTP proxy server. 4. In the ddl directory, run the appropriate version of the cs_tab_upgrade_ _xxx.sql script for your database. v v v DB2: cs_tab_upgrade_ _db2.sql Oracle: cs_tab_upgrade_ _ora.sql MS SQL Server: cs_tab_upgrade_ _sqlsvr.sql Use the jdbc.properties file to configure JDBC access to enable data transfer between IBM Campaign and IBM Watson Campaign Automation. About this task To configure properties in this file, you must know the database driver class and the JDBC URL for the Campaign database that contains the data that you upload to Watson Campaign Automation. You must also know the name and password for the system user that is used to access the Campaign database. Procedure Comments in jdbc.properties provide guidance for configuring each property. The jdbc.properties file is in the conf directory of CS_HOME. Creating tables for data download To enable Campaign to receive contact and tracking data from Watson Campaign Automation, you must create new database tables to receive the downloaded data. The integration package includes several DDL scripts that you can use to create the required tables. Before you begin Confirm that the integration files are installed in a folder on the Campaign Analytics server. The folder that contains the integration files is considered the <CS_HOME> directory. Locate the ddl folder. Chapter 4. Installation and configuration 19

24 Procedure 1. On the Campaign Analytics server, navigate to the ddl folder in the <CS_HOME> directory. 2. Use your database client to run the DDL scripts against the database or schema that holds the Campaign system tables. v v v Microsoft SQL server: cs_tab_sqlsvr.sql Oracle: cs_tab_ora.sql IBM DB2: cs_tab_db2.sql Running the DDL script against the Campaign database extends the Campaign database schema to include the new tables. Results The following tables are created in the Campaign database schema. Tracking table Description More information SP_Attachment SP_BounceReply Records when an attachment is downloaded or viewed. Records of unsuccessful message delivery. SP_Attachment on page 109 SP_BounceReply on page 110 SP_Click Records for link clicks in messages. SP_Click on page 110 SP_Conversion SP_Forward Records of Watson Campaign Automation conversion events. Records of messages that were forwarded. SP_Conversion on page 112 SP_Forward on page 113 SP_Open Records of message opens. SP_Open on page 113 SP_OptIn Records that are marked as opted-in. SP_OptIn on page 114 SP_OptOut Records that are marked as opted-out. SP_OptOut on page 115 SP_Sent Records of messages sent. SP_Sent on page 116 SP_Suppressed SP_UploadAudit Records of recipients for whom messages are suppressed. Record of all data uploads and related API calls. SP_Suppressed on page 117 SP_UploadAudit on page 118 The SP_UploadAudit table is updated when marketers run the contactupload or tableupload script to upload data and segmentation to Watson Campaign Automation. The remaining tables are updated when marketers run the trackingdownload script to download tracking data from Watson Campaign Automation. Related tasks: Installing the integration files on page IBM Campaign Version-independent Integration with IBM Watson Campaign Automation: Integration Guide