본문으로 건너뛰기

SDK 시작 및 중지

이 단계에서는 실제 위치 모니터링을 시작하고, 이벤트를 앱 로직에 연결합니다.

목표​

  • 1. start() 호출 시점 정리
  • 2. stop() 호출 기준 정리
  • 3. 주요 응답 필드 이해
팁

start() / stop()은 중복 호출해도 SDK 내부에서 1회로 처리됩니다.

중복 호출하더라도, SDK는 정상적으로 동작합니다.

위치 권한 획득​

경고

ACCESS_FINE_LOCATION 등 민감한 권한은 OS 버전에 따라 앱이 사용자에게 런타임 요청을 해야 합니다.

권장 순서​

  1. 위치 서비스 사용에 대한 앱 내 설명, 동의

  2. requestPermissions로 위치 권한 요청, 허용

  3. (필요시) 백그라운드 위치 등 추가 안내 후 그에 맞는 권한 요청

  4. start() 호출

정보

매니페스트·문구·UX는 스토어 정책에 맞게 구성해 주세요.

백그라운드 위치 권한 사용/심사 가이드는 백그라운드 위치 가이드 문서에 작성되어 있습니다.

Start 호출​

사용자가 위치 약관에 동의하면 start()를 호출하도록 구현해 주세요.

start()가 호출된 시점부터 SDK 동작이 시작되고 리스너를 통해 위치 요청 결과가 전달됩니다.

경고

안정적인 SDK 동작을 위해 앱 정책에 따라 "로그인 후"와 "앱 최초 실행 시"에도 위치 약관 동의 여부를 확인해서 호출해 주세요.

Plengi.getInstance(this).start();

Stop 호출​

수집을 명시적으로 중단해야 하는 경우에만 stop() 함수를 호출하도록 구현해 주세요.

  • 사용자의 위치 약관 철회
  • 위치 약관 동의한 사용자의 로그아웃
  • 서비스 만료/해지
위험

예외적 케이스(권한 제거, 단말기 재부팅, 앱 비정상 종료 등)만으로 stop() 을 임의 호출하지 마세요.

Plengi.getInstance(this).stop();

start / stop 호출까지 완료되면 기본 동작을 위한 SDK 탑재는 완료되었습니다.

아래 참고 가이드를 확인한 뒤 동작 테스트를 진행해 주세요.

참고 가이드​

위치 요청 결과/캠페인 매칭 결과 확인이 필요하다면?​

PlengiResponse 및 Advertisement 필드 상세는 아래 문서로 분리했습니다.

SDK 동작 테스트가 필요하다면?​