Optional client configuration parameters

In additional to the required client configuration parameters for a web implementation your organization can also utilize optional parameters for further customizations unique to your implementation. The optional client configuration parameters can be categorized into the following groups: 


Optional overall client configuration parameters

In the tables below, please find the available parameters for your implementation.

authId Data type
Allows your organization to pass a consent identifier to Sourcepoint to be used with authenticated consent. Click here to learn more.   
authCookie Data type
Allows your organization to configure a unique name for Sourcepoint's authId cookie. Click here for more information on authId. String
campaignEnv Data type

Designates which campaign environment to use and accepts either of the following values:

  • stage
  • prod

When set to stage, the implementation will default to campaigns configured in your stage campaign environment. When set to prod, the implementation will default to campaigns configured in your public campaign environment. 

  Note: This parameter defaults to your prod campaign environment unless otherwise indicated.

String
isSPA Data type
When set to true, will confirm the implementation for a single page application and will show a message only when window._sp_.executeMessaging(); is triggered.

Click here to learn more about single page application functions.
Boolean
joinHref Data type
When set to true, will ensure that all directory regular expression functionality works in conjunction with the propertyHref parameter.

The joinHref parameter is solely used to test your implementation across different servers while still allowing for URL RegEx matching.

For these reasons, Sourcepoint strongly recommends that joinHref is set to true to ensure full CMP functionality.
Boolean
targetingParams Data type
Targeting params allow a developer to set arbitrary key/value pairs. These key/value pairs are sent to Sourcepoint servers where they can be used to take a decision within the scenario builder. Click here to learn more.

  Note: targetingParams set at either within the U.S. Privacy - CCPA or GDPR objectwill override this configuration.

targetingParams: {
   key1: valueA,
   key2: valueB
}
Object literal
propertyHref Data type
Maps the implementation to a specific URL as set up in the Sourcepoint account dashboard. Click here for more information and best practices.

  Note: Use the propertyHref parameter to spoof messaging campaigns onto a local environment for testing or debugging.

propertyHref: "https://tom.sourcepoint.com",
String
propertyId Data type
Maps the message to a specific property (website, app, OTT) as set up in Sourcepoint account dashboard. Integer
//Example
window._sp_queue = [];
window._sp_ = {
    config: {
        accountId: 1584,
        baseEndpoint: 'https://cdn.privacy-mgmt.com',
        ccpa: { },
        gdpr: { },
        propertyHref: 'https://www.testdemo.com',
        authCookie: 'test_uuid',
        campaignEnv: 'stage',
        isSPA: true,
        joinHref: true,
        targetingParams:{
            darkmode: true
          },

Optional U.S. Privacy - CCPA client configuration parameters

In the tables below, please find the available parameters specific to U.S. Privacy - CCPA. These parameters should be implemented within the ccpa: { } object.

  Note: In order to surface a U.S. Privacy - CCPA message to your clients, you will need to include the ccpa:{ } object in your client configuration script regardless of whether you configure any optional parameters.

alwaysDisplayDNS Data type
Setting this parameter to true enables use cases where a Sourcepoint Do Not Sell (my data) notification is hardcoded. Boolean
targetingParams Data type

Targeting params allow a developer to set arbitrary key/value pairs. These key/value pairs are sent to Sourcepoint servers where they can be used to take a decision within the scenario builder. Click here to learn more.

  Note: targetingParams set within the ccpa object will override overall targetingParams.

targetingParams: {               
   key1: valueA,
   key2: valueB
}
Object literal
includeGppApi Data type

Setting this parameter to true enables the IAB Tech Lab's Global Privacy Platform's (GPP) Multi-State Privacy String (MSPS) signal. This parameter must be used in conjunction with a specific stub file. Click here for more information. 

Boolean
//Example
window._sp_queue = [];
window._sp_ = {
    config: {
        accountId: 1584,
        baseEndpoint: 'https://cdn.privacy-mgmt.com',
        ccpa: { 
            alwaysDisplayDNS: false,
            targetingParams:{
                darkmode: true
              },
            includeGppApi: true
        },
        gdpr: { },
        propertyHref: 'https://www.testdemo.com',

Optional GDPR client configuration parameters

In the tables below, please find the available parameters specific to GDPR. These parameters should be implemented within the gdpr: { } object.

  Note: In order to surface a GDPR message to your clients, you will need to include the gdpr:{ } object in your client configuration script regardless of whether you configure any optional parameters.

consentLanguage Data type
Ensure that the purposes or stack names listed in a consent message remain in the same language regardless of an end-user's browser language setting. Click here for a list of ISO 639-1 language codes.

If this parameter is absent, the stacks and purposes will appear according the user's preferred language.
String
groupPmId Data type

Allows your organization to use the privacy manager ID for the property group's privacy manager.

  Note: Call window._sp_.gdpr.loadPrivacyManagerModal() without passing a parameter and the privacy manager that displays will be that property's version of the groupPmId privacy manager.

Number
targetingParams Data type

Targeting params allow a developer to set arbitrary key/value pairs. These key/value pairs are sent to Sourcepoint servers where they can be used to take a decision within the scenario builder. Click here to learn more.

  Note: targetingParams set within the gdpr object will override overall targetingParams.

targetingParams: {               
   key1: valueA,
   key2: valueB
}
Object literal
shortCircuitPartialConsent Data type

When set to true will eliminate an extra network call when the end-user has at least partial consent.

  Note: When this parameter is set to true, an end-user will not receive a new message until their consent expires. Re-consent scenario steps will not be possible.

Boolean
//Example
window._sp_queue = [];
window._sp_ = {
    config: {
        accountId: 1584,
        baseEndpoint: 'https://cdn.privacy-mgmt.com',
        consentLanguage: "fi",
        ccpa: { },
        gdpr: {
            groupPmId: 123456,
            targetingParams:{
                darkmode: false
              },
            shortCircuitPartialConsent: true  
        },
        propertyHref: 'https://www.demotest.com',

Optional Custom Messaging client configuration parameters

In the tables below, please find the available parameters specific to Custom Messaging. These parameters should be implemented within the custom: { } object.

  Note: In order to surface a custom message to your clients, you will need to include the custom:{ } object in your client configuration script regardless of whether you configure any optional parameters.

targetingParams Data type

Targeting params allow a developer to set arbitrary key/value pairs. These key/value pairs are sent to Sourcepoint servers where they can be used to take a decision within the scenario builder. Click here to learn more.

  Note: targetingParams set within the custom object will override overall targetingParams.

targetingParams: {               
   key1: valueA,
   key2: valueB
}
Object literal
//Example
window._sp_queue = [];
window._sp_ = {
    config: {
        accountId: 1584,
        baseEndpoint: 'https://cdn.privacy-mgmt.com',
        custom: {
            targetingParams:{
                darkmode: false
              }
        },
        propertyHref: 'https://www.demotest.com',
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.