채널 설정

일부 광고 네트워크 파트너는 연동을 완료하기 위해 추가적인 구성 값을 필요로 합니다. 앱을 생성하거나 업데이트할 때 channel_setup 파라미터를 사용하여 이러한 파트너별 설정을 제공합니다.

채널 설정 방식

/app 엔드포인트로 앱을 생성하거나 업데이트하면 API가 템플릿 앱에서 파트너 구성을 복사합니다. 그러나 일부 파트너는 앱마다 다른 값(예: 앱 ID 또는 API 키)이 필요할 수 있습니다.

워크플로우

POST /app 엔드포인트를 사용하여 앱을 생성합니다.
파트너별 ID를 확보한 후에는 channel_setup 파라미터와 함께 요청을 다시 전송합니다.
각 요청에 모든 채널 설정 값을 포함합니다. API는 이전 요청의 값을 병합하지 않습니다.

지원되는 파트너

다음의 파트너는 채널 설정 구성이 필요합니다.

파트너	필수 파라미터	설명
`applovin`	`sdk_keys`	앱에 대한 AppLovin SDK 키의 배열.
`chartboost`	`app_id`, `token`	Chartboost 앱 ID와 앱 서명.
`facebook`	`app_id`	Facebook 앱 ID. 광고 노출 포워딩을 활성화하기 위해 `adimpression_forwarding`을 포함할 수 있습니다.
`gameanalytics`	`key`	고유한 GameAnalytics 게임 키.
`google`	`link_id`	Google Ads 링크 ID.
`inmobi`	`property_id`, `advertiser_id`	InMobi 속성 ID와 광고주 ID.
`ironsource`	`advertiser_id`, `password`	ironSource 광고주 ID 및 비밀번호.
`mintegral`	`enabled`	Mintegral 연동을 활성화하려면 `true`로 설정합니다.
`snapchat`	`snap_app_id`	Snapchat 앱 ID.
`tapjoy`	`app_id`	Tapjoy 앱 ID.
`tiktok`	`app_id`, `enabled`	TikTok 앱 ID 및 연동 활성화 여부.
`unityads`	`game_id`	Unity Ads 게임 ID.
`vungle`	`app_id`	Vungle 앱 ID.

파라미터

모든 파라미터는 channel_setup 객체 안에 키-값 쌍으로 전달됩니다.

AppLovin

파라미터	데이터 유형	필수	설명
`sdk_keys`	`Array[String]`	O	앱에 대한 AppLovin SDK 키 목록.

Chartboost

파라미터	데이터 유형	필수	설명
`app_id`	`String`	O	Chartboost 앱 ID.
`token`	`String`	O	Chartboost 앱 서명.

Facebook

파라미터	데이터 유형	필수	설명
`app_id`	`String`	O	Facebook 앱 ID.
`adimpression_forwarding`	`Boolean`	아니요	광고 노출 포워딩을 활성화합니다. 기본값은 `false`입니다.

GameAnalytics

파라미터	데이터 유형	필수	설명
`key`	`String`	O	고유한 GameAnalytics 게임 키.

Google

파라미터	데이터 유형	필수	설명
`link_id`	`String`	O	Google Ads 링크 ID.

InMobi

파라미터	데이터 유형	필수	설명
`property_id`	`String`	O	InMobi 속성 ID(GMP ID).
`advertiser_id`	`String`	O	InMobi 광고주 ID.

ironSource

파라미터	데이터 유형	필수	설명
`advertiser_id`	`String`	O	ironSource 광고주 ID.
`password`	`String`	O	ironSource 비밀번호.

Mintegral

파라미터	데이터 유형	필수	설명
`enabled`	`Boolean`	O	Mintegral 연동을 활성화하려면 `true`로 설정합니다.

Snapchat

파라미터	데이터 유형	필수	설명
`snap_app_id`	`String`	O	Snapchat 앱 ID.

Tapjoy

파라미터	데이터 유형	필수	설명
`app_id`	`String`	O	Tapjoy 앱 ID.

TikTok

파라미터	데이터 유형	필수	설명
`app_id`	`String`	O	TikTok 앱 ID.
`enabled`	`Boolean`	아니요	연동 활성화 여부. 기본값은 `true`입니다.

Unity Ads

파라미터	데이터 유형	필수	설명
`game_id`	`String`	O	Unity Ads 게임 ID.

Vungle

파라미터	데이터 유형	필수	설명
`app_id`	`String`	O	Vungle 앱 ID.

예

전체 채널 설정 예시

다음 예시는 여러 파트너에 대한 채널 설정 요청을 보여줍니다.

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"
        }
    }
}'

단일 파트너 설정

1개의 파트너만 구성:

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"
        }
    }
}'

기존 앱에 대한 채널 설정 업데이트

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"
        }
    }
}'

채널 설정 보기

앱에 대한 현재 채널 설정을 보려면 GET /app/{app_token} 엔드포인트를 사용합니다. 응답에는 구성된 값과 함께 channel_setup 객체가 포함됩니다.

{
   "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" }
   }
}