본문으로 건너뛰기

서드파티 데이터 콜백 유저 변환 실패 문제 해결 모범 사례

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

1. 배경​

고객이 서드파티 데이터 콜백 계획을 연동하고 사용할 때 유저 ID 변환 실패 문제가 자주 발생합니다. 이러한 문제는 일상적인 문제 처리에서 높은 비중을 차지하며, 데이터의 정확성과 비즈니스 의사 결정의 유효성에 영향을 줍니다. 내부 동료와 외부 고객이 이러한 문제를 더 잘 조사하고 해결할 수 있도록 이 모범 사례 문서를 작성하여 체계적인 문제 해결 가이드와 해결 방안을 제공합니다.

팁

Adjust: adjust push api 설정 문서

AppsFlyer: appsflyer push api 설정 문서

SolarEngine: SolarEngine push api 설정 문서

2. SDK 초기화 순서(중요)​

경고

ThinkingData SDK와 서드파티 SDK는 반드시 다음 절차에 따라 초기화하고 인터페이스를 호출해야 합니다. 코드의 초기화 절차에 문제가 없음을 확인한 후 아래 내용을 확인하십시오

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

3. 문제 시나리오​

팁

  • App 버전 번호: 전환 전 데이터의 app_version이 app 버전입니다. 전환 전 데이터에 app_version 필드가 없으면 서드파티 플랫폼에서 이 필드를 콜백하도록 설정해야 합니다.

  • 이벤트 이름:

    • Appsflyer: 전환 전 데이터의 event_name을 이벤트 이름으로 사용합니다
    • Adjust: 이벤트 이름은 activity_kind(값이 "event"가 아닌 경우) > event_token > event_name 순으로 우선 적용됩니다
    • SolarEngine: 전환 전 데이터의 event_name을 이벤트 이름으로 사용합니다

  • 시나리오 1:

    • 같은 APP 버전에서 install 이벤트에는 distinct_id가 포함되지 않았지만 다른 이벤트에는 distinct_id가 포함되었습니다.

      • 서드파티 install 이벤트 수집 원리:
        • 서드파티 SDK로 앱 설치를 추적할 때 install 이벤트는 SDK 초기화 후 자동으로 전송되는 첫 번째 이벤트입니다. SDK 초기화 후에 유저 식별자(distinct_id)를 설정하면 install 이벤트는 distinct_id가 설정되기 전에 이미 트리거되므로 해당 distinct_id를 포함할 수 없습니다
      • 문제 원인: ThinkingData 클라이언트 SDK가 서드파티 SDK 초기화 후에 초기화되었기 때문입니다
      • 해결 방법: ThinkingData 클라이언트 SDK의 초기화와 did 설정 인터페이스 호출을 서드파티 SDK보다 먼저 수행하도록 조정합니다

  • 시나리오 2:

    • 서로 다른 APP 버전 중 일부 버전에는 distinct_id가 포함되었고 일부 버전에는 포함되지 않았습니다.
      • 일부 존재 여부 확인

  • 시나리오 3:

    • SDK 초기화 순서와 절차를 확인했고 문제가 없지만, 콜백된 모든 이벤트가 유저 변환 실패로 표시됩니다.

  • 시나리오 4:

    • 위 시나리오가 모두 정상이면 서드파티 백엔드에서 유저 식별 필드를 AE로 반환하도록 설정했는지 확인하십시오

      • AppsFlyer: Custom Data & Customer User ID 두 필드를 선택했는지 확인하십시오
      • Adjust: 설정한 콜백 링크에 publisher_parameters={publisher_parameters} 파라미터가 포함되어 있는지 확인하고, 없으면 추가하십시오
      • SolarEngine: 콜백 주소에 event_custom_params 파라미터가 포함되어 있는지 확인하십시오
이 문서가 도움이 되었나요?
이 페이지의 내용