디바이스 API

디바이스 API를 통해 사용자의 디바이스 정보를 확인하고, 테스트 목적으로 진행한 Adjust에서 디바이스 활동 내역을 삭제해보시기 바랍니다.

요구 사항

기기 삭제는 파괴적인(destructive) 행동입니다. 기기 삭제 엔드포인트를 사용하려면 반드시 계정에 다음 사용자 권한 중 하나 가 있어야 합니다.

관리자 .
편집자 .
타겟 앱에 대한 액세스가 있는 커스텀 편집자 .

인증

기기 API는 인증을 위해 베어러 토큰 을 사용합니다. 디바이스 API에 대한 각 요청과 함께 Authorization 헤더에 Adjust API 토큰을 포함해야 합니다.

Single Sign-On (SSO)를 활성화한 경우, Adjust 담당자에게 연락하거나 support@adjust.com 으로 이메일을 보내 API를 찾는 데 도움을 받으시기 바랍니다.

비 SSO 계정의 경우, API는 사용자의 프로필 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다.

계정(사용자) 아이콘을 선택합니다.
계정 설정 을 선택합니다.
내 프로필 탭을 선택합니다.
API 토큰 은 사용자 세부 사항 과 함께 표시됩니다. 시스템 클립보드에 토큰을 복사하기 위해 복사를 선택합니다.

Adjust API 토큰 재설정

Adjust API 토큰은 언제든지 재설정할 수 있습니다. 토큰을 재설정하면 이전의 토큰은 무효화됩니다. Adjust API 토큰을 재설정한 경우 기존 토큰이 사용되는 모든 곳에서 교체해야 합니다. 무효화된 토큰에 대한 요청은 Adjust에 의해 거부됩니다.

Adjust API 토큰 재설정

계정(사용자) 아이콘을 선택합니다.
계정 설정 을 선택합니다.
내 프로필 탭을 선택합니다.
API 토큰 은 사용자 세부 사항 과 함께 표시됩니다.
API 토큰 재설정 을 선택합니다.
모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 재설정 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다.
시스템 클립보드에 API 토큰 을 복사하기 위해 복사를 선택합니다.

기기 검사

GET https://api.adjust.com/device_service/api/v2/inspect_device

GET https://api.adjust.com/device_service/api/v1/inspect_device

기기 엔드포인트 검사를 사용하여 앱과 관련된 기기 및 링크 정보를 가져올 수 있습니다.

파라미터

다음의 파라미터를 반드시 쿼리 파라미터 로 추가해야 합니다.

app_token (String): 앱을 식별하는 영숫자 토큰. 반드시 12자여야 합니다.
advertising_id (String): 기기와 관련된 고유한 광고 ID.

이용 가능한 광고 ID는 다음과 같습니다.

idfa: 광고주를 위한 ID. iOS 기기에서만 이용 가능합니다.
gps_adid: Google 광고 ID.Google Play Store를 사용하는 Android 기기에서만 이용 가능합니다.
android_id: Android 기기 ID. Android 기기에서만 이용 가능합니다.
fire_adid: Amazon Fire 광고 ID. Amazon Fire 스토어를 사용하는 Android 기기에서만 이용 가능합니다.
win_adid: Windows 광고 ID. Windows 기기에서만 이용 가능합니다.

응답 형식

1
{
2
   "Adid": "string",
3
   "AdvertisingId": "string",
4
   "Tracker": "string",
5
   "TrackerName": "string",
6
   "Environment": "string",
7
   "ClickTime": "date-time",
8
   "InstallTime": "date-time",
9
   "LastSessionTime": "date-time",
10
   "LastEventsInfo": {
11
      "{event_id}": {
12
         "name": "string",
13
         "time": "date-time"
14
      },
15
      "{event_id}": {
16
         "name": "string",
17
         "time": "date-time"
18
      },
19
      "{event_id}": {
20
         "name": "string",
21
         "time": "date-time"
22
      }
23
   },
24
   "LastSdkVersion": "ios4.37.2",
25
   "State": "string"
26
}

1
{
2
   "Adid": "string",
3
   "AdvertisingId": "string",
4
   "Tracker": "string",
5
   "TrackerName": "string",
6
   "ClickTime": "date-time",
7
   "InstallTime": "date-time",
8
   "LastSessionTime": "date-time",
9
   "LastEventTimes": {
10
      "string": "date-time",
11
      "string": "date-time",
12
      "string": "date-time",
13
      "string": "date-time"
14
   },
15
   "State": "string"
16
}

예:

$ curl \
--header "Authorization: Bearer ask43jskdp2tg2hg87" \
-L -X GET "https://api.adjust.com/device_service/api/v2/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"

{
   "Adid": "acf8534f2f052395e617a38730682ccc",
   "AdvertisingId": "1234-5678-9012-3456",
   "Tracker": "abc123",
   "TrackerName": "Organic",
   "FirstTracker": "zr5vueb",
   "FirstTrackerName": "Organic",
   "Environment": "sandbox",
   "ClickTime": "0001-01-01T00:00:00Z",
   "InstallTime": "2015-08-19T03:42:03Z",
   "LastSessionTime": "2017-07-29T17:29:17Z",
   "LastEventsInfo": {
      "kgfcul": {
         "name": "Copy IDFA",
         "time": "2024-07-18T10:01:16Z"
      },
      "wz9qqz": {
         "name": "Accept Terms",
         "time": "2024-07-01T14:13:47Z"
      },
      "z3f773": {
         "name": "Copy IDFV",
         "time": "2024-07-01T19:01:39Z"
      }
   },
   "LastSdkVersion": "ios4.37.2",
   "State": "installed"
}

$ curl \
--header "Authorization: Bearer ask43jskdp2tg2hg87" \
-L -X GET "https://api.adjust.com/device_service/api/v1/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"

{
   "Adid": "acf8534f2f052395e617a38730682ccc",
   "AdvertisingId": "1234-5678-9012-3456",
   "Tracker": "abc123",
   "TrackerName": "Organic",
   "ClickTime": "0001-01-01T00:00:00Z",
   "InstallTime": "2015-08-19T03:42:03Z",
   "LastSessionTime": "2017-07-29T17:29:17Z",
   "LastEventTimes": {
      "a1a1a1": "2017-07-29T17:29:55Z",
      "b2b2b2": "2017-07-29T17:29:21Z",
      "c3c3c3": "2017-07-29T17:29:38Z",
      "4d4d4d": "2017-07-29T17:29:58Z"
   },
   "State": "installed"
}

디바이스 삭제

POST https://api.adjust.com/device_service/api/v1/forget_device

Adjust 서버에서 기기 정보를 삭제하려면 디바이스 삭제 엔드포인트를 사용하시기 바랍니다. 이를 사용하여 기기에서의 설치를 여러 번 테스트할 수 있습니다.

파라미터

다음의 파라미터를 반드시 요청 데이터 로 추가해야 합니다.

app_token (String): 앱을 식별하는 영숫자 토큰. 반드시 12자여야 합니다.
adid (String): 기기의 고유한 Adjust ID. 기기의 ADID를 찾으려면 기기 엔드포인트 검사 를 사용하시기 바랍니다.

예:

$ curl \
--header "Authorization: Token token=ask43jskdp2tg2hg87" \
--location --request POST "https://api.adjust.com/device_service/api/v1/forget_device" \
--data "adid=acf8534f2f052395e617a38730682ccc&app_token=gwzpeepw8uf8"

200: Forgot device