This is the mParticle Unity plugin - use it to send your data to the mParticle platform and off to 100+ app services. The plugin exposes a native C# interface for direct use from Unity scripts, and is bundled with mParticle’s native SDKs for iOS and Android. With the mParticle Unity SDK, developers can leverage mParticle’s wide range of supported integrations that are otherwise unsupported by Unity.
Download and import the plugin package to get started:
mParticle.unitypackage
mParticle.unitypackage
contains the mParticle Apple SDK as a static library and the required headers which will be automatically imported into your project.
mParticle.unitypackage
includes PostprocessBuildPlayer_mParticle
that automates several Xcode project configuration steps that are required to successfully build your application for the iOS platform. During the build process, Unity will locate and execute this script.
Starting with Unity 5.3, post-process scripts are not run automatically. In those cases, the script will be run by
mParticleBuildPostprocessor.cs
instead.
You can also configure Xcode manually by adding the required frameworks specified in the Apple SDK’s manual installation guide.
mParticle.unitypackage
contains the mParticle core AAR artifact which will be automatically imported into your project.
Version 3 of the Unity Plugin contains breaking changes from version 2.x, including new methods to support mParticle’s IDSync features and the deprecation of older methods for managing users.
Previously, current user identities and attributes were set at the level of the device and included with any outgoing uploads. This approach has been deprecated in favor of more explicit user management via the Identity API. You may include an Identity request when you intialize the native iOS and Android SDKs. If you do not specify a request, identify
will be called with the most recently stored user identities. You should also update the current User Identity at appropriate points in your app lifecycle, such as Login and Logout. See Identity for more.
UserAliasHandler
When transitioning from one user to another, usually as a previously anonymous user creates an account and becomes a known user, some Identity Strategies will alias the old anonymous profile to the new known one. The UserAliasHandler
gives you the option to copy over attributes currently held in local storage to the new user profile.
MParticleUser
ObjectThe SetUserIdentity()
and SetUserAttribute()
methods are deprecated as at version 3. Instead, the current user, as determined by the Identity API is exposed via MParticle.Instance.Identity.CurrentUser
. The user object provides methods to check the MPID of the current user, modify the user’s identities and get/set attributes.
Was this page helpful?