Skip to main content

Quickstart

Let's discover Condee in less than 5 minutes.

Create Events​

Get started by creating a new data event in the condee dashboard. You will find a + button on the events page, right above the list in the dashboard that do this.

What is a Data Event​

Data events is piece of data that is generated by a software application or service. It is a record of an event that has happened. Data events are used to track user interactions with a website or application, and can be used to analyze user behavior and improve the user experience. They are generally made up of an event name that describes the event that occurred, and a set of key-value pairs/properties that provide additional information about the event.

Sample Data Event​

{
  "event_name" : "user_sign_up",
  "user_id" : "12345abcd-abcd1234",
  "signup_time" : "2025-05-29T15:40:48Z",
  "referrer" : "ad_campaign_1",
  "client" : "web-mobile",
  "consent_given" : true,
  "paid_up_amount" : 123.50
}

How condee works here.​

Condee will help you define similar events in the dashboard. Its entire schema via a user interface. Interface will help you define the name of the event along with its various properties. You will be able to not only set prorperties name and their data types. But also validation whether they are mandatory or not for client to send while sending the data event to your analytical systems. There are all CRUD operations available on the defined events so that you can update them anytime.

NOTE

Values of the data event properties are set by the clients at the runtime. Condee only helps in defining its schema so you get the skeleton up and clients just have to fill the values and send the data to their existing systems.

Publish Artifacts​

Publishing​

Once you have created a set of events. Its time to publish them. Publishing events creates an artifact which carries generated code for multiple languages. These are plain data object classes auto created for you based on the events that you have defined in the dashboard. There is publish icon right next to create event button on the events page that do this. You would have to provide a text message for the publishing.

Downloading the artifacts​

You can see an option on the left side menu of the dashboard. Named as Artfiacts. You can directly download generated artifacts from this page. Its a plain zip file that carries all the generated code based on the events

Using the artifacts​

Integrating​

Once a code is generated, client like Android, IOS, Web or Backend. Based on their tech stack and language choosen. Can pick up the generated code and directly place it in their existing codebase.

Filling up the data​

At runtime based on the requirement, client code needs to create the event object and fill data to it via available setter methods. Generated event classes are using builder pattern. That will help create the object easily. Following sample is based on the sample event defined above

UserSignUp event = new UserSignUp.Builder()
  .setUserId("12345abcd-abcd1234")
  .setSignupTime("2025-05-29T15:40:48Z")
  .setReferrer("ad_campaign_1")
  .setClient("web-mobile")
  .setConsentGiven(true)
  .setPaidUpAmount(123.50)
  .build();

Validation​

Condee dashboard allows adding validation rules that can be applied and checked at runtime for the event whenever build() is called. This helps setup rules like non null values or a specific value only kind of validation. Like sending only an email which is in valid email format. This is one of the most important value that condee brings up while defining analytics specs.

Sending the data​

If all validation is in place and as per rules defined in the condee event definition. Build method will simply return the json created or will throw exception. Generated json will carry the event name and its properties name exactly consistent to what was defined in the dashboard.

This generated json can be sent to your existing system the way it is already being sent. Condee has helped making it consistent and as per expectation.

Condee's Placement​

Condee isn't a replacement of your existing anaylytical system. Atleast for now. It is acting as middleware between your data source and your existing analytical system. Enforcing clients to send the correct data only. Without this if clients sends a garbage data, your anaylics will produce garbage insights.

Middleware

Data Source ---> Condee ---> Your Existing Analytical System