Skip to content

[NM-465] Meta 광고 어트리뷰션 SDK 연동 - #167

Closed
ParkMazorika wants to merge 2 commits into
developfrom
feature/NM-465-meta-ads-sdk
Closed

ParkMazorika wants to merge 2 commits into
developfrom
feature/NM-465-meta-ads-sdk

Conversation

@ParkMazorika

@ParkMazorika ParkMazorika commented Sep 10, 2026 •

Copy link
Copy Markdown
Contributor

관련 이슈

  • NM-465

변경 요약

Meta 광고 집행을 위해 Meta SDK(facebook-ios-sdk)를 붙인다. 제품 지표가 아니라 광고 어트리뷰션 전용 채널이며, 보내는 이벤트는 ActivateApp(자동) + CompleteRegistration 둘뿐이다.

설계·근거 문서: ~/SWMproject/docs/Meta광고-어트리뷰션-설계.md (레포 밖)

왜 Firebase로 안 되나

방향이 반대다.

Firebase :  앱 → 우리 대시보드   (우리가 보려고 측정)
Meta SDK :  앱 → Meta           (Meta가 보고 광고를 최적화하려고)

Meta는 유저 단위 어트리뷰션을 외부로 내보내지 않는다. Firebase가 아무리 정확해도 "이 설치는 Meta 캠페인 A에서 왔다"를 볼 방법이 없고, 무엇보다 Meta의 알고리즘이 학습할 신호가 가지 않는다. 대체 관계가 아니라 역할이 다르다 — NM-458의 Firebase 일원화와 충돌하지 않는다.

변경 내용

화이트리스트 강제

MetaAdsService에 범용 log(event:)를 두지 않았다. 이벤트마다 전용 메서드를 만들어야 하므로 실수로 새어나갈 구멍이 없다. 자동 수집은 Info.plist와 런타임 양쪽에서 끈다.

AnalyticsEvent 17개는 전부 제외했다. 이유는 둘이다.

  1. 광고 최적화에 쓸모가 없다 — 캠페인 목표는 가입·결제지 앱 내 행동이 아니다
  2. preset_label이 자유 입력이다 — 사용자가 직접 타이핑하는 처치명이라 무엇이 들어올지 통제할 수 없고, 외부 광고 플랫폼으로 나가면 되돌릴 수 없다

앱은 그 사용자가 Meta에서 왔는지 모른다. 매칭은 Meta 서버에서 하므로 전원의 이벤트가 나간다 — 오가닉 사용자도 예외가 아니다. 목록을 한 줄 늘릴 때마다 전원의 그 행동이 Meta에 쌓이므로, 얻는 게 없으면 보내지 않는 게 맞다.

발사 지점 — onFinished로는 부족하다

설계 초안에는 "AuthCoordinator.onFinished 한 자리면 된다"고 적었으나 구현하면서 틀린 걸 발견했다. 호출부가 둘인데 뜻이 다르다.

자리 상황 발사
ConsentViewModel.onCompleted + !isReconsent 신규 가입 ✅
ConsentViewModel.onCompleted + isReconsent 약관 개정 재동의 ❌
handle(.home) 이미 동의한 회원 재로그인 ❌

개정 재동의도 같은 onCompleted를 타므로 그대로 두면 같은 사람이 두 번 잡힌다. presentConsentSheet(isReconsent:)로 갈라 최초 동의일 때만 발사한다 — NM-446의 AuthUser.needsReconsent(agreed && !satisfied) 재사용.

잘못 세면 캠페인 전환수가 그대로 부풀려진다.

추적 선언을 뒤집는다

전환 신호가 Meta의 크로스-앱 프로필과 결합되므로 애플 기준 '추적'이다. 도메인은 추측하지 않고 FBSDKCoreKit 자체 매니페스트의 값을 그대로 썼다.

NSPrivacyTracking          false → true
NSPrivacyTrackingDomains   []    → [ep1.facebook.com]
ProductInteraction         tracking true · Analytics + ThirdPartyAdvertising
DeviceID                   tracking true · ThirdPartyAdvertising

DeviceID 항목은 NM-410으로 죽었던 Keychain UUID 자리가 IDFA로 되살아난 것이라, 지우는 대신 용도를 광고로 바꿔 적었다.

ATT 프롬프트

콜드런치가 아니라 홈 진입 직후(AppCoordinator.showTabBar() 뒤 한 런루프)에 띄운다. 맥락 없이 물으면 대개 거부하고, 여기까지 온 사용자는 로그인·동의를 마쳐 앱이 뭘 하는지 봤다. 거부해도 광고는 돈다(SKAdNetwork 집계).

광고 성과를 측정해 더 나은 서비스를 만드는 데 사용됩니다. 알약 식별·타이머 기록은 수집하지 않습니다.

뒷문장은 실제로 사실이다.

리뷰에서 봐줬으면 하는 것

1. SKAdNetworkItems는 넣지 않았다. 그건 광고를 보여주는 앱(source app)이 넣는 값이고, 광고되는 앱은 넣지 않는다. (설계 문서 초안에 필수로 적었던 걸 정정했다.)

2. 가입 전환이 ATT 프롬프트보다 먼저 나간다. 동의 화면 → 홈 진입 순서라서다. 그 이벤트는 IDFA 없이 SKAdNetwork로 잡힌다. 프롬프트를 앞당기면 거부율이 오르고 미루면 첫 전환이 IDFA를 못 쓴다 — 거부율 쪽을 택했다.

3. 제외 근거가 "건강 데이터"가 아니다. 이 앱은 간호사의 업무 도구이고 사용자 본인이 아니라 환자의 지참약을 식별하므로, "앱을 쓴다"는 사실 자체는 건강정보가 아니다. 근거는 위 ①②다.

테스트

  • 로컬 빌드/실행 확인 — tuist build App 성공
  • 번들 산출물 검증 — FacebookAppID 실값 주입, FacebookAutoLogAppEventsEnabled=false, NSPrivacyTracking=true, NSPrivacyTrackingDomains=[ep1.facebook.com] 확인
  • 실기기 ATT 프롬프트 — 홈 진입 직후 표시·문구 줄바꿈 확인 필요
  • Meta 이벤트 매니저 수신 확인 — 실기기로 가입 1건 발생시켜 CompleteRegistration 도달 확인

체크리스트

  • PR 제목이 [NM-XXX] 요약 형식
  • 브랜치명 <type>/NM-XXX-요약 형식
  • 커밋 메시지 [NM-XXX] type: 요약 형식
  • 셀프 리뷰 완료

머지 후 필요한 것 (레포 밖)

  • GitHub Actions 시크릿 META_APP_ID · META_CLIENT_TOKEN 등록 — 없으면 CI 빌드의 Info.plist가 빈 값이 된다
  • App Store Connect 개인정보 영양성분표 — "추적에 사용되는 데이터" 섹션 추가. 매니페스트와 어긋나면 심사에서 걸린다
  • Meta 콘솔 — 개인정보처리방침 URL이 비어 있고 서비스 약관 URL이 facebook.com 기본값이다. 앱 게시 전 실제 URL로 교체
  • 개인정보 처리방침 개정

Meta 콘솔 설정값

항목 값
App ID 1782054189772876
이용 사례 Meta 광고 관리자로 앱 광고 만들기 및 관리하기
비즈니스 널스메이트 - 간호사를 위한 AI 업무 파트너
플랫폼 iOS · app.nursemate.app · Store ID 6783877557

App Store Connect 신고 (완료)

코드 매니페스트와 짝이 되는 영양성분표를 게시했다.

데이터 유형 사용 목적 추적
기기 ID 타사 광고 예
제품 상호 작용 분석 · 타사 광고 예

리뷰 중 DeveloperAdvertising(자사 광고)로 바꿨다가 되돌렸다(592933f). 애플 문구의 "귀사 광고를 표시하는 법인과의 데이터 공유"가 Meta처럼 읽히지만, 두 목적을 실제로 가르는 건 ATT와 식별자다 — DeveloperAdvertising은 데이터가 앱 밖으로 안 나가 ATT가 면제되고 IDFV로 충분한 자사 광고를 가리킨다. 우리는 IDFA를 쓰고 ATT를 띄우므로 타사 광고가 맞다.

Meta 광고를 집행하려면 전환 신호를 Meta 에 되돌려줘야 한다. Firebase 로는 안 된다 —
Meta 가 유저 단위 어트리뷰션을 외부로 내보내지 않아 "이 캠페인에서 몇 명 가입했나" 를
알 방법이 없고, 무엇보다 Meta 의 알고리즘이 학습할 신호가 가지 않는다.
방향이 반대인 채널이라 제품 지표(Firebase)와 역할이 겹치지 않는다.

**보내는 것은 둘뿐이다** — ActivateApp(자동) + CompleteRegistration.
AnalyticsEvent 17개는 전부 제외한다. 이유는 둘이다.

  ① 광고 최적화에 쓸모가 없다. 캠페인 목표는 가입·결제지 앱 내 행동이 아니다.
  ② preset_label 은 사용자가 직접 타이핑하는 자유 입력이라 무엇이 들어올지 통제할 수 없다.

그리고 앱은 그 사용자가 Meta 에서 왔는지 **모른다** — 매칭은 Meta 서버에서 하므로
**전원의 이벤트가 나간다.** 목록을 한 줄 늘릴 때마다 오가닉 사용자까지 포함한 전원의
그 행동이 Meta 에 쌓인다. 얻는 게 없으면 보내지 않는 게 맞다.

(이 앱은 간호사의 **업무 도구**다. 사용자 본인이 아니라 환자의 지참약을 식별하므로
 "앱을 쓴다" 는 사실 자체는 건강정보가 아니다 — 제외 근거는 위 둘이지 데이터 유형이 아니다.)

그래서 MetaAdsService 는 범용 log(event:) 를 두지 않고 이벤트마다 전용 메서드를 만든다.
자동 수집도 Info.plist 와 런타임 양쪽에서 끈다.

**CompleteRegistration 발사 지점** — onFinished 호출부가 둘인데 뜻이 다르다.
동의 완료(신규 가입)만 가입이고, handle(.home)(재로그인)은 아니다. 개정 재동의도 같은
onCompleted 를 타므로 그대로 두면 같은 사람이 두 번 잡힌다. isReconsent 로 갈라
최초 동의일 때만 보낸다 (NM-446 의 needsReconsent 재사용).

**추적 선언을 뒤집는다.** 전환 신호가 Meta 의 크로스-앱 프로필과 결합되므로 애플 기준
'추적'이다. 도메인은 추측하지 않고 FBSDKCoreKit 자체 매니페스트의 ep1.facebook.com 을 쓴다.
DeviceID 항목은 NM-410 으로 죽었던 게 IDFA 로 되살아난 것이라 용도를 광고로 바꿔 적었다.

ATT 프롬프트는 콜드런치가 아니라 **홈 진입 직후**에 띄운다 — 맥락 없이 물으면 대개 거부한다.
거부해도 광고는 돈다(SKAdNetwork 집계). 문구에 쓰지 않는 것까지 적었다:
"광고 성과를 측정해 더 나은 서비스를 만드는 데 사용됩니다. 알약 식별·타이머 기록은
수집하지 않습니다."

SKAdNetworkItems 는 넣지 않는다 — 그건 광고를 **보여주는** 앱(source app)이 넣는 값이고
광고되는 앱은 넣지 않는다. (설계 문서 초안의 오류를 정정했다.)

설계·근거: ~/SWMproject/docs/Meta광고-어트리뷰션-설계.md
App ID 1782054189772876 · 키는 Secrets.xcconfig(gitignore) + CI 시크릿 4개 레인.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ch9vPGGKfeTUWMKEsZ3NWM
@ParkMazorika ParkMazorika self-assigned this Sep 10, 2026
@ParkMazorika ParkMazorika added the enhancement New feature or request label Sep 10, 2026
애플 문구만 보면 DeveloperAdvertising 의 "귀사 광고를 표시하는 법인과의 데이터
공유" 가 Meta 처럼 읽히지만, 두 목적을 실제로 가르는 기준은 ATT 와 식별자다.
DeveloperAdvertising 은 데이터가 앱 밖으로 나가지 않아 ATT 가 면제되고 IDFV 로
충분한 자사 광고·크로스프로모션을 가리킨다. 우리는 IDFA 를 쓰고 ATT 를 띄우며
데이터가 Meta 로 나가므로 ThirdPartyAdvertising 이 맞다.

App Store Connect 신고도 기기 ID·제품 상호 작용 모두 `타사 광고`로 게시했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ch9vPGGKfeTUWMKEsZ3NWM
@ParkMazorika

Copy link
Copy Markdown
Contributor Author

AB180 사용으로 인한 close

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant