MMP 포스트백 이벤트 매핑 설정 전 확인할 항목
- 앱 이벤트와 파트너 이벤트의 의미 및 이름을 정확히 연결합니다.
- 파트너별 전송 범위와 조건, 공유할 이벤트 값을 확인합니다.
- 테스트 이벤트와 포스트백 로그로 실제 수신 여부를 검증합니다.
MMP 포스트백 이벤트 매핑은 MMP가 수집한 앱 이벤트를 광고 파트너가 인식하는 이벤트명이나 ID에 연결하는 설정입니다. 예를 들어 앱의 subscribe_start 이벤트를 파트너가 요구하는 구독 시작 이벤트에 대응시킬 수 있습니다. 이름을 연결하는 것만으로 설정이 끝나는 것은 아닙니다. 이벤트가 MMP에 들어오는지, 파트너에 어떤 이벤트를 보낼지, 값과 조건이 맞는지도 확인해야 합니다.
먼저 이벤트와 매핑 방향을 확인하세요
앱 이벤트 수집과 파트너 전송은 별도 단계입니다
일반적인 흐름은 앱 또는 서버 이벤트 → MMP 수집 이벤트 → 파트너 이벤트입니다. 앱 SDK나 서버에서 원본 이벤트를 보내지 않으면 매핑을 해도 포스트백이 생성되지 않습니다. 원본 이벤트가 수집되더라도 파트너 이벤트명이나 ID가 잘못 연결되면 파트너가 의도한 전환으로 처리하지 못할 수 있습니다.
설정하는 포스트백의 방향을 확인하세요
포스트백이라는 말은 제품과 연동 맥락에 따라 MMP에서 광고 파트너로 보내는 이벤트 또는 파트너가 MMP로 돌려주는 어트리뷰션 정보를 가리킬 수 있습니다. 이 글은 주로 MMP에서 광고 파트너로 보내는 인앱 이벤트 포스트백을 다룹니다. 사용 중인 대시보드에서 송신 주체와 이벤트 소유자를 먼저 확인하세요.
이벤트 의미와 이름을 맞추기
이벤트가 발생하는 시점을 합의합니다
같은 purchase라도 결제창 진입, 결제 승인, 환불 불가 확정 중 무엇을 뜻하는지 팀마다 다를 수 있습니다. 최적화에 사용할 이벤트는 발생 조건을 문장으로 정의하고, 앱과 서버에서 같은 기준으로 구현하세요. 결제 승인 전에 이벤트가 발생하면 파트너가 실제 결제보다 앞선 행동을 구매 신호로 받을 수 있습니다.
앱 이벤트와 파트너 이벤트 ID를 구분합니다
파트너 연동 방식은 자유 입력, 목록 선택, 앱 이벤트명 그대로 전송 등으로 다를 수 있습니다. 어느 입력란에 앱 이벤트를 선택하고 어느 곳에 파트너 이벤트 ID를 넣는지 해당 연동 문서에서 확인하세요. AppsFlyer는 파트너별 매핑 방식이 다를 수 있고, 이벤트명이 대소문자를 구분한다고 안내합니다. [인앱 이벤트 포스트백 설정 가이드](https://support.appsflyer.com/hc/en-us/articles/208439256-In-app-event-postback-configuration)에서 해당 제품의 매핑 사례를 확인할 수 있습니다. 실제 허용 이름과 필드는 사용하는 MMP 및 파트너 문서를 따르세요.
| 확인 항목 | 점검 질문 | 흔한 문제 |
|---|---|---|
| 앱 이벤트 | 어떤 조건과 시점에 발생하는가? | 화면을 열 때마다 구매 이벤트 발생 |
| 파트너 매핑 | 파트너가 요구한 이름 또는 ID인가? | 대소문자·밑줄·ID 불일치 |
| 전송 범위 | 어떤 사용자와 이벤트를 보낼 것인가? | 필요한 이벤트 누락 또는 불필요한 공유 |
| 이벤트 값 | 매출·통화·속성 중 무엇을 보낼 것인가? | 통화 누락 또는 필요 이상의 정보 전송 |
전송 대상과 조건을 검토하기
파트너별 전송 범위를 확인합니다
파트너에 따라 해당 파트너에 기여된 이벤트만 보내거나, 오가닉을 포함한 여러 출처의 이벤트를 보내도록 설정할 수 있습니다. 지원 옵션과 기본값은 MMP 및 파트너별로 다릅니다. 파트너의 최적화 요구와 데이터 공유 목적을 확인한 뒤 범위를 선택하세요. 전송 범위가 좁으면 필요한 이벤트가 빠질 수 있고, 범위가 넓으면 목적에 맞지 않는 이벤트까지 공유될 수 있습니다.
이벤트 조건이 있다면 실제 데이터와 대조합니다
이벤트 속성 조건이나 전송 기간을 설정하면 조건에 맞지 않는 이벤트는 전달되지 않을 수 있습니다. 속성 키와 값이 실제 이벤트 데이터와 일치하는지, 자료형과 대소문자가 맞는지 확인하세요. AppsFlyer는 조건에 사용한 속성과 값이 이벤트 데이터와 일치해야 하며 조건 평가 순서가 적용될 수 있다고 설명합니다. 플랫폼마다 지원 기능은 다르므로 사용 중인 제품의 조건 규칙을 확인하세요.
- 파트너별 전송 대상과 오가닉 포함 여부
- 전송 기간과 재시도 처리 방식
- 조건에 사용하는 속성 키와 값
- 파트너가 허용하는 매출·통화·이벤트 파라미터
매출 값과 중복 이벤트를 점검하기
매출과 통화가 올바르게 전달되는지 확인합니다
매출 이벤트를 공유한다면 금액이 세금, 할인, 환불 중 무엇을 반영하는지 정하고 실제 통화와 코드가 맞는지 확인하세요. 매출과 통화를 받는 방식은 파트너 연동마다 다릅니다. 예를 들어 Adjust의 [Atlas 연동 가이드](https://help.adjust.com/en/partner-setup/atlas)는 수익 이벤트 매핑과 통화·매출 관련 필드를 설명합니다. 파트너가 요구하지 않는 사용자 속성은 보내지 말고, 테스트 포스트백이나 파트너 수신 기록으로 전달값을 확인하세요.
SDK와 서버 이벤트가 중복되지 않는지 살핍니다
같은 구매를 앱 SDK와 서버 간 전송(S2S) 양쪽에서 보내면 중복 이벤트가 기록될 가능성이 있습니다. 고유 주문 ID 등 중복 확인에 쓸 식별자가 있는지, MMP와 파트너가 중복을 어떻게 처리하는지 확인하세요. 재시도 로직이 동일 구매를 새 이벤트로 만들지 테스트하고, 검증이 끝나기 전에는 핵심 전환 이벤트를 캠페인 최적화에 적용하지 않는 편이 안전합니다.
핵심 점검: 이벤트 의미, 파트너 매핑, 전송 대상, 매출·통화와 중복 처리 기준을 함께 확인하세요. 이벤트 이름만 일치한다고 포스트백이 올바른 것은 아닙니다.
저장 전후 검증 순서
대시보드에 매핑이 표시되는지만 확인하지 말고 이벤트가 파트너까지 전달되는지 점검하세요. 메뉴와 테스트 기능은 제품 및 파트너별로 다를 수 있습니다.
- 원본 이벤트명, 발생 조건, 파트너 이벤트 ID, 전송 대상과 공유할 값을 정리합니다.
- 테스트 환경에서 이벤트를 발생시키고 앱 버전과 SDK 또는 S2S 구현이 반영됐는지 확인합니다.
- MMP의 이벤트 수신 내역에서 이름·시각·속성·매출과 이벤트 횟수를 확인합니다.
- 포스트백 로그나 파트너 테스트 도구에서 전송 결과와 수신 이벤트명을 확인합니다.
- 파트너 리포트와 내부 기록을 비교합니다. 집계 시점이나 어트리뷰션 기준 차이도 고려합니다.
예를 들어 Airbridge의 [채널 연동하기 – 구글 애즈](https://help.airbridge.io/ko/guides/google-ads-channel-integration)는 인앱 이벤트를 파트너 이벤트에 매핑하는 방법과 이벤트 수집 여부 확인을 안내합니다. 해당 MMP와 채널을 사용하는 경우에도 실제 계정의 설정과 연동 문서를 기준으로 확인하세요.
- 테스트 이벤트가 MMP에 수신됐는가?
- 파트너 이벤트 이름 또는 ID가 의도한 값인가?
- 전송 범위나 조건 때문에 이벤트가 제외되지 않았는가?
- 금액·통화·속성이 파트너 수신 데이터와 일치하는가?
- 동일 주문이 SDK와 서버에서 중복으로 기록되지 않는가?
운영 전 확인: 이벤트 매핑은 파트너의 전환 보고와 캠페인 최적화에 영향을 줄 수 있습니다. 핵심 이벤트나 전송 설정을 바꾸기 전에 연동 규격을 확인하고 테스트 결과를 기록하세요.
자주 묻는 질문
Q. 앱 이벤트가 MMP에 보이면 포스트백도 전송된 건가요?
아닙니다. 이벤트 수신과 파트너 포스트백 전송은 별도 단계입니다. 파트너 연동 활성화, 이벤트 매핑, 전송 대상과 조건을 확인한 뒤 포스트백 로그나 파트너 수신 기록도 살펴보세요.
Q. 파트너 이벤트가 목록에 없으면 어떻게 하나요?
파트너가 사용자 지정 이벤트나 ID 입력을 허용하는지 확인하세요. 비슷해 보이는 이벤트를 임의로 고르면 의미가 달라질 수 있습니다. 파트너가 안내한 이름이나 ID를 사용하고, 앱 이벤트가 실제로 수집되는지도 확인하세요.
Q. 오가닉 이벤트도 파트너에 보내야 하나요?
파트너의 요구사항과 데이터 공유 목적에 따라 다릅니다. 지원 옵션을 확인하고, 수신 측의 사용 목적과 공유 권한에 맞춰 범위를 정하세요.
Q. 매핑을 바꾸면 이전 데이터도 변경되나요?
적용 시점과 과거 데이터의 처리 방식은 MMP와 파트너에 따라 다를 수 있습니다. 변경 전후 적용 시각을 기록하고 이벤트 재전송이나 소급 반영 지원 여부를 연동 문서에서 확인하세요.
