본문으로 건너뛰기

Adjust FAQ(자가 점검용)

최근 업데이트 2026. 10. 07.

1. Push API​

1.1 SDK 초기화 순서(필독)​

경고

ThinkingData SDK와 Adjust SDK는 반드시 다음 절차에 따라 초기화하고 인터페이스를 호출해야 합니다

  • ThinkingData 클라이언트 SDK를 초기화합니다
  • 자동 통합 또는 수동 통합 인터페이스를 호출하여 distinct_id를 서드파티 이벤트에 설정합니다(설정 코드는 공식 문서를 참고하십시오. 이 문서에서는 자세히 설명하지 않습니다)
  • Adjust SDK를 초기화합니다

1.2 AE 설정 - 데이터 소스의 엔드포인트 주소가 비어 있는 경우 처리​

  • AE 백엔드의 프로젝트 관리 - 연동 설정 - 데이터 수집 주소에 8991 포트의 서버 주소를 추가합니다. 서버 주소는 회사의 운영 관리 담당자에게 확인할 수 있습니다. 이후 Adjust 플랫폼의 엔드포인트 주소가 자동으로 동기화됩니다.

1.3 Adjust 콜백 계획의 상태​

1.3.1 상태 1: 연동 오류​

1.3.2 연동 오류의 원인​

  • Adjust 콜백 계획을 생성하거나 업데이트한 후 2시간 이내에 콜백된 데이터가 없음.
  • 72시간 이내에 연동된 데이터는 있지만 변환 실패가 있거나, 72시간이 넘도록 새 이벤트가 콜백되지 않음.

1.3.3 변환 실패 원인 분석​

  • 데이터 변환 실패 원인을 확인하려면 계획 오른쪽 상단의 상세 아이콘을 클릭하고 데이터 상세 정보에서 변환 실패 원인을 확인합니다

  • 시나리오: 변환 실패, 사유: 유저 ID를 연결할 수 없음

    • 문제 원인 1: 문서의 요구 사항에 따라 AE 유저 식별자를 Adjust 이벤트에 할당하지 않았기 때문입니다
    • 문제 원인 2: 이전 버전의 APP에서 유저 식별자를 Adjust 이벤트에 설정하지 않았거나 ThinkingData SDK를 통합하지 않았기 때문입니다
    • 구체적인 조사 절차는 서드파티 데이터 콜백 유저 변환 실패 문제 해결 모범 사례를 참고하십시오

1.3.4 상태 2: 연동됨​

  • 플랫폼 연동 상태가 연동됨이면 해당 플랫폼에서 데이터를 수신했고 데이터가 이미 저장되었음을 의미합니다. 이때 통합 페이지 또는 각 플랫폼의 설정 페이지에서 상세 데이터를 클릭하여 최근 수신한 1000건의 데이터를 바로 확인할 수 있습니다:

1.3.5 상태 3: 연동 대기 중​

  • 설정을 완료한 후 AE로 콜백된 이벤트가 없는 상태입니다. 콜백 url이 Adjust 백엔드에 정상적으로 설정되었는지 확인하십시오

1.4 te_ads_object 속성은 무엇이며, 다른 필드를 저장할 수 있나요?​

  • te_ads_object 객체는 표준화된 객체 필드로, 서드파티 플랫폼마다 필드 이름은 다르지만 의미가 같은 필드를 이 객체에 통일하여 저장하여 이후 분석에 활용할 수 있도록 합니다.
  • 가능합니다. 유저 속성 저장 규칙 설정 모듈에서 설정할 수 있으며, 소스 데이터명은 변환 전 필드이고 대상 속성명은 저장할 필드 이름입니다
    • 예: Adjust가 콜백한 원본 데이터 필드 idfa를 te_ads_object 객체에 매핑합니다.

1.5 특수 이벤트(노출, 클릭, 비용 데이터)의 저장 규칙​

  • impression, click, Ad spend의 콜백 데이터는 커스텀 파라미터 전달을 지원하지 않으므로 커스텀 유저 ID를 포함할 수 없습니다. 이러한 데이터를 연동하기 위해 AE 시스템은 이 데이터를 하나의 "가상 유저"에 자동으로 연결합니다. 유저 수준의 impression 및 click 데이터는 데이터양이 너무 많으므로 Adjust Report Service API를 통해 위 이벤트의 집계 데이터를 수집할 것을 권장합니다.

    데이터 타입설명AE 저장 후 이벤트 이름이벤트의 가상 유저
    impression노출adjust_impressionwithout_id
    click클릭adjust_clickwithout_id
    ad_revenue수익adjust_ad_revenuewithout_id

1.6 Adjust 콜백 계획은 비용/지출 데이터 콜백을 지원하나요?​

  • 미지원: Adjust의 제한으로 인해 현재 비용 데이터 콜백은 지원하지 않습니다. Adjust Report Service API를 통해 비용 데이터를 수집할 것을 권장합니다

1.7 Adjust가 콜백한 install 이벤트와 AE SDK가 수집한 ta_app_install 이벤트 수가 일치하지 않나요?​

  • 데이터양 차이가 작은 경우:

    • 일반적으로 설치 이벤트의 수집 규칙이 다르기 때문입니다. ta_app_install은 APP을 새로 설치하거나 삭제 후 재설치할 때마다 한 번씩 트리거됩니다. 반면 Adjust SDK의 install 이벤트에는 일정한 윈도우 기간이 있어, 윈도우 기간 내에 삭제 후 재설치해도 설치 이벤트를 다시 전송하지 않습니다. Adjust 윈도우 기간은 다음 문서를 참고하십시오: Attribution windows | Adjust Help Center

  • 데이터양 차이가 큰 경우:

    • 비교 샘플링 기간이 너무 짧지 않은지, 비교하는 시간대가 일치하는지 확인합니다.
    • AE SDK 또는 Adjust SDK가 연동되지 않은 App 버전이나 채널 패키지가 있는지 확인합니다.
    • 서드파티 콜백 계획이 연동 오류 상태인지 확인하고, Adjust 연동 오류 문제 해결 문서에 따라 조사하고 처리하십시오

1.8 이벤트가 모두 전환 성공했는데 데이터를 조회할 수 없는 원인은 무엇인가요?​

  • 프로젝트에서 강력 검증 모드를 활성화했는지 확인하십시오(프로젝트 데이터 처리 규칙). 활성화되어 있으면 먼저 이 모드를 끄고, 데이터가 한 차례 콜백된 후 다시 활성화할 것을 권장합니다.
    • 강력 검증 모드인지 확인하는 방법: 오른쪽 상단의 설정 버튼을 클릭하고 프로젝트 관리를 찾아 클릭한 후 데이터 처리 규칙을 확인합니다.

1.9 어트리뷰션 채널 media_source에 unattributed와 restricted가 표시되는 문제​

2. Report Service API​

2.1 데이터 수집 성공 또는 실패 여부는 어떻게 확인하나요?​

  • 설정에 성공한 후 계획 오른쪽 상단의 단일 수집을 클릭하면 수집 결과가 내부 메시지로 통지됩니다.
  • 수집 성공 예시
  • 수집 실패 예시

2.2 Report Service API 데이터와 Adjust 백엔드 데이터가 일치하지 않나요?​

  • 차원이 다르거나 파라미터 설정 때문에 데이터 차이가 발생했는지 확인합니다

    • Adjust 대시보드 데이터와 시간대가 일치하는지
    • 어트리뷰션 설정이 모두 기본값인지

  • 채널 타입 필터가 수집 데이터와 일치하는지(현재 Report Service API가 기본으로 수집하는 데이터 타입은 network입니다)

  • Adjust api 데이터에는 지연과 업데이트에 따른 변동이 있으므로 며칠 전 데이터가 정확한지 확인해 보십시오. 일부 날짜의 데이터만 부정확하다면 다시 수집해 보십시오

2.3 Report Service API는 당일 데이터 수집을 지원하나요? 수집 빈도는 어떻게 설정해야 하나요?​

  • 당일 데이터 수집을 지원합니다

  • Adjust에는 동적 보정 메커니즘이 있어 언제 과거 데이터를 수신하든 당일 데이터 값을 동적으로 보정하므로, 데이터가 안정되는 일정한 주기가 없습니다. 보정된 데이터를 수집할 수 있도록 수집 기간을 적절히 늘립니다.

    • 데이터 실시간성 요구가 높은 경우: 매시간 최근 3-7일 데이터를 수집하도록 설정할 것을 권장합니다
    • 데이터 실시간성 요구가 없는 경우: 매일 12시에 최근 3-7일 데이터를 수집하도록 설정할 것을 권장합니다

  • 수집 시간 차원을 전환하는 방법은 아래 그림을 참고하십시오

2.4 같은 계획에 여러 App ID를 설정하려면 어떻게 하나요?​

  • 여러 App ID를 영문 쉼표 ,로 구분하면 됩니다. 아래 그림과 같습니다

2.5 같은 기간의 데이터를 반복 수집하면 중복 데이터가 생기나요?​

  • 같은 기간의 데이터를 여러 번 수집해도 데이터가 중복되지 않습니다. 같은 기간의 데이터는 새 데이터로 전체 덮어쓰기됩니다

2.6 수집 이벤트 이름은 어떻게 수정하나요?​

  • event_name에 해당하는 값을 수정하면 됩니다

2.7 Report Service API가 기본으로 수집하는 attribution_types는 무엇인가요​

  • 기본값은 all이며, 모든 어트리뷰션 타입을 수집합니다.

2.8 자주 발생하는 수집 오류 및 처리 방법​

  • Create event and props failed!
    • 이 오류는 일반적으로 처음 데이터를 수집하거나 계획에 수집 필드를 새로 추가할 때 발생하며, 서버 과부하로 새 필드 생성에 실패하여 발생했을 수 있습니다. 약 10분 정도 기다린 후 데이터 수집을 다시 시도하십시오. 문제가 계속되면 전담 그룹 채팅의 ThinkingAI 고객 성공 매니저(CSM) 또는 ThinkingAI 기술 담당자에게 문의하십시오.
  • The job conflicts with the scheduled
    • 이 오류는 같은 수집 계획에서 이전 수집 작업이 끝나기 전에 새 수집 작업이 실행되어 발생합니다. 일반적으로 무시하거나 10분 정도 기다린 후 다시 수집하면 됩니다
  • Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"User doesn't have enough permissions loc=roas","source":"API","show_error":true}
    • metrics 중 revenue 관련 항목은 모두 지원되지 않으므로 제거해야 하며, 이는 계정 권한과 관련이 있습니다. 다른 차원은 테스트가 필요합니다

Adjust 앱 삭제 이벤트 변환 실패​

  • 사유: 앱 삭제 이벤트에는 커스텀 파라미터를 전달할 수 없습니다
  • 해결: 어트리뷰션 데이터가 필요하면 설치 이벤트와 기타 인앱 이벤트에 콜백 주소를 설정할 수 있습니다

Adjust 요청 오류 start_date​

  • 사유: start_date: should not be in the future
  • 해결: 예약 수집 시간은 서버 시간보다 이전이어야 합니다

Adjust 광고 계층 데이터가 일치하지 않음​

  • 사유: 일부 데이터가 Unattributed로 분류되었거나 campaign_name 필드로 분류되었습니다
  • 해결: 데이터 분포를 확인하고 어트리뷰션 로직을 확인합니다

Adjust 어트리뷰션 데이터와 AE 백엔드가 일치하지 않음​

  • 사유: 콜백 데이터는 organic이지만 AD 백엔드에서는 GG입니다
  • 해결: adjust와 협의하여 데이터 소스를 확인해야 합니다

Adjust FB 채널 데이터가 일치하지 않음​

Adjust SKAN 관련 설정​

  • 이벤트 타입별로 callback url을 입력하면 이후 해당 이벤트만 AE로 콜백됩니다
  • essential과 advanced는 콜백 주소에 이어 붙이는 플레이스홀더이므로 콜백 주소에 설정해야 합니다
  • 콜백 주소에 플레이스홀더 created_at_milli={sk_ts}를 추가합니다

Adjust 콜백 유저 속성 누락​

문제: Adjust 콜백 이벤트에 유저 속성 콜백을 설정했지만 AE 플랫폼의 유저 속성에 해당 필드가 없습니다.

원인 분석:

  • Adjust 콜백 URL의 플레이스홀더 설정이 불완전함
  • 일부 속성은 Adjust SDK 측에서 함께 전달해야 함
  • 커스텀 매크로가 Adjust 백엔드에 설정되지 않음

해결 방안:

  1. Adjust 콜백 URL에 필요한 플레이스홀더가 모두 포함되어 있는지 확인합니다
  2. Adjust 백엔드에서 필요한 커스텀 매크로를 설정합니다
  3. 콜백 데이터의 유저 속성 필드에 값이 있는지 확인합니다

콜백 withoutID 문제​

문제: Adjust 콜백 데이터가 모두 "withoutID" 상태로 표시됩니다.

원인 분석: Adjust가 콜백한 설치 이벤트가 AE 플랫폼에서 기존 유저(#distinct_id 또는 #device_id)와 일치하지 않아 "withoutID"로 표시됩니다.

해결 방안:

  • 클라이언트 SDK가 전송한 #device_id와 Adjust가 콜백한 {adid}가 일치하는지 확인합니다
  • SDK 초기화가 Adjust SDK보다 먼저 완료되는지 확인합니다
  • Adjust 콜백 URL에 디바이스 식별 파라미터가 포함되어 있는지 확인합니다

Adjust 데이터 변환 후 without ID로 표시됨​

  • 사유: Unity SDK 버전 문제입니다. Adjust 5.0 이상을 지원하는 3.4.0으로 업데이트해야 합니다

설정 보충​

채널을 필터링하는 방법​

채널 필터링:

"extra_params": {"allPurpose": "{\\"partner_name__in\\":\\"xxx\\"}"}

필터를 사용하는 방법​

필터를 사용할 때 key에는 필터링할 필드를 그대로 사용합니다:

"extra_params": {"attribution_source": "xxx"}

광고 수익 플랫폼을 지정하는 방법​

광고 수익 플랫폼 지정:

"extra_params": {"ad_revenue_sources": "applovin_max_sdk"}

오류 보충​

start_date 오류​

  • 오류 정보: {"error_code":"request_error","error_desc":"KPI Service: start_date: should not be in the future (400)"}
  • 해결 방안: 예약 수집 시간은 서버 시간보다 이전이어야 합니다.

수집 오류​

  • 오류 정보:
Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"Invalid app tokens. No apps matching the given app filters combination loc=app_tokens"
  • 해결 방안: app_token이 유효하지 않습니다. app_token과 API token의 소속 관계를 확인하십시오.
    curl 검증: 요청 파라미터에서 app_token__in을 제거하고 dimensions에 app_token을 추가한 후 반환 데이터에 어떤 app_token이 포함되어 있는지 확인합니다 
     //요청 파라미터에 adjust_account_id를 추가하면 개인 계정에 소속된 앱의 데이터를 반환할 수 있습니다. 설정:
      "extra_params": { "adjust_account_id": 12345 }
이 문서가 도움이 되었나요?
이 페이지의 내용