---
updatedAt: 2025-06-10T23:34:59.000Z
agentTools:
  projectIndex: https://airbridge.readme.io/llms.txt
---

# React native 2.X.X migration guide

<HTMLBlock>{`
<head>
  <link rel="alternate" hreflang="en" href="https://developers.airbridge.io/v1.1-en/page/react-native-2xx-migration-guide-1" />
  <link rel="alternate" hreflang="ko" href="https://developers.airbridge.io/page/react-native-2xx-migration-guide" />
</head>
`}</HTMLBlock>

# 변경사항

기존에 1.X.X 버전 에 있던 있던 event 전송 API 가 삭제 되고 아래의 API 로 대체 되었습니다.

```javascript
/**
 * Send event to server.
 * @param {string} category event name
 * @param {EventOption} [option={}] event options
 */
trackEvent(category: string, option?: EventOption): void;
```

option 정보는 null 일 수 있고 해당 정보에 action, label, value, customAttributes, semanticAttributes 사용이 가능합니다.

[이벤트 설정](https://developers.airbridge.io/docs/react-native-sdk#%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%84%A4%EC%A0%95) 에서 자세한 내용을 확인하세요.

> 🚧 1.X.X 버전을 사용하신다면 아래의 React-native SDK 사용 가이드를 확인 바랍니다.
>
> * [React-native SDK v1.5.0 사용 가이드](https://developers.airbridge.io/docs/react-native-sdk-v150)

이벤트 전송 관련 된 API 가 변경 되어 이벤트 전송에 따른 코드를 아래와 같이 변경이 필요합니다.\
1.X.X 에서 아래의 method 를 사용 중이라면 `trackEvent(category: string, option?: EventOption)` 로 전환 해야 합니다.

### 사용자 이벤트 전송 [바로가기](https://developers.airbridge.io/docs/react-native-sdk#%EC%82%AC%EC%9A%A9%EC%9E%90-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1)

#### 회원가입

```diff
- Airbridge.event.signUp(user, option);
+ Airbridge.state.setUser({
+    ID: ...,
+    email: ...,
+    phone: ...,
+    alias: {},
+    attributes: {},
+ });
+ Airbridge.trackEvent(AirbridgeCategory.SIGN_UP, option);
```

`Airbridge.event.signUp(user, option)` 를 사용하고 있다면 변경이 필요합니다.\
매개변수로 전달 하던 user 정보를 `Airbridge.state.setUser()` 에 채워주고 `Airbridge.trackEvent(AirbridgeCategory.SIGN_UP, option)` 으로 `SIGN_UP` 이벤트를 전달합니다.

#### 로그인

```diff
- Airbridge.event.signIn(user, option);
+ Airbridge.state.setUser({
+    ID: ...,
+    email: ...,
+    phone: ...,
+    alias: {},
+    attributes: {},
+ });
+ Airbridge.trackEvent(AirbridgeCategory.SIGN_IN, option);
```

`Airbridge.event.signIn(user, option)` 를 사용하고 있다면 변경이 필요합니다.\
매개변수로 전달 하던 user 정보를 `Airbridge.state.setUser()` 에 채워주고 `Airbridge.trackEvent(AirbridgeCategory.SIGN_IN, option)` 으로 `SIGN_IN` 이벤트를 전달합니다.

#### 로그아웃

```diff
- Airbridge.event.signOut(option);
+ Airbridge.trackEvent(AirbridgeCategory.SIGN_OUT, option);
+ Airbridge.state.setUser({});
```

`Airbridge.event.signOut(option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.SIGN_OUT, option)` 으로 `SIGN_OUT` 이벤트를 전달하고,\
`Airbridge.state.setUser()` 에 빈객체를 전달하여 현재 유저정보를 비워주세요.

### 이커머스 이벤트 전송 [바로가기](https://developers.airbridge.io/docs/react-native-sdk#%EC%9D%B4%EC%BB%A4%EB%A8%B8%EC%8A%A4-%EC%9D%B4%EB%B2%A4%ED%8A%B8-%EC%A0%84%EC%86%A1)

#### 홈 화면 조회

```diff
- Airbridge.event.viewHome(option);
+ Airbridge.trackEvent(AirbridgeCategory.HOME_VIEW, option);
```

`Airbridge.event.viewHome(category, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.HOME_VIEW, option)` 으로 `HOME_VIEW` 이벤트를 전달합니다.

#### 상품 상세 조회

```diff
- Airbridge.event.viewProductDetail(data?: {products?: Product[];}, option?: EventOption)
+ Airbridge.trackEvent(AirbridgeCategory.PRODUCT_DETAILS_VIEW, {
+     semanticAttributes: {
+         [AirbridgeAttributes.PRODUCTS]: [
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '1',
+                 [AirbridgeProduct.NAME]: 'product custom A name',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 1,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+         ]
+     }
+ });
```

`Airbridge.event.viewProductDetail(data, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.PRODUCT_DETAILS_VIEW, option)` 으로 `PRODUCT_DETAILS_VIEW` 이벤트를 전달합니다.\
기존 api 의 매개변수에 값을 option 에 객체에 담아서 전달 한다.

> `product` => `semanticAttributes.[AirbridgeAttributes.PRODUCTS]`

#### 상품 리스트 조회

```diff
- Airbridge.event.viewProductList(data?: {listID?: string; products?: Product[];}, option?:EventOption);
+ Airbridge.trackEvent(AirbridgeCategory.PRODUCT_LIST_VIEW, {
+     semanticAttributes: {
+         [AirbridgeAttributes.PRODUCT_LIST_ID]: 'ID-1234567890'
+         [AirbridgeAttributes.PRODUCTS]: [
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '1',
+                 [AirbridgeProduct.NAME]: 'product A',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 1,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '2',
+                 [AirbridgeProduct.NAME]: 'product B',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 2,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+         ]
+     }
+ });
```

`Airbridge.event.viewProductList(data, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.PRODUCT_LIST_VIEW, option)` 으로 `PRODUCT_LIST_VIEW` 이벤트를 전달합니다.\
기존 api 의 매개변수에 값을 option 에 객체에 담아서 전달 한다.

> `listID` => `semanticAttributes.[AirbridgeAttributes.PRODUCT_LIST_ID]`\
> `product` => `semanticAttributes.[AirbridgeAttributes.PRODUCTS]`

#### 검색결과 조회

```diff
- Airbridge.event.viewSearchResult(data?: {query?: string; products?: Product[];}, option?:EventOption)
+ Airbridge.trackEvent(AirbridgeCategory.SEARCH_RESULT_VIEW, {
+     semanticAttributes: {
+         [AirbridgeAttributes.QUERY]: 'product'
+         [AirbridgeAttributes.PRODUCTS]: [
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '1',
+                 [AirbridgeProduct.NAME]: 'product A',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 1,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '2',
+                 [AirbridgeProduct.NAME]: 'product B',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 2,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+         ]
+     }
+ });
```

`Airbridge.event.viewSearchResult(data, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.SEARCH_RESULT_VIEW, option)` 으로 `SEARCH_RESULT_VIEW` 이벤트를 전달합니다.\
기존 api 의 매개변수에 값을 option 에 객체에 담아서 전달 한다.

> `query` => `semanticAttributes.[AirbridgeAttributes.QUERY]`\
> `product` => `semanticAttributes.[AirbridgeAttributes.PRODUCTS]`

#### 장바구니 담기

```diff
- Airbridge.event.addToCart(data?: {cartID?: string; products?: Product[]; currency?: string; total?: number;}, option?: EventOption)
+ Airbridge.trackEvent(AirbridgeCategory.ADD_TO_CART, {
+     semanticAttributes: {
+         [AirbridgeAttributes.CART_ID]: 'ID-1234567890',
+         [AirbridgeAttributes.CURRENCY]: 'KRW',
+         [AirbridgeAttributes.TOTAL_VALUE]: 2000000,
+         [AirbridgeAttributes.PRODUCTS]: [
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '1',
+                 [AirbridgeProduct.NAME]: 'product A',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 1,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '2',
+                 [AirbridgeProduct.NAME]: 'product B',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 2,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+         ]
+     }
+ });
```

`Airbridge.event.addToCart(data, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.ADD_TO_CART, option)` 으로 `ADD_TO_CART` 이벤트를 전달합니다.\
기존 api 의 매개변수에 값을 option 에 객체에 담아서 전달 한다.

> `cartID` => `semanticAttributes.[AirbridgeAttributes.CART_ID]`\
> `product` => `semanticAttributes.[AirbridgeAttributes.PRODUCTS]`\
> `currency` => `semanticAttributes.[AirbridgeAttributes.CURRENCY]`\
> `total` => `semanticAttributes.[AirbridgeAttributes.TOTAL_VALUE]`

#### 결제

```diff
- Airbridge.event.purchase(data?: {transactionID?: string; products?: Product[]; isInAppPurchase?: boolean; currency?: string; total?: number;}, option?: EventOption)
+ Airbridge.trackEvent(AirbridgeCategory.ORDER_COMPLETED, {
+     semanticAttributes: {
+         [AirbridgeAttributes.TRANSACTION_ID]: 'transactionID-purchase',
+         [AirbridgeAttributes.CURRENCY]: 'KRW',
+         [AirbridgeAttributes.TOTAL_VALUE]: 2000000,
+         [AirbridgeAttributes.IN_APP_PURCHASED]: true,
+         [AirbridgeAttributes.PRODUCTS]: [
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '1',
+                 [AirbridgeProduct.NAME]: 'product A',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 1,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+             {
+                 [AirbridgeProduct.PRODUCT_ID]: '2',
+                 [AirbridgeProduct.NAME]: 'product B',
+                 [AirbridgeProduct.PRICE]: 1000000,
+                 [AirbridgeProduct.CURRENCY]: 'KRW',
+                 [AirbridgeProduct.POSITION]: 2,
+                 [AirbridgeProduct.QUANTITY]: 1,
+             },
+         ]
+     }
+ });
```

`Airbridge.event.purchase(data, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(AirbridgeCategory.ORDER_COMPLETED, option)` 으로 `ORDER_COMPLETED` 이벤트를 전달합니다.\
기존 api 의 매개변수에 값을 option 에 객체에 담아서 전달 한다.

> `transactionID` => `semanticAttributes.[AirbridgeAttributes.TRANSACTION_ID]`\
> `product` => `semanticAttributes.[AirbridgeAttributes.PRODUCTS]`\
> `isInAppPurchase` => `semanticAttributes.[AirbridgeAttributes.IN_APP_PURCHASED]`\
> `total` => `semanticAttributes.[AirbridgeAttributes.TOTAL_VALUE]`

### 사용자 이벤트

```diff
- Airbridge.event.custom(category, option)
+ Airbridge.trackEvent(category, option);
```

`Airbridge.event.custom(category, option)` 를 사용하고 있다면 변경이 필요합니다.\
`Airbridge.trackEvent(category, option)` 으로 이벤트를 전달합니다.