The Velocidi Android SDK is open-source and can be found at github.com/velocidi/velocidi-android-sdk.
Velocidi SDK is published to Maven central as a single module. Please reference the badge above or go to the release page to check our latest version.
To install the SDK in your application you just need to add the following dependency to the
You also need to add the following permissions to ensure the good functioning of the SDK.
In your application
We highly recommend initializing the SDK on the
onCreate method in your
If you don't already have an
Application subclass, you can also instantiate it in your
MainActivity although it is not recommended.
You can also have a more granular control over the supported channels:
track method allows you to collect user activity performed in your application.
This method is expecting a tracking event with the event details. For more information check our documentation.
It also accepts custom tracking events in a JSON format. Custom events should have type
"custom" and a field
"customType" with their custom event type:
match method allows you to identify a user across multiple channels.
Internally, the SDK is identifying a user based on its Advertising ID.
By performing a match between an Advertising ID and your custom ID (e.g. e-mail hashes or CRM IDs),
you are telling Velocidi CDP that these are the same user and all the information retrieved with either one of these IDs belongs to the same user.
For more information our documentation section on Cross-Channel Matches