앱 엔드포인트

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

새 앱 생성하기

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

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

파라미터

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

응답 파라미터

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

예시

$ 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": "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"
}

앱 상세 정보 불러오기

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

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

파라미터

이름	데이터 유형	In	설명
`store_id`*	`String`	Query	Android용 번들 ID \| Apple용 스토어 ID
`platform`*	`String`	Query	`android` \| `ios`

응답 파라미터

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

예시

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

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

Adjust 토큰의 앱 상세 정보 불러오기

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

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

파라미터

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

응답 파라미터

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

예시

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

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

앱 채널 불러오기

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

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

파라미터

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

응답 파라미터

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

예시

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

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