로컬 푸시

🔔 최신화 일자: 2025-09-25

이 문서는 로컬 푸시 알림에 대한 설명과 로컬 푸시 예약 및 관리에 필요한 프로세스에 대해 안내합니다.

로컬 푸시 알림 이해하기

로컬 푸시란?

로컬 푸시란 서버를 거치지 않고 디바이스 자체에서 예약하고 전송하는 푸시 알림을 의미합니다.

nachocode의 로컬 푸시 기능은 디바이스 내에서 직접 푸시 알림을 예약하고 특정 시각에 자동으로 표시할 수 있는 편리한 기능입니다.

서버 연결이 필요하지 않으며, 즉시 발송이나 예약 발송 모두 가능합니다. 예약된 알림은 고유 ID를 통해 언제든지 취소할 수 있어 유연한 알림 관리가 가능합니다.

개인 일정 관리, 리마인더, 앱 내 이벤트 알림 등 다양한 상황에서 활용할 수 있습니다.

로컬 푸시 활용 방법

서버 없이도 스마트한 알림

서버 연결이 불가능한 상황에서도 사용자에게 중요한 알림을 전달할 수 있습니다.

앱이 백그라운드에 있거나 종료된 상태에서도 디바이스의 시스템 스케줄러가 예약된 시간에 정확히 알림을 표시합니다.

간단한 코드 한 줄로 완성

복잡한 서버 설정이나 API 호출 없이도 간단한 SDK 메서드 호출만으로 푸시 알림을 예약할 수 있습니다.

Nachocode.push.sendLocalPush({
  title: '미팅 알림',
  content: '회의 시작 10분 전입니다.',
  scheduledTime: new Date('2025-12-25T14:50:00'),
});

유연한 관리와 취소

예약된 알림은 고유 ID로 관리되어 필요에 따라 언제든지 취소할 수 있습니다.

사용자의 행동이나 상황 변화에 따라 동적으로 알림을 조정하여 더 나은 사용자 경험을 제공할 수 있습니다.

로컬 푸시 활용 예시

개인 일정 관리
- 중요한 약속이나 미팅 전 리마인더 알림 전송
- 복용해야 할 약물이나 정기 체크업 알림 예약
- 생일이나 기념일 등 개인적인 이벤트 알림

앱 내 기능 활용 촉진
- 특정 기능을 일정 시간 후 다시 사용해 보라는 권유 알림
- 무료 체험 기간 만료 전 안내 알림
- 데이터 백업이나 동기화 권장 시점 알림

사용자 참여 유도
- 앱을 일정 시간 사용하지 않은 사용자에게 재방문 유도 알림
- 일일 목표 달성 독려나 습관 형성을 위한 정기 알림
- 게임이나 학습 앱에서 연속 사용 독려 알림

로컬 푸시 사용 프로세스

로컬 푸시는 디바이스 단독으로 처리되는 간단한 프로세스를 가집니다.

[ 프로세스 : 로컬 푸시 예약 및 표시 (SDK) ]

local_push_sequence_diagram

구현 가이드

1. 로컬 푸시 전송하기

즉시 발송

// 즉시 발송 - scheduledTime을 지정하지 않으면 바로 알림이 표시됩니다
Nachocode.push.sendLocalPush(
  {
    title: '깜짝 쿠폰 발송!',
    content: '지금 바로 앱에서 확인해보세요!',
    link: 'https://nachocode.io/pricing',
  },
  result => {
    if (result.status === 'success') {
      console.log('푸시 알림이 즉시 전송되었습니다.');
    } else {
      console.error(`푸시 전송 실패: ${result.message}`);
    }
  }
);

예약 발송

// 예약 발송 - 특정 시간에 알림 표시
const scheduledDate = new Date();
scheduledDate.setMinutes(scheduledDate.getMinutes() + 30); // 30분 후

Nachocode.push.sendLocalPush(
  {
    title: '미팅 알림',
    content: '회의 시작 10분 전입니다.',
    scheduledTime: scheduledDate,
    id: 12345, // 고유 ID 지정 (취소 시 사용)
    link: 'https://myapp.com/meeting/room1',
  },
  result => {
    if (result.status === 'success') {
      console.log(`알림이 예약되었습니다. ID: ${result.id}`);
    } else {
      console.error(`예약 실패: ${result.message}`);
    }
  }
);

2. 예약된 알림 취소하기

// 예약된 알림 취소
const notificationId = 12345;

Nachocode.push.cancelLocalPush(notificationId);
console.log(`알림 ${notificationId}가 취소되었습니다.`);

3. 로컬 푸시 예약 관리하기

// 로컬 스토리지를 활용한 예제
Nachocode.push.sendLocalPush(
  {
    title: '운동 시간!',
    content: '오늘의 운동 목표를 달성해보세요.',
    link: 'https://myapp.com/fitness/workout',
    scheduledTime: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24시간 후
    id: 'workout_reminder_' + Date.now(), // 유니크한 ID 생성
  },
  result => {
    if (result.status === 'success') {
      console.log('운동 리마인더가 설정되었습니다!');

      // 필요시 나중에 취소할 수 있도록 ID 저장
      localStorage.setItem('workoutReminderId', result.id);
    }
  }
);

Best Practice

알림 시점 최적화

사용자의 활동 패턴을 분석하여 가장 적절한 시간에 알림 예약
너무 빈번한 알림으로 사용자를 방해하지 않도록 주의
시간대와 요일을 고려한 스마트한 알림 스케줄링

콘텐츠 최적화

간결하고 명확한 제목으로 사용자의 주의를 끌기
구체적인 행동 유도를 포함한 본문 메시지 작성
link를 활용하여 관련 화면으로 바로 이동 가능하도록 설정

알림 관리

고유한 ID 체계를 구축하여 알림을 체계적으로 관리
상황 변화 시 불필요한 알림은 즉시 취소
사용자 설정에 따라 알림 ON/OFF 기능 제공

참고 사항

로컬 푸시는 디바이스 시스템의 알림 권한이 필요합니다. 사용자가 알림 권한을 거부한 경우 로컬 푸시도 표시되지 않습니다.

로컬 푸시 알림 이해하기​

로컬 푸시 활용 방법​

로컬 푸시 활용 예시​

로컬 푸시 사용 프로세스​

구현 가이드​

1. 로컬 푸시 전송하기​

즉시 발송​

예약 발송​

2. 예약된 알림 취소하기​

3. 로컬 푸시 예약 관리하기​

Best Practice​

알림 시점 최적화​

콘텐츠 최적화​

알림 관리​

관련 문서​