Welcome
Administrator Guides
Administrator Guide
Database table administration
Unica Campaign administrators must perform initial one-time tasks and routine administration tasks that pertain to database tables.
Setting up Unica Campaign to use Database load utilities
You can improve performance by using a database load utility for all datasources.
Oracle - Loader configurations

Unica Campaign
Release Notes
System Requirements
Installation Guides
Upgrade Guide
User Guide
Unica Campaign is a web-based solution that enables you to design, run, and analyze direct marketing campaigns.
Administrator Guides
- Administrator Guide
  - Unica Campaign administration overview
    The Settings menu provides access to most of the tasks that Unica Campaign administrators typically perform.
  - Security in Unica Campaign
    Security policies control user access to the objects and features in Unica Campaign.
  - Database table administration
    Unica Campaign administrators must perform initial one-time tasks and routine administration tasks that pertain to database tables.
    - Table administration concepts
      The following concepts pertain to system tables, user tables, flat files, and table mapping.
    - Initial table administration tasks
      Administrators must perform several initial table-related tasks after Unica Campaign is installed.
    - User table administration
      Unica Campaign administrators typically perform the following tasks pertaining to user tables.
    - System table administration
      Unica Campaign administrators may perform the following tasks pertaining to system tables.
    - Data dictionary administrative tasks
      A data dictionary defines the format of data in a fixed-width ASCII flat file. You use data dictionaries in Snapshot processes to ensure that any fixed-width output files that you create adhere to a specific structure.
    - Table catalog administrative tasks
      A table catalog is a collection of mapped user tables. Administrators can create and load table catalogs and perform other operations to make table catalogs available to Unica Campaign users.
    - Setting up Unica Campaign to use Database load utilities
      You can improve performance by using a database load utility for all datasources.
      - Amazon Redshift - Loader configurations
      - MariaDB - Loader configurations
      - Oracle - Loader configurations
      - Google BigQuery - Loader Configuration
        For GBQ we have tested and supported using “bq” command line tool which is available when Google Cloud SDK is installed (Version 267.0.0), using below link you can download this.
      - PostGreSQL - Loader Configuration
        PostGreSQL UserDB datasource configuration
      - Actian Db - Loader configurations
      - Fast loader repeated tokens
        When you create a LoaderControlFileTemplate or a LoaderControlFileTemplateForAppend, a list of special tokens is repeated once for each field in the outbound table.
      - Using database load utilities with DB2 on z/OS
        A database load utility can improve Unica Campaign performance. Follow these steps to configure Campaign to use a database load utility for a DB2® user database on z/OS®.
      - Troubleshooting database load utilities for Unica Campaign
        Some known issues with database loader utilities are listed below, along with workarounds or solutions.
    - Archiving campaigns and flowcharts
      The Unica Campaign application does not provide an automated way to archive retired marketing campaigns or flowcharts. However, you can back up the required files, then use the Unica Campaign user interface to delete unneeded campaigns and flowcharts.
  - Customizing campaigns
    Administrators can customize campaigns by using custom campaign attributes, initiatives, and products.
  - Offer template concepts
    Before administrators perform offer template management tasks, there are several important concepts to understand.
  - About audience level administration
    Unica Campaign is delivered with a single audience level called Customer. You can define any additional audience levels that you need. Audience levels let flowchart designers target specific groups, such as Households, in marketing campaigns.
  - Before you begin working with contact history
    Contact history is stored in the Unica Campaign system database in separate tables by audience level. Therefore, you need to set up audience levels before you begin working with contact history.
  - Response history administration
    Before you begin working with response history, you should read the audience level administration topics and set up required audience levels.
  - Monitoring and controlling flowchart runs
    Choose Campaign > Monitoring and use the All monitored runs page to view the status of all active flowcharts and suspend, resume, or stop flowchart runs.
  - Dimension hierarchy concepts
    A dimension hierarchy is a data construct that groups data into bins based on value ranges. Dimension hierarchies are the basis for a variety of reports.
  - Triggers administration
    Unica Campaign allows you to define inbound and outbound triggers that can be used in all flowcharts in a partition.
  - Unica Campaign log files
    Unica Campaign records information in several different log files.
  - JVM Parameters
  - About codes in Unica Campaign
    Each campaign, cell, offer, and treatment in Unica Campaign has an identifying code that is generated by code generators, and conforms to a specified format.
  - Accessing the Advanced settings
    When a flowchart is open for editing, administrators can choose the Advanced settings option on the Admin menu to make administrative changes that affect only the current flowchart.
  - Unica Campaign integration with other products
    Unica Campaign optionally integrates with a number of other products.
  - Unica Campaign integration with Kafka
    Kafka instance configuration template - Affinium|Campaign|partitions|partition[n]|Kafka|(KafkaTemplate)
  - Unica Campaign listeners
    The listener is a key component of Unica Campaign. It provides an interface between front-end clients and back-end analytical server processes.
  - Unica Campaign utilities
    Administrators use the Unica Campaign utilities to manage listeners, sessions, and flowcharts, and perform other important administrative tasks.
  - Configuring the ACOOptAdmin tool
    Configure the ACOOptAdmin tool to run Unica Optimize sessions from the command line.
  - Configuring Campaign Instrumentation
    Integrate OpenTelemetry with Unica campaign to implement real-time monitoring of system health, monitor health status of campaign components, and receive alerts before system health deteriorates.
  - Non-ASCII data in Unica Campaign
    Unica Campaign supports the use of localized data and non-United States locales, including multiple user-preferred locales within the same installation of the application.
  - Configuration properties for Unica Campaign
    The configuration properties of Unica Campaign are located at SettingsConfiguration. For more details on the configuration properties, see the Campaign Administrator Guide.
  - About special characters
    Some special characters are not supported in any Unica Campaign object names. In addition, some objects have specific naming restrictions.
  - Introduction to character encodings
    This section provides information on character encodings and language-sensitive database considerations, and lists the encodings supported by Unica Campaign.
  - About Unica Campaign Error Codes
    Unica Campaign notifies users of error events when they occur with error messages that consist of a code number and error text.
  - Troubleshooting
- System Tables
Troubleshooting and Tuning
Performance depends on many factors, including your database and web server configuration, network connectivity and other configurations.
API Guides
Reports
Developer Guides
Campaign and SPSSMA
Integration guides
GDPR Guide
There are several basic concepts that can help you understand how to use Unica Campaign to create and manage marketing campaigns.
Licensing Guide
PDFs
Glossary
Notices

Oracle - Loader configurations

Oracle supports DB loader capabilities. The SQL Loader (sqlldr) utility is specifically used for Oracle databases. It is a powerful and flexible tool provided by Oracle to load data from external files (such as text files or CSV files) into Oracle database tables. See the following configurations.

For Linux

User load configurations

LoaderCommand = <Partition_HOME>/partition1/oraload.sh <DBUSER> <PASSWORD> <DSN> <DATAFILE> <CONTROLFILE>
LoaderCommandForAppend = <Partition_HOME>/partition1/oraload.sh <DBUSER> <PASSWORD> <DSN> <DATAFILE> <CONTROLFILE>
LoaderControlFileSpecifiesFields = FALSE 
LoaderControlFileTemplate = load.ctr 
LoaderControlFileTemplateForAppend = load_append.ctr

Sample oraload.sh file

export USER=$1 
export PASSWORD=$2
export DSN=$3
export DATAFILE=$4
export CONTROLFILE=$5
sqlldr $USER/$PASSWORD@$DSN control=$CONTROLFILE 
rc=$? 
exit $rc

For Windows

User load configurations

LoaderCommand = <Partition_HOME>/partition1/oraload.bat <DBUSER> <PASSWORD> <DSN> <DATAFILE> <CONTROLFILE>
LoaderCommandForAppend = <Partition_HOME>/partition1/oraload.bat <DBUSER> <PASSWORD> <DSN> <DATAFILE> <CONTROLFILE>
 LoaderControlFileSpecifiesFields = TRUE
LoaderControlFileTemplate = load.ctr 
LoaderControlFileTemplateForAppend = load_append.ctr

Sample oraload.bat file

set USER_ID=%1
set PSWD=%2
set DB=%3
set CTRL_FILE=%4
set DATA_FILE=%5
sqlldr %user_id%/%PSWD%@%DB% control=%CTRL_FILE% direct=true
exit %errorlevel%

Sample load.ctr file

options (parallel=false, direct=true, errors=0)
unrecoverable
load data
infile '<DATAFILE>'
replace into table <TABLE>
fields terminated by '|'
OPTIONALLY ENCLOSED BY '"'
TRAILING NULLCOLS
(
<FIELDNAME><,>
)

Sample load_append.ctr file

options (parallel=false, direct=true, errors=0)
unrecoverable
load data
infile '<DATAFILE>'
append into table <TABLE>
fields terminated by '|'
OPTIONALLY ENCLOSED BY '"'
TRAILING NULLCOLS
(
<FIELDNAME><,>
)