Campaign | partitions | partition[n] | Acoustic Campaign

These properties control authentication and data exchange between Unica Campaign and Engage if the products are integrated.

To access these properties, choose Settings > Configuration. If your Unica Campaign installation has multiple partitions, set these properties for each partition that uses the integration.

Service URL

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Service URL indicates the URL where Unica Campaign can access the Acoustic Campaign application. The Acoustic Campaign Org Admin must provide this value.

Default value
<none>
Example
https://engageapi.abc01.com/

OAuth URL Suffix

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The OAuth URL Suffix specifies the authentication token for the Acoustic Campaign APIs.

Default value
oauth/token

API URL Suffix

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The API URL Suffix is set to XMLAPI to ensure that Unica Campaign uses the Acoustic Campaign XML APIs. Best practice is to leave this set to the default value.

Default value
XMLAPI

Platform User with Data Sources for Acoustic Campaign Credentials

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Platform User with Data Sources for Acoustic Campaign Credentials indicates the name of the Unica Platform user account that is allowed to connect to the Acoustic Campaign server. This user account contains the data sources that provide Acoustic Campaign credentials. Typically, asm_admin is used.

Default value
No default value defined.
Valid values
The Unica Platform user account that contains the data sources for Acoustic Campaign integration credentials.

Data Source for Client ID

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Data Source for Client ID value must exactly match the name of the Acoustic Campaign Client ID data source that was created for the user account that connects to the Acoustic Campaign server (Platform User with Data Sources for Acoustic Campaign Credentials). In other words, the value must match what is set up as the datasource for the Unica Platform user. Best practice is to leave this set to the default value.

Default value
ENGAGE_CLIENT_ID_DS

Data Source for Client Secret

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Data Source for Client Secret value must exactly match the name of the Acoustic Campaign Client Secret data source that was created for the user account that connects to the Acoustic Campaign server (Platform User with Data Sources for Acoustic Campaign Credentials). Best practice is to leave this set to the default value.

Default value
ENGAGE_CLIENT_SECRET_DS

Data Source for Client Refresh Token

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Data Source for Client Refresh Token value must exactly match the name of the Acoustic Campaign Client Refresh Token data source that was created for the user account that connects to the Acoustic Campaign server (Platform User with Data Sources for Acoustic Campaign Credentials). Best practice is to leave this set to the default value.

Default value
ENGAGE_CLIENT_REF_TOK_DS

Data Source for File Transfer Credentials

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Data Source for File Transfer Credentials indicates the name of the data source that provides the credentials for FTP communication between Campaign and Acoustic Campaign. This value must exactly match the name of the Acoustic Campaign FTP data source that was created for the user account that connects to the Acoustic Campaign server (Platform User with Data Sources for Acoustic Campaign Credentials). Best practice is to leave this set to the default value.

Default value
ENGAGE_FTP_DS

Host Name for File Transfer

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Host Name for File Transfer indicates the host name of the Acoustic Campaign FTP server where Campaign uploads the contact list in TSV format. This file gets deleted automatically after it is uploaded into a contact list.

Default value
<none>
Valid values
Any valid address in the list of IBM® Marketing Cloud FTP addresses.. For example: transfer2.silverpop.com

Port Number for File Transfer

Configuration category
Campaign | partitions | partition[n] | Acoustic Campaign
Description

The Port Number for File Transfer indicates the port number for the FTP server that is specified in Host Name for File Transfer.

Default value
22
Valid values
Any valid FTP port number

Use proxy for ServiceURL

Description
Determine if you use proxy for ServiceURL. If you select Yes, your connection uses the proxy server. Proxy server details can be configured under Campaign | proxy. If you select No, a proxy server is not used to connect to Acoustic Campaign.
Default value
No
Valid values
Yes, No

Use proxy for FTP

Description
Determine if you use proxy for FTP. If you select Yes, your connection to the Acoustic Campaign FTP server uses the proxy server. Proxy server details can be configured under Campaign | proxy. If you select No, a proxy server is not used to connect to the Acoustic Campaign FTP server.
Default value
No
Valid values
Yes, No

allowableFailurePercentage

Description

When a campaign contact list is processed in Acoustic Campaign, an error is returned to Campaign if a contact fails for any reason. Use the allowableFailurePercentage property to specify the percentage of failed records that are allowed before the campaign process fails. If the percentage of failed records is greater than the configured allowableFailurePercentage, the process fails.

If the percentage of failed records is less than or equal to the configured allowableFailurePercentage, the process does not fail. Duplicate records are considered as valid records and so they do not affect the allowableFailurePercentage for a process box. All valid records are imported into Acoustic Campaign.

The percentage of failed records is calculated as ([TOTAL_ROWS - TOTAL_VALID]/ TOTAL_ROWS) *100.

Any warnings and errors for the process are logged in the ImportErrors log file. You can delete this file at regular intervals. The ImportErrors log file is located in the <Campaign_home>/logs folder.

Default value
0
Valid values
Integers between 0-100.