Overview

This article guides you on how to build your own applications in Gtmhub.

The applications can be either published to the Gtmhub Marketplace or used privately in your account. Watch our video or read the steps below.

Watch an overview of how to build an app

Prerequisites

  • Gtmhub account

  • Admin role or enabled "Manage Applications", "Manage Data", and "Manage Configuration" permissions

Types of Gtmhub Apps

Data Apps

When installed, data apps are used as data sources and connectors in Gtmhub.

Data integrations in Gtmhub allow combining data from multiple systems to create unified sets of information for both operational and analytical uses.

What do data integrations solve in Gtmhub?

  • Automated progress tracking (Key Results updates)

  • Automated tracking of KPIs

  • Consolidated sets of data from multiple systems powering Insights (charts)

Data Apps can be built to sync data from any third-party system (via REST API).

UI Apps

iframe plugins allow displaying content from third-party systems in Gtmhub or creating custom content. An SDK is available to speed up the development. All UI applications need to follow Gtmhub's style guide.

More information on both types of supported Gtmhub applications is available in our Developer documentation.

How to build an app?

Step 1 - Navigate to Gtmhub Marketplace

Step 2 - Click on Build an app (available from a couple of places in the navigation)

Step 3 - You'll be navigated to an App Development section. Click on "Create new app" and select the type of app you'd like to build.

Step 4 - You'll be navigated to your app's page where you can start working on your app.

All the apps you've created are listed under the "Drafts" section.

Step 5 - From your app's page, start by becoming familiar with the documentation and the UI guidelines (for UI apps only)

Step 6 - If you are planning to make your app public in the Gtmhub Marketplace, you will need to provide details for sections 2, 3, and 4. If you are planning to use the app privately in your account, you can skip these sections.

Step 7 - Work on section 5 providing details for manifest. Detailed guidelines are available in our Gtmhub developer portal.

Save your progress anytime by clicking on Save as draft

App statuses

Draft - The App development is in progress. The app is automatically installed and can be tested in your account. The app will be kept private as a draft and not submitted to the Marketplace. In this case, it is available only for your account.

In review - The app is submitted and is being reviewed by Gtmhub's Engineering team. After review, the app will be returned with comments or approved for publication to Gtmhub's App Marketplace. If returned, you'll receive an e-mail and the app will move back to draft.

Published - The App is published in the Gtmhub Marketplace and is available for Gtmhub users to install.

How to test an app in development

While you're building an application you can also test it out. This can be done from the "My Apps" menu or from the options menu of the app.

Apps are automatically installed in the account while you're building them.

Testing an app is done by:

  • Configuring the app based on the config parameters you require for your app

  • Testing the app in action in the platform

Installed Data apps

Every installed data app works as a Data Source in Gtmhub. More information on how users automate Key Results, KPIs, and Insights with data sources can be found here.

Installed UI apps

Every installed UI app loads visual content in an iframe. Once you configure the installed app, navigate to the place in the platform where you expect your app to appear.

Did this answer your question?