We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

개발자

앱 엔드포인트

/app 엔드포인트를 사용하면 새 앱의 생성과 업데이트를 자동화할 수 있습니다.

시작에 앞서

해당 엔드포인트를 사용하려면 요청을 인증해야 합니다. Adjust의 인증 가이드에 나온 설명을 참조하시기 바랍니다.

엔드포인트

/app

POST

템플릿 앱의 설정을 사용해 새 앱을 생성할 수 있습니다. 앱이 이미 존재하는 경우, force_update 파라미터를 사용해 새 설정으로 앱을 업데이트할 수 있습니다.

https://settings.adjust.com/api/app

파라미터

파라미터	데이터 유형	In	설명
`store_id`*	String	Body	Android에 대한 번들 ID. Apple에 대한 Store ID.
`platform`*	String	Body	`android`또는 `ios`.
`name`*	String	Body	앱의 이름.
`bundle_id`*	String	Body	Android 또는 iOS 앱에 대한 번들 ID.
`android_signature_hash`	String	Body	SDK 서명을 빌드하기 위해 키스토어 파일로부터 생성된 SHA1 해시.
`channel_setup`	Object	Body	앱에 대한 파트너 모듈 설정을 위해 필요. 자세한 정보는 채널 설정 설명 참조.
`editors`	String	Body	앱에 대한 액세스가 필요한 사용자의 이메일 목록.
`template_app_token`	String	Body	템플릿으로 사용할 Adjust 앱 토큰. 템플릿 앱을 사용하지 않는 경우 필요.
`force_update`	Boolean	Body	기존 앱의 설정을 업데이트 하려면 이 값을 `true` 로 전달.

예시

curl \
--header "AdjustAuthorization: Token <adjust api token>" \
--header "Content-Type: application/json" \
--data '{
    "name":"Test App Name",
    "bundle_id":"test.bundle.app",
    "store_id":"test.bundle.app",
    "platform":"android",
    "channel_setup": { "facebook": {"app_id": "123456789"} }
}' \
-X POST https://settings.adjust.com/api/app

응답

파라미터	데이터 유형	설명
`adjust_app_token`	String	SDK 연동과 기타 API 요청에 사용될 Adjust 앱 토큰.
`name`	String	앱의 이름.
`sk_app_id`	Integer	iOS 앱에 대한 StoreKit 앱 ID.
`store_id`	String	Android에 대한 번들 ID. Apple에 대한 Store ID.
`bundle_id`	String	Andorid나 iOS에 대한 번들 ID.
`ticket_token`	UUID	현재 작업 상태를 확인하기 위한 티켓 ID. 자세한 정보는 상태 엔드포인트 설명 참조.

{
    "adjust_app_token": "p77yk727r18g",
    "name": "Test App Name",
    "sk_app_id": null,
    "store_id": "test.bundle.app",
    "bundle_id": "test.bundle.app",
    "ticket_token": "af7702a9-ba95-6ba2-bdac-3f83e55ed8d3"
}

/app

GET

앱 스토어 ID와 플랫폼 이름을 사용해 앱에 관한 상세 정보를 조회할 수 있습니다.

https://settings.adjust.com/api/app?store_id={}&platform={}

파라미터

이름	데이터 유형	In	설명
`store_id`*	String	쿼리	Android에 대한 번들 ID. Apple에 대한 Store ID.
`platform`*	String	쿼리	`android`또는 `ios`.

예시

curl \
--header "AdjustAuthorization: Token <adjust api token>" \
-L -X GET 'https://settings.adjust.com/api/app?store_id=test.bundle.app&platform=android'

응답

이름	유형	설명
`name`	String	앱 이름
`platform`	String	`android` 또는 `ios`
`store_id`	String	Android에 대한 번들 ID. iOS에 대한 Store ID.
`adjust_app_token`	String	요청된 앱에 대한 토큰.
`additional_info`	Object	엔드포인트에서 이미 수신한 모든 앱 세부정보.
`channel_setup`	Object	파트너별 파라미터 정보는 채널 설정을 참고하시기 바랍니다.
`cross_promo_token`	String	CrossPromotion에 사용할 Adjust 트래커 토큰(사용 가능한 경우)
`android_signature_hash`	String	SDK 서명을 빌드하기 위해 키스토어 파일로부터 생성된 SHA1 해시.

{
    "name": "Test App Name",
    "platform": "android",
    "store_id": "test.bundle.app"
    "adjust_app_token": "p77yk727r18g",
    "additional_info": { "overrides": {} },
    "channel_setup": {
       "facebook": { "app_id": "123456789" },
       "snapchat": { "app_id": "test.bundle.app" }
    },
    "cross_promo_token": "hgj3li1",
    "android_signature_hash":
        "FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF",
}

/app/{adjust_app_token}

GET

Adjust 앱 토큰을 사용해 앱에 관한 상세 정보를 조회할 수 있습니다.

https://settings.adjust.com/api/app/{adjust_app_token}

파라미터

이름	데이터 유형	In	설명
`adjust_app_token`*	String	Path	Adjust 앱 토큰. Adjust 대시보드나 /app POST 응답에서 확인 가능.

예시

curl \
--header "AdjustAuthorization: Token <adjust api token>" \
-X GET https://settings.adjust.com/api/app/p77yk727r18g/

응답

이름	유형	설명
`name`	String	앱 이름
`platform`	String	`android` 또는 `ios`
`store_id`	String	Android에 대한 번들 ID. iOS에 대한 Store ID.
`adjust_app_token`	String	요청된 앱에 대한 토큰.
`additional_info`	Object	엔드포인트에서 이미 수신한 모든 앱 세부정보.
`channel_setup`	Object	파트너별 파라미터 정보는 채널 설정을 참고하시기 바랍니다.
`cross_promo_token`	String	CrossPromotion에 사용할 Adjust 트래커 토큰(사용 가능한 경우)
`android_signature_hash`	String	SDK 서명을 빌드하기 위해 키스토어 파일로부터 생성된 SHA1 해시.

{
    "name": "Test App Name",
    "platform": "android",
    "store_id": "test.bundle.app"
    "adjust_app_token": "p77yk727r18g",
    "additional_info": { "overrides": {} },
    "channel_setup": {
       "facebook": { "app_id": "123456789" },
       "snapchat": { "app_id": "test.bundle.app" }
    },
    "cross_promo_token": "hgj3li1",
    "android_signature_hash":
        "FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF",
}

/app/{adjust_app_token}/channels

GET

앱에 대해 활성 상태인 트래커가 있는 채널의 목록을 조회합니다.

https://settings.adjust.com/api/app/{adjust_app_token}/channels

파라미터

이름	데이터 유형	In	설명
`adjust_app_token`*	String	Path	Adjust 앱 토큰. Adjust 대시보드나 /app POST 응답에서 확인 가능.

예시

curl \ 
--header 'AdjustAuthorization: Token <adjust api token>' \
--header "SignatureAuthorization: Token <adjust signature token>" \
--X GET 'https://settings.adjust.com/api/app/927t3s86rzsw/channels'

응답

파라미터	데이터 유형	설명
`채널`	Array	앱에 대해 활성 상태인 채널에 대한 네트워크 슬러그 목록.

[
    "unityads",
    "digitalturbine",
    "jetfuel_api",
    "jetfuel",
    "criteo",
    "tapjoy",
    "bytedance",
    "moloco",
    "adikteev",
    "pinsightmedia",
    "applovin",
    "aura_ironsource",
    "freakout",
    "tradedoubler"
]

모든 이용 가능한 네트워크 슬러그가 이 표에 포함되어 있습니다.

Network slug
apple_search_ads
applovin
chartboost
crossinstall
crosspromotion
digitalturbine
facebook
gameanalytics
google
ironsource
snapchat
tapjoy
unityads
vungle
inmobi