> ## 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.

# 레비뉴캣

레비뉴캣(RevenueCat)과 에어브릿지를 연동해 에어브릿지에서 구독 성과를 함께 분석해 보세요.

## 연동하기

레비뉴캣과 에어브릿지를 연동해 레비뉴캣의 구독 관련 이벤트를 에어브릿지로 전송할 수 있습니다.

### 사전 준비사항

먼저 레비뉴캣 SDK 설정을 완료하세요.

* [레비뉴캣 가이드](https://www.revenuecat.com/docs/integrations/attribution/airbridge)

<Danger>
  **주의하세요**

  레비뉴캣과 연동하기 전에 아래 사항을 확인하세요. 자세한 내용은 [에어브릿지 가이드](/ko/guides/revenuecat#주의사항)를 참고하세요.

  * 에어브릿지의 디바이스 ID를 레비뉴캣으로 전송했는지 여부
  * 레비뉴캣과 에어브릿지의 유저 ID가 정상적으로 매칭됐는지 여부
  * 이벤트 중복 집계를 방지했는지 여부
</Danger>

### 에어브릿지에서 연동 정보 확인하기

레비뉴캣 대시보드에 입력할 연동 정보를 에어브릿지 대시보드에서 확인해야 합니다. 연동 정보는 총 2가지입니다.

* Airbridge Subdomain
* Airbridge Token

1. 에어브릿지 대시보드 \[연동]>\[서드파티 연동]에서 ‘RevenueCat’을 클릭합니다.
2. Airbridge Subdomain과 Airbridge Token을 각각 복사합니다. 이후 레비뉴캣 대시보드에 각 값을  붙여 넣어야 합니다.

### 레비뉴캣에서 연동 정보 입력하기

1. 레비뉴캣 대시보드 왼쪽 메뉴에서 \[Integrations]를 클릭합니다.
2. \[Attribution]에서 'Airbridge'를 클릭합니다.
3. 에어브릿지 대시보드에서 복사한 Airbridge Subdomain과 Airbridge Token을 레비뉴캣 대시보드에서 각각 해당하는 위치에 입력하세요.
4. \[Event Names]에서 레비뉴캣 이벤트별로 에어브릿지에서 확인하려는 이벤트 이름을 입력합니다. 'Use default event names'를 클릭하면 에어브릿지와 미리 매핑된 이벤트의 이름이 자동 입력되며 이 이름은 수정할 수 있습니다. 자세한 내용은 [매핑 테이블](/ko/guides/revenuecat#에어브릿지에서-연동-데이터-조회하기)을 참고하세요.
5. 'Add Integration'을 클릭해 연동을 완료합니다.

## 에어브릿지에서 연동 데이터 조회하기

아래는 래비뉴캣과 에어브릿지가 미리 매핑한 이벤트 목록입니다. 이 목록은 레비뉴캣 대시보드 \[Event Names]에서 'Use default event names'를 클릭하면 나타나는 매핑과 일치합니다.

<Accordion title="매핑 테이블) 레비뉴캣 이벤트 - 에어브릿지 이벤트">
  레비뉴캣 이벤트는 에어브릿지의 스탠다드 이벤트와 커스텀 이벤트로 매핑됐습니다. 스탠다드 이벤트와 커스텀 이벤트는 레비뉴캣 대시보드에서 입력하는 이름에 따라 서로 바뀔 수 있습니다. 이벤트 매핑을 수정할 경우 아래를 꼭 참고하세요.

  ###### 스탠다드 이벤트

  아래 이벤트는 [스탠다드 이벤트](/ko/guides/airbridge-event-types#%EC%8A%A4%ED%83%A0%EB%8B%A4%EB%93%9C-%EC%9D%B4%EB%B2%A4%ED%8A%B8)로 기본 매핑됐습니다. 스탠다드 이벤트로 매핑된 레비뉴캣 이벤트는 스탠다드 이벤트의 이름으로 표시됩니다.

  * 다른 스탠다드 이벤트로 매핑하려면 매핑을 변경하려는 스탠다드 이벤트의 [이벤트 카테고리](/ko/guides/airbridge-event-types#%EC%8A%A4%ED%83%A0%EB%8B%A4%EB%93%9C-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EB%AA%A9%EB%A1%9D)를 입력하세요.
  * 커스텀 이벤트로 매핑하려면 스탠다드 이벤트의 이벤트 카테고리를 제외한 다른 이름을 입력하세요. 스탠다드 이벤트의 이벤트 카테고리를 입력하면 해당 이벤트는 스탠다드 이벤트가 됩니다.

  | 레비뉴캣 이벤트          | 에어브릿지 이벤트 |
  | ----------------- | --------- |
  | TRIAL\_STARTED    | 체험판 시작    |
  | INITIAL\_PURCHASE | 구독        |
  | TRIAL\_CONVERTED  | 구독        |
  | RENEWAL           | 구독        |
  | CANCELLATION      | 구독 취소     |

  ###### 커스텀 이벤트

  아래 이벤트는 [커스텀 이벤트](/ko/guides/airbridge-event-types#%EC%BB%A4%EC%8A%A4%ED%85%80-%EC%9D%B4%EB%B2%A4%ED%8A%B8)로 기본 매핑됐습니다. 커스텀 이벤트로 매핑된 레비뉴캣 이벤트는 원래 이름 그대로 표시됩니다. 이벤트에 포함된 데이터는 커스텀 어트리뷰트로 확인할 수 있습니다.

  * 스탠다드 이벤트로 매핑하려면 매핑을 변경하려는 스탠다드 이벤트의 [이벤트 카테고리](/ko/guides/airbridge-event-types#%EC%8A%A4%ED%83%A0%EB%8B%A4%EB%93%9C-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EB%AA%A9%EB%A1%9D)를 입력하세요.
  * 다른 커스텀 이벤트로 매핑하려면 스탠다드 이벤트의 이벤트 카테고리를 제외한 다른 이름을 입력하세요. 스탠다드 이벤트의 이벤트 카테고리를 입력하면 해당 이벤트는 스탠다드 이벤트가 됩니다.

  | 레비뉴캣 이벤트                       | 에어브릿지 이벤트                      |
  | ------------------------------ | ------------------------------ |
  | TRIAL\_CANCELLED               | TRIAL\_CANCELLED               |
  | TRIAL                          | TRIAL                          |
  | UNCANCELLATION                 | UNCANCELLATION                 |
  | NON\_RENEWING\_PURCHASE        | NON\_RENEWING\_PURCHASE        |
  | SUBSCRIPTION\_PAUSED           | SUBSCRIPTION\_PAUSED           |
  | EXPIRATION                     | EXPIRATION                     |
  | BILLING\_ISSUE                 | BILLING\_ISSUE                 |
  | PRODUCT\_CHANGE                | PRODUCT\_CHANGE                |
  | TRANSFER                       | TRANSFER                       |
  | SUBSCRIPTION\_EXTENDED         | SUBSCRIPTION\_EXTENDED         |
  | TEMPORARY\_ENTITLEMENT\_GRANT  | TEMPORARY\_ENTITLEMENT\_GRANT  |
  | REFUND\_REVERSED               | REFUND\_REVERSED               |
  | INVOICE\_ISSUANCE              | INVOICE\_ISSUANCE              |
  | VIRTUAL\_CURRENCY\_TRANSACTION | VIRTUAL\_CURRENCY\_TRANSACTION |
  | REFUND                         | REFUND                         |
</Accordion>

## 주의사항

아래 사항을 주의해 주세요.

<AccordionGroup>
  <Accordion title="에어브릿지의 디바이스 ID 가져오기">
    레비뉴캣으로 에어브릿지에서 수집한 디바이스 ID를 전송해야 합니다. 디바이스 ID를 전달받기 위해 레비뉴캣 SDK를 설정하세요. 자세한 내용은 [레비뉴캣 가이드](https://www.revenuecat.com/docs/integrations/attribution/airbridge#2-send-device-data-to-revenuecat)를 참고해 주세요.
  </Accordion>

  <Accordion title="에어브릿지와 레비뉴캣의 동일한 유저 ID 매칭">
    레비뉴캣의 [앱 유저 ID](https://www.revenuecat.com/docs/user-ids)를 에어브릿지 SDK에 전달하세요. 에어브릿지와 레비뉴캣에 동일한 유저 ID가 기록돼야 정상적으로 연동 결과를 조회할 수 있습니다. 전달받는 앱 유저 ID가 없으면 에어브릿지는 임의의 유저 ID를 생성하게 되므로 에어브릿지 대시보드에서 레비뉴캣 이벤트의 유저 수가 실제보다 더 집계될 수 있습니다.
  </Accordion>

  <Accordion title="이벤트 중복 집계">
    에어브릿지 SDK에서 이미 수집 중인 서드파티 플랫폼의 이벤트를 새롭게 정의하고 수집하게 되면 해당 이벤트는 중복 집계됩니다. 서드파티 플랫폼과 연동 중인 SDK로 수집 중인 이벤트는 추가로 수집하지 않도록 주의하세요.
  </Accordion>

  <Accordion title="SKAN 전환값 측정에 S2S 이벤트 반영하기">
    서버 투 서버(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)를 참고하세요.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/revenuecat" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/revenuecat" />