상태 엔드포인트

/status 엔드포인트를 사용하여 백그라운드 작업의 진행 상황을 추적합니다. 앱을 생성하거나 업데이트할 때 설정 마이그레이션은 백그라운드 작업으로 실행됩니다. API는 작업 상태 확인에 사용할 수 있는 ticket_token을 반환합니다.

티켓 상태 조회

티켓 토큰을 사용하여 백그라운드 작업의 현재 상태를 조회합니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/status/{ticket_token}

호출하여 트래킹할 수 있습니다: GET

응답: 티켓 상태 응답

파라미터

파라미터	데이터 유형	In	필수	설명
`ticket_token`	`String`	Path	O	이전 API 작업(예: 앱 생성 또는 업데이트)에서 반환된 티켓 토큰.

예

curl --location 'https://automate.adjust.com/app-automation/status/e5b07bb3-b5f3-40a8-8a2d-197d30b6beff' \
--header 'Authorization: Bearer {your-adjust-api-token}'

{
   "status": "completed",
   "kind": "migration",
   "result": {
      "events": {
         "successes": ["purchase", "registration", "level_complete"],
         "failures": []
      },
      "partners": {
         "successes": ["facebook", "google", "applovin"],
         "failures": []
      },
      "trackers": {
         "successes": ["facebook_installs", "google_installs"],
         "failures": []
      }
   }
}

{
   "status": "opened",
   "kind": "migration",
   "result": {
      "events": {
         "successes": ["purchase"],
         "failures": []
      }
   }
}

{
   "status": "failed",
   "kind": "migration",
   "result": {
      "events": {
         "successes": ["purchase"],
         "failures": []
      },
      "partners": {
         "section": "partners",
         "detail": "Could not be started because events section has failed"
      }
   }
}

상태 값

상태	설명
`new`	작업이 생성되었지만 처리는 아직 시작되지 않았습니다.
`opened`	작업이 현재 처리 중입니다.
`completed`	작업이 성공적으로 완료되었습니다. 자세한 내용은 `result` 필드를 확인하세요.
`failed`	작업이 실패했습니다. 오류 상세 정보는 `result` 필드를 확인하세요.

작업 유형

kind 필드는 티켓이 추적하는 작업 유형을 나타냅니다.

종류	설명
`migration`	템플릿 앱 마이그레이션(템플릿에서 타겟 앱으로 설정 복사)
`update_app`	앱 설정 업데이트(이름, 스토어 ID, 번들 ID 변경)
`create_signature`	SDK 서명 생성
`event_partial_update`	이벤트 생성 또는 업데이트
`partner_partial_update`	파트너 설정 업데이트
`tracker_partial_update`	트래커 설정 업데이트
`callback_partial_update`	콜백 URL 업데이트

결과 이해하기

result 객체에 작업 중 성공한 항목과 실패한 항목에 대한 정보가 포함됩니다. 구조는 작업 유형에 따라 달라집니다.

마이그레이션 결과

migration 작업의 경우, 처리된 각 앱 섹션의 상태가 결과에 포함됩니다.

{
   "result": {
      "events": {
         "successes": ["event_name_1", "event_name_2"],
         "failures": []
      },
      "partners": {
         "successes": ["facebook", "google"],
         "failures": ["snapchat"]
      },
      "trackers": {
         "successes": [],
         "failures": [],
         "skipped": "Partner facebook not configured in target app"
      }
   }
}

부분 업데이트 결과

부분 업데이트 작업의 경우, 결과는 성공적으로 업데이트된 항목과 실패한 항목을 보여줍니다.

{
   "result": {
      "successes": [{ "app_token": "abc123", "name": "purchase" }],
      "failures": [
         {
            "app_token": "xyz789",
            "name": "invalid_event",
            "detail": "Event not found"
         }
      ]
   }
}

상태 폴링

Adjust는 작업이 완료되기를 기다릴 때 적절한 간격으로 상태 엔드포인트를 폴링할 것을 권장합니다.

티켓 토큰을 받은 후 첫 상태 확인까지 2~3초 정도 대기합니다.
상태가 completed 또는 failed가 될 때까지 5~10초 간격으로 폴링합니다.
무한 폴링을 방지하기 위해 최대 타임아웃(예: 5분)을 설정합니다.

데이터 모델

티켓 상태 응답

파라미터	데이터 유형	설명
`status`*	`String`	작업의 현재 상태. `new`, `opened`, `completed`, `failed` 중 하나입니다.
`kind`*	`String`	작업 유형. `migration`, `update_app`, `create_signature`, `event_partial_update`, `partner_partial_update`, `tracker_partial_update`, `callback_partial_update` 중 하나입니다.
`result`*	`Object`	작업 중 성공 및 실패에 대한 정보. 구조는 작업 유형에 따라 다릅니다.