> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 슈퍼월
슈퍼월(Superwall)과 에어브릿지를 연동해 에어브릿지에서 구독 성과를 함께 분석해 보세요.
## **사전 준비사항**
에어브릿지로 슈퍼월 이벤트를 정확하게 전송하려면 먼저 SDK를 설정해야 합니다.
**개발 작업이 필요합니다. 개발자에게 도움을 요청하세요.**
### 에어브릿지 디바이스 ID 전달 설정하기
슈퍼월에 에어브릿지 디바이스 ID를 전달하도록 설정해야 정상적으로 어트리뷰션 결과를 조회할 수 있습니다.
1. 에어브릿지 SDK `fetchDeviceUUID` 함수를 호출해 에어브릿지 디바이스 ID를 가져오세요. 플랫폼별 방법은 [각 가이드](/ko/developers/fetching-guide)를 참고하세요.
2. 슈퍼월 SDK `setIntegrationAttributes` 함수를 호출해 가져온 에어브릿지 디바이스 ID를 슈퍼월로 전달하세요. 플랫폼별 방법은 [슈퍼월 공식 문서](https://superwall.com/docs/ios/sdk-reference/setIntegrationAttributes)를 참고하세요.
### 유저 ID 매칭하기
에어브릿지와 슈퍼월에 동일한 유저 ID가 기록돼야 정상적으로 연동 결과를 조회할 수 있습니다.
1. 에어브릿지 SDK `setUserID` 함수를 호출해 유저 ID를 입력하세요. [안드로이드](/ko/developers/android-sdk-v4#%EC%9C%A0%EC%A0%80-id-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0), [iOS](/ko/developers/ios-sdk-v4#%EC%9C%A0%EC%A0%80-id-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0) 등 플랫폼별 내용은 각 가이드를 참고하세요.
2. 슈퍼월 SDK `setUserAttributes` 함수를 호출해 슈퍼월이 전달받은 유저 ID를 매칭하도록 설정하세요. 플랫폼별 내용은 [슈퍼월 공식 문서](https://superwall.com/docs/ios/sdk-reference/setUserAttributes)를 참고하세요.
**주의하세요**
`setUserID` 함수 호출 시 서드파티 플랫폼과 공통으로 지정한 유저 ID를 입력하세요.
매칭된 유저 ID는 이후 슈퍼월이 에어브릿지로 전송하는 이벤트 데이터에 `externalUserID` 필드로 포함됩니다.
### 이벤트 중복 집계 방지하기
서드파티 플랫폼 연동으로 수집 중인 이벤트를 에어브릿지 SDK에서도 수집하면 이벤트가 중복 집계됩니다. 따라서 연동으로 수집 중인 이벤트는 에어브릿지 SDK가 추가로 수집하지 않도록 하세요.
## **연동하기**
슈퍼월과 에어브릿지를 연동해 슈퍼월의 구독 관련 이벤트를 에어브릿지로 전송할 수 있습니다.
**주의하세요**
아래 사항을 모두 확인한 후에 연동을 시작하세요. 자세한 내용은 [가이드](#사전-준비사항)를 참고하세요.
* 에어브릿지 디바이스 ID를 서드파티 플랫폼으로 전달하도록 설정됐습니다.
* 에어브릿지와 서드파티 플랫폼의 유저 ID가 정상적으로 매칭됐습니다.
* 에어브릿지 SDK가 서드파티 플랫폼에서 전송 중인 이벤트를 중복 수집하지 않습니다.
### **에어브릿지에서 연동 정보 확인하기**
슈퍼월 대시보드에 입력할 연동 정보를 에어브릿지 대시보드에서 확인해야 합니다. 연동 정보는 총 2가지입니다.
* Airbridge Subdomain
* Airbridge Token
1. 에어브릿지 대시보드 \[연동]>\[서드파티 연동]에서 ‘Superwall’을 클릭하세요.
2. Airbridge Subdomain과 Airbridge Token을 각각 복사하세요. 이후 슈퍼월 대시보드에 각 값을 붙여 넣어야 합니다.
### **슈퍼월에서 연동 정보 입력하기**
1. 슈퍼월 대시보드 왼쪽 메뉴에서 \[Integrations]를 클릭하세요.
2. \[Integrations]에서 'Create Webhook'을 클릭하세요.
3. 에어브릿지 대시보드에서 복사한 Airbridge Subdomain과 Airbridge Token을 슈퍼월 대시보드에서 각각 해당하는 위치에 입력하세요.
4. \[Events to Listen For]에서 에어브릿지로 전송할 이벤트를 선택하세요. 자세한 내용은 매핑 테이블을 참고하세요.
5. 'Create Webhook'을 클릭해 연동을 완료하세요.
## **에어브릿지에서 연동 데이터 조회하기**
아래는 슈퍼월과 에어브릿지가 미리 매핑한 이벤트 목록입니다.
| 슈퍼월 이벤트 | 에어브릿지 이벤트 | 그룹바이 Action 선택 시 확인 가능한 값 |
| ----------------------- | ----------------------- | ------------------------- |
| initial\_purchase | airbridge.subscribe | initial\_purchase |
| initial\_purchase | airbridge.startTrial | initial\_purchase |
| renewal | airbridge.subscribe | renewal |
| cancellation | airbridge.unsubscribe | cancellation |
| uncancellation | uncancellation | - |
| expiration | expiration | - |
| billing\_issue | billing\_issue | - |
| product\_change | product\_change | - |
| subscription\_extended | subscription\_extended | - |
| subscription\_paused | subscription\_paused | - |
| non\_renewing\_purchase | non\_renewing\_purchase | - |
## **주의사항**
아래 사항을 주의해 주세요.
서버 투 서버(S2S)로 수집한 이벤트를 SKAN 전환값에 반영하려면 아래 조건을 모두 충족해야 합니다.
* 에어브릿지 iOS SDK가 4.8.0 이상입니다. 에어브릿지는 4.8.1 이상을 권장합니다.
* 에어브릿지 SDK에서 `calculateSKAdNetworkByServerEnabled` 옵션이 `true`로 설정돼 있습니다. 자세한 내용은 [가이드](/ko/developers/ios-sdk-v4#skadnetwork-conversionvalue-%EA%B3%84%EC%82%B0%EC%9D%84-%EC%84%9C%EB%B2%84%EC%97%90%EC%84%9C-%ED%95%98%EA%B8%B0)를 참고하세요.