mParticle Integration Reference

Contents

Introduction

Whenever events are generated, Radar will send custom events and user attributes to mParticle. The full list of supported user attributes and events is below.

User mapping

Note that Radar uses the special string "(null)" to represent null user attribute values.

Radar User Field mParticle User Attribute Type Example Value
userId customerid string "1"
deviceId ios_idfv or android_uuid string "10974a2ee035770b9"
location current_location location (39.525665, -76.350663)
_id radar_id string "5b2c0906f5874b001aecfd8d"
updatedAt radar_updated_at timestamp "2018-06-22T15:23:39.000Z"
geofences[]._id radar_geofence_ids array[string] ["5b2c0906f5874b001aecfd8e"]
geofences[].description radar_geofence_descriptions array[string] ["Bel Air"]
geofences[].tag radar_geofence_tags array[string] ["city"]
geofences[].externalId radar_geofence_external_ids array[string] ["bel-air"]
place._id radar_place_id string "59302bcf8f27e8a156bd4f91"
place.name radar_place_name string "Target Bel Air"
place.facebookId radar_place_facebook_id string "141162456060553"
place.categories radar_place_categories array[string] ["shopping-retail"]
place.chain.slug radar_place_chain_slug string "target"
place.chain.name radar_place_chain_name string "Target"
insights.state.home radar_insights_state_home boolean false
insights.state.office radar_insights_state_office boolean false
insights.state.traveling radar_insights_state_traveling boolean true

Event mapping

user.entered_geofence

Radar Event Field mParticle Event Attribute Type Example Value
geofence._id geofence_id string "5b2c0906f5874b001aecfd8e"
geofence.description geofence_description string "Bel Air"
geofence.tag geofence_tag string "city"
geofence.externalId geofence_external_id string "bel-air"
geofence.metadata[{key}] geofence_metadata_{key} {type} {value}
confidence confidence string "high"

user.exited_geofence

Radar Event Field mParticle Event Attribute Type Example Value
geofence._id geofence_id string "5b2c0906f5874b001aecfd8e"
geofence.description geofence_description string "Bel Air"
geofence.tag geofence_tag string "city"
geofence.externalId geofence_external_id string "bel-air"
geofence.metadata[{key}] geofence_metadata_{key} {type} {value}
confidence confidence string "high"
duration duration number (minutes) 42.1

user.entered_place

Radar Event Field mParticle Event Attribute Type Example Value
place._id place_id string "59302bcf8f27e8a156bd4f91"
place.name place_name string "Target Bel Air"
place.facebookId place_facebook_id string "141162456060553"
place.chain.slug place_chain_slug string "target"
place.chain.name place_chain_name string "Target"
place.categories place_categories string (comma-separated) "shopping-retail"
confidence confidence string "high"

user.exited_place

Radar Event Field mParticle Event Attribute Type Example Value
place._id place_id string "59302bcf8f27e8a156bd4f91"
place.name place_name string "Target Bel Air"
place.facebookId place_facebook_id string "141162456060553"
place.chain.slug place_chain_slug string "target"
place.chain.name place_chain_name string "Target"
place.categories place_categories string (comma-separated) "shopping-retail"
confidence confidence string "high"
duration duration number (minutes) 42.1

user.entered_home

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"

user.exited_home

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"

user.entered_office

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"

user.exited_office

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"

user.started_traveling

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"

user.stopped_traveling

Radar Event Field mParticle Event Attribute Type Example Value
confidence confidence string "high"