Amplitude provides product analytics that helps companies leverage cross-platform behavioral data to drive user growth.
In order to activate mParticle’s integration with Amplitude, you will need the Amplitude API Key for each app that you’d like to setup. Your API key can be found on the Settings page of the Amplitude dashboard.
mParticle will forward User Identities and Attributes to Amplitude, even if there are no events in the batch.
Every event in Amplitude has a main Device ID field. mParticle populates this field as follows:
Amplitude also has dedicated fields for particular Device IDs, such as IDFA, Android ID. These will be populated if the ID is available. See Field Mappings for more information.
Amplitude requires either a Device ID or a Customer ID / Email. If no accepted identifiers are present, data will not be forwarded.
mParticle will forward all screen views to Amplitude with the Amplitude Event Type set to “Viewed ScreenName”, where “ScreenName” is the screen name passed to the
logScreen SDK method (or the name of the screen’s Activity class if you’re using automatic screen tracking on Android).
mParticle will forward all session start and session end events to Amplitude with the Amplitude Event Type set to “session_start” and “session_end”.
mParticle will translate eCommerce events into Amplitude events by expanding the eCommerce event into multiple events per product by appending the event name with ” - Item” , i.e. eCommerce - AddToCart - Item. This expansion applies to all eCommerce transactions; Add To Cart, Add To WishList, Checkout Purchase, etc.
All in app purchases and refunds logged by mParticle’s
logTransaction or an
eCommerce event of will be forwarded to Amplitude with the Amplitude Event Type set to “revenue_amount”, using the
|Parameter||mParticle details||Amplitude field|
|Product ID||Product ID or SKU||productId|
The TotalAmount attribute is not forwarded to Amplitude on a CommerceEvent
Custom events logged via mParticle’s
logEvent SDK method and their attributes will be forwarded to Amplitude, with the event name passed to
logEvent as the Amplitude Event Type. An event name must be specified or an error will be returned.
Attribution Custom events will be forwarded to Amplitude prefixed with the attribution provider in the event name. For example,
[Tune] attribution. Event Attributes that are included with the event are forwarded to Amplitude in user_properties, also prefixed with the attribution provider.
|Parameter||Amplitude field||mParticle details|
|Android ID||android_id||Passed if OS is Android|
|Android Advertising ID||adid||Passed if OS is Android|
|Application Version||app_version||Application Version|
|Brand||device_brand||The device brand the user is on. This is not passed for Apple devices.|
|City||city||City the user is in; this is also included in User Properties|
|Country||Country the user is in; this is also included in User Properties||country|
|Designated Market Area||DMA||If you wish to forward this property to Amplitude, you must set it as a custom user attribute, labeled
|Device ID||device_id||Set based on Operating System; see Device ID Mapping|
|Event Properties||event_properties||All event attributes included with eCommerce, Custom and Screen View events. See above for Attribution Custom Events.|
|Event Type||event_type||Described above for each supported event|
|IDFA||idfa||Passed if OS is iOS or tvOS|
|Insert ID||insert_id||A unique id for the event derived from the event name and the event and session_start timestamps|
|IP Address||ip||IP address of the user|
|Language||language||Language the user has set|
|Latitude||location_lat||Latitude of the user|
|Library||library||A label for the source of data which is visible in the Amplitude dashboard. This will always be set to ‘mParticle’|
|Longitude||location_lng||Longitude of the user|
|OS Name||os_name||iOS, tvOS, Android, Roku|
|OS Version||os_version||The version of the mobile OS or browser the user is on|
|Platform||platform||iOS, Android, Apple TV, Web, Roku|
|Region||region||Region (or State) the user is in; this is also included in User Properties|
|Session Start Time||session_id||Session Start Timestamp|
|Time||time||Event Timestamp, in milliseconds|
|User ID||user_id||Set based on the value of the
|User Properties||user_properties||All user attributes included with the event. See above for Attribution Custom Events.|
|Setting Name||Data Type||Default Value||Description|
||Your app’s Amplitude API Key. You can find this on the “My Account” page of Amplitude’s dashboard.|
|Setting Name||Data Type||Default Value||Platform||Description|
||default||Web||The name of the client-side Amplitude instance to use. This should be unique for each Amplitude connection.|
||customerId||All||To identify users, choose “Customer ID” to send Customer ID if provided or or “Email” to send Email addresses if provided.|
|Include Email in User Properties||
||False||All||If enabled, the email user identity will be forwarded in the Amplitude user_properites|
|Allow unset user attributes||
||True||All||Allow user attributes to be removed in Amplitude using the $unset operation|
|Prefix Attribution with Source||
||True||All||If enabled, the attribution source name will be prefixed for attribution events.|
Was this page helpful?