Flarelane

https://flarelane.com/ko/docs/
Admin
Flarelane is a customer engagement and marketing automation platform that provides various messaging...
Tokens:45,456
Snippets:430
Trust Score:7.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install React Native SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/react-native-sdk

Command to install the FlareLane SDK package via yarn.

```bash
$ yarn add @flarelane/react-native-sdk@1.10.0
```

--------------------------------

### Install Flutter SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/flutter-sdk

Run this command in the project root directory to add the FlareLane dependency.

```bash
$ flutter pub add flarelane_flutter:1.10.0
```

--------------------------------

### FlareLane.initWithLaunchOptions

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-sdk

Initializes the FlareLane SDK within the application's didFinishLaunchingWithOptions method.

```APIDOC
## FlareLane.initWithLaunchOptions

### Description
Initializes the FlareLane SDK. This should be called in the application's `didFinishLaunchingWithOptions` method.

### Parameters
- **launchOptions** (NSDictionary/Dictionary) - The launch options provided by the system.
- **projectId** (String) - Your unique FlareLane project ID.
- **requestPermissionOnLaunch** (Bool) - Whether to request notification permissions immediately upon launch.
```

--------------------------------

### Get Device ID

Source: https://flarelane.com/ko/docs/mobile-sdk-reference

Retrieves the unique identifier for the current device.

```Kotlin

/*
  Params
  - Context context
*/


FlareLane.getDeviceId(this);

```

```Java

/*
  Params
  - Context context
*/


FlareLane.getDeviceId(this);

```

```Swift

FlareLane.getDeviceId()

```

```Objective-C

[FlareLane getDeviceId];

```

```Dart

await FlareLane.shared.getDeviceId())

```

```JavaScript

await FlareLane.getDeviceId()

```

--------------------------------

### Get Device ID

Source: https://flarelane.com/ko/docs/web-sdk-reference

Retrieves the unique FlareLane device ID.

```javascript
FlareLane.getDeviceId((deviceId) => {
    // Do something...
    console.log(deviceId);
 });
```

--------------------------------

### Get Subscription Status

Source: https://flarelane.com/ko/docs/web-sdk-reference

Retrieves the current subscription status of the device via a callback.

```javascript
FlareLane.getIsSubscribed((isSubscribed) => {
    // Do something...
    console.log(isSubscribed);
});
```

--------------------------------

### Initialize FlareLane Web SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/web-sdk

Add this script before the closing body tag to initialize the SDK with your unique project ID.

```html
<script src="https://cdn.flarelane.com/WebSDK.js" charset="UTF-8"></script>
<script>FlareLane.initialize({ projectId: "프로젝트 ID" });</script>
```

--------------------------------

### FlareLane.init

Source: https://flarelane.com/ko/docs/mobile-sdk-reference

Registers a device to the FlareLane project. The requestPermissionOnLaunch parameter allows requesting notification permissions upon app launch.

```APIDOC
## FlareLane.init

### Description
Registers a device to the FlareLane project. If requestPermissionOnLaunch is set to true, notification permissions are requested when the app launches.

### Parameters
- **context** (Context) - Required - The application context.
- **projectId** (String) - Required - The unique project identifier.
- **requestPermissionOnLaunch** (boolean) - Optional - Whether to request notification permissions on launch (default: true).
```

--------------------------------

### Initialize FlareLane SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/android-sdk

Initialize the SDK within the Application class's onCreate method using your project ID.

```kotlin
import com.flarelane.FlareLane


class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()


        // 아래 코드 추가
        // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
        FlareLane.initWithContext(this, "PROJECT_ID", true)
    }
}
```

```java
import com.flarelane.FlareLane;


public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();


        // 아래 코드 추가
        // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
        FlareLane.initWithContext(this, "PROJECT_ID", true);
    }
}
```

--------------------------------

### Initialize FlareLane SDK

Source: https://flarelane.com/ko/docs/web-sdk-reference

Initializes the SDK with the required project ID and optional service worker path.

```javascript
FlareLane.initialize({
  projectId: "<PROJECT_ID>",
  serviceWorkerPath: "/sw.js" // optional
});
```

--------------------------------

### FlareLane.initialize

Source: https://flarelane.com/ko/docs/sdk-integrations/react-native-sdk

Initializes the FlareLane SDK in your application. The project ID can be found in the FlareLane console.

```APIDOC
## FlareLane.initialize(projectId, requestPermissionOnLaunch)

### Description
Initializes the FlareLane SDK. Set the second parameter to false if you wish to control the timing of the notification permission popup manually using the .subscribe() function.

### Parameters
- **projectId** (string) - Required - The project ID from the FlareLane console.
- **requestPermissionOnLaunch** (boolean) - Required - Whether to request notification permissions automatically on launch.

### Example
```javascript
import FlareLane from '@flarelane/react-native-sdk';
FlareLane.initialize('PROJECT_ID', true);
```
```

--------------------------------

### Initialize FlareLane SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/react-native-sdk

Initialize the SDK in the main application file. Set the second parameter to false to manually control the notification permission prompt timing.

```typescript
import FlareLane from '@flarelane/react-native-sdk';


// 알림 권한 팝업 타이밍을 제어하려면 2번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
FlareLane.initialize('PROJECT_ID', true);
```

--------------------------------

### Initialize FlareLane SDK

Source: https://flarelane.com/ko/docs/mobile-sdk-reference

Registers the device with a FlareLane project. Use requestPermissionOnLaunch to control whether notification permissions are requested immediately upon app startup.

```Java

/*
  Params
  - Context context
  - String projectId
  - boolean requestPermissionOnLaunch
*/


FlareLane.initWithContext(this, "INPUT_YOUR_PROJECT_ID", true)
```

```Java

/*
  Params
  - Context context
  - String projectId
  - boolean requestPermissionOnLaunch
*/


FlareLane.initWithContext(this, "INPUT_YOUR_PROJECT_ID", true);
```

```Swift

/*
  Params
  - launchOptions: [UIApplication.LaunchOptionsKey : Any]?
  - projectId: String
  - requestPermissionOnLaunch: Bool = true
*/


FlareLane.initWithLaunchOptions(launchOptions, projectId: "INPUT_YOUR_PROJECT_ID", true)
```

```Objective-C

/*
  Params
  - launchOptions:(NSDictionary<UIApplicationLaunchOptionsKey,id> * _Nullable)
  - projectId:(NSString * _Nonnull)
  - requestPermissionOnLaunch:(Bool) = YES
*/


[FlareLane initWithLaunchOptions:launchOptions projectId:@"INPUT_YOUR_PROJECT_ID" requestPermissionOnLaunch: YES];
```

```Swift

/*
  Params
  - String projectId
  - bool? requestPermissionOnLaunch = true
*/


FlareLane.shared.initialize("INPUT_YOUR_PROJECT_ID", requestPermissionOnLaunch: true);
```

```JavaScript

/*
  Params
  - projectId: string
  - requestPermissionOnLaunch: boolean = true


*/


FlareLane.initialize('INPUT_YOUR_PROJECT_ID', true);
```

--------------------------------

### 직접 만든 알림 채널 설정

Source: https://flarelane.com/ko/docs/sdk-integrations/android-notification-channel

기존에 사용 중인 알림 채널을 사용하도록 manifest.xml에 설정합니다. 이 값이 정의되면 SDK는 별도의 채널을 생성하지 않습니다.

```xml
<application>
  <meta-data android:name="flarelane_default_channel_id" android:value="YOUR_CHANNEL_ID" />
<application/>
```

--------------------------------

### FlareLane.shared.initialize

Source: https://flarelane.com/ko/docs/sdk-integrations/flutter-sdk

Initializes the FlareLane SDK with your project ID. This should be called in the main function after WidgetsFlutterBinding.ensureInitialized().

```APIDOC
## FlareLane.shared.initialize

### Description
Initializes the FlareLane SDK. The project ID can be found in the FlareLane console.

### Parameters
- **projectId** (String) - Required - The unique identifier for your project.
- **requestPermissionOnLaunch** (bool) - Optional - Whether to request notification permissions on launch. If set to false, you must call .subscribe() manually.
```

--------------------------------

### 기본 알림 채널명 변경

Source: https://flarelane.com/ko/docs/sdk-integrations/android-notification-channel

플레어레인이 생성한 기본 알림 채널의 이름을 변경하기 위해 strings.xml에 리소스를 추가합니다.

```xml
<resources>
    <string name="flarelane_default_channel_name">전체 알림</string>
</resources>
```

--------------------------------

### Initialize Airbridge and FlareLane in iOS

Source: https://flarelane.com/ko/docs/external-integrations/airbridge

Configure both SDKs within the AppDelegate to sync attribution data as FlareLane tags upon receipt.

```swift
import FlareLane
import Airbridge


@main
class AppDelegate: UIResponder, UIApplicationDelegate {


  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    FlareLane.initWithLaunchOptions(launchOptions, projectId: "PROJECT_ID", requestPermissionOnLaunch: true)


    let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
        .setOnAttributionReceived({ attribution in
            var tags: [String: Any] = [:]


            if let attributedChannel = attribution["attributedChannel"] {
                tags["attributedChannel"] = attributedChannel
            }
            if let attributedCampaign = attribution["attributedCampaign"] {
                tags["attributedCampaign"] = attributedCampaign
            }
            if let attributedAdGroup = attribution["attributedAdGroup"] {
                tags["attributedAdGroup"] = attributedAdGroup
            }
            if let attributedAdCreative = attribution["attributedAdCreative"] {
                tags["attributedAdCreative"] = attributedAdCreative
            }


            if !tags.isEmpty {
              FlareLane.setTags(tags: tags)
            }
        })
        .build()
    Airbridge.initializeSDK(option: option)


    return true
  }

}
```

```objective-c
#import "AppDelegate.h"
@import FlareLane;
#import <Airbridge/Airbridge.h>


@implementation AppDelegate


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {


  [FlareLane initWithLaunchOptions:launchOptions projectId:@"PROJECT_ID" requestPermissionOnLaunch:YES];


  AirbridgeOptionBuilder* optionBuilder = [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                                                 token:@"YOUR_APP_SDK_TOKEN"];
  [optionBuilder setOnAttributionReceived:^(NSDictionary<NSString *,NSString *> * attribution) {
      NSMutableDictionary *tags = [[NSMutableDictionary alloc] init];


      if (attribution[@"attributedChannel"]) {
          [tags setObject:attribution[@"attributedChannel"] forKey:@"attributedChannel"];
      }
      if (attribution[@"attributedCampaign"]) {
          [tags setObject:attribution[@"attributedCampaign"] forKey:@"attributedCampaign"];
      }
      if (attribution[@"attributedAdGroup"]) {
          [tags setObject:attribution[@"attributedAdGroup"] forKey:@"attributedAdGroup"];
      }
      if (attribution[@"attributedAdCreative"]) {
          [tags setObject:attribution[@"attributedAdCreative"] forKey:@"attributedAdCreative"];
      }


      if (tags.count > 0) {
        [FlareLane setTagsWithTags:tags];
      }
  }];
  AirbridgeOption* option = [optionBuilder build];
  [Airbridge initializeSDKWithOption:option];


  return YES;
}
```

--------------------------------

### 이벤트 API 연동 예시

Source: https://flarelane.com/ko/docs/data-integrations/events

REST API를 사용하여 서버 측에서 이벤트를 전송하는 예시입니다. API 키와 프로젝트 ID가 필요합니다.

```bash
curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "events": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "type": "purchase",
      "data": {
        "productId": "123",
        "productName": "상품명",
        "amount": 10000
      }
    }
  ]
}
'

```

--------------------------------

### Configure Podfile for FlareLane SDK

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-sdk

Add the FlareLane dependency to your Podfile for both the main application target and the Notification Service Extension target.

```ruby
// 파일 최상단에 아래 줄을 추가하여 Dynamic Framework를 활성화합니다.
use_frameworks!


target 'YOUR_PROJECT_NAME' do
  // 아래 줄 추가
  pod 'FlareLane', '1.10.1'
end


// 파일 최하단의 아래 줄 추가
// 앞서 입력한 Extension의 Product Name을 target 이름으로 설정합니다.
target 'FlareLaneNotificationServiceExtension' do
  pod 'FlareLane', '1.10.1'
end
```

--------------------------------

### Initialize FlareLane SDK in Flutter

Source: https://flarelane.com/ko/docs/sdk-integrations/flutter-sdk

Initialize the SDK in the main.dart file. Ensure WidgetsFlutterBinding.ensureInitialized() is called before initialization.

```dart
import 'package:flarelane_flutter/flarelane_flutter.dart';


void main() {
  // ensureInitialized() 이후 초기화 코드가 실행되도록 합니다
  WidgetsFlutterBinding.ensureInitialized();


  // 다음 초기화 코드 입력
  // 알림 권한 팝업 타이밍을 제어하려면 2번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
  FlareLane.shared.initialize("PROJECT_ID", requestPermissionOnLaunch: true);


  runApp(...);
}
```

--------------------------------

### manifest.json 연결

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-web-push

웹사이트의 <head> 태그 내에 manifest.json 파일을 연결하기 위한 HTML 코드입니다.

```html
<link rel="manifest" href="/manifest.json" />
```

--------------------------------

### Create AppDelegate for SwiftUI

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-sdk

Define the AppDelegate class and adapt it to the SwiftUI App lifecycle.

```swift
import UIKit


class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    return true
  }
}
```

```swift
struct <YOUR_PROJECT_NAME>App: App {
    // 아래 코드 추가
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
}
```

--------------------------------

### 이벤트 트리거 SDK 예시

Source: https://flarelane.com/ko/docs/data-integrations/events

Web SDK 또는 Mobile SDK를 사용하여 이벤트를 트리거하는 방법입니다.

```javascript
FlareLane.trackEvent("test_event")
```

--------------------------------

### Initialize FlareLane in AppDelegate

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-sdk

Configure FlareLane initialization and register device tokens for push notifications.

```swift
import FlareLane


class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 1
    // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
    FlareLane.initWithLaunchOptions(launchOptions, projectId: "PROJECT_ID", requestPermissionOnLaunch: true)
  }


  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    // 2
    FlareLaneAppDelegate.shared.application(application, didRegisterForRemoteNotificationsWithDeviceToken: deviceToken)
  }
}
```

```objective-c
@import FlareLane;


@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 // 1
 // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
 [FlareLane initWithLaunchOptions:launchOptions projectId:@"PROJECT_ID" requestPermissionOnLaunch:true];
}


- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  // 2
  [[FlareLaneAppDelegate shared] application:application didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
```

--------------------------------

### FlareLaneJavascriptInterface 연동

Source: https://flarelane.com/ko/docs/sdk-integrations/webview-bridge

각 모바일 플랫폼의 웹뷰 설정에 FlareLaneJavascriptInterface를 추가하여 웹 SDK와 모바일 SDK 간의 통신을 활성화합니다.

```APIDOC
## FlareLaneJavascriptInterface 연동

### 설명
웹뷰 내에서 발생하는 사용자 행동을 모바일 앱으로 전달하기 위해 각 플랫폼별 웹뷰 설정에 `FlareLaneJavascriptInterface`를 등록합니다. 브릿지 이름은 `FlareLaneJavascriptInterface.BRIDGE_NAME` 상수를 사용합니다.

### 지원 플랫폼
- Android
- iOS
- React Native
- Flutter

### 주요 연동 함수
브릿지 설정이 완료되면 웹 SDK에서 다음 함수 호출 시 앱의 Mobile SDK 함수가 자동으로 실행됩니다:
- `setUserId`
- `setTags`
- `trackEvent`
- `setUserAttributes`
```

--------------------------------

### FlareLane Skills 설치 명령어

Source: https://flarelane.com/ko/docs/skills

프로젝트 터미널에서 실행하여 AI 에이전트가 FlareLane과 상호작용할 수 있도록 설정합니다.

```bash
npx skills add flarelane/flarelane-skills
```

--------------------------------

### manifest.json 설정

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-web-push

웹앱의 이름, 아이콘, 표시 방식을 정의하는 manifest.json 파일의 필수 구성 요소입니다.

```json
{
    "name": "플레어레인",
    "icons": [{
        "src": "/icon-192x192.png",
        "sizes": "192x192",
        "type": "image/png"
    }],
    "display": "fullscreen"
}
```

--------------------------------

### FlareLaneAppDelegate.shared.application

Source: https://flarelane.com/ko/docs/sdk-integrations/ios-sdk

Forwards device token registration to the FlareLane SDK.

```APIDOC
## FlareLaneAppDelegate.shared.application

### Description
Forwards the device token received from APNs to the FlareLane SDK to enable push notifications.

### Parameters
- **application** (UIApplication) - The current application instance.
- **deviceToken** (Data/NSData) - The device token received from Apple Push Notification service.
```

--------------------------------

### Configure iOS Podfile

Source: https://flarelane.com/ko/docs/sdk-integrations/react-native-sdk

Add the FlareLane pod to the Notification Service Extension target in the Podfile.

```ruby
// 파일 최하단의 아래 줄 추가
// 앞서 입력한 Extension의 Product Name을 target 이름으로 설정합니다.
target 'FlareLaneNotificationServiceExtension' do
  pod 'FlareLane', '1.10.0'
end
```

--------------------------------

### Integrate Flutter WebView Bridge

Source: https://flarelane.com/ko/docs/sdk-integrations/webview-bridge

Set up the bridge using either webview_flutter or flutter_inappwebview packages.

```dart
import 'package:webview_flutter/webview_flutter.dart';
import 'package:flarelane_flutter/adapters/webview_flutter.dart';


final controller = WebViewController()
  ..setJavaScriptMode(JavaScriptMode.unrestricted)
  ..addJavaScriptChannel(
    FlareLaneJavascriptInterface.BRIDGE_NAME,
    onMessageReceived:
      FlareLaneJavascriptInterface.onMessageReceived(controller),
  )
  ..setNavigationDelegate(NavigationDelegate(
    onPageStarted: FlareLaneJavascriptInterface.onPageStarted(controller),
  ));
```

```dart
import 'package:flutter_inappwebview/flutter_inappwebview.dart';
import 'package:flarelane_flutter/adapters/flutter_inappwebview.dart';


InAppWebView(
  initialUrlRequest: URLRequest(url: WebUri(url)),
  initialUserScripts: UnmodifiableListView([
    ...FlareLaneJavascriptInterface.initialUserScripts,
  ]),
  onWebViewCreated: (controller) {
    controller.addJavaScriptHandler(
      handlerName: FlareLaneJavascriptInterface.BRIDGE_NAME,
      callback: FlareLaneJavascriptInterface.handlerCallback(controller),
    );
  },
);
```

--------------------------------

### POST /v1/projects/{PROJECT_ID}/track

Source: https://flarelane.com/ko/docs/data-integrations/user-attributes-tags

유저 프로필 및 태그 데이터를 대량 배치 등을 통해 주기적으로 동기화하는 API입니다.

```APIDOC
## POST /v1/projects/{PROJECT_ID}/track

### Description
유저 프로필 속성(userAttributes) 또는 커스텀 태그(tags)를 서버로 전송하여 동기화합니다.

### Method
POST

### Endpoint
https://api.flarelane.com/v1/projects/{PROJECT_ID}/track

### Parameters
#### Path Parameters
- **PROJECT_ID** (string) - Required - 프로젝트 고유 식별자

#### Request Body
- **userAttributes** (array) - Optional - 유저 프로필 데이터 리스트
- **tags** (array) - Optional - 태그 데이터 리스트

### Request Example
{
  "userAttributes": [
    {
      "userId": "userid1",
      "name": "name",
      "phoneNumber": "+821011112222",
      "email": "john@example.com",
      "dob": "1990-01-01",
      "timeZone": "Asia/Seoul",
      "country": "KR",
      "language": "ko"
    }
  ]
}
```

--------------------------------

### Set Tags

Source: https://flarelane.com/ko/docs/web-sdk-reference

Applies tags to the current user or device.

```javascript
// SET
FlareLane.setTags({ gender: "men", age: 24 });
```

--------------------------------

### Android SDK 연동 (Kotlin/Java)

Source: https://flarelane.com/ko/docs/external-integrations/airbridge

에어브릿지 SDK 초기화 시 어트리뷰션 데이터를 수신하여 플레어레인 태그로 설정합니다.

```kotlin
class MainApplication : Application() {
  override fun onCreate() {
    super.onCreate()


    FlareLane.initWithContext(this, "PROJECT_ID", true)


    val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
      .setOnAttributionReceived(object : OnAttributionResultReceiveListener {
        override fun onAttributionResultReceived(result: Map<String, String>) {
          val tags = JSONObject()
          result["attributedChannel"]?.let { tags.put("attributedChannel", it) }
          result["attributedCampaign"]?.let { tags.put("attributedCampaign", it) }
          result["attributedAdGroup"]?.let { tags.put("attributedAdGroup", it) }
          result["attributedAdCreative"]?.let { tags.put("attributedAdCreative", it) }


          if (tags.length() > 0) {
            FlareLane.setTags(applicationContext, tags)
          }
        }
      })
      .build()
    Airbridge.initializeSDK(this, option)
  }
}
```

```java
public class MainApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();


    FlareLane.initWithContext(this, "PROJECT_ID", true);


    AirbridgeOption option = new AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
      .setOnAttributionReceived(new OnAttributionResultReceiveListener() {
        @Override
        public void onAttributionResultReceived(@NonNull Map<String, String> result) {
          JSONObject tags = new JSONObject();
          try {
            if (result.get("attributedChannel") != null) {
              tags.put("attributedChannel", result.get("attributedChannel"));
            }
            if (result.get("attributedCampaign") != null) {
              tags.put("attributedCampaign", result.get("attributedCampaign"));
            }
            if (result.get("attributedAdGroup") != null) {
              tags.put("attributedAdGroup", result.get("attributedAdGroup"));
            }
            if (result.get("attributedAdCreative") != null) {
              tags.put("attributedAdCreative", result.get("attributedAdCreative"));
            }


            if (tags.length() > 0) {
              FlareLane.setTags(getApplicationContext(), tags);
            }
          } catch (JSONException e) {
            // Handling Exception...
          }
        }
      })
      .build();
    Airbridge.initializeSDK(this, option);
  }
}
```

--------------------------------

### 인앱메시지 노출 트리거 연동

Source: https://flarelane.com/ko/docs/channels/in-app-message

각 트리거 시점에 displayInApp 함수를 호출하여 인앱메시지를 노출합니다. 데이터 객체를 전달하여 세부 필터링을 수행할 수 있습니다.

```javascript
// 홈 화면 접속 시 다음 함수 실행
FlareLane.displayInApp("home");


// 데이터 함께 제공 시 세부 트리거 필터로 활용 가능 (특정 상품 조회 시 인앱 노출 등)
FlareLane.displayInApp("view_product", { "product_id": 12345, "category": "food" });
```

--------------------------------

### Configure JitPack Repository

Source: https://flarelane.com/ko/docs/sdk-integrations/android-sdk

Add the JitPack repository to your project's dependency management configuration.

```kotlin
dependencyResolutionManagement {
  repositories {
    // 아래 줄 추가
    maven("https://jitpack.io")
  }
}
```

```groovy
dependencyResolutionManagement {
  repositories {
    // 아래 줄 추가
    maven { url 'https://jitpack.io' }
  }
}
```

```groovy
allprojects {
  repositories {
    // 아래 줄 추가
    maven { url 'https://jitpack.io' }
  }
}
```

--------------------------------

### 기본 Liquid 문법 예시

Source: https://flarelane.com/ko/docs/targets/personalized-messages

다양한 데이터 타입과 필터를 활용한 개인화 메시지 작성 예시입니다.

```liquid
{{ name | default: "고객" }}님 안녕하세요!
```

```liquid
{{ tags.signup_date | date: "%Y-%m-%d", "Asia/Seoul" }} 일자로 가입이 완료되었습니다.
```

```liquid
주문하신 {{ entry_event.data.product_name | truncate: 20 }} 상품의 배송이 시작되었습니다.
```

```liquid
적립금 {{ tags.point | number_with_delimiter}} 원이 소멸 예정입니다.
```

--------------------------------

### Liquid 필터 연속 활용

Source: https://flarelane.com/ko/docs/targets/personalized-messages

필터를 체이닝하여 데이터 포맷팅과 기본값 설정을 동시에 처리합니다.

```liquid
{{ tags.signup_date | date: "%Y-%m-%d", "Asia/Seoul" | default: "오늘" }} 일자로 가입이 완료되었습니다.
```

--------------------------------

### Set Tags

Source: https://flarelane.com/ko/docs/mobile-sdk-reference

Updates user or device tags. Use JSONObject.NULL or equivalent to remove a specific tag.

```Kotlin

/*
  Params
  - Context context
  - JSONObject tags
*/


var tags = JSONObject()
tags.put("gender", "men")
tags.put("age", 24)
tags.put("removeTag", JSONObject.NULL) // remove


FlareLane.setTags(this, tags)

```

```Java

/*
  Params
  - Context context
  - JSONObject tags
*/


JSONObject tags = new JSONObject();
tags.put("gender", "men");
tags.put("age", 24);
tags.put("removeTag", JSONObject.NULL); // remove


FlareLane.setTags(this, tags);

```

```Swift

/*
  Params
  - tags: [String : Any]
*/


FlareLane.setTags(tags: ["gender": "men", "age": 24])

```

```Objective-C

/*
  Params
  - tags:(NSDictionary<NSString *,id> * _Nonnull)
*/


[FlareLane setTagsWithTags:@{@"gender": @"men", @"age": @24}];

```

```Dart

/*
  Params
  - Map<String, Object> tags
*/


FlareLane.shared.setTags({
  "gender": "men",
  "age": 24
});

```

```JavaScript

/*
  Params
  - tags: Record<string, any>
*/


FlareLane.setTags({ gender: 'men', age: 27 });

```

--------------------------------

### POST /v1/projects/{PROJECT_ID}/track

Source: https://flarelane.com/ko/docs/data-integrations/events

Triggers an event for a specific user. This is the recommended method for server-side event tracking to ensure accuracy.

```APIDOC
## POST /v1/projects/{PROJECT_ID}/track

### Description
Triggers an event for a specific user. This is the recommended method for server-side event tracking to ensure accuracy.

### Method
POST

### Endpoint
https://api.flarelane.com/v1/projects/{PROJECT_ID}/track

### Request Body
- **events** (array) - Required - List of event objects
  - **subjectType** (string) - Required - The type of subject (e.g., "user")
  - **subjectId** (string) - Required - The unique identifier for the user
  - **type** (string) - Required - The name of the event (e.g., "purchase")
  - **data** (object) - Optional - Key-value pairs containing event details

### Request Example
{
  "events": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "type": "purchase",
      "data": {
        "productId": "123",
        "productName": "상품명",
        "amount": 10000
      }
    }
  ]
}
```

--------------------------------

### Liquid 조건 분기 및 변수 할당

Source: https://flarelane.com/ko/docs/targets/personalized-messages

assign을 사용하여 변수를 정의하고 if/elsif/else 문으로 메시지 내용을 분기합니다.

```liquid
{% assign user_name = tags.nickname %}
{% assign last_purchase = tags.last_purchase_category %}


{% if last_purchase == "스니커즈" %}
이번 주 한정으로 {{ user_name }}님이 좋아하시는 스니커즈 신상품을 10% 할인 중이에요! 놓치지 마세요 👟
{% elsif last_purchase == "아우터" %}
추운 날씨에 딱 맞는 아우터 신상이 입고되었어요! {{ user_name }}님을 위한 특별 혜택도 준비되어 있답니다 🧥
{% else %}
{{ user_name }}님만을 위한 신규 상품과 할인 혜택이 준비되어 있어요. 지금 바로 확인해보세요!
{% endif %}
```

--------------------------------

### Android 매니페스트 설정

Source: https://flarelane.com/ko/docs/sdk-integrations/disable-click-url-processing

manifest.xml 파일에 meta-data 태그를 추가하여 모든 알림의 URL 자동 처리를 비활성화합니다.

```xml
<application>
  # 1줄 코드 추가
  <meta-data android:name="flarelane_dismiss_launch_url" android:value="true" />
<application/>
```
Tokens:
Raw