App Partner Connection

API v1

With the App Partner Connection API, you can:

• View details about an app partner connection
• Create a partner connection for an app (This is the API equivalent of connecting a partner in the dashboard)
• Update details about an app partner connection

info

Without an app partner connection, justtrack can't operate for most of its features, including campaign creation, tracking, and more.

Get app partner connection

Get data for existing app partner connection.

GET /management/v1/app/{appId}/connection/{partnerId}

Request

Path parameters	Type	Description
appId	uint	justtrack's identifier for the app
partnerId	uint	justtrack's identifier for the advertising partner

Response

200

{
  "campaignTypes": []string,
  "defaultChannelId": integer,
  "multiCountryCampaignAllowed": boolean,
  "trackingUrlSlug": string
}

Field	Type	Description
campaignTypes	[]string	List of campaign types this partner can run. Possible values are acquisition and retargeting.
defaultChannelId	uint	ID of the default channel
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingUrlSlug	string	Value of the tracking URL slug

400

You will receive a HTTP 400 if neither the app or partner exist.

Create or update app partner connection

Create or update an app partner connection.

PUT /management/v1/app/{appId}/connection/{partnerId}

Request

Path parameters	Type	Description
appId	uint	justtrack's identifier for the app
partnerId	uint	justtrack's identifier for the advertising partner

The message body has the following form:

{
    "campaignTypes": []string,
    "defaultChannelId": integer,
    "multiCountryCampaignAllowed": boolean,
    "trackingUrlSlug": string,
}

Field	Type	Description
campaignTypes	[]string	List of campaign types this partner can run. Possible values are acquisition and retargeting.
defaultChannelId	uint	ID of the default channel
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingUrlSlug	string	Value of the tracking URL slug

Response

200

{
  "campaignTypes": []string,
  "defaultChannelId": integer,
  "multiCountryCampaignAllowed": boolean,
  "trackingUrlSlug": string
}

Field	Type	Description
campaignTypes	[]string	List of campaign types this partner can run. Possible values are acquisition and retargeting.
defaultChannelId	uint	ID of the default channel
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingUrlSlug	string	Value of the tracking URL slug

400

You will receive a HTTP 400 if neither the app or partner exist.

API v0 (App Configuration)

warning

This is the documentation for API v0, which is no longer maintained.

For up-to-date documentation, see the latest version.

You use the app configuration to connect an app and a network.

info

Without an app configuration, justtrack can't operate for most of its features, including campaign creation, tracking, and more.

Get app configuration

This API provides data for existing app configurations.

GET /management/v0/app/{appId}/configuration/{partnerId}

Request

Name	Type	Description
appId	int	appId is the justtrack internal identifier for the app
networkId	int	networkId is the justtrack internal identifier for the network

Response

{
  "campaignTypes": [int],
  "defaultChannelId": int,
  "multiCountryCampaignAllowed": boolean,
  "trackingLinkSlug": string
}

Field	Type	Description
campaignTypes	[int]	list of campaign type IDs
defaultChannelId	int	ID of default channel
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingLinkSlug	string	value of the tracking URL slug

info

You will receive a HTTP 400 if neither the app or network exist.

Create or update app configuration

This API allows you to create or update (=upsert) an app configuration.

PUT /management/v0/app/{appId}/configuration/{partnerId}

Request

Name	Type	Description
appId	int	appId is the justtrack internal identifier for the app
networkId	int	networkId is the justtrack internal identifier for the network

The general request to the Upsert Client Configuration API looks like:

{
    "campaignTypes": [int],
    "defaultChannelId": int,
    "multiCountryCampaignAllowed": boolean,
    "trackingLinkSlug": string,
}

Field	Type	Description
campaignTypes	[int]	list of campaign type IDs
defaultChannelId	int	ID of default channel. This channel is used to create campaigns.
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingLinkSlug	string	value of the tracking URL slug

info

CampaignTypes refer to the different types of campaigns you can run through justtrack and their partners. Use 1 for acquisition campaigns and 2 for retargeting campaigns.

Response

{
  "campaignTypes": [int],
  "defaultChannelId": int,
  "multiCountryCampaignAllowed": boolean,
  "trackingLinkSlug": string
}

Field	Type	Description
campaignTypes	[int]	list of campaign type IDs
defaultChannelId	int	ID of default channel
multiCountryCampaignAllowed	boolean	true if this partner supports multiple countries in one campaign
trackingLinkSlug	string	value of the tracking URL slug

info

You will receive a HTTP 400 if neither the app or network exist.