앱 개발

우리 앱 걸음 수가 건강 앱과 다르게 나오는 이유

우리 앱 걸음 수가 건강 앱과 다르게 나오는 이유

우리 앱 걸음 수가 건강 앱과 다르게 나오는 이유

헬스 커넥트 문서는 걸음 수를 원본 기록으로 읽지 말고 집계 기능으로 읽으라고 적고 있습니다. 아이폰과 애플워치가 같은 걸음을 두 번 기록하는 문제, 2026년 6월 바뀐 안드로이드 기기 걸음 수 출처 이름처럼 숫자가 어긋나는 원인을 다룹니다.

헬스 커넥트 문서는 걸음 수를 원본 기록으로 읽지 말고 집계 기능으로 읽으라고 적고 있습니다. 아이폰과 애플워치가 같은 걸음을 두 번 기록하는 문제, 2026년 6월 바뀐 안드로이드 기기 걸음 수 출처 이름처럼 숫자가 어긋나는 원인을 다룹니다.

6분 소요

6분 소요

걸음 수 리워드 앱을 운영하면 고객센터에 같은 문의가 반복해서 들어옵니다. "건강 앱에는 8천 보인데 이 앱에는 1만 2천 보로 나와요", 또는 그 반대입니다. 포인트가 걸린 앱이라면 숫자 하나가 민원이 됩니다. 원인은 대부분 공식 문서에 이미 적혀 있고, 기획 단계에서 정해 두면 막을 수 있는 것들입니다.

우리 앱 걸음 수가 건강 앱과 다르게 나오는 이유 대표 이미지

같은 걸음을 두 번 세는 경우

아이폰을 주머니에 넣고 애플워치를 찬 채로 걸으면 두 기기가 같은 걸음을 각각 기록합니다. 안드로이드도 휴대폰과 워치, 운동 앱이 같은 시간대 걸음을 헬스 커넥트에 각자 넣을 수 있습니다. 앱이 이 원본 기록을 모두 더하면 실제보다 훨씬 많은 숫자가 나옵니다.

걸음 수가 합쳐지는 과정
휴대폰 기록10시부터 10시 30분, 3,000보
워치 기록같은 시간대, 3,100보
집계 기능출처 우선순위로 겹침 정리
하루 합계한쪽 기록만 반영
원본 기록을 직접 더하면 6,100보가 됩니다.

헬스 커넥트 집계 문서는 걸음 수를 읽을 때 원본 기록 읽기(`readRecords`)가 아니라 집계 기능(`aggregate`)을 쓰라고 명시합니다. 집계 기능은 사용자가 헬스 커넥트 설정에서 정한 앱 우선순위에 따라 겹치는 기록을 정리합니다. 이 정리는 활동과 수면 종류 데이터에만 적용된다고 문서에 적혀 있습니다.

iOS도 같습니다. 애플 개발자 포럼에서 애플 기술 지원 담당자가 답한 내용을 보면, 원본 샘플을 읽으면 모든 기록이 그대로 나오고, 통계 쿼리(`HKStatisticsCollectionQuery`)는 중복을 걸러 준다고 합니다. 기기별 숫자를 따로 보고 싶다면 출처별 합계 옵션(`separateBySource`)을 씁니다.

그래서 개발사에 요청할 때는 "하루 걸음 수는 플랫폼의 집계 기능 결과를 쓴다"를 요구사항에 적어 두는 것이 좋습니다. 검수 때는 휴대폰과 워치를 함께 착용하고 걸은 날의 숫자를 건강 앱 화면과 비교해 보면 확인됩니다.

사용자가 정한 우선순위 때문에 다른 경우

집계 기능을 쓰더라도 어느 기록을 우선할지는 사용자 설정입니다. 아이폰 건강 앱은 데이터 소스 화면에서 기기와 앱의 순서를 바꿀 수 있고, 헬스 커넥트도 앱 우선순위를 사용자가 정합니다. 다만 애플은 어느 기기를 기본으로 우선하는지 개발자 문서에 정해 두지 않았습니다.

앱이 특정 기기 기록만 골라 읽으면 건강 앱 숫자와 달라집니다. 헬스 커넥트에는 특정 앱이 넣은 기록만 읽는 필터(`dataOriginFilter`)가 있는데, 이 필터를 쓴 채로 사용자가 다른 앱을 주로 쓰기 시작하면 걸음 수가 갑자기 줄어든 것처럼 보입니다.

2026년 6월에 바뀐 안드로이드 출처 이름

안드로이드 14 이상 기기에서는 휴대폰 자체가 센 걸음 수가 헬스 커넥트에 직접 기록됩니다. 헬스 커넥트 문서에 따르면 이 기능은 어떤 앱이든 걸음 수 읽기 권한을 받았을 때 켜지고, 배터리 사용을 줄이려고 1분에 한 번 이하로 몰아서 저장합니다. 방금 걸은 걸음이 바로 반영되지 않는 이유가 이것입니다.

이 기록의 출처 이름이 2026년 6월 업데이트부터 바뀌었습니다. 이전에는 출처가 `android`로 찍혔는데, 이제 기기마다 다른 가상 패키지 이름이 붙습니다. "출처가 android인 기록만 휴대폰 걸음으로 친다"는 식으로 코드에 이름을 적어 둔 앱은 업데이트 뒤 휴대폰 걸음 수를 놓칩니다. 문서는 이 이름을 코드에 직접 적지 말고 조회 기능으로 받아 쓰라고 안내합니다. 출처 구분 없이 전체 합계만 쓰던 앱은 바꿀 것이 없습니다.

기록 보관 기간에 걸린 경우

기기 안 기록에는 읽을 수 있는 기간이 있습니다. 이 기간이 지나면 앱에서는 기록이 없는 것처럼 보입니다.

앱이 읽을 수 있는 지난 기록
  1. 7일iOS CMPedometer 보관 기간
  2. 10일안드로이드 Recording API 보관 기간
  3. 30일헬스 커넥트, 권한을 처음 받은 날 이전
  4. 재부팅안드로이드 걸음 센서 누적 값 초기화

헬스 커넥트는 기본적으로 권한을 처음 받은 날 기준 30일 전까지만 읽을 수 있고, 그 이전 기록은 지난 기록 읽기 권한을 따로 받아야 합니다. 앱을 지웠다 다시 설치하면 30일 기준이 새로 설치한 날부터 다시 잡힙니다. "앱을 다시 깔았더니 지난달 기록이 사라졌다"는 문의가 여기서 나옵니다.

사용자가 며칠 동안 앱을 열지 않은 경우도 있습니다. 주간 미션을 서버 기록으로 판정하는데 앱이 그 기간에 한 번도 서버로 올리지 못했다면, 보관 기간이 지난 날의 걸음은 다시 가져올 수 없습니다. 미션 판정 기간을 보관 기간보다 짧게 잡거나, 판정 전에 앱을 열어 동기화하라는 알림을 보내는 식으로 정책을 정합니다.

어제 걸음 수가 오늘 바뀌는 경우

워치 기록은 휴대폰과 연결될 때 한꺼번에 넘어옵니다. 워치를 휴대폰 없이 차고 다녔다면 저녁이나 다음 날 아침에야 기록이 들어오고, 그 순간 어제 합계가 바뀝니다. iOS도 아이폰이 잠긴 동안 읽지 못한 기록이 잠금을 풀 때 들어옵니다.

서버가 자정에 한 번 읽고 그날 걸음 수를 확정하면, 사용자는 건강 앱에 늘어난 어제 숫자를 보고 포인트가 덜 들어왔다고 문의합니다. 헬스 커넥트에는 마지막으로 읽은 뒤 바뀐 기록만 돌려주는 변경 목록 기능이 있고, 동기화 문서도 이 방식으로 앱 서버와 맞추는 방법을 설명합니다. 기술보다 먼저 정할 것은 운영 정책입니다. 걸음 수를 며칠 뒤에 확정할지, 확정 뒤에 들어온 기록은 반영하지 않는다는 문구를 어디에 보여 줄지를 정해 두면 문의에 같은 답을 줄 수 있습니다.

하루를 나누는 기준이 다른 경우

해외여행 중이거나 자정 무렵 걸은 걸음은 어느 날짜에 넣을지에 따라 숫자가 달라집니다. 헬스 커넥트는 기간 단위 집계에서 기기의 현지 날짜와 시각(`LocalDateTime`)을 쓰도록 되어 있고, HealthKit 통계 쿼리는 하루를 자르는 기준 시각을 앱이 정합니다. 서버가 한국 시간으로 날짜를 다시 자르면 앱 화면과 서버 기록이 하루씩 어긋날 수 있습니다. "하루는 기기 현지 시간 0시 기준" 같은 규칙을 앱과 서버 담당자가 같이 정해 두어야 합니다.

검수 때 확인하면 좋은 상황

  • 휴대폰과 워치를 함께 착용하고 걸은 날, 앱 숫자와 건강 앱 숫자 비교
  • 앱을 지우고 다시 설치한 뒤 지난 기록이 어디까지 보이는지
  • 안드로이드 휴대폰을 재부팅한 날의 걸음 수
  • 일주일 넘게 앱을 열지 않았다가 연 경우 미션 판정 결과
  • 기기 시간대를 바꾼 상태에서 자정 전후 걸음의 날짜

걸음 수 기능의 데이터 출처를 고르는 방법은 걸음 수 기능, 안드로이드와 iOS에서 어디서 가져오나 글에 있습니다. 운영 중인 앱에서 숫자 문의가 잦다면 상담 페이지로 현재 연동 방식을 알려 주세요.

자주 묻는 질문

건강 앱과 숫자를 완전히 똑같이 맞출 수 있나요?

플랫폼의 집계 기능을 쓰고 하루 기준 시각을 같게 하면 대부분 맞습니다. 다만 안드로이드 기기 걸음 수는 1분 이하 간격으로 몰아서 저장되고, 앱이 서버로 올리는 시점도 있어서 화면을 여는 순간에는 몇 분 차이가 날 수 있습니다.

걸음 수가 0으로 나오는 사용자는 무엇을 확인해야 하나요?

권한부터 봅니다. 안드로이드는 신체 활동 권한과 헬스 커넥트 걸음 수 권한이 모두 켜져 있는지, iOS는 건강 앱에서 이 앱의 걸음 수 읽기가 켜져 있는지 확인합니다. iOS는 읽기 권한을 끈 경우에도 앱이 그 사실을 알 수 없어서 앱 안내 문구로 확인 경로를 알려 줘야 합니다.

걸음 수 조작은 막을 수 있나요?

완전히 막기는 어렵습니다. 다른 앱이 헬스 커넥트나 HealthKit에 직접 기록을 넣을 수 있기 때문입니다. 포인트가 걸린 서비스라면 하루 상한, 짧은 시간에 비정상적으로 많은 걸음, 출처별 합계 비교 같은 서버 쪽 판정 규칙을 운영 정책으로 함께 정합니다.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다

다른 아티클 살펴보기

다른 아티클 살펴보기

다른 아티클 살펴보기