Analytics is mParticle’s customer journey analytics platform designed for product and marketing teams to leverage complex analysis to build better products that drive conversion, increase engagement, and retain customers.
There are three possible types of Audience updates:
Audience updates either record an Analytics event or update an Analytics user property. Audience updates don’t create an Analytics User Segment, but they can be created manually. See Audience Events for details.
Analytics supports the following user and device identities.
Analytics triggers events when a user is added to or removed from an audience, as outlined below. Analytics uses mParticle’s MPID as the Analytics eventUniqueId
.
mParticle Audience Method | Analytics Event |
---|---|
Audience Add | “Audience: User Added” |
Audience Delete | “Audience: User Removed” |
In Analytics, enable the “Audience Member: $audience_name” event property as a user property for analysis. Use the Attribution Mode “Last” to represent the user’s most recent Audience membership status.
mParticle Audience attributes are converted to Analytics event properties automatically when forwarded. Analytics’s naming conventions closely match mParticle naming conventions.
false
automatically.true
automatically.Analytics triggers an Identify call to update user attributes for a given user. No event is stored in this case. Note that in Analytics, an Identify call can be encoded as an event by using $_indicative_identifiable_event
as an eventName
.
The following mParticle user attributes can be included in any of the Audience update types. mParticle user attributes are converted to Analytics user properties when forwarded.
mParticle Property Value or Path | Analytics Event Name |
---|---|
user_identities | user_id.$type |
device_info | device_id.$type |
User attributes for audience integrations are more complex than for event integrations. While event user attributes are mapped from string keys to string values, audience user attributes are mapped from string keys to a more complex object:
class AudienceUserAttributeValue
value: String
valueList: List<String>
action: enum({ UPSERT | DELETE })
Analytics uses the following rules to derive a string value from the more complex object above:
value
is defined, then map ua_$key
to the value.valueList
is defined, then map ua_$key
to valueList
, comma-delimited.ua_$key
to the string $unset
, because Analytics has no concept of unsetting a user attribute.When audiences are defined in mParticle and forwarded to an Analytics output, they are represented as Analytics user properties.
If the audience is later disconnected from being forwarded to Analytics, the updates to the user properties will stop, but the user properties are not removed from Analytics. In this case, other users will still be able to view these properties, but the data will be incomplete. For this reason, mParticle users are encouraged to toggle “Off” the audience Analytics user properties that are no longer being forwarded to Analytics.
You can set configuration values for different inputs, and connection setting values to control the behavior of data once it is input.
Setting Name | Data Type | Default Value | Description |
---|---|---|---|
API Key | string |
Input your project API key found within your Analytics project settings. | |
User Identity Field | string |
MPID |
Select which user identity to identify users in Analytics. Must be one of CustomerId, Email, MPID, or Other. |
Setting Name | Data Type | Default Value | Description |
---|---|---|---|
Configure User Attribute Forwarding | bool |
False | If enabled, you can configure user attributes to share for this audience connection. |
Was this page helpful?