Pega Customer Decision Hub uses 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 behavior of various elements.
Pega Customer Decision Hub
The following tables contain descriptions of these settings, divided according to the
setting purpose. The tables contains the setting name, ruleset, and description.
Installation
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 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 Customer Decision Hub is deployed. Configure this setting on
a remote Event Strategy Manager environment when integrating with events. For more
information, see Responding to real-time customer engagement with real-time event triggers. |
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. |
| decision/adm/modelExecution/format | Pega-DecisionEngine | Determines the common inputs in pxDecisionResults to store
predictor data. Set to single-level-v1 by default, can be
updated to multi-level-v1 when multiple common inputs are
needed in a multi-level decision structure. |
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 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 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 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 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 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 Customer Decision Hub. |
| microsite/parameters/skinname | PegaMKT-Engine | Name of the skin used by the Microsite. |
Paid Media Manager
| Setting name | Owning ruleset | Description |
| 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. |
| paidmedia/adobe/file/push/dir/cleanup/staletimeinms | PegaMKT-Engine | 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/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. |
| paidmedia/syncService/requestBatchSize | PegaMKT-Engine | Defines the number of records which Paid Media Manager batched within a Paid
Media Sync queue item before it prepares an API call to supported networks such as
Google or Facebook. The default number of records is
10000. The more records there are in a queue item,
the less API calls there will be. Adjust this value depending on the memory capacity
available in the cluster. |
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 | Meant for the ‘DELETE’ portion of query in segments. Different timeouts values
are use to have a better control for customers. 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. |
