adjust-icon

앱 엔드포인트

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

새 앱 생성하기

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

엔드포인트
POST https://settings.adjust.com/api/app

파라미터

응답 파라미터

예시

cURL
$ 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
$ 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
$ 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
$ 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: 앱에 대한 파트너 모듈 설정을 위해 필요 자세한 정보는 채널 설정 설명을 참고하시기 바랍니다.
    Terminal window
    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 헤더.
    Terminal window
    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