앱 엔드포인트

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

새 앱 생성하기

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

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

파라미터

응답 파라미터

예시

$ 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={}

파라미터

응답 파라미터

예시

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

파라미터

응답 파라미터

예시

$ 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

파라미터

응답 파라미터

예시

$ 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"
]

서명 검증 활성화

앱 트래픽 보안을 위해 Adjust v3 Signature 라이브러리를 사용하는 경우, 자동화 API를 사용하여 앱의 인증서 핑거프린트를 구성할 수 있습니다.

설명

1. 다음 정보와 함께 POST 요청을 /app 엔드포인트로 전송합니다.

   • name: 앱의 이름
   • bundle_id: Android용 번들 ID | Apple용 스토어 ID
   • store_id: 타겟 앱 스토어 내 앱의 ID
   • platform: 앱의 타겟 플랫폼
   • channel_setup: 앱에 대한 파트너 모듈 설정을 위해 필요 자세한 정보는 채널 설정 설명을 참고하시기 바랍니다.

   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"}, "snapchat": {"app_id": "test.bundle.app"} } }' \
   -X POST https://settings.adjust.com/api/app

2. Adjust 담당자에게 연락하여 Signature v3 지원을 활성화하도록 요청하시기 바랍니다.

3. 앱이 Signature v3 지원 대상으로 표시되면, 다음과 함께 /app 엔드포인트로 또 다른 POST 요청을 전송합니다.

   • android_signature_hash: 쉼표로 구분된 16진법 형식의 SHA-1 서명 목록.
   • Adjust 서명 토큰 값이 포함된 SignatureAuthorization 헤더.

   curl \
   --header "AdjustAuthorization: Token <adjust api token>" \
   --header "SignatureAuthorization: Token <adjust signature token>" \
   --header "Content-Type: application/json" \
   --data '{ "name":"Test App Name", "android_signature_hash": "45:a7:2b:82:00:f1:f6:99:d7:c5:1e:6e:1f:8c:91:b5:5c:f9:98:a2,44:40:16:6e:ed:36:cc:6d:6e:62:53:92:9e:ef:45:63:a1:3c:19:0c,57:44:3a:4c:05:23:50:a4:46:38:83:5d:64:fd:66:82:2f:81:33:19", "bundle_id":"test.bundle.app", "store_id":"test.bundle.app", "platform":"android", "channel_setup": { "facebook": {"app_id": "123456789"}, "snapchat": {"app_id": "test.bundle.app"} } }' \
   -X POST https://settings.adjust.com/api/app