Home
Administrator Guides
Administrator Guide
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.
About creating custom code generators
You can create custom code generators in any language that can be compiled into an executable file for the operating system on which you are running Unica Campaign.
About outputting errors
The custom code generator must output an error to the standard output stream (stdout) when it is not able to properly generate a unique code of the proper format.

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.
  - 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.
    - About Unica campaign codes
      A campaign code is the globally unique identifier for a campaign. Each campaign must have a code, and no two campaign codes in the same Unica Campaign partition can be the same.
    - About cell codes
      A cell code is an identifier for each cell in a flowchart or in the target cell spreadsheet.
    - About offer codes
      An offer code is the globally unique identifier for an offer. A treatment code is the globally unique identifier for a combination of a cell (a list of IDs) and an offer.
    - Code formats
      The default and valid format for each type of generated code uses a series of characters to represent the character types. You can override the default formats for the codes generated by the Campaign built-in code generators.
    - Default code formats
      The following table shows the default formats for campaign, cell, offer and treatment codes that are generated by the Unica Campaign built-in code generators.
    - About code generators
      Code generators are the programs used to automatically generate campaign, cell, offer, and treatment codes of the required format in Unica Campaign.
    - About custom code generators
      If the Unica Campaign default code generators do not meet your needs, you can develop and use your own code generators.
    - About creating custom code generators
      You can create custom code generators in any language that can be compiled into an executable file for the operating system on which you are running Unica Campaign.
      - About outputting unique codes
        The custom code generator must output unique codes, of no more than 32 characters, to the standard output stream (stdout).
      - About outputting errors
        The custom code generator must output an error to the standard output stream (stdout) when it is not able to properly generate a unique code of the proper format.
      - About placing the custom code generators
        You must place the application that generates campaign or cell codes in the bin directory of your Unica Campaign installation.
      - To specify the location of the custom offer code generator
        On the Configuration page, change the value of the offerCodeGeneratorConfigString property in the Campaign | partitions | partition_N | offerCodeGenerator category to the location of the custom offer code generator executable. The location is relative to the Unica Campaign web application home.
    - Properties related to code generation
      On the Settings > Configuration page, you can modify configuration properties to customize code formats and generators.
    - Parameters for the default campaign and cell code generators
      The uaccampcodegen program supports the parameters described in this section. The uaccampcodegen program is located in the bin directory under your Unica Campaign installation directory.
    - Parameters for the default offer code generator
      The uacoffercodegen program supports the parameters described in this section. The uacoffercodegen program is located in the bin directory under your Unica Campaign installation directory.
    - Parameters for custom code generators
      Unica Campaign supports custom parameters as input to any custom code generator you configure for use in Unica Campaign.
  - 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 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.
  - 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

About outputting errors

The custom code generator must output an error to the standard output stream (stdout) when it is not able to properly generate a unique code of the proper format.

The output line for the error must:

Start with 0,
Followed by one or more blank spaces,
Followed by the error message, within double quotation marks.

Example

The following example shows the correct code output format:

0 "error_message"

Note: The error message generated by the custom code generator is displayed to the user and written to the log.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.