Note: This content is valid until Pega Marketing™ or Pega Customer Decision Hub™ version 8.4. For the latest version of this article, see the Pega Customer Decision Hub User Guide on the Pega Customer Decision Hub product page.
Pega Marketing and Pega Customer Decision Hub use Dynamic System Settings to manage various configurable items. Most of these settings are owned by the PegaMKT-Engine and PegaMKT-Install rulesets. In addition, some settings are owned by the PegaMKT-Install, PegaMKT-Portal, and PegaMKT-PushNotification rulesets. Administrators can edit these settings to modify the behaviour of various elements.
The following tables contain descriptions of these settings, divided according to the setting purpose. The tables contains the setting name, ruleset, and description.
Dynamic System Settings in the PegaMKT-Install ruleset are typically set during application installation or setup. They are listed here for reference only.
Setting name
Owning ruleset
Description
MKTBuildID
PegaMKT-Install
The build from which this instance of Pega Marketing or Pega Customer Decision Hub was created.
MTKCurrentVersion
PegaMKT-Install
The ruleset version which you currently have installed.
MKTApplicationLabel
PegaMKT-Install
The application label visible in the portals.
MKTApplicationName
PegaMKT-Install
The application name.
MKTOrgName
PegaMKT-Install
The organization name.
MKTOrgLabel
PegaMKT-Install
An optional short description for the organization.
MKTAdminUserEmail
PegaMKT-Install
The email of the admin user.
MKTAdminUserName
PegaMKT-Install
The name of the admin user.
MKTAdminUserId
PegaMKT-Install
The ID of the admin user.
MKTTestOpsPassword
PegaMKT-Install
Password for the test user.
MKTUnitLabel
PegaMKT-Install
An optional short description for the unit.
MKTDivLabel
PegaMKT-Install
An optional short description for the division.
MKTDivName
PegaMKT-Install
The division name.
MKTUnitName
PegaMKT-Install
The unit name.
MKTWorkGroupManager
PegaMKT-Install
The ID of the work group manager.
MKTBuiltOnApp
PegaMKT-Install
The application on which your application is built.
MKTDescription
PegaMKT-Install
The application description.
Upgrade
Setting name
Owning ruleset
Description
MKTStagingUpgrade0802
PegaMKT-Engine
Used in the OutboundMaster agent in ProcessOutboundStaging to determine whether the seamless upgrade for outbound staging has successfully happened.
UpgradeSuccessful
PegaMKT-Engine
Initially set to false when installed. Successful run of upgrade scripts will set this to true.
CRM implementation
Setting name
Owning ruleset
Description
ConnectMKTURL
PegaMKT-Integration
For implementations of the Pega CRM suite, this is the URL where Pega Marketing or Pega Customer Decision Hub is deployed. Configure this setting on a remote Event Strategy Manager environment when integrating with Events.
Basic configuration
Setting name
Owning ruleset
Description
MarketingOperations
PegaMKT-Engine
If set to true, the Approval action is available for campaigns. The default value of this setting is true.
Adaptive learning
Setting name
Owning ruleset
Description
ADMShortTimeoutForDelayedLearning
PegaMKT-Engine
Duration in seconds to store results for adaptive learning. This setting is used for Real-Time Container scenarios. The default value of this setting is 86400 (1 day).
ADMTimeoutForDelayedLearning
PegaMKT-Engine
Duration in seconds to store results for adaptive learning. The default value of this setting is 2592000 (30 days).
MKTOptimizationModelThreshold
PegaMKT-Engine
Threshold by which an Adaptive Model's performance is compared for a self-optimizing campaign. If the model's performance is below this threshold, offer assignment will be handled randomly. Otherwise, the model will be utilized alongside random assignment. The default value of this setting is 0.65.
Campaign data flow
Setting name
Owning ruleset
Description
MKTDDFProgressNewTimeout
PegaMKT-Engine
Timeout duration in seconds used internally to determine if data flow execution is stuck in the New state, that is, if execution did not start correctly. The default value of this setting is 60.
MKTDDFProgressRefreshInterval
PegaMKT-Engine
Refresh duration in seconds used internally to monitoring the progress of campaign execution data flows. The default value of this setting is 30.
MKTDDFProgressRefreshTimeout
PegaMKT-Engine
Timeout duration in seconds used internally to determine if data flow execution is stuck while processing a batch of records. The default value of this setting is 600 (10 minutes).
MKTDFRetryInterval
PegaMKT-Engine
Retry duration in minutes used internally to wait before checking data flow availability again if there is no room for more concurrent data flow runs. The default value of this setting is 30.
MKTDFNumRetries
PegaMKT-Engine
Maximum number of times a campaign run will attempt to execute its data flow before the run fails. The default value of this setting is 5.
MKTMaxAllowedBatchDFs
PegaMKT-Engine
Number of data flows which can run on batch-type nodes at the same time. The default value of this setting is 10.
Channels
Setting name
Owning ruleset
Description
IsReceiptDecodingRequired
PegaMKT-Engine
Specify whether SMS delivery receipts decoding is required when connecting to an SMSC. The default value of this setting is false.
MKTChannelQueueStatsFormat
PegaMKT-Engine
Configure the format of the log created by the MonitorChannelQueue agent.
MKTEmailPartitionCount
PegaMKT-Engine
Number of email table partitions. The default value of this setting is 99.
MKTOutboundEmailMaxBatchSize
PegaMKT-Engine
Maximum number of emails sent in one batch. The default value of this setting is 1000.
MKTOutboundEmailMinBatchSize
PegaMKT-Engine
Minimum number of emails sent in one batch. The default value of this setting is 250.
MKTOutboundSMSMaxBatchSize
PegaMKT-Engine
Maximum number of SMS messages sent in one batch. The default value of this setting is 1000.
MKTOutboundSMSMinBatchSize
PegaMKT-Engine
Minimum number of SMS messages sent in one batch. The default value of this setting is 250.
MKTPushPartitionCount
PegaMKT-Engine
Number of Push Notification table partitions. The default value of this setting is 5.
MKTSMSPartitionCount
PegaMKT-Engine
Number of SMS table partitions. The default value of this setting is 10.
MaxSMSResponseDeliveryReceiptPartition
PegaMKT-Engine
Maximum value for PartitionKey in the SMS Response Delivery Receipt table. The default value of this setting is 20.
SMSFailMaxNumberOfRetries
PegaMKT-Engine
Maximum number of times the SMS message should be re-sent if it fails. The default value of this setting is 3.
NumberOfPartitions
PegaMKT-Engine
Number of buckets used internally to divide Push Notification processing items. Each bucket can be picked up individually by a node where the Push Notification Processor agent is running. The default value of this setting is 5.
RequestorBatchSize
PegaMKT-Engine
Number of Push Notification items to process at a time. The Push Notification Processor agent retrieves items until this size is met (or all items have been retrieved) before processing them. The default value of this setting is 1000.
Containers
Setting name
Owning ruleset
Description
MKTEnableCustomerLookup
PegaMKT-Engine
Toggle the loading of customer data during container execution. The default value of this setting is true.
MKTEnableCustomerValidation
PegaMKT-Engine
Toggle validating if a customer exists in the database during container execution. The default value of this setting is false.
MKTEnableIdentityMatching
PegaMKT-Engine
Toggle customer identity matching for container services. The default value of this setting is true.
Content repository
Setting name
Owning ruleset
Description
MarketingImageAssets/AllowedFileSize
PegaMKT-Engine
Size limit in KB for the digital assets uploaded to the image library. The default value of this setting is 100.
MarketingImageAssets/BaseURL
PegaMKT-Engine
URL of the Content Delivery Network for digital assets. If you leave this setting blank, the images will be rendered directly from the Pega Web Service.
MarketingImageAssets/CustomBaseURL
PegaMKT-Engine
URL of the Content Delivery Network which you configured for digital assets. This setting overwrites the value of the setting MarketingImageAssets/BaseURL.
MarketingImageAssets/CustomRepositoryName
PegaMKT-Engine
Name of the repository rule which points to your S3 repository. This setting overwrites the value of the setting MarketingImageAssets/DefaultRepositoryName.
MarketingImageAssets/DefaultRepositoryName
PegaMKT-Engine
Name of the default repository rule. The default value of this setting is pegacloudfilestorage.
MarketingImageAssets/Folder
PegaMKT-Engine
Name of the folder where Pega Marketing or Pega Customer Decision Hub will store the image assets. This folder will be located inside the root folder defined in the repository rule. If you do not define a folder for the images, they will be stored directly in the repository root folder. The default value of this setting is pegamarketing/imagelibrary.
MarketingImageAssets/IsRepositoryStorageEnabled
PegaMKT-Engine
Set to true if you want Pega Marketing or Pega Customer Decision Hub to use repository storage for your image library. The default value of this setting is false.
Microsites
Setting name
Owning ruleset
Description
microsite/URL
PegaMKT-Engine
URL which the Microsite gadget uses when connecting to Pega Marketing or Pega Customer Decision Hub. The URL should point to an IAC servlet on the public node. The URL format is http://<hostname>:<port>/prweb/IAC.
microsite/applicationname
PegaMKT-Engine
Application name which the Microsite gadget uses when connecting to Pega Marketing or Pega Customer Decision Hub. By default, it is the name of the application associated with the access group on the PegaMKTMicrosite service package.
microsite/systemid
PegaMKT-Engine
System ID which the Microsite gadget uses when connecting to Pega Marketing or Pega Customer Decision Hub. By default, it is the system ID defined on the system which the URLs point to.
microsite/defaultclass
PegaMKT-Engine
If the Site parameter of the Microsite URL is not defined, this setting purpose is used instead. The default value of this setting is PegaMKT-Work-Microsite_NOSITENAMESPECIFIED_.
microsite/parameters/useridentifier
PegaMKT-Engine
The user which the Microsite gadget uses to authenticate itself with Pega Marketing or Pega Customer Decision Hub.
microsite/parameters/skinname
PegaMKT-Engine
Name of the skin used by the Microsite.
Paid Media Manager
Setting name
Owning ruleset
Description
dataflow/paidmedia/customerBatchSize
PegaMKT-Engine
Number of records processed during an paid outbound batch run. The default value of this setting is 2000.
paidmedia/ResponseWaitingTime
PegaMKT-Engine
Timeout period in seconds for offers in paid channels. If an individual does not respond to an offer within the specified time period, the system automatically records a negative response. The default value of this setting is 604800 (1 week).
paidmedia/adobe/api/authserver/url
PegaMKT-Engine
Auth Server URL for Adobe Audience Manager. The default value of this setting is https://api.demdex.com/oauth/token.
paidmedia/adobe/api/resourceserver/url
PegaMKT-Engine
Resource Server Base URL for Adobe Audience Manager. The default value of this setting is https://api.demdex.com:443/v1.
paidmedia/adobe/traitsegment/toplevel/folder/name
PegaMKT-Engine
Name of the top level segment and trait folder created under the parent folder in Adobe Audience Manager. The default value of this setting is Paid Audiences.
paidmedia/adobe/file/push/maxfilesizeinbytes
PegaMKT-Engine
Maximum size in bytes of synchronization files sent to Adobe Audience Manager. The default value of this setting is 1000000000.
paidmedia/adobe/file/push/retrycount
PegaMKT-Engine
Number of times Paid Media Manager automatically tries to resend the synchronization file to Adobe Audience Manager in case of any synchronization problems. The default value of this setting is 3.
paidmedia/adobe/file/directory/base
PegaMKT-Engine
Base directory where the Adobe Audience Manager file would be pushed by the data flow run.
Time in milliseconds during which the files are kept in the Adobe Audience Manager file directory. The default value of this setting is 691200000.
paidmedia/allNBAAudience/TimeToLive
PegaMKT-Engine
Defines how long the system stores a record in the All customers audience. Individuals who are not targeted for more than the number of days specified in this setting are removed from the audience and are available for anonymously targeted campaigns on Facebook, Google, LinkedIn, and Adobe Audience Manager. The default value of this setting is 1.
paidmedia/linkedin/WaitTimeInMillis
PegaMKT-Engine
LinkedIn wait time in milliseconds. The default value of this setting is 60000.
paidmedia/linkedin/api/resourceserver/url
PegaMKT-Engine
LinkedIn API resource server endpoint. The default value of this setting is https://api.linkedin.com/v2.
Segments
Setting name
Owning ruleset
Description
MKTSegCriteriaInsertRequestorCount
PegaMKT-Engine
Total number of child requestors that are used during the segment runtime. The default value of this setting is 1.
MKTSegCriteriaQueryTimeout
PegaMKT-Engine
Time in seconds for an insert operation to the Criteria query for segment runtime. The default value of this setting is 1200 (20 minutes).
MKTSegDeleteRepopulateQueryTimeout
PegaMKT-Engine
Time in seconds for an insert operation to the Criteria query for segment runtime. The default value of this setting is 1200 (20 minutes).
MKTSegDisplayPreAggregateCounts
PegaMKT-Engine
Used by segment In List criteria to determine if a second column should be displayed with counts for each distinct value. The default value of this setting is true.
MKTSegGroupByBothColumns
PegaMKT-Engine
Enables grouping by both keys for aggregate segment criteria. The default value of this setting is true.
MKTSegIgnoreCaseDefaultSetting
PegaMKT-Engine
Default value for the Ignore Case setting for String segment criteria. If true, the Ignore Case check box is selected by default. The default value of this setting is false.
MKTSegOracleDeleteHint
PegaMKT-Engine
Used to specify the DELETE hint used during segment runtime for Oracle DELETE statements.
MKTSegOracleInsertHint
PegaMKT-Engine
Used to specify the INSERT hint used during segment runtime for Oracle INSERT statements.
MKTSegOracleSelectHint
PegaMKT-Engine
Used to specify the SELECT hint used during segment runtime for Oracle SELECT statements.
MKTSegPartitionCount
PegaMKT-Engine
Number of segment table partitions. The default value of this setting is 99.
MKTSegRevalidateCustomers
PegaMKT-Engine
Specify whether or not segment groups should be validated against the customer table using an INTERSECT statement. Validating segment groups ensures that all customers in a segment still have a valid ID in the customer table, but may result in a longer segment runtime. The default value of this setting is false.
MKTSegmentRefreshInterval
PegaMKT-Engine
Refresh duration in seconds used internally for monitoring the progress of segment execution data flows. The default value of this setting is 10.
ProspectListImportRetries
PegaMKT-Engine
Maximum number of times the prospect import should run if it fails. The default value of this setting is 15.
Other configuration
Setting name
Owning ruleset
Description
HelpURI/MarketingHelp
PegaMKT-Engine
URL where the MarketingHelp WAR file is deployed.
MKTConstraintAsGroup
PegaMKT-Engine
Specify if a customer constraint should be applied to your whole application. The default value of this setting is false.
MKTDefaultTemplateTextLength
PegaMKT-Engine
Default size of text columns created in Database Template tables. This value is only used for those properties which do not have maximum length specified. For individual cases, it is recommended to set the maximum length on the property rule rather than update this setting. The default value of this setting is 200.
MKTDefaultThreadCount
PegaMKT-Engine
The default thread count used for multi-requestor processing on a node where the topology has not been configured. The default value of this setting is 2.
MKTDeliveryMatchingMaximumTimeToLive
PegaMKT-Engine
Duration in seconds for an unmatched offer or batch table to delivery. The default value of this setting is 300.
MKTDistinctValuesMaxResults
PegaMKT-Engine
Maximum number of distinct values to retrieve. The default value of this setting is 500.
MKTFileDelimiter
PegaMKT-Engine
Character or characters used by file templates as delimiter. The default value of this setting is , (comma).
MKTFunnelAnalysisReportsDefault
PegaMKT-Engine
Default value of the Create funnel analysis reports setting for Campaign Distribution Tests. If true, the Create funnel analysis reports check box is selected by default when starting a Campaign Distribution Test. The default value of this setting is true.
MappingLicenseKey
PegaMKT-Engine
License key required for premium GeofenceMap capabilities.
StrategiesRequireReindex
PegaMKT-Engine
Flag to determine whether strategy rules which are shipped in PegaMKT-Engine should be re-indexed. Typically used by the PegaMKTStartupAgent to check whether missing index records require re-generation. The default value of this setting is false.
WaitAgentReQueueTime
PegaMKT-Engine
Duration in seconds used internally to re-queue wait agent processing if a campaign run table still has records that are in a pending state. The default value of this setting is 600 (10 minutes).
database/databases/ExternalMKTData/dataSource
PegaMKT-Engine
Name of the JNDI datasource, used when ExternalMKTData database rule is set to Use preferences mode.
MaxRecentsCount
PegaMKT-Portal
Number of items to show in the Recents pane in the portal. The default value of this setting is 10.