부록: 푸시 수신 동의 값 매트릭스¶

이 문서는 Groobee SDK에 전달하는 세 가지 푸시 수신 동의 값(AgreedAP · AgreedAA · AgreedAN) 의 조합이 실제 푸시 발송 결과에 어떻게 반영되는지를 정리한 부록 문서입니다.

Android / iOS SDK 설정 메소드와 함께 보면서, 앱에서 어떤 값을 어떤 시점에 전달해야 할지 판단할 때 참고하세요.

목차¶

개요
동의 값 정의
SDK 설정 메소드 매핑
동의 조합 × 발송 결과 매트릭스
케이스별 설명
운영 주의 사항
함께 보면 좋은 문서

개요¶

Groobee의 푸시 발송 대상 필터링은 세 가지 Bool 동의 값에 의해 결정됩니다.

AgreedAP — 전체 푸시 사용 동의. 모든 푸시 발송의 기본 스위치 역할을 합니다.
AgreedAA — 광고성 푸시 동의. 광고 캠페인 발송 대상을 추리는 데 사용됩니다.
AgreedAN — 야간 푸시 동의. 21시 이후 시간대 발송 대상을 추리는 데 사용됩니다.

세 값은 독립 플래그가 아니라 AND 조합으로 적용됩니다. 즉, 광고 푸시를 받으려면 AgreedAP && AgreedAA가 모두 true여야 하고, 야간 광고 푸시를 받으려면 AgreedAP && AgreedAA && AgreedAN이 모두 true여야 합니다.

야간 시간대 기준은 21시 이후입니다.

동의 값 정의¶

값	의미	필터링되는 메시지 유형
`AgreedAP`	전체 푸시 수신 동의	정보성 / 광고성 / 야간 — 모든 푸시의 마스터 스위치
`AgreedAA`	광고성 푸시 수신 동의	광고 캠페인 메시지
`AgreedAN`	야간 푸시 수신 동의	21시 이후 발송되는 메시지

AgreedAP가 false면 나머지 두 값과 무관하게 모든 푸시가 발송되지 않습니다.
AgreedAA / AgreedAN은 각각 광고성 · 야간 발송에 대한 추가 필터이며, AgreedAP = true인 사용자에 한해 의미를 가집니다.

SDK 설정 메소드 매핑¶

각 동의 값을 SDK에 전달하는 메소드는 아래와 같습니다. 자세한 파라미터와 호출 시점은 링크한 상세 가이드를 참고하세요.

동의 값	Android SDK	iOS SDK
`AgreedAP`	`setAgreedPush(isAgreed)`	`setPushAgreeAP(isPushAgreedAP)`
`AgreedAA`	`setAgreedPushAdvertising(isAgreed)`	`setPushAgreeAA(isPushAgreedAA)`
`AgreedAN`	`setAgreedPushNight(isAgreed)`	`setPushAgreeAN(isPushAgreedAN)`

현재 동의 상태를 조회하려면 Android getPushAgreed(memberId) 또는 iOS getPushAgreed(memberId)를 사용하며, 반환 객체의 프로퍼티 이름이 그대로 agreedAP / agreedAA / agreedAN 입니다.

호출 예시¶

Android (Kotlin)iOS (Swift)iOS (Objective-C)

Groobee.getInstance().setAgreedPush(isAgreedAP)            // AgreedAP
Groobee.getInstance().setAgreedPushAdvertising(isAgreedAA) // AgreedAA
Groobee.getInstance().setAgreedPushNight(isAgreedAN)       // AgreedAN

Groobee.getInstance().setPushAgreeAP(isPushAgreedAP: isAgreedAP) // AgreedAP
Groobee.getInstance().setPushAgreeAA(isPushAgreedAA: isAgreedAA) // AgreedAA
Groobee.getInstance().setPushAgreeAN(isPushAgreedAN: isAgreedAN) // AgreedAN

[[Groobee getInstance] setPushAgreeAPWithIsPushAgreedAP:isAgreedAP]; // AgreedAP
[[Groobee getInstance] setPushAgreeAAWithIsPushAgreedAA:isAgreedAA]; // AgreedAA
[[Groobee getInstance] setPushAgreeANWithIsPushAgreedAN:isAgreedAN]; // AgreedAN

동의 조합 × 발송 결과 매트릭스¶

세 플래그의 모든 조합(2³ = 8가지)에 대해 어떤 푸시가 발송되는지 정리한 표입니다. ✅ 는 발송됨, ❌ 는 발송되지 않음을 의미합니다.

AgreedAP	AgreedAA	AgreedAN	정보성 (주간)	광고성 (주간)	정보성 (야간, 21시 이후)	광고성 (야간, 21시 이후)
✅	❌	❌	✅	❌	❌	❌
✅	✅	❌	✅	✅	❌	❌
✅	❌	✅	✅	❌	✅	❌
✅	✅	✅	✅	✅	✅	✅
❌	❌	❌	❌	❌	❌	❌
❌	✅	❌	❌	❌	❌	❌
❌	❌	✅	❌	❌	❌	❌
❌	✅	✅	❌	❌	❌	❌

AgreedAP = false 인 경우 다른 두 값과 무관하게 모든 푸시가 차단됩니다. 표의 아래쪽 네 행이 이에 해당합니다.

케이스별 설명¶

1. `AgreedAP`만 `true`¶

정보성 푸시 발송됨 (주간)
광고성 푸시 · 야간 시간대 푸시는 모두 차단

2. `AgreedAP && AgreedAA`¶

정보성 푸시 및 광고성 푸시 모두 발송됨 (주간)
야간 시간대(21시 이후) 발송분은 차단

3. `AgreedAP && AgreedAN`¶

주간 정보성 푸시 + 야간 정보성 푸시 발송됨
광고성 푸시는 주간 · 야간 모두 차단

4. `AgreedAP && AgreedAA && AgreedAN`¶

주간 정보성 / 주간 광고성 / 야간 정보성 / 야간 광고성 모두 발송됨

5. `!AgreedAP`¶

모든 푸시 발송 안 됨. 다른 두 값이 무엇이든 영향을 주지 않습니다.

운영 주의 사항¶

세 메소드 모두 사용자가 토글을 변경할 때뿐 아니라 현재 상태도 한 번 호출해 동기화해야 합니다. 변경 시점에만 호출하면 초기값이 전달되지 않아 해당 사용자가 false로 집계될 수 있습니다.
설정 화면 진입 시 현재 상태를 한 번 동기화하고, 사용자가 토글을 변경할 때 다시 호출하는 방식을 권장합니다.

AgreedAP	AgreedAA	AgreedAN	정보성 (주간)	광고성 (주간)	정보성 (야간, 21시 이후)	광고성 (야간, 21시 이후)
✅	❌	❌	✅	❌	❌	❌
✅	✅	❌	✅	✅	❌	❌
✅	❌	✅	✅	❌	✅	❌
✅	✅	✅	✅	✅	✅	✅
❌	❌	❌	❌	❌	❌	❌
❌	✅	❌	❌	❌	❌	❌
❌	❌	✅	❌	❌	❌	❌
❌	✅	✅	❌	❌	❌	❌

AgreedAP	AgreedAA	AgreedAN	정보성 (주간)	광고성 (주간)	정보성 (야간, 21시 이후)	광고성 (야간, 21시 이후)
✅	❌	❌	✅	❌	❌	❌
✅	✅	❌	✅	✅	❌	❌
✅	❌	✅	✅	❌	✅	❌
✅	✅	✅	✅	✅	✅	✅
❌	❌	❌	❌	❌	❌	❌
❌	✅	❌	❌	❌	❌	❌
❌	❌	✅	❌	❌	❌	❌
❌	✅	✅	❌	❌	❌	❌

부록: 푸시 수신 동의 값 매트릭스¶

목차¶

개요¶

동의 값 정의¶

SDK 설정 메소드 매핑¶

호출 예시¶

동의 조합 × 발송 결과 매트릭스¶

케이스별 설명¶

1. AgreedAP만 true¶

2. AgreedAP && AgreedAA¶

3. AgreedAP && AgreedAN¶

4. AgreedAP && AgreedAA && AgreedAN¶

5. !AgreedAP¶