SDK 시작 및 중지

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

목표

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

팁

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

위치 권한 획득

경고

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

권장 순서

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

   

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

   

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

   

4. start() 호출

정보

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

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

Start 호출

사용자가 위치 약관에 동의하면 호출합니다.

start()를 호출하면 SDK가 동작을 시작하고, 리스너를 통해 위치 정보를 전달합니다.

경고

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

Java

Plengi.getInstance(this).start();

Kotlin

Plengi.getInstance(this).start()

Stop 호출

아래처럼 수집을 명시적으로 중단해야 하는 경우에만 호출합니다.

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

경고

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

Java

Plengi.getInstance(this).stop();

Kotlin

Plengi.getInstance(this).stop()

---

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

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

참고 가이드

loplat X를 사용한다면?

X 연동 가이드와 캠페인 매칭 결과 Advertisement 필드 상세를 확인해보세요.

• loplat X 연동
• 캠페인 매칭 결과 레퍼런스

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

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

• 위치 요청 결과 레퍼런스
• 캠페인 매칭 결과 레퍼런스

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

• 테스트 및 검증