MarketingCloudConfig

Package: com.salesforce.marketingcloud

Type: data class

Extends: EngagementModuleConfig

Overview 

The MarketingCloudConfig class is a data configuration class for the Salesforce Marketing Cloud Unified SDK. It contains all configuration parameters needed to initialize and customize the Marketing Cloud SDK functionality.

Class Declaration 

1data class MarketingCloudConfig : EngagementModuleConfig

Properties 

Required Configuration 

PropertyTypeDescription
accessTokenStringAuthentication token for Marketing Cloud API access
applicationIdStringUnique identifier for the application
marketingCloudServerUrlStringThe Marketing Cloud server URL endpoint

Optional Configuration 

PropertyTypeDescription
midString?Marketing Cloud Member ID (nullable)
analyticsEnabledBooleanEnables or disables analytics tracking
piAnalyticsEnabledBooleanEnables or disables Predictive Intelligence analytics
inboxEnabledBooleanEnables or disables inbox messaging functionality
geofencingEnabledBooleanEnables or disables geofencing features
proximityEnabledBooleanEnables or disables proximity/beacon messaging
delayRegistrationUntilContactKeyIsSetBooleanDelays device registration until contact key is provided
markMessageReadOnInboxNotificationOpenBooleanAuto-marks inbox messages as read when notification is opened
useLegacyPiIdentifierBooleanUses legacy identifier format for Predictive Intelligence
urlHandlerUrlHandler?Custom handler for URL processing (nullable)
proximityNotificationCustomizationOptionsProximityNotificationCustomizationOptions?Customization options for proximity notifications (nullable)

All properties are annotated with @JvmField for Java interoperability.

Nested Types 

Builder 

1class Builder

Builder pattern implementation for constructing MarketingCloudConfig instances.

Companion 

1object Companion

Companion object for static utility methods and constants.

Methods 

toBuilder() 

1fun toBuilder(): MarketingCloudConfig.Builder

Converts the current configuration instance back into a Builder for modification.

Returns: A new Builder instance populated with current configuration values

Usage 

This configuration class is typically instantiated using the Builder pattern:

1val config = MarketingCloudConfig.Builder()
2    .setAccessToken("your-access-token")
3    .setApplicationId("your-app-id")
4    .setMarketingCloudServerUrl("https://your-server.com")
5    .setAnalyticsEnabled(true)
6    .build()

The configuration object is then passed to the Marketing Cloud SDK during initialization.