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

# 클레버탭

에어브릿지는 [클레버탭(CleverTap)](https://clevertap.com/) 연동을 지원합니다.

클레버탭은 유저의 잔존율과 LTV(Life Time Value, 생애 가치)를 올릴 수 있는 리텐션 중심의 마케팅 솔루션입니다. 클레버탭 연동을 통해 에어브릿지의 어트리뷰션 데이터와 클레버탭의 AI, 머신러닝에 기반을 둔 인사이트를 활용한 초개인화된 CRM 마케팅을 진행할 수 있습니다.

## 연동하기

클레버탭 SDK의 디바이스 ID를 에어브릿지 SDK의 디바이스 알리아스(Device Alias)로 지정하는 방식으로 에어브릿지 SDK로 수집되는 데이터를 클레버탭 서버로 전송합니다.

#### 지원하는 SDK

아래 버전 이상의 SDK에서 클레버탭 연동을 지원합니다.

* Airbridge Android SDK: 2.19.5
* Airbridge iOS SDK: 1.18.0
* Airbridge React Native SDK: 1.5.0
* Airbridge Cordova SDK: 2.0.2
* Airbridge Flutter SDK: 3.0.2
* Airbridge Unity SDK: 1.9.0

### 사전 준비사항

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

  연동을 마치기 위해서는 에어브릿지 대시보드 설정이 필요합니다. SDK 설정 이후에 반드시 필요한 모든 설정을 진행해 주세요.
</Danger>

에어브릿지 SDK에 아래 코드를 삽입합니다. 에어브릿지 SDK 작업을 하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 클레버탭이 정상적으로 연동되지 않습니다.

<AccordionGroup>
  <Accordion title="SDK 연동하기 (Android)">
    #### Android SDK

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.kt
      override fun onCreate() {
          super.onCreate()
          // Initialize Airbridge SDK
          val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(this, option)

          // Fetch CleverTapID from CleverTap SDK
          CleverTapAPI.getDefaultInstance(this)?.getCleverTapID { cleverTapID ->
              // Set device alias into Airbridge SDK
              Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID)
              // Explicitly start tracking
              Airbridge.startTracking()
          }
      }
      ```

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeOption option = new AirbridgeOptionBuilder("APP_NAME", "APP_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build();
          Airbridge.initializeSDK(application, option);
          
          // Fetch CleverTapID from CleverTap SDK
          CleverTapAPI.getDefaultInstance(this).getCleverTapID(new OnInitCleverTapIDListener() {
              @Override
              public void onInitCleverTapID(String cleverTapID) {
                  // Set device alias into Airbridge SDK
                  Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID);
                  // Explicitly start tracking
                  Airbridge.startTracking();
              }
          });
      }
      ```
    </CodeGroup>

    #### Android SDK (Deprecated)

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.kt
      override fun onCreate() {
          super.onCreate()
          // Initialize Airbridge SDK
          val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.init(this, config)

          // Fetch CleverTapID from CleverTap SDK
          CleverTapAPI.getDefaultInstance(this)?.getCleverTapID { cleverTapID ->
              // Set device alias into Airbridge SDK
              Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID)
              // Explicitly start tracking
              Airbridge.startTracking()
          }
      }
      ```

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build();
          Airbridge.init(this, config);
          
          // Fetch CleverTapID from CleverTap SDK
          CleverTapAPI.getDefaultInstance(this).getCleverTapID(new OnInitCleverTapIDListener() {
              @Override
              public void onInitCleverTapID(String cleverTapID) {
                  // Set device alias into Airbridge SDK
                  Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID);
                  // Explicitly start tracking
                  Airbridge.startTracking();
              }
          });
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK 연동하기 (iOS)">
    #### iOS SDK

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {

          let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(option: option)

          CleverTap.autoIntegrate()
          if let cleverTapID = CleverTap.sharedInstance()?.profileGetID() {
              Airbridge.setDeviceAlias(key:"clevertap_device_id", value:String(cleverTapID))
          }
          
          // Explicitly start tracking
          Airbridge.startTracking()

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirbridgeOptionBuilder* optionBuilder = 
              [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                     token:@"YOUR_APP_SDK_TOKEN"];

          [optionBuilder setAutoStartTrackingEnabled:NO];
          AirbridgeOption* option = [optionBuilder build];
          [Airbridge initializeSDKWithOption:option];

          [CleverTap autoIntegrate];
          NSString* cleverTapID = [CleverTap.sharedInstance profileGetCleverTapID];
          if (cleverTapID != nil) {
              [Airbridge setDeviceAliasWithKey:@"clevertap_device_id" 
                                         value:cleverTapID];
          }

          // Explicitly start tracking
          [Airbridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>

    #### iOS SDK (Deprecated)

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {
        
          AirBridge.setAutoStartTrackingEnabled(false)
          AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

          CleverTap.autoIntegrate()
          if let cleverTapID = CleverTap.sharedInstance()?.profileGetID() {
              AirBridge.setDeviceAlias(withKey:"clevertap_device_id", value:String(cleverTapID))
          }

          // Explicitly start tracking
          AirBridge.startTracking()

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirBridge.autoStartTrackingEnabled = NO;
          [AirBridge getInstance:@"YOUR_APP_SDK_TOKEN"
                         appName:@"YOUR_APP_NAME"
               withLaunchOptions:launchOptions];

          [CleverTap autoIntegrate];
          NSString* cleverTapID = [CleverTap.sharedInstance profileGetCleverTapID];
          if (cleverTapID != nil) {
              [AirBridge setDeviceAliasWithKey:@"clevertap_device_id" value:cleverTapID];
          }

          // Explicitly start tracking
          [AirBridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK 연동하기 (React Native)">
    #### React Native SDK

    [`airbridge.json`](/ko/developers/react-native-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    CleverTap.profileGetCleverTapID(function (error, cleverTapID) {
        Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID);
        Airbridge.startTracking();
    })
    ```

    #### React Native SDK (Deprecated)

    [`airbridge.json`](/ko/developers/deprecated-react-native-sdk-v2#airbridge-json)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    CleverTap.profileGetCleverTapID(function (error, cleverTapID) {
        Airbridge.state.setDeviceAlias("clevertap_device_id", cleverTapID)
        Airbirdge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK 연동하기 (Cordova)">
    [`airbridge.json`](/ko/developers/deprecated-cordova-ionic-sdk-v2#airbridge-json)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    CleverTap.getCleverTapID(function (cleverTapID) {
        Airbridge.state.setDeviceAlias("clevertap_device_id", cleverTapID)
        Airbirdge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK 연동하기 (Flutter)">
    #### Flutter SDK

    [`airbridge.json`](/ko/developers/flutter-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    CleverTapPlugin.getCleverTapID().then((cleverTapID) {
        Airbridge.setDeviceAlias("clevertap_device_id", cleverTapID);
        Airbridge.startTracking();
    });
    ```

    #### Flutter SDK (Deprecated)

    [`airbridge.json`](/ko/developers/deprecated-flutter-sdk-v3#airbridge-json)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    CleverTapPlugin.getCleverTapID().then((cleverTapID) {
        Airbridge.state.setDeviceAlias("clevertap_device_id", cleverTapID)
        Airbirdge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK 연동하기 (Unity)">
    #### Unity SDK

    [프로젝트 설정](/ko/developers/unity-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    string CleverTapID = CleverTapBinding.ProfileGetCleverTapID();
    Airbridge.SetDeviceAlias("clevertap_device_id", CleverTapID);
    Airbridge.StartTracking();
    ```

    #### Unity SDK (Deprecated)

    [프로젝트 설정](/ko/developers/deprecated-unity-sdk-v1#프로젝트-설정)의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    string CleverTapID = CleverTapBinding.ProfileGetCleverTapID();
    AirbridgeUnity.SetDeviceAlias("clevertap_device_id", CleverTapID);
    AirbridgeUnity.StartTracking();
    ```
  </Accordion>
</AccordionGroup>

### 에어브릿지에서 클레버탭 연동하기

SDK 작업을 마친 후에 에어브릿지 대시보드에서 필요한 작업을 마쳐야 모든 연동 과정이 마무리됩니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

* [클레버탭 연동하기 (유저 가이드)](/ko/guides/clevertap)

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

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