Channel setup

Some ad network partners require additional configuration values to complete their integration. Use the channel_setup parameter when creating or updating apps to provide these partner-specific settings.

How channel setup works

When you create or update an app with the /app endpoint, the API copies partner configurations from your template app. However, certain partners require app-specific values (like app IDs or API keys) that vary between apps.

Workflow

Create your app using the POST /app endpoint.
Once you have your partner-specific IDs, send another request with the channel_setup parameter.
Include all channel setup values in each request—the API doesn’t merge values from previous requests.

Supported partners

The following partners require channel setup configuration:

Partner	Required parameters	Description
`applovin`	`sdk_keys`	Array of AppLovin SDK keys for your app.
`chartboost`	`app_id`, `token`	Your Chartboost app ID and app signature.
`facebook`	`app_id`	Your Facebook app ID. Optionally include `adimpression_forwarding` to enable ad impression forwarding.
`gameanalytics`	`key`	Your unique GameAnalytics game key.
`google`	`link_id`	Your Google Ads link ID.
`inmobi`	`property_id`, `advertiser_id`	Your InMobi property ID and advertiser ID.
`ironsource`	`advertiser_id`, `password`	Your ironSource advertiser ID and password.
`mintegral`	`enabled`	Set to `true` to enable the Mintegral integration.
`snapchat`	`snap_app_id`	Your Snapchat app ID.
`tapjoy`	`app_id`	Your Tapjoy app ID.
`tiktok`	`app_id`, `enabled`	Your TikTok app ID and whether the integration is enabled.
`unityads`	`game_id`	Your Unity Ads game ID.
`vungle`	`app_id`	Your Vungle app ID.

Parameters

All parameters are passed as key-value pairs inside the channel_setup object.

AppLovin

Parameter	Data type	Required	Description
`sdk_keys`	`Array[String]`	Yes	List of AppLovin SDK keys for your app.

Chartboost

Parameter	Data type	Required	Description
`app_id`	`String`	Yes	Your Chartboost app ID.
`token`	`String`	Yes	Your Chartboost app signature.

Facebook

Parameter	Data type	Required	Description
`app_id`	`String`	Yes	Your Facebook app ID.
`adimpression_forwarding`	`Boolean`	No	Enable ad impression forwarding. Default: `false`.

GameAnalytics

Parameter	Data type	Required	Description
`key`	`String`	Yes	Your unique GameAnalytics game key.

Google

Parameter	Data type	Required	Description
`link_id`	`String`	Yes	Your Google Ads link ID.

InMobi

Parameter	Data type	Required	Description
`property_id`	`String`	Yes	Your InMobi property ID (GMP ID).
`advertiser_id`	`String`	Yes	Your InMobi advertiser ID.

ironSource

Parameter	Data type	Required	Description
`advertiser_id`	`String`	Yes	Your ironSource advertiser ID.
`password`	`String`	Yes	Your ironSource password.

Mintegral

Parameter	Data type	Required	Description
`enabled`	`Boolean`	Yes	Set to `true` to enable the Mintegral integration.

Snapchat

Parameter	Data type	Required	Description
`snap_app_id`	`String`	Yes	Your Snapchat app ID.

Tapjoy

Parameter	Data type	Required	Description
`app_id`	`String`	Yes	Your Tapjoy app ID.

TikTok

Parameter	Data type	Required	Description
`app_id`	`String`	Yes	Your TikTok app ID.
`enabled`	`Boolean`	No	Whether the integration is enabled. Default: `true`.

Unity Ads

Parameter	Data type	Required	Description
`game_id`	`String`	Yes	Your Unity Ads game ID.

Vungle

Parameter	Data type	Required	Description
`app_id`	`String`	Yes	Your Vungle app ID.

Examples

Complete channel setup example

This example shows a request with channel setup for multiple partners:

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "channel_setup": {
        "applovin": {
            "sdk_keys": ["sdk_key_1", "sdk_key_2"]
        },
        "chartboost": {
            "app_id": "chartboost_app_id",
            "token": "app_signature"
        },
        "facebook": {
            "app_id": "123456789",
            "adimpression_forwarding": true
        },
        "gameanalytics": {
            "key": "unique_game_key"
        },
        "google": {
            "link_id": "adwords_link_id"
        },
        "inmobi": {
            "property_id": "inmobi_property_id",
            "advertiser_id": "advertiser_id"
        },
        "ironsource": {
            "advertiser_id": "6734",
            "password": "abc123"
        },
        "mintegral": {
            "enabled": true
        },
        "snapchat": {
            "snap_app_id": "snapchat_app_id"
        },
        "tapjoy": {
            "app_id": "tapjoy_app_id"
        },
        "tiktok": {
            "app_id": "5464534",
            "enabled": true
        },
        "unityads": {
            "game_id": "unity_game_id"
        },
        "vungle": {
            "app_id": "vungle_app_id"
        }
    }
}'

Single partner setup

Configure just one partner:

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "channel_setup": {
        "facebook": {
            "app_id": "987654321"
        }
    }
}'

Update channel setup for existing app

Add channel setup to an existing app by sending a new request with force_update:

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "force_update": true,
    "channel_setup": {
        "google": {
            "link_id": "new_google_link_id"
        },
        "facebook": {
            "app_id": "updated_facebook_id"
        }
    }
}'

Viewing channel setup

To view the current channel setup for an app, use the GET /app/{app_token} endpoint. The response includes a channel_setup object with the configured values:

{
   "name": "My App",
   "store_id": "com.example.myapp",
   "platform": "android",
   "adjust_app_token": "abc123xyz",
   "channel_setup": {
      "facebook": { "app_id": "123456789" },
      "google": { "link_id": "adwords_link_id" },
      "snapchat": { "snap_app_id": "snapchat_app_id" }
   }
}