adjust-icon

서버 간(S2S) API

앱 코드 변경 없이 Adjust S2S API를 사용하여 앱을 Adjust에 연결하세요.

인증

서버 간 API는 인증을 위해 베어러 토큰을 사용합니다. 반드시 차단 리스트 API에 대한 각 요청과 함께 Authorization 헤더에 Adjust API 토큰을 포함해야 합니다.

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

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

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

Adjust API 토큰 재설정

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

Adjust API 토큰 재설정:

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

S2S 엔드포인트

엔드포인트Function
https://s2s.adjust.com/eventAdjust에 인앱 이벤트 통보
https://s2s.adjust.com/ad_revenueAdjust에 광고 매출 데이터 통보
https://s2s.adjust.com/sessionAdjust에 세션 데이터 통보

기기 ID

서버 간 이벤트를 위해 사용할 수 있는 기기 ID는 다음과 같습니다.

선호되는 ID

이름
Raw IDFA (IOS)idfa
Raw Google advertising IDgps_adid
Raw Amazon Fire advertising IDfire_adid
오픈 광고 ID (OAID, Huawei)oaid
웹 ID(Adjust 웹 SDK에서 생성)web_uuid

백업 ID

이름
Raw IDFV(IOS만 해당)idfv
Android ID (Android only)android_id

이벤트 제출에 대한 응답

성공적으로 기록된 모든 이벤트는 OK라는 응답을 반환합니다.

트래킹에 실패한 이벤트는 다음과 같이 HTTP 오류 코드와 JSON 메시지를 반환합니다.

오류 응답
{ "error": "Event request failed (${error_message})" }

오류 메시지는 요청의 어떤 부분이 잘못 되었는지를 알려줍니다. 다음 표를 참고하여 오류를 식별한 다음, 설정을 검토하거나 지원이 필요한 경우 support@adjust.com에 문의하세요.

오류 코드오류 메시지원인
400Bad event state요청 세부 사항이 기대를 충족하지 못하는 경우에 발생 (예: created at 시점이 installed_at 시점보다 앞서 발생함)
400Invalid app token앱 토큰이 올바르게 설정 되지 않음
400Ignoring event, earlier unique event tracked특정 이벤트가 이미 기록됨. 중복된 요청으로 처리되지 않음.
400Invalid callback parameters콜백 파라미터를 추출할 수 없음
400Invalid event token이벤트 토큰이 존재하지 않거나, 잘못 설정되었거나, 앱 토큰과 일치하지 않음
400Invalid revenue숫자가 잘못 설정되었거나 한도보다 높은 값을 입력함 (한도: 100,000,000,000)
401Failed to authorize request인증 토큰이 없거나 일치하지 않음
403App is inactive앱이 대시보드에서 비활성화 됨
403Tracking disabled이 플랫폼에서는 측정할 수 없음
403Event token blocklisted이벤트 토큰이 차단 리스트에 등록되었습니다
404App token not foundApp token을 찾을 수
404Device not found디바이스 데이터를 찾을 수 없음
413Request size too large요청 크기가 최대 허용치인 1MB를 넘음
451Device is opted outDevice is opted out
500Internal error, contact support@adjust.com디바이스 데이터를 업데이트 하던 중 내부에 오류가 발생함