Application Settings

An Application in Omniata is a set of configurations that define how to structure and deal with a specific source of data, and extract information from it. In other words, an Application is a schema on how to process data to be used within Omniata.

Applications can be accessed from the homepage. The homepage allows you to access all applications, as well as selecting “favorite” ones. An application can be favored by clicking the star icon on the top left of the application’s icon.


Application Types

There are three types of Applications in Omniata:

Application Project
Uses events as source of data, and defines how to transform the events and aggregate the data. If you are using the SDK this is the default selection.
External Database
Uses external databases as source of data, such as MySQL or PostgreSQL. The project configuration defines how to connect to these databases and how to use the data from the database tables.
External Services
Used for visualizing data from specialized service partners for user acquisition such as Attribution Partners and Ad Networks. This external services can also be connected to an Application Project to set attribution source for users.

Application Settings

Application Projects build on event data sent from an application to Omniata Event API. Omniata directs the data to appropriate Application using the API key.

Application specific settings can be accessed under Settings -> Project Settings. On this page you find the options:

Option Description
Name Change the display name of the application in the Omniata panel.
Machine Name Set the Machine Name of the application. This name is internally used for setting up object relations, for example, it is used to set up the Dataset name in BigQuery.
User ID Parameter Defines the parameter used for User ID (the default is uid).
Event Type Parameter Define the Event Type parameter (default is om_event_type).
Automatically scan for events and create fields daily Toggle option to automatically schedule event scan jobs and add new events and parameters found. This will also create the necesary event property fields.
Enable processing of user de-ghosting events Option to enable processing of user De-Ghosting events.
Send push delivery event Sends an internal event to track each time a push notification has been sent for the user. The event will not trigger activity for the user.
Show in Dashboard Unselecting will hide the application.
Type Modify the application type, default is OmniataDataModel. Application types enable or disable configuration options according to the intended use.
Icon Add an icon for the application. It will be shown on the front page. (Optional)
Permissions Set Project specific access permissions. More details can be found in the User Management guide.

Add a New Application

To create a new Application Project, navigate to the Omniata homepage and select ‘New Project’. Select Blank Project to create an Application with no content, that is, no predefined elements. Blank applications can be expanded later with Packages that have predefined settings.

The most common option is to start with the Free-to-Play package for any new application. This package contains several predefined elements that will help you kickstart your analytics.

Application requires API keys per Application and per Environment. To create the API Keys for new applications navigate to Integrate -> Applications -> New Application. The API keys are automatically generated for all Environments.

Remove an Application

Please note that deleting an Application will erase everything related to it from the Omniata Panel. The deletion of applications is permanent and cannot be reversed. Deleting an Application Project will delete Data Fields, Tables, Charts, and all Engagement objects. This does not delete raw data, as it will still be stored by Omniata.

To delete an Application navigate to Settings -> Project Settings -> Remove Project.

This article was last updated on April 28, 2017 15:35. If you didn't find your answer here, search for another article or contact our support to get in touch.