Configure Features

API v1

Configurable features

You configure features by app and partner. If you want to configure features for multiple apps, you must call this endpoint for each app.

info

For each feature, you must create all the required keys, which are specified by the Partner Configuration API.

The available features are:

• attribution: required for tracking attributions
• campaign: required for bid and campaign automation
• creative: required for creative automation
• skad-import: required for spend imports or tracking event-based spend data
• spend-import: required for SkAd imports or tracking event-based SkAd data
• tracking: required for tracking parameter macros (custom partners only)
• postback: required to share data via postbacks

You can switch between these features by exchanging the macro in the URL path to the desired feature:

/management/v1/partner-configuration/{feature}

info

For attribution viewEventTimeFrame and clickEventTimeFrame, use ISO8601 duration-only format, i.e. P1DT0H0M

List partner configurations

View the list of feature configurations for the given app and partner.

POST /management/v1/partner-configuration/{feature}

Request

{
    "page": {
        "offset": integer,
        "limit": integer,
    },
    "filter": {
      "appId": integer,
      "partnerId": integer
    }
}

Parameter	Type	Description
page.offset	uint	Number of feature configurations to skip for this filter
page.limit	uint	Maximum number of feature configurations to return
filter.appId	uint	(Optional) justtrack's identifier for the app
filter.partnerId	uint	(Optional) justtrack's identifier for the advertising partner

Responses

200

{
    "results": [
        {
            "appId": integer,
            "key": string,
            "partnerId": integer,
            "value": string
        }
    ]
}

Field	Type	Description
appId	uint	justtrack's identifier for the app
key	string	The name of the partner configuration key
partnerId	uint	justtrack's identifier for the advertising partner
value	string	The value of the partner configuration

Update configurations

Create or update feature-specific configurations for a given app and partner.

PUT /management/v1/partner-configuration/{feature}

Request

{
    "appId": integer,
    "configuration": [
        {
            "key": string,
            "value": string
        }
    ],
    "partnerId": integer
}

Parameter	Type	Description
appId	uint	justtrack's identifier for the app
configuration.key	string	The key of the partner configuration
configuration.value	string	The value of the partner configuration
partnerId	uint	justtrack's identifier for the advertising partner

warning

You must provide values for all keys listed by List partner configurations. Otherwise, the feature won't work as expected.

Responses

200

[
    {
        "appId": integer,
        "key": string,
        "partnerId": integer,
        "value": string
    }
]

Field	Type	Description
appId	uint	justtrack's identifier for the app
key	string	The name of the partner configuration key
partnerId	uint	justtrack's identifier for the advertising partner
value	string	The value of the partner configuration

API v0

warning

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

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

You configure features by app and partner. If you want to configure features for multiple apps, you must call this endpoint for each app.

info

For each feature, you must create all the required keys, which are specified by the Vendor Configuration API.

The available features are:

• attribution: required for tracking attributions
• campaign: required for bid and campaign automation
• revenue: required for revenue imports or S2S revenue tracking
• spend-import: required for spend imports or tracking event-based spend/cost data
• postback: required to share data via postbacks

You can switch between these features by exchanging the macro in the URL path to the desired feature:

/management/v0/configuration/:feature

info

For attribution viewEventTimeFrame and clickEventTimeFrame, use ISO8601 duration-only format, i.e. P1DT0H0M

List configurations

List configurations returns the list of feature configurations for the given app and partner.

POST /management/v0/configuration/attribution

Request

The message body is an object:

{
    "appId": int,
    "networkId": int
}

Parameter	Type	Description
networkId	int	justtrack internal ID of the partner. You can find it with the partner list API.
appId	int	justtrack internal ID of the app. You can find it with the app list API, or use the return value from app create API.

Response

[
  {
    "id": int,
    "app": {
      "id": int
    },
    "network": {
      "id": int,
      "vendor": string
    },
    "key": string,
    "value": string,
    "sensitive": boolean
  }
]

Field	Type	Description
id	int	ID of the configuration value
app.id	int	justtrack internal app ID
network.id	int	justtrack internal partner ID
network.vendor	string	Name of the partner vendor
key	string	Name of the vendor configuration key
value	string	Value of the vendor configuration
sensitive	boolean	True if the value is confidential. False otherwise

Update configurations

Update configurations creates or updates feature-specific configurations for a given app and partner.

PUT /management/v0/configuration/attribution

info

You must provide values for all keys listed by List vendor configurations. Otherwise, the feature won't work as expected.

Request

The message body is an object:

{
    "appId": int,
    "networkId": int,
    "configuration": [
        {
            "key": string,
            "value": string
        }
    ]
}

Parameter	Type	Description
appId	int	justtrack internal app ID
networkId	int	justtrack internal app ID
configuration.key	string	Name of the configuration. Has to be one which is returned by the list call for this appId and networkId
configuration.value	string	Value of the configuration

Response

[
  {
    "id": int,
    "app": {
      "id": int
    },
    "network": {
      "id": int,
      "vendor": string
    },
    "key": string,
    "value": string,
    "sensitive": boolean
  }
]

Field	Type	Description
id	int	ID of the configuration value
app.id	int	justtrack internal app ID
network.id	int	justtrack internal partner ID
network.vendor	string	Name of the partner vendor
key	string	Name of the vendor configuration key
value	string	Value of the vendor configuration
sensitive	boolean	True, if the value is confidential. False otherwise