Advanced Configuration

Configuration Keys

This section details how to programmatically configure the Content Analytics extension.

The following config settings are available. These settings can also be managed within the Adobe Content Analytics extension.

Setting	Type	Default	Description
`configId`	String	N/A	Custom datastream for Content Analytics events (overrides edge.configId)
`batchingEnabled`	Boolean	true	Enable batching
`maxBatchSize`	Integer	10	Maximum events per batch.
`flushInterval`	Integer	2000	Flush interval (in milliseconds)
`trackExperiences`	Boolean	true	Enable experience tracking.
`excludedAssetLocationsRegexp`	String	-	Asset location regex pattern.
`excludedAssetUrlsRegexp`	String	-	Asset URL regex pattern.
`excludedExperienceLocationsRegexp`	String	-	Experience location regex pattern.
`debugLogging`	Boolean	false	Verbose logging.

All keys are prepended with contentanalytics..

You can configure the extension through the Data Collection Content Analytics extension UI, or programmatically.

Android

MobileCore.updateConfiguration(mapOf(
    "contentanalytics.maxBatchSize" to 20,
    "contentanalytics.batchFlushInterval" to 5000
))
Copied to your clipboard
MobileCore.updateConfiguration(mapOf(
    "contentanalytics.maxBatchSize" to 20,
    "contentanalytics.batchFlushInterval" to 5000
))

iOS

MobileCore.updateConfigurationWith(configDict: [
    "contentanalytics.maxBatchSize": 20,
    "contentanalytics.batchFlushInterval": 5000
])
Copied to your clipboard
MobileCore.updateConfigurationWith(configDict: [
    "contentanalytics.maxBatchSize": 20,
    "contentanalytics.batchFlushInterval": 5000
])

MobileCore.updateConfiguration(mapOf(
    "contentanalytics.maxBatchSize" to 20,
    "contentanalytics.batchFlushInterval" to 5000
))
Copied to your clipboard
MobileCore.updateConfiguration(mapOf(
    "contentanalytics.maxBatchSize" to 20,
    "contentanalytics.batchFlushInterval" to 5000
))

MobileCore.updateConfigurationWith(configDict: [
    "contentanalytics.maxBatchSize": 20,
    "contentanalytics.batchFlushInterval": 5000
])
Copied to your clipboard
MobileCore.updateConfigurationWith(configDict: [
    "contentanalytics.maxBatchSize": 20,
    "contentanalytics.batchFlushInterval": 5000
])

Datastream

You can stream data from content analytics through a separate datastream.

To route Content Analytics to a different datastream:

{
  "edge.configId": "main-datastream-id",
  "contentanalytics.configId": "content-analytics-datastream-id"
}
Copied to your clipboard
{
  "edge.configId": "main-datastream-id",
  "contentanalytics.configId": "content-analytics-datastream-id"
}

If contentanalytics.configId is not set, the default edge.configId is used.

Batching

You can use the following flush triggers:

Batch reaches maxBatchSize.
Timer reaches batchFlushInterval (ms).
App backgrounds.

{
  "contentanalytics.batchingEnabled": true,
  "contentanalytics.maxBatchSize": 10,
  "contentanalytics.batchFlushInterval": 2000
}
Copied to your clipboard
{
  "contentanalytics.batchingEnabled": true,
  "contentanalytics.maxBatchSize": 10,
  "contentanalytics.batchFlushInterval": 2000
}

To disable flushes for immediate sends:

{ "contentanalytics.batchingEnabled": false }
Copied to your clipboard
{ "contentanalytics.batchingEnabled": false }

Batching only affects network delivery. Features like asset attribution, experience tracking, and featurization work the same whether batching is enabled or disabled.

Filtering

You filter content analytics events through regular expressions.

By URL

An example of a regex that filters out URLs.

{ "contentanalytics.excludedAssetUrlsRegexp": ".*\\.gif$|.*spinner.*" }
Copied to your clipboard
{ "contentanalytics.excludedAssetUrlsRegexp": ".*\\.gif$|.*spinner.*" }

By Location

An example of a regex that filers our asset and experience locations.

{ "contentanalytics.excludedAssetLocationsRegexp": "^(debug|test).*" }
{ "contentanalytics.excludedExperienceLocationsRegexp": "^admin\\..*" }
Copied to your clipboard
{ "contentanalytics.excludedAssetLocationsRegexp": "^(debug|test).*" }
{ "contentanalytics.excludedExperienceLocationsRegexp": "^admin\\..*" }

Privacy

To manage privacy, use the consent API's.

Android

// Opt in
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "y"))))

// Opt out
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "n"))))

// Pending
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "p"))))
Copied to your clipboard
// Opt in
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "y"))))

// Opt out
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "n"))))

// Pending
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "p"))))

iOS

// Opt in
Consent.update(with: ["consents": ["collect": ["val": "y"]]])

// Opt out
Consent.update(with: ["consents": ["collect": ["val": "n"]]])

// Pending
Consent.update(with: ["consents": ["collect": ["val": "p"]]])
Copied to your clipboard
// Opt in
Consent.update(with: ["consents": ["collect": ["val": "y"]]])

// Opt out
Consent.update(with: ["consents": ["collect": ["val": "n"]]])

// Pending
Consent.update(with: ["consents": ["collect": ["val": "p"]]])

// Opt in
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "y"))))

// Opt out
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "n"))))

// Pending
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "p"))))
Copied to your clipboard
// Opt in
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "y"))))

// Opt out
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "n"))))

// Pending
Consent.update(mapOf("consents" to mapOf("collect" to mapOf("val" to "p"))))

// Opt in
Consent.update(with: ["consents": ["collect": ["val": "y"]]])

// Opt out
Consent.update(with: ["consents": ["collect": ["val": "n"]]])

// Pending
Consent.update(with: ["consents": ["collect": ["val": "p"]]])
Copied to your clipboard
// Opt in
Consent.update(with: ["consents": ["collect": ["val": "y"]]])

// Opt out
Consent.update(with: ["consents": ["collect": ["val": "n"]]])

// Pending
Consent.update(with: ["consents": ["collect": ["val": "p"]]])

Value	Result
`"y"`	Events sent
`"n"`	Events dropped
`"p"`	Events queued

Legacy

The legacy privacy APIs also should work.

Android

MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_IN)   // send
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_OUT)  // drop + clear
MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN)  // queue
Copied to your clipboard
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_IN)   // send
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_OUT)  // drop + clear
MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN)  // queue

iOS

MobileCore.setPrivacyStatus(.optedIn)   // send
MobileCore.setPrivacyStatus(.optedOut)  // drop + clear
MobileCore.setPrivacyStatus(.unknown)   // queue
Copied to your clipboard
MobileCore.setPrivacyStatus(.optedIn)   // send
MobileCore.setPrivacyStatus(.optedOut)  // drop + clear
MobileCore.setPrivacyStatus(.unknown)   // queue

MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_IN)   // send
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_OUT)  // drop + clear
MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN)  // queue
Copied to your clipboard
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_IN)   // send
MobileCore.setPrivacyStatus(MobilePrivacyStatus.OPT_OUT)  // drop + clear
MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN)  // queue

MobileCore.setPrivacyStatus(.optedIn)   // send
MobileCore.setPrivacyStatus(.optedOut)  // drop + clear
MobileCore.setPrivacyStatus(.unknown)   // queue
Copied to your clipboard
MobileCore.setPrivacyStatus(.optedIn)   // send
MobileCore.setPrivacyStatus(.optedOut)  // drop + clear
MobileCore.setPrivacyStatus(.unknown)   // queue

Data Deletion

To delete data, use resetIdentities() to reset identities, clear cache and queue.

Android

MobileCore.resetIdentities()  // clears cache + queue
Copied to your clipboard
MobileCore.resetIdentities()  // clears cache + queue

iOS

MobileCore.resetIdentities()  // clears cache + queue
Copied to your clipboard
MobileCore.resetIdentities()  // clears cache + queue

MobileCore.resetIdentities()  // clears cache + queue
Copied to your clipboard
MobileCore.resetIdentities()  // clears cache + queue

MobileCore.resetIdentities()  // clears cache + queue
Copied to your clipboard
MobileCore.resetIdentities()  // clears cache + queue

Featurization

Featurization is configured automatically. Sends experience content to the machine learning service for feature extraction.

See below for an example of the payload to send.

{
  "experienceId": "mobile-abc123",
  "orgID": "YOUR_ORG@AdobeOrg",
  "content": {
    "images": [{"value": "https://...jpg", "style": {}}],
    "texts": [{"value": "Title", "style": {"role": "headline"}}],
    "ctas": [{"value": "Buy", "style": {"enabled": true}}]
  }
}
Copied to your clipboard
{
  "experienceId": "mobile-abc123",
  "orgID": "YOUR_ORG@AdobeOrg",
  "content": {
    "images": [{"value": "https://...jpg", "style": {}}],
    "texts": [{"value": "Title", "style": {"role": "headline"}}],
    "ctas": [{"value": "Buy", "style": {"enabled": true}}]
  }
}

Tuning Batch Settings

The default settings (maxBatchSize: 10, batchFlushInterval: 2000 ms) should work well for most apps. Adjust these settings based on your event volume:

Events per Minute	maxBatchSize	batchFlushInterval (ms)	Notes
< 10	10 (default)	2000 (default)	Default works well
10-50	15-25	3000	Reduces network calls
> 50	25-50	5000	High-volume optimization

Trade-off: Larger batches reduce network overhead but increase latency before data appears in reporting.

Debugging

Use setLogLevel() to set the debugging level.

Android

MobileCore.setLogLevel(LoggingMode.VERBOSE)
Copied to your clipboard
MobileCore.setLogLevel(LoggingMode.VERBOSE)

iOS

MobileCore.setLogLevel(.debug)
Copied to your clipboard
MobileCore.setLogLevel(.debug)

MobileCore.setLogLevel(LoggingMode.VERBOSE)
Copied to your clipboard
MobileCore.setLogLevel(LoggingMode.VERBOSE)

MobileCore.setLogLevel(.debug)
Copied to your clipboard
MobileCore.setLogLevel(.debug)

Log entries are tagged. See below for the various tags.

[ContentAnalytics] - main
[ContentAnalytics.Batch] - batching
[ContentAnalytics.Featurization] - ML service

Experience tracking

Crash recovery

Last updated 4/29/2026

Was this helpful?

Yes

Advanced Configuration

Configuration Keys.css-83mclq{margin-left:var(--spectrum-global-dimension-size-100);}

Datastream

Batching

Filtering

By URL.css-jmmyhj{margin-left:var(--spectrum-global-dimension-size-50);}

By Location

Privacy

Edge Consent

Legacy

Data Deletion

Featurization

Tuning Batch Settings

Debugging

Configuration Keys

By URL