Repository navigation
[NM-465] Meta 광고 어트리뷰션 SDK 연동 - #167
Closed
ParkMazorika wants to merge 2 commits into
Closed
ParkMazorika wants to merge 2 commits into
ParkMazorika wants to merge 2 commits into
Conversation
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
애플 문구만 보면 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
Contributor
Author
|
AB180 사용으로 인한 close |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
관련 이슈
변경 요약
Meta 광고 집행을 위해 Meta SDK(
facebook-ios-sdk)를 붙인다. 제품 지표가 아니라 광고 어트리뷰션 전용 채널이며, 보내는 이벤트는ActivateApp(자동) +CompleteRegistration둘뿐이다.설계·근거 문서:
~/SWMproject/docs/Meta광고-어트리뷰션-설계.md(레포 밖)왜 Firebase로 안 되나
방향이 반대다.
Meta는 유저 단위 어트리뷰션을 외부로 내보내지 않는다. Firebase가 아무리 정확해도 "이 설치는 Meta 캠페인 A에서 왔다"를 볼 방법이 없고, 무엇보다 Meta의 알고리즘이 학습할 신호가 가지 않는다. 대체 관계가 아니라 역할이 다르다 — NM-458의 Firebase 일원화와 충돌하지 않는다.
변경 내용
화이트리스트 강제
MetaAdsService에 범용log(event:)를 두지 않았다. 이벤트마다 전용 메서드를 만들어야 하므로 실수로 새어나갈 구멍이 없다. 자동 수집은 Info.plist와 런타임 양쪽에서 끈다.AnalyticsEvent17개는 전부 제외했다. 이유는 둘이다.preset_label이 자유 입력이다 — 사용자가 직접 타이핑하는 처치명이라 무엇이 들어올지 통제할 수 없고, 외부 광고 플랫폼으로 나가면 되돌릴 수 없다앱은 그 사용자가 Meta에서 왔는지 모른다. 매칭은 Meta 서버에서 하므로 전원의 이벤트가 나간다 — 오가닉 사용자도 예외가 아니다. 목록을 한 줄 늘릴 때마다 전원의 그 행동이 Meta에 쌓이므로, 얻는 게 없으면 보내지 않는 게 맞다.
발사 지점 —
onFinished로는 부족하다설계 초안에는 "
AuthCoordinator.onFinished한 자리면 된다"고 적었으나 구현하면서 틀린 걸 발견했다. 호출부가 둘인데 뜻이 다르다.ConsentViewModel.onCompleted+!isReconsentConsentViewModel.onCompleted+isReconsenthandle(.home)개정 재동의도 같은
onCompleted를 타므로 그대로 두면 같은 사람이 두 번 잡힌다.presentConsentSheet(isReconsent:)로 갈라 최초 동의일 때만 발사한다 — NM-446의AuthUser.needsReconsent(agreed && !satisfied) 재사용.잘못 세면 캠페인 전환수가 그대로 부풀려진다.
추적 선언을 뒤집는다
전환 신호가 Meta의 크로스-앱 프로필과 결합되므로 애플 기준 '추적'이다. 도메인은 추측하지 않고 FBSDKCoreKit 자체 매니페스트의 값을 그대로 썼다.
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]확인CompleteRegistration도달 확인체크리스트
[NM-XXX] 요약형식<type>/NM-XXX-요약형식[NM-XXX] type: 요약형식머지 후 필요한 것 (레포 밖)
META_APP_ID·META_CLIENT_TOKEN등록 — 없으면 CI 빌드의 Info.plist가 빈 값이 된다facebook.com기본값이다. 앱 게시 전 실제 URL로 교체Meta 콘솔 설정값
1782054189772876app.nursemate.app· Store ID6783877557App Store Connect 신고 (완료)
코드 매니페스트와 짝이 되는 영양성분표를 게시했다.
리뷰 중
DeveloperAdvertising(자사 광고)로 바꿨다가 되돌렸다(592933f). 애플 문구의 "귀사 광고를 표시하는 법인과의 데이터 공유"가 Meta처럼 읽히지만, 두 목적을 실제로 가르는 건 ATT와 식별자다 —DeveloperAdvertising은 데이터가 앱 밖으로 안 나가 ATT가 면제되고 IDFV로 충분한 자사 광고를 가리킨다. 우리는 IDFA를 쓰고 ATT를 띄우므로 타사 광고가 맞다.