Unity SDK - Airbridge Help Center

에어브릿지 유니티 SDK를 설치하고 필요한 설정을 추가할 수 있습니다.

유니티 SDK 설치하기

에어브릿지 유니티 SDK는 최소 2018.4 버전 이상의 유니티 버전을 필요로 합니다.

에어브릿지 유니티 SDK는 Unity Package Manager와 직접 설치, 두 가지 방법을 지원합니다. 설치한 이후에 유니티 SDK 테스트로 SDK가 정상적으로 설치됐는지 확인할 수 있습니다. 정책, 환경 등에 따라 GAID, IDFA 같은 디바이스 ID 수집에 제한이 필요할 수 있습니다. 제한된 SDK(Restricted SDK)를 설치하면 에어브릿지 SDK가 GAID, IDFA 같은 디바이스 ID를 수집하지 않습니다.

Unity Package Manager
직접 설치

Unity 상단 메뉴에서 Window > Package Manager 를 클릭합니다.
Package Manager 창 왼쪽 상단의 + 버튼을 클릭합니다.
Add package from git URL… 을 클릭합니다.
다음 URL을 입력하고 Install을 클릭합니다.
- https://github.com/ab180/airbridge-unity-sdk-deployment.git

디바이스 ID를 수집하지 않는 SDK를 설치하는 경우 다음 Restricted SDK URL을 입력하고 Install을 클릭합니다.

https://github.com/ab180/airbridge-unity-sdk-restricted-deployment

설치가 완료되면 유니티 상단에 Airbridge 탭이 표시됩니다.

SDK 초기화하기

SDK 설정하기의 App Name, App Token 에 올바른 값을 입력해 주세요. App Name과 App Token은 에어브릿지 대시보드의 [설정]>[토큰 관리]에서 확인할 수 있습니다.

SDK 설정하기

유니티 상단의 Airbridge > Airbridge Settings 를 클릭하시면 설정 화면을 확인 할 수 있습니다. 설정이 필요하지 않은 값은 키값을 생략해 주세요.

알립니다에어브릿지 유니티 SDK v4.2.0 이하의 경우 유니티 상단의 AB180 > Airbridge Settings 을 클릭하여주세요.

빌드 설정에 따른 SDK 설정 적용

알립니다에어브릿지 유니티 SDK 4.5.0 이상이 필요합니다.

에어브릿지 유니티 SDK는 유니티의 빌드 설정에 따라 서로 다른 설정을 적용할 수 있도록, Development와 Production 용으로 각각 별도의 입력 필드를 제공합니다. 자세한 사항은 빌드 설정에 따른 SDK 설정하기 를 참고 하세요.

설정값에 대한 가이드는 아래를 참고해 주세요.

설정값에 대한 가이드

설정값	가이드
App Name	SDK 초기화하기 에어브릿지 딥링크로 앱이 실행되도록 설정하기
App Token	SDK 초기화하기
Log Level	SDK 로그 확인하기
iOS URI Scheme	에어브릿지 딥링크로 앱이 실행되도록 설정하기
Android URI Scheme	에어브릿지 딥링크로 앱이 실행되도록 설정하기
Custom Domain	커스텀 도메인 설정하기
Session Timeout Seconds	인앱 이벤트 세션 설정하기
User Info Hash Enabled	유저 속성 해쉬화하기
Track Airbridge Link Only	에어브릿지 딥링크만 추적하기
Auto Start Tracking Enabled	옵트인(Opt-In) 설정하기 옵트아웃(Opt-Out) 설정하기
Facebook Deferred App Link Enabled	메타 디퍼드 앱 링크 설정하기
iOS Tracking Authorize Timeout Seconds	ATT 프롬프트 제공하기
SDK Signature Secret ID	SDK 시그니처 설정하기
SDK Signature Secret	SDK 시그니처 설정하기
Track In Session Life Cycle Event Enabled	세션내 생명주기 이벤트 수집하기
Clear Event Buffer On Initialize Enabled	전송되지 않은 이벤트 삭제하기
SDK Enabled	비활성화 상태로 에어브릿지 SDK 초기화하기
Event Buffer Count Limit	인앱 이벤트 저장 용량 설정하기
Event Buffer Size Limit In Gibibyte	인앱 이벤트 저장 용량 설정하기
Event Transmit Interval Seconds	인앱 이벤트 전송 주기 설정하기
Meta Install Referrer (Facebook App ID)	메타 인스톨 리퍼러 수집 설정
Is Handle Airbridge Deeplink Only	에어브릿지 딥링크만 전달받기
Tracking Blocklist	식별자 추적 제한하기
Calculate SKAdNetwork By Server Enabled	SKAdNetwork ConversionValue 계산을 서버에서 하기

ATT 프롬프트 제공하기

알립니다개인정보보호 정책 준수를 위해 필요한 기능은 법률 자문사와 함께 검토해야 합니다.

iOS 환경에서는 앱 추적 투명성(App Tracking Transparency, ATT) 프롬프트에서 정보 수집에 동의한 유저의 IDFA만 식별자로 수집할 수 있습니다. 유저가 ATT 프롬프트에서 정보 수집에 동의하는 시점까지 앱 설치 이벤트를 수집하는 것을 지연해야 합니다. IDFA는 앱 설치 이벤트와 함께 수집됩니다. 유저가 정보 수집에 동의하기 전에 앱 설치 이벤트를 수집하면 IDFA가 수집되지 않기 때문에 성과를 측정할 수 없습니다. 유저가 ATT 프롬프트에 동의하면 IDFA를 수집하도록 앱 설치 이벤트를 수집하는 시간을 설정하는 것을 권장합니다.

ATT 프롬프트에 사용하는 문구를 준비합니다.
애플 가이드에 따라 ATT 프롬프트를 설정해 주세요.
에어브릿지 유니티 SDK는 앱 설치 이벤트가 수집되지 않으면 앱이 실행되는 시점마다 유저가 정보 수집에 동의하기 전까지 30초 동안 앱 설치 이벤트의 수집을 지연합니다. 유저가 정보 수집의 동의 여부를 결정하기 전에 앱을 종료하면 앱 설치 이벤트를 수집하지 않고 다음에 앱이 실행되는 시점에 다시 시도합니다.

SDK 설정하기의 iOS Tracking Authorize Timeout Seconds 로 설치 이벤트 수집 지연 시간을 더 길게 설정할 수 있습니다. iOS Tracking Authorize Timeout Seconds 의 기본 설정은 30초입니다. 최대 3600초(1시간)까지 설정할 수 있습니다.

주의하세요앱 설치 이벤트의 수집을 지연하는 시간을 충분히 설정해야 합니다. 유저가 ATT 프롬프트에서 정보 수집에 동의하기 전에 앱 설치 이벤트를 수집하면 IDFA가 함께 수집되지 않습니다.

옵트인(Opt-In) 설정하기

알립니다필수 설정 기능이 아닙니다. 필요한 경우에만 설정해 주세요.

옵트인(Opt-In)은 유저가 동의하기 전에 유저 정보를 사용하지 않는 정책입니다. SDK 설정하기의 Auto Start Tracking Enabled를 false로 설정한 후에 이벤트를 수집할 수 있는 시점에 StartTracking 함수를 호출합니다. StartTracking 함수가 호출된 시점부터 이벤트를 수집합니다.

Airbridge.StartTracking();

옵트아웃(Opt-Out) 설정하기

알립니다필수 설정 기능이 아닙니다. 필요한 경우에만 설정해 주세요.

옵트아웃(Opt-Out)은 유저가 거부하기 전에 유저 정보를 사용하는 정책입니다. SDK 설정하기의 Auto Start Tracking Enabled를 true로 설정한 후에 이벤트를 수집할 수 없는 시점에 StopTracking 함수를 호출합니다. StopTracking 함수가 호출된 시점부터 이벤트를 수집하지 않습니다.

Airbridge.StopTracking();

SDK 시그니처 설정하기

알립니다필수 설정 기능이 아닙니다. 필요한 경우에만 설정해 주세요.

SDK 시그니처(SDK Signature)로 SDK 스푸핑(SDK Spoofing)을 방지해 정확성과 안전성이 검증된 이벤트만 광고 성과 측정에 사용할 수 있습니다. SDK 시그니처 설정에 SDK 시그니처 보안 정보가 필요합니다. SDK 시그니처 보안 정보에는 시크릿 ID와 시크릿이 있습니다. 필요한 SDK 시그니처 보안 정보는 에어브릿지 대시보드에서 확인할 수 있습니다. SDK 시그니처 보안 정보에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

SDK 설정하기의 SDK Signature Secret ID 를 입력해주세요.
SDK 설정하기의 SDK Signature Secret 을 입력해주세요.

SDK 시그니처 설정에 필요한 SDK 시그니처 보안 정보는 아래와 같습니다.

SDK Signature Secret ID : 시크릿 ID. 에어브릿지 대시보드 [규칙 관리]>[광고사기 검증 규칙]>[SDK 시그니처]>[SDK 시그니처 보안 정보]에서 확인할 수 있습니다.
SDK Signature Secret : 시크릿. 에어브릿지 대시보드 [규칙 관리]>[광고사기 검증 규칙]>[SDK 시그니처]>[SDK 시그니처 보안 정보]에서 확인할 수 있습니다.

딥링크

딥링크를 설정하면 트래킹 링크가 있는 광고를 클릭한 유저를 원하는 앱의 특정 페이지로 이동시킬 수 있습니다. 또한 트래킹 링크로 수집된 정보를 바탕으로 딥링크를 통해서 발생한 성과를 에어브릿지에서 확인할 수 있습니다.

에어브릿지의 딥링크 작동 방식

에어브릿지는 트래킹 링크가 열릴 때, 트래킹 링크에 설정된 스킴 딥링크를 유저의 환경에 따라 최적인 형태의 에어브릿지 딥링크(HTTP 딥링크 또는 스킴 딥링크)로 변환하여 유저를 앱으로 이동시킵니다. 그리고 에어브릿지 SDK가 에어브릿지 딥링크를 트래킹 링크에 설정된 스킴 딥링크로 다시 변환하여 앱에 전달합니다.

트래킹 링크에 설정된 스킴 딥링크 예시: YOUR_SCHEME://product/12345
에어브릿지 딥링크 예시
- HTTP 딥링크 형태 1: https://YOUR_APP_NAME.airbridge.io/~~~
- HTTP 딥링크 형태 2: https://YOUR_APP_NAME.abr.ge/~~~
- 스킴 딥링크 형태: YOUR_SCHEME://product/12345?airbridge_referrer=~~~

앱이 설치된 상태에서 유저가 트래킹 링크를 열면 에어브릿지 딥링크로 앱이 열립니다. 그리고 에어브릿지 SDK는 해당 에어브릿지 딥링크를 트래킹 링크에 설정되어 있는 스킴 딥링크로 변환한 후에 이를 앱에 전달합니다. 앱이 설치되어 있지 않은 상태에서 유저가 트래킹 링크를 열면 SDK는 에어브릿지 딥링크를 저장합니다. 유저가 앱스토어 또는 웹 사이트로 이동하여 앱 설치 후 앱을 실행하면 에어브릿지 SDK는 저장한 에어브릿지 딥링크를 트래킹 링크에 설정된 스킴 딥링크로 변환한 후에 이를 앱에 전달합니다.

딥링크 설정하기

딥링크를 설정합니다. 에어브릿지 대시보드에서 설정한 정보와 유저가 이동하는 목적지로 사용되는 앱 페이지 주소가 필요합니다. 먼저 에어브릿지에 딥링크 정보를 등록합니다.

에어브릿지에 딥링크 정보 등록하기

에어브릿지 대시보드 [트래킹 링크]>[딥링크]에서 딥링크에 필요한 정보를 등록해야 합니다.

iOS

iOS 환경에서 필요한 딥링크 정보는 아래와 같습니다.

iOS URI 스킴: iOS URI 스킴을 기준으로 에어브릿지 딥링크를 스킴 딥링크로 변환합니다. URI 스킴에 필요한 딥링크 정보입니다.
iOS 앱 ID: iOS 앱 ID를 기준으로 에어브릿지 딥링크의 유니버셜 링크 도메인을 설정합니다. 유니버셜 링크에 필요한 딥링크 정보입니다.

에어브릿지에 딥링크 정보를 등록해 주세요.

에어브릿지 대시보드의 [트래킹 링크]>[딥링크]로 이동합니다.
[iOS URI 스킴]에 iOS URI 스킴을 입력합니다. ://와 함께 입력해야 합니다. 예를 들어 iOS URI 스킴이 demo면 demo://와 같이 입력합니다.
애플 개발자 대시보드에서 딥링크를 설정하는 앱의 [Identifier]으로 이동합니다. App ID Prefix, Bundle ID를 확인합니다.
iOS 앱 ID는 App ID Prefix+ .+ Bundle ID 형식입니다. 에어브릿지 대시보드의 [트래킹 링크]>[딥링크]에서 [iOS App ID]에 iOS 앱 ID를 입력합니다.

예를 들어 App ID Prefix가 prefix이고 Bundle ID가 example이면 iOS 앱 ID는 prefix.example입니다.

안드로이드

안드로이드 환경에서 필요한 딥링크 정보는 아래와 같습니다.

안드로이드 URI 스킴: 안드로이드 URI 스킴을 기준으로 에어브릿지 딥링크를 스킴 딥링크로 변환합니다. 앱 링크와 URI 스킴에 필요한 딥링크 정보입니다.
패키지 이름: 안드로이드 앱을 식별합니다. 앱 링크와 URI 스킴에 필요한 딥링크 정보입니다.
Android sha256_cert_fingerprints: 앱 링크 도메인을 설정하는 기준입니다. 앱 링크에 필요한 딥링크 정보입니다.

주의하세요실제 출시 앱과 개발용 앱의 딥링크 정보를 다르게 등록해야 유저를 정상적으로 이동 시킬 수 있습니다.

구글 플레이의 Play App Signing이 적용된 앱은 개발자가 서명한 APK를 구글 서버가 재서명하여 배포합니다. 이 과정에서 Android sha256_cert_fingerprints 가 달라지기 때문에, 에어브릿지에는 로컬 키스토어가 아닌 구글 플레이 콘솔의 최종 서명 값을 등록해야 App Links가 정상 동작합니다.서명 방식에 따라 에어브릿지에 안드로이드 URI 스킴, 패키지 이름과 Android sha256_cert_fingerprints를 등록해 주세요.

Play App signing
자체 서명

에어브릿지 대시보드의 [트래킹 링크]>[딥링크]⁠로 이동합니다.
안드로이드 URI 스킴에 Android URI 스킴을 입력합니다. ://와 함께 입력해야 합니다. 예를 들어 Android URI 스킴이 demo면 demo://와 같이 입력합니다.
패키지 이름에 패키지 이름을 입력합니다.
구글 플레이 콘솔에 접속해서 대상 앱을 선택합니다.
[앱 무결성] 으로 이동합니다.
앱 서명 키 인증서 섹션에서 앱 서명 키 인증서 값을 복사합니다.

알립니다반드시 올바른 섹션에서 복사하세요. 이 페이지에는 두 가지 인증서 정보가 있습니다.

앱 서명 키 인증서 ← 이 값을 사용
업로드 키 인증서 ← 이 값은 절대 사용 금지

두 값은 서로 다르며, 업로드 키 값을 등록하면 App Links가 동작하지 않습니다.

[sha256_cert_fingerprints]에 확인한 SHA256 값을 입력합니다.

에어브릿지 대시보드의 [트래킹 링크]>[딥링크]⁠로 이동합니다.
안드로이드 URI 스킴에 Android URI 스킴을 입력합니다. ://와 함께 입력해야 합니다. 예를 들어 Android URI 스킴이 demo면 demo://와 같이 입력합니다.
패키지 이름에 패키지 이름을 입력합니다.
sha256_cert_fingerprints를 확인해야 합니다. 배포하는 keystore 파일에서 아래 명령을 실행합니다.

keytool -J-Duser.language=en -list -v -keystore YOUR_KEYSTORE.keystore

결과에서 SHA256 값을 확인합니다. SHA256 값이 sha256_cert_fingerprints입니다.

Certificate fingerprints:
    MD5:  4C:65:04:52:F0:3F:F8:65:08:D3:71:86:FC:EF:C3:49
    SHA1: C8:BF:B7:B8:94:EA:5D:9D:38:59:FE:99:63:ED:47:B2:D9:5A:4E:CC
    SHA256: B5:EF:4D:F9:DC:95:E6:9B:F3:9A:5E:E9:D6:E0:D8:F6:7B:AB:79:C8:78:67:34:D9:A7:01:AB:6A:86:01:0E:99

sha256_cert_fingerprints에 확인한 SHA256 값을 입력합니다.

에어브릿지에 딥링크 정보를 등록한 후에 앱에 딥링크를 설정해야 합니다. 앱에서 딥링크를 위해 필요한 개발은 아래와 같습니다.

에어브릿지 딥링크로 앱이 실행되도록 설정합니다.
앱에서 에어브릿지 딥링크를 수집합니다.
에어브릿지 딥링크로 유저를 이동시킵니다.

아래 내용을 참고해 주세요.

에어브릿지 딥링크로 앱이 실행되도록 설정하기

유저가 트래킹 링크를 클릭한 후에 앱이 에어브릿지 딥링크로 실행되도록 설정합니다.

iOS

SDK 설정하기의 iOS URI Scheme 필드에 에어브릿지 대시보드의 [트래킹 링크]>[딥링크] 페이지에 입력한 iOS URI 스킴을 입력하세요. 유니버셜 링크 도메인은 SDK 설정하기의 App Name 설정 값으로 자동으로 설정됩니다.

Android

SDK 설정하기의 Android URI Scheme 필드에 에어브릿지 대시보드의 [트래킹 링크]>[딥링크] 페이지에 입력한 안드로이드 URI 스킴을 입력하세요. 앱 링크(App Links)는 SDK 설정하기의 App Name 설정 값으로 자동으로 설정됩니다.

앱에서 딥링크 이벤트 수집하기

알립니다다음 설정은 자동으로 적용됩니다. iOS의 경우 Unity Engine 2022.3.72 미만의 버전에서 커스텀 App Controller를 사용하거나, Android에서 커스텀 안드로이드 액티비티를 사용하고 있을 경우에만 자동으로 적용되지 않으니 수동으로 적용해 주세요.

iOS

Unity Engine 2022.3.72 이상에서는 SceneDelegate가 자동으로 수집되고 있습니다. Unity Engine 2022.3.72 미만의 버전은 AppController의 AppDelegate(Assets/Plugins/Airbridge/iOS/Delegate/AUAppController.mm)를 통해서 딥링크를 수집하고 있습니다. 사용자가 커스텀 AppDelegate를 사용하고 있을 경우, 해당 커스텀 AppDelegate에 아래와 같은 코드를 추가해 주세요.

#import "UnityAppController.h"
#import "AirbridgeUnityDelegate.h"

@interface YourAppController : UnityAppController

@end

@implementation YourAppController

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary<UIApplicationLaunchOptionsKey,id> *)launchOptions {
    [AirbridgeUnityDelegate instance];
    return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    [super application:app openURL:url options:options];
    return [AirbridgeUnityDelegate trackDeeplinkWithURL:url];
}

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>>* _Nullable))restorationHandler {
    [super application:application continueUserActivity:userActivity restorationHandler:restorationHandler];
    return [AirbridgeUnityDelegate trackDeeplinkWithUserActivity:userActivity];
}

@end

IMPL_APP_CONTROLLER_SUBCLASS(AppController)

안드로이드

에어브릿지 유니티는 안드로이드 액티비티(Assets/Plugins/Airbridge/Android/java/co/ab180/airbridge/unity/AirbridgeActivity.java)를 사용하고 있습니다. 사용자가 이미 커스텀 액티비티를 사용하고 있을 경우, 해당 커스텀 액티비티에 아래와 같은 코드를 추가해 주세요.

import co.ab180.airbridge.unity.AirbridgeUnity

override fun onResume() {
    super.onResume()
    AirbridgeUnity.processHandleDeeplink(intent)
}

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    setIntent(intent)
}

import co.ab180.airbridge.unity.AirbridgeUnity;

@Override
protected void onResume() {
    super.onResume();
    AirbridgeUnity.processHandleDeeplink(getIntent());
}

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
}

수집한 에어브릿지 딥링크로 유저를 이동시키기

에어브릿지 딥링크가 실행되면 스킴 딥링크로 변환되어 onDeeplinkReceived 콜백에 전달됩니다. 그리고 에어브릿지 딥링크가 아닌 딥링크가 실행되면 변환없이 그대로 콜백에 전달됩니다.
전달받은 딥링크를 활용해 유저를 설정한 목적지로 보냅니다.

Airbridge.SetOnDeeplinkReceived((string deeplink) =>
{
    // show proper content using url
});

디퍼드 딥링크 설정하기

앱이 설치되지 않은 상태에서 디퍼드 딥링크를 설정한 트래킹 링크를 클릭하면 에어브릿지 딥링크를 저장합니다. 디퍼드 딥링크를 설정하면 에어브릿지 SDK는 아래와 같은 방식으로 딥링크를 획득합니다.

에어브릿지 SDK의 디퍼드 딥링크 획득 방식

에어브릿지 SDK는 SDK 초기화 이후에 아래 조건을 모두 만족하면 딥링크 획득을 시도합니다. 획득 도중에 앱이 종료되면 에어브릿지 SDK는 저장된 에어브릿지 딥링크가 없는 것으로 처리합니다.

옵트인(Opt-In)을 설정한 상태에서 Airbridge.StartTracking 함수를 호출합니다. 또는 옵트인을 설정하지 않았습니다.
ATT 추적 동의 여부가 결정되었습니다. 또는 ATT 프롬프트에서 설정한 이벤트 수집 지연 시간이 종료되었습니다.

디퍼드 딥링크는 자동으로 onDeeplinkReceived 콜백에 전달되기 때문에 별도의 설정을 하지 않아도 됩니다.

커스텀 도메인 설정하기

알립니다필수 설정 기능이 아닙니다. 필요한 경우에만 설정해 주세요.

유저가이드를 참고해서 대시보드에 커스텀 도메인을 설정하세요.
SDK 설정하기의 Custom Domain 필드에 커스텀 도메인 주소를 입력한 후, Add URL 버튼을 클릭하세요.

주의하세요추가한 커스텀 도메인은 Airbridge 대시보드에 설정된 정보와 일치해야 합니다.

인앱 이벤트

에어브릿지 SDK가 서비스에서 발생한 유저의 특정 행동을 설정에 따라 수집한 후에 인앱 이벤트로 전송합니다.

에어브릿지 이벤트 살펴보기 (유저 가이드)

인앱 이벤트 전송하기

하이브리드 앱 설정하기하이브리드 앱에서 웹 사이트 코드를 변경하지 않아도 인앱 웹 사이트에서 발생하는 에어브릿지 관련 작업을 유니티 SDK가 처리하도록 설정할 수 있습니다.

하이브리드 앱 설정하기 (v4)

이벤트를 전송하기 위해서는 Airbridge.TrackEvent 함수를 호출해야 합니다. Airbridge.TrackEvent 함수 구성 요소의 필수 여부와 타입은 아래와 같습니다.

public static void TrackEvent(
    string category,
    Dictionary<string, object> semanticAttributes = null,
    Dictionary<string, object> customAttributes = null
)

이름	필수 여부	타입	설명
category	필수	String	이벤트의 이름
semanticAttributes	선택	Dictionary<string, object>	이벤트의 시맨틱 어트리뷰트
customAttributes	선택	Dictionary<string, object>	이벤트의 커스텀 어트리뷰트

각 구성요소의 정의와 사용할 수 있는 문자열을 아래에서 확인해 주세요.

카테고리

AirbridgeCategory에서 에어브릿지 SDK가 제공하는 스탠다드 이벤트 카테고리를 확인할 수 있습니다. 또는 스탠다드 이벤트 목록에서 확인한 이벤트 카테고리를 입력합니다.

스탠다드 이벤트 목록

커스텀 이벤트는 이벤트 택소노미에서 정한 이벤트 이름을 입력하면 전송할 수 있습니다.아래 예시를 참고해 주세요.

// track standard event (provided by sdk)
Airbridge.TrackEvent(AirbridgeCategory.ORDER_COMPLETED);
// track standard event (not provided by sdk)
Airbridge.TrackEvent("airbridge.ecommerce.order.canceled");
// track custom event
Airbridge.TrackEvent("eventViewed");

어트리뷰트

주의하세요에어브릿지 SDK v4의 어트리뷰트는 이전 버전과 다릅니다. 이전 버전의 어트리뷰트에는 액션, 라벨, 밸류가 포함되지 않습니다.

어트리뷰트로 이벤트의 추가 정보를 수집할 수 있습니다.

액션, 라벨: 에어브릿지 리포트에서 그룹바이로 활용할 수 있는 정보를 수집합니다.
밸류: 매출 분석에 활용하는 정보를 수집합니다. 수집한 데이터는 자유롭게 사칙연산에 활용할 수 있습니다.
시맨틱 어트리뷰트: 에어브릿지가 미리 정의한 어트리뷰트입니다.
커스텀 어트리뷰트: 에어브릿지 사용자가 정의한 어트리뷰트입니다.

Airbridge.TrackEvent 함수의 semanticAttributes 파라미터를 통해 액션, 라벨, 밸류, 시맨틱 어트리뷰트를 입력하고 customAttributes 파라미터를 통해 커스텀 어트리뷰트를 입력할 수 있습니다.에어브릿지가 제공하는 시맨틱 어트리뷰트 목록은 아래에서 확인할 수 있습니다.

시맨틱 어트리뷰트 목록

아래 예시를 참고해 주세요.

Airbridge.TrackEvent(
    category: AirbridgeCategory.ORDER_COMPLETED,
    semanticAttributes: new Dictionary<string, object>()
    {
        // action
        { AirbridgeAttribute.ACTION, "Tool" },
        // label
        { AirbridgeAttribute.LABEL, "Hammer" },
        // value
        { AirbridgeAttribute.VALUE, 10 },
        // semantic attribute (provided by sdk)
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    // semantic attribute value (provided by sdk)
                    { AirbridgeAttribute.PRODUCT_ID, "12345" },
                    // semantic attribute value (not provided by sdk)
                    { "name", "PlasticHammer" },
                },
            }
        },
        // semantic attribute (not provided by sdk)
        { "totalQuantity", 1 }
    },
    customAttributes: new Dictionary<string, object>()
    {
        // custom attribute
        { "promotion", "FirstPurchasePromotion" }
    }
);

주의하세요시멘틱 어트리뷰트와 커스텀 어트리뷰트는 JSON만 데이터 타입으로 허용합니다.

JSON 타입: String, Number, Boolean, Object<String, JSON>, Array<JSON>
시멘틱 어트리뷰트와 커스텀 어트리뷰트에 사용할 수 없는 타입: Struct, Class 등

SDK가 제공하는 스탠다드 이벤트 카테고리와 시맨틱 어트리뷰트는 아래와 같습니다.

SDK가 제공하는 스탠다드 이벤트 카테고리(AirbridgeCategory)

키	데이터
SIGN_UP	airbridge.user.signup
SIGN_IN	airbridge.user.signin
SIGN_OUT	airbridge.user.signout
HOME_VIEWED	airbridge.ecommerce.home.viewed
PRODUCT_LIST_VIEWED	airbridge.ecommerce.productList.viewed
SEARCH_RESULTS_VIEWED	airbridge.ecommerce.searchResults.viewed
PRODUCT_VIEWED	airbridge.ecommerce.product.viewed
ADD_PAYMENT_INFO	airbridge.addPaymentInfo
ADD_TO_WISHLIST	airbridge.addToWishlist
ADDED_TO_CART	airbridge.ecommerce.product.addedToCart
INITIATE_CHECKOUT	airbridge.initiateCheckout
ORDER_COMPLETED	airbridge.ecommerce.order.completed
ORDER_CANCELED	airbridge.ecommerce.order.canceled
START_TRIAL	airbridge.startTrial
SUBSCRIBE	airbridge.subscribe
UNSUBSCRIBE	airbridge.unsubscribe
AD_IMPRESSION	airbridge.adImpression
AD_CLICK	airbridge.adClick
COMPLETE_TUTORIAL	airbridge.completeTutorial
ACHIEVE_LEVEL	airbridge.achieveLevel
UNLOCK_ACHIEVEMENT	airbridge.unlockAchievement
RATE	airbridge.rate
SHARE	airbridge.share
SCHEDULE	airbridge.schedule
SPEND_CREDITS	airbridge.spendCredits

SDK가 제공하는 시맨틱 어트리뷰트(AirbridgeAttribute)

키	데이터	데이터 형식
ACTION	action	string
LABEL	label	string
VALUE	value	float
CURRENCY	currency	string
PRODUCTS	products	array
PRODUCT_ID	productID	string
PRODUCT_NAME	name	string
PRODUCT_PRICE	price	float
PRODUCT_QUANTITY	quantity	int
PRODUCT_CURRENCY	currency	string
PRODUCT_POSITION	position	int
PRODUCT_CATEGORY_ID	categoryID	string
PRODUCT_CATEGORY_NAME	categoryName	string
PRODUCT_BRAND_ID	brandID	string
PRODUCT_BRAND_NAME	brandName	string
PERIOD	period	string
IS_RENEWAL	isRenewal	boolean
RENEWAL_COUNT	renewalCount	int
PRODUCT_LIST_ID	productListID	string
CART_ID	cartID	string
TRANSACTION_ID	transactionID	string
TRANSACTION_TYPE	transactionType	string
TRANSACTION_PAIRED_EVENT_CATEGORY	transactionPairedEventCategory	string
TRANSACTION_PAIRED_EVENT_TIMESTAMP	transactionPairedEventTimestamp	int
TOTAL_QUANTITY	totalQuantity	int
QUERY	query	string
IN_APP_PURCHASED	inAppPurchased	boolean
CONTRIBUTION_MARGIN	contributionMargin	float
LIST_ID	listID	string
RATE_ID	rateID	string
RATE	rate	float
MAX_RATE	maxRate	float
ACHIEVEMENT_ID	achievementID	string
SHARED_CHANNEL	sharedChannel	string
DATE_TIME	datetime	string
DESCRIPTION	description	string
IS_REVENUE	isRevenue	boolean
PLACE	place	string
SCHEDULE_ID	scheduleID	string
TYPE	type	string
LEVEL	level	string
SCORE	score	float
AD_PARTNERS	adPartners	array
IS_FIRST_PER_USER	isFirstPerUser	boolean

아래 데이터 유형별 예시 코드를 참고해 주세요.

Airbridge.TrackEvent(
    category: "event",
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 10 },
    },
    customAttributes: new Dictionary<string, object>()
    {
        { "string", "string" },
        { "number", 1000 },
        { "boolean", true },
        {
            "object", new Dictionary<string, object>()
            {
                { "key", "value" }
            }
        },
        { "array", new List<object>() { "value" } },
    }
);

인앱 이벤트 추가 설정하기

알립니다설정하지 않아도 기본 설정이 적용되어 있습니다. 추가 설정 필요한지 검토한 후에 진행해 주세요.

전송하는 인앱 이벤트에 필요한 설정을 추가할 수 있습니다.

인앱 이벤트 세션 설정하기

에어브릿지 SDK는 이벤트 데이터에 세션 정보를 포함하여 전송합니다.앱이 백그라운드로 전환되거나 프로세스가 종료되면 백그라운드 진입 시간이 기록되고, 앱이 포그라운드로 전환되거나 프로세스가 실행되면 재진입 시간이 기록됩니다. 마지막 백그라운드 진입 시간과 재진입 시간의 차이가 세션 만료 시간보다 길 경우, 이전 세션은 종료되고 새로운 세션이 시작됩니다.기본 세션 타임아웃은 300초(5분)입니다. SDK 설정하기의 Session Timeout Seconds 를 활용하면 이 값을 최대 604,800초(7일)까지 변경할 수 있습니다.

주의하세요에어브릿지 SDK는 새로운 세션을 시작하는 실행(Open), 포어그라운드(Foregroud) 이벤트는 수집합니다. 세션이 유지되는 중에는 해당 이벤트를 수집하지 않습니다. 해당 이벤트를 세션 유지 중에 수집하기 위해서는 추가 설정이 필요합니다.

인앱 이벤트 전송 주기 설정하기

기본 이벤트 전송 주기는 0초입니다. SDK 설정하기의 Event Transmit Interval Seconds 를 이용하면 최대 86,400초(1일)까지 설정할 수 있습니다.

인앱 이벤트 저장 용량 설정하기

SDK가 저장할 수 있는 이벤트 개수와 이벤트 저장 용량의 기본 및 최대 설정값은 다음과 같습니다.

	이벤트 개수	저장 용량
기본값	INT_MAX	1024 GiB(기비바이트)
최대값	INT_MAX	1024 GiB(기비바이트)

SDK 설정하기의 Event Buffer Count Limit 로 이벤트 개수를 제한할 수 있고, Event Buffer Size Limit In Gibibyte 로 이벤트 저장 용량을 제한할 수 있습니다.

전송되지 않은 이벤트 삭제하기

이벤트 삭제 옵션을 활성화하면 에어브릿지 SDK 초기화 과정에서 전송되지 않고 저장된 인앱 이벤트를 모두 삭제합니다. 기본 이벤트 삭제 옵션은 비활성화입니다.SDK 설정하기의 Clear Event Buffer On Initialize Enabled 를 true로 설정하면 이벤트 삭제 옵션이 활성화됩니다.

디바이스 식별자 설정하기

에어브릿지 SDK는 디바이스 식별자를 모든 이벤트에 포함해 전송하는 기능을 지원합니다.

함수	설명
`Airbridge.SetDeviceAlias`	디바이스 식별자를 추가로 입력합니다. 최대 10개 입력할 수 있습니다. - key: 최대 128자입니다. `^[a-zA-Z_][a-zA-Z0-9_]*$` 정규식을 만족해야 합니다. - value: 최대 128자입니다.
`Airbridge.RemoveDeviceAlias`	지정한 디바이스 식별자를 삭제합니다.
`Airbridge.ClearDeviceAlias`	디바이스 식별자를 모두 삭제합니다.

아래 예시를 참고해 주세요.

Airbridge.SetDeviceAlias("string", "string");
Airbridge.RemoveDeviceAlias("string");
Airbridge.ClearDeviceAlias();

인앱 이벤트 예시 코드

에어브릿지가 수집하는 주요 인앱 이벤트는 스탠다드 이벤트와 커스텀 이벤트입니다. 스탠다드 이벤트는 에어브릿지가 정의한 이벤트입니다. 아래 예시 코드를 참고해 주세요.

회원가입, 로그인, 로그아웃, 홈화면 조회, 상품리스트 조회

회원가입

Airbridge.SetUserID("string");
Airbridge.SetUserAlias("string", "string");
Airbridge.SetUserEmail("string");
Airbridge.SetUserPhone("string");
Airbridge.SetUserAttribute("string", "string");
        
Airbridge.TrackEvent(AirbridgeCategory.SIGN_UP);

로그아웃

Airbridge.TrackEvent(AirbridgeCategory.SIGN_OUT);

Airbridge.ClearUser();

홈화면 조회

Airbridge.TrackEvent(AirbridgeCategory.HOME_VIEWED);

상품리스트 조회

Airbridge.TrackEvent(
    category: AirbridgeCategory.PRODUCT_LIST_VIEWED,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.LIST_ID, "84e6e236-38c4-48db-9b49-16e4cc064386" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "d6ab2fbe-decc-4362-b719-d257a131e91e" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticFork" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 1 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

검색결과 조회, 상품상세페이지 조회, 결제수단 등록, 위시리스트 추가, 장바구니 담기

검색결과 조회

Airbridge.TrackEvent(
    category: AirbridgeCategory.SEARCH_RESULTS_VIEWED,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.QUERY, "Plastic" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "d6ab2fbe-decc-4362-b719-d257a131e91e" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticFork" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 1 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

상품상세페이지 조회

Airbridge.TrackEvent(
    category: AirbridgeCategory.PRODUCT_VIEWED,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

결제수단 등록

Airbridge.TrackEvent(
    category: AirbridgeCategory.ADD_PAYMENT_INFO,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.TYPE, "CreditCard" },
    }
);

위시리스트 추가

Airbridge.TrackEvent(
    category: AirbridgeCategory.ADD_TO_WISHLIST,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.LIST_ID, "189a2f8b-83ee-4074-8158-726be54e57d4" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

장바구니 담기

Airbridge.TrackEvent(
    category: AirbridgeCategory.ADDED_TO_CART,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.CART_ID, "421eaeb7-6e80-4694-933e-f2e1a55e9cbd" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

결제 시작, 구매 완료, 구매 취소, 체험판 시작, 구독, 구독 취소

결제 시작

Airbridge.TrackEvent(
    category: AirbridgeCategory.INITIATE_CHECKOUT,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.TRANSACTION_ID, "0a7ee1ec-33da-4ffb-b775-89e80e75978a" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "d6ab2fbe-decc-4362-b719-d257a131e91e" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticFork" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 1 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

구매 완료

Airbridge.TrackEvent(
    category: AirbridgeCategory.ORDER_COMPLETED,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 11 },
        { AirbridgeAttribute.TRANSACTION_ID, "8065ef16-162b-4a82-b683-e51aefdda7d5" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        { AirbridgeAttribute.IN_APP_PURCHASED, true },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "d6ab2fbe-decc-4362-b719-d257a131e91e" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticFork" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 1 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

구매 취소

Airbridge.TrackEvent(
    category: AirbridgeCategory.ORDER_CANCELED,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 11 },
        { AirbridgeAttribute.TRANSACTION_ID, "8065ef16-162b-4a82-b683-e51aefdda7d5" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        { AirbridgeAttribute.IN_APP_PURCHASED, true },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "d6ab2fbe-decc-4362-b719-d257a131e91e" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticFork" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 1 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

체험판 시작

Airbridge.TrackEvent(
    category: AirbridgeCategory.START_TRIAL,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.TRANSACTION_ID, "ef1e5271-0370-407c-b1e9-669a8df1dc2c" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        { AirbridgeAttribute.PERIOD, "P1M" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "306a57cb-f653-4220-a208-8405d8e4d506" },
                    { AirbridgeAttribute.PRODUCT_NAME, "MusicStreamingMembership" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 15 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

Airbridge.TrackEvent(
    category: AirbridgeCategory.SUBSCRIBE,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 15 },
        { AirbridgeAttribute.CURRENCY, "USD" },
        { AirbridgeAttribute.TRANSACTION_ID, "cbe718c7-e44e-4707-b5cd-4a6a29f29649" },
        { AirbridgeAttribute.PERIOD, "P1M" },
        { AirbridgeAttribute.IS_RENEWAL, true },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "306a57cb-f653-4220-a208-8405d8e4d506" },
                    { AirbridgeAttribute.PRODUCT_NAME, "MusicStreamingMembership" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 15 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

구독 취소

Airbridge.TrackEvent(
    category: AirbridgeCategory.UNSUBSCRIBE,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 15 },
        { AirbridgeAttribute.CURRENCY, "USD" },
        { AirbridgeAttribute.TRANSACTION_ID, "cbe718c7-e44e-4707-b5cd-4a6a29f29649" },
        { AirbridgeAttribute.IS_RENEWAL, true },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "306a57cb-f653-4220-a208-8405d8e4d506" },
                    { AirbridgeAttribute.PRODUCT_NAME, "MusicStreamingMembership" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 15 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" },
                },
            }
        }
    }
);

광고 노출, 광고 클릭, 튜토리얼 완료, 레벨 달성, 과제 달성

광고 노출

Airbridge.TrackEvent(
    category: AirbridgeCategory.AD_IMPRESSION,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 0.01 },
        {
            AirbridgeAttribute.AD_PARTNERS, new Dictionary<string, object>()
            {
                {
                    "mopub", new Dictionary<string, object>()
                    {
                        { "app_version", "5.18.0" },
                        { "adunit_id", "12345" },
                        { "adunit_name", "12345" },
                        { "adunit_format", "Banner" },
                        { "id", "12345" },
                        { "currency", "USD" },
                        { "publisher_revenue", 12345.123 },
                        { "adgroup_id", "12345" },
                        { "adgroup_name", "12345" },
                        { "adgroup_type", "12345" },
                        { "adgroup_priority", "12345" },
                        { "country", "kr" },
                        { "precision", "publisher_defined" },
                        { "network_name", "12345" },
                        { "network_placement_id", "12345" },
                        { "demand_partner_data", "12345" },
                    }
                }
            }
        },
    }
);

광고 클릭

Airbridge.TrackEvent(
    category: AirbridgeCategory.AD_CLICK,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 0.01 },
        {
            AirbridgeAttribute.AD_PARTNERS, new Dictionary<string, object>()
            {
                {
                    "mopub", new Dictionary<string, object>()
                    {
                        { "app_version", "5.18.0" },
                        { "adunit_id", "12345" },
                        { "adunit_name", "12345" },
                        { "adunit_format", "Banner" },
                        { "id", "12345" },
                        { "currency", "USD" },
                        { "publisher_revenue", 12345.123 },
                        { "adgroup_id", "12345" },
                        { "adgroup_name", "12345" },
                        { "adgroup_type", "12345" },
                        { "adgroup_priority", "12345" },
                        { "country", "kr" },
                        { "precision", "publisher_defined" },
                        { "network_name", "12345" },
                        { "network_placement_id", "12345" },
                        { "demand_partner_data", "12345" },
                    }
                }
            }
        },
    }
);

튜토리얼 완료

Airbridge.TrackEvent(
    category: AirbridgeCategory.COMPLETE_TUTORIAL,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.DESCRIPTION, "Finish Initial Tutorial" },
    }
);

레벨 달성

Airbridge.TrackEvent(
    category: AirbridgeCategory.ACHIEVE_LEVEL,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.LEVEL, 13 },
    }
);

과제 달성

Airbridge.TrackEvent(
    category: AirbridgeCategory.UNLOCK_ACHIEVEMENT,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.ACHIEVEMENT_ID, "36a0f0bb-b153-4be1-a3e0-3cb5b2b076c1" },
        { AirbridgeAttribute.DESCRIPTION, "Get Score Over 50" },
        { AirbridgeAttribute.SCORE, 80 },
    }
);

평가, 공유, 일정 예약, 크레딧 사용

평가

Airbridge.TrackEvent(
    category: AirbridgeCategory.RATE,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.RATE_ID, "531c64b3-4704-4780-a306-89014ec18daf" },
        { AirbridgeAttribute.RATE, 4.5 },
        { AirbridgeAttribute.MAX_RATE, 5 },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_QUANTITY, 1 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

Airbridge.TrackEvent(
    category: AirbridgeCategory.SHARE,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.DESCRIPTION, "Share Promotion" },
        { AirbridgeAttribute.SHARED_CHANNEL, "CopyLink" },
    }
);

일정 예약

Airbridge.TrackEvent(
    category: AirbridgeCategory.SCHEDULE,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.SCHEDULE_ID, "75712915-2cd9-4e42-a85e-8d42f356f4c6" },
        { AirbridgeAttribute.DATE_TIME, "2024-01-01T00:00:00+00:00" },
        { AirbridgeAttribute.PLACE, "ConferenceRoom" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "abb3e65d-17bc-4b28-89e3-5e356c0ea697" },
                    { AirbridgeAttribute.PRODUCT_NAME, "ConferenceRoom" },
                },
            }
        }
    }
);

크레딧 사용

Airbridge.TrackEvent(
    category: AirbridgeCategory.SPEND_CREDITS,
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.TRANSACTION_ID, "22eb193d-be11-4fe4-95da-c91a196faf1c" },
        { AirbridgeAttribute.CURRENCY, "USD" },
        {
            AirbridgeAttribute.PRODUCTS, new List<object>()
            {
                new Dictionary<string, object>()
                {
                    { AirbridgeAttribute.PRODUCT_ID, "0117b32a-5a6c-4d4c-b64c-7858e07dba78" },
                    { AirbridgeAttribute.PRODUCT_NAME, "PlasticHammer" },
                    { AirbridgeAttribute.PRODUCT_PRICE, 10 },
                    { AirbridgeAttribute.PRODUCT_CURRENCY, "USD" }
                },
            }
        }
    }
);

커스텀 이벤트는 앱 서비스에 맞는 광고 성과를 추적하기 위해 스탠다드 이벤트에 해당하지 않는 유저의 행동을 새로 정의한 이벤트입니다. 아래 예시 코드를 참고해 주세요.

Airbridge.TrackEvent(
    category: "event",
    semanticAttributes: new Dictionary<string, object>()
    {
        { AirbridgeAttribute.VALUE, 10 },
    },
    customAttributes: new Dictionary<string, object>()
    {
        { "string", "string" },
        { "number", 1000 },
        { "boolean", true },
        {
            "object", new Dictionary<string, object>()
            {
                { "key", "value" }
            }
        },
        { "array", new List<object>() { "value" } },
    }
);

유저 정보

유저 정보를 이벤트에 포함해 전송합니다. 해당 유저 정보를 바탕으로 웹과 앱에서 발생한 광고 성과를 더 정확하게 분석할 수 있습니다.

유저 ID 설정하기

유저 ID는 서비스에서 활용하는 유저 식별자입니다. 유저 ID는 유저를 웹과 앱에서 하나의 유저로 특정할 수 있는 고유한 ID이어야 합니다.

함수	설명
`Airbridge.SetUserID`	유저 ID를 입력합니다.
`Airbridge.ClearUserID`	유저 ID를 삭제합니다.
`Airbridge.SetUserAlias`	유저 식별자를 추가로 입력합니다. 최대 10개 입력할 수 있습니다. - key: 최대 128자입니다. `^[a-zA-Z_][a-zA-Z0-9_]*$` 정규식을 만족해야 합니다. - value: 최대 1024자입니다.
`Airbridge.RemoveUserAlias`	추가로 입력한 유저 식별자 중에서 지정한 식별자를 삭제합니다.
`Airbridge.ClearUserAlias`	추가로 입력한 모든 유저 식별자를 삭제합니다.

아래 예시를 참고해 주세요.

// ID
Airbridge.SetUserID("testID");

// Alias
Airbridge.SetUserAlias("ADD_YOUR_KEY", "ADD_YOUR_VALUE");
Airbridge.RemoveUserAlias("DELETE_THIS_KEY");
Airbridge.ClearUserAlias();

유저 속성 설정하기

주의하세요민감한 유저 정보가 포함될 수 있습니다. 법률 자문사와 충분히 검토한 후에 전송해 주세요.

유저 속성을 설정하면 추가 유저 정보를 전송할 수 있습니다.

함수	설명
`Airbridge.SetUserEmail`	유저 이메일을 입력합니다. SHA256으로 해시(Hash)화되어 있습니다.
`Airbridge.ClearUserEmail`	유저 이메일을 삭제합니다.
`Airbridge.SetUserPhone`	유저 전화 번호를 입력합니다. SHA256으로 해시화되어 있습니다.
`Airbridge.ClearUserPhone`	유저 전화 번호를 삭제합니다.
`Airbridge.SetUserAttribute`	유저 속성을 추가로 입력합니다. 최대 100개 입력할 수 있습니다. - key: 최대 128자입니다. `^[a-zA-Z_][a-zA-Z0-9_]*$` 정규식을 만족해야 합니다. - value: String, Number, Boolean 타입만 지원합니다. 최대 1024자입니다.
`Airbridge.RemoveUserAttribute`	추가로 입력한 유저 속성 중에서 지정한 속성을 삭제합니다.
`Airbridge.ClearUserAttributes`	추가로 입력한 모든 유저 속성을 삭제합니다.

아래 예시를 참고해 주세요.

// Automatically hashed on client side using SHA256
// Can turn off hashing feature with special flag
Airbridge.SetUserEmail("testID@ab180.co");
Airbridge.SetUserPhone("821012341234");

// Attributes
Airbridge.SetUserAttribute("ADD_YOUR_KEY", 1);
Airbridge.SetUserAttribute("ADD_YOUR_KEY", 1L);
Airbridge.SetUserAttribute("ADD_YOUR_KEY", 1f);
Airbridge.SetUserAttribute("ADD_YOUR_KEY", 1.0);
Airbridge.SetUserAttribute("ADD_YOUR_KEY", "1");
Airbridge.SetUserAttribute("ADD_YOUR_KEY", true);
Airbridge.RemoveUserAttribute("DELETE_THIS_KEY");
Airbridge.ClearUserAttributes();

유저 속성 해쉬화하기

SDK 설정하기의 User Info Hash Enabled 를 false로 설정하면 유저 이메일과 전화번호를 해시화하지 않고 전송합니다. 기본 설정은 true입니다.

유저 정보 초기화하기

Airbridge.ClearUser 함수로 유저 정보를 초기화할 수 있습니다.

Airbridge.ClearUser();

설치/오픈 이벤트에 유저 정보 포함하기

SDK는 앱 실행 직후 설치 및 오픈 이벤트를 자동으로 전송합니다. 따라서 앱 실행 직후 유저 정보 함수를 호출하면, 이벤트 전송 타이밍에 따라 유저 정보가 설치/오픈 이벤트에 포함되지 않을 수 있습니다. 설치/오픈 이벤트에 유저 정보를 확실히 포함하려면, 옵트인(Opt-In) 설정하기를 통해 이벤트 전송 시점을 제어하세요. 다음 순서로 구현하세요:

SDK 설정하기 Auto Start Tracking Enabled 옵션을 false 로 설정합니다.
유저 정보 함수를 호출하여 유저 정보를 설정합니다.
startTracking() 함수를 호출하여 이벤트 수집을 시작합니다.

추가 설정하기

유니티 SDK를 추가로 설정할 수 있습니다.

알립니다필수 설정 기능이 아닙니다. 필요한 경우에만 설정해 주세요.

SKAdNetwork ConversionValue 계산을 서버에서 하기

SKAdNetwork의 ConversionValue는 기본적으로 SDK에서 계산한 값을 사용하고 있습니다. SDK가 아닌 서버 사이드로 수집한 이벤트를 SKAN으로 측정하고자 한다면 calculateSKAdNetworkByServerEnabled 옵션값을 true로 변경 해 주세요.

알립니다이미 SKAdNetwork 전환값을 SDK 에서 계산한 값을 사용중이시면 변경시 주의 바랍니다. 전환값 계산 방식을 변경할 경우, 기존 데이터와 새로운 데이터 간의 일관성 문제가 발생할 수 있습니다.

식별자 추적 제한하기

SDK 초기화시 식별자 제한하기

알립니다에어브릿지 유니티 SDK 4.7.0 이상이 필요합니다.

SDK가 식별자 데이터를 추적하지 않도록 제한할 수 있습니다.SDK 설정하기의 Tracking Blocklist에 제한할 데이터들을 설정하면 수집되는 이벤트에서 지정된 식별자 항목들이 제외됩니다. 이미 저장된 이벤트에는 영향이 없습니다.식별자 제한 목록에서 제한 가능한 데이터에 대해서 확인하세요.

SDK 동작 중 식별자 제한하기

알립니다에어브릿지 유니티 SDK 4.9.0 이상이 필요합니다.

SDK 동작 중 AllowTrackingItem, BlockTrackingItem 함수를 사용하여 제한할 데이터들을 설정할 수 있습니다. 지정된 식별자 항목들은 제외 혹은 포함됩니다. 이미 저장된 이벤트에는 영향이 없습니다.

public static void AllowTrackingItem(AirbridgeTrackingBlocklist item);

public static void BlockTrackingItem(AirbridgeTrackingBlocklist item);

식별자 제한 목록에서 제한 가능한 데이터에 대해서 확인하세요.

식별자 제한 목록

AirbridgeTrackingBlocklist 를 통해 식별자 제한 목록이 제공 됩니다.

식별자	플랫폼	설명
IDFA	iOS	IDFA 의 수집을 제한합니다.
IDFV	iOS	IDFV 의 수집을 제한합니다.
SKAdNetwork	iOS	SKAdNetwork 계산이 수행되더라도 SKAdNetwork 값을 업데이트 하지 않습니다.
GAID	Android	GAID(Google Advertising ID) 의 수집을 제한합니다.
OAID	Android	OAID(Huawei Advertising ID) 의 수집을 제한합니다.
FAID	Android	FAID(FireOS Advertising ID) 의 수집을 제한합니다.
AppSetID	Android	Google Play App Set ID 의 수집을 제한합니다.

빌드 설정에 따른 SDK 설정하기

알립니다에어브릿지 유니티 SDK 4.5.0 이상이 필요합니다.

유니티 빌드 설정에 맞게 SDK 설정을 다르게 적용할 수 있습니다. Use Development Airbridge Settings 또는 Use Production Airbridge Settings 옵션을 활성화하여 유니티 빌드 설정에 따라 SDK 설정을 적용할 수 있습니다. Use Development Airbridge Settings 또는 Use Production Airbridge Settings 옵션이 비활성화된 경우, SDK 설정은 Default 설정값으로 적용됩니다.

Use Development Airbridge Settings 옵션이 활성화되어 있고, 유니티 빌드 설정이 Development Build일 경우, SDK 설정은 Development 설정값으로 적용됩니다.

Use Production Airbridge Settings 옵션이 활성화되어 있고, 유니티 빌드 설정의 Production Build인 경우, SDK 설정은 Production 설정값으로 초기화됩니다.

ICM 어트리뷰션 데이터 확인하기

알립니다에어브릿지 유니티 SDK 4.4.0 이상이 필요합니다.

구글 애즈는 개인정보 수집에 동의하지 않은 유저의 디바이스에서 발생한 전환에 대해 ICM(Integrated Conversion Measurement) 어트리뷰션 데이터를 제공합니다. ICM은 구글 애즈에서 개인정보보호 기반 전환 모델링으로 유저를 식별하지 않고 성과를 측정하는 방법입니다. ICM 어트리뷰션 데이터를 확인하려면 구글의 ODM(On-Device Conversion Measurement) SDK를 설치하고 에어브릿지의 유니티 SDK 버전을 4.4.0 이상으로 업데이트해야 합니다. ODM SDK 설치는 파이어베이스 가이드를 참고해 주세요. 또는 구글 담당자에게 문의해 주세요.

인앱에서 트래킹 링크 생성하기

에어브릿지 유니티 SDK v4.3.0 이상이 필요합니다.

트래킹 링크는 유저가 발생시킨 터치포인트 데이터를 에어브릿지에 전달하기 위해 만드는 링크입니다. 트래킹 링크를 활용하면 광고를 보거나 클릭한 유저를 원하는 목적지로 보낼 수 있습니다. 에어브릿지는 트래킹 링크로 수집한 터치포인트 데이터를 활용해 전환에 기여한 채널을 분석할 수 있습니다. 트래킹 링크 생성을 하기 위해서는 CreateTrackingLink 함수를 사용합니다. 파라미터의 필수 여부와 타입은 아래와 같습니다.

public static void CreateTrackingLink(
    string channel, 
    Dictionary<string, object> option, 
    Action<AirbridgeTrackingLink> onSuccess,
    Action<Exception> onFailure = null
)

이름	필수 여부	타입	설명
channel	필수	string	트래킹 링크를 사용할 광고 채널
option	필수	Dictionary<string, object>	트래킹 링크 생성 옵션
onSuccess	필수	Action<AirbridgeTrackingLink>	성공 콜백
onFailure	선택	Action<Exception>	실패 콜백

CreateTrackingLink 함수는 option 파라미터를 통해 생성 옵션을 설정할 수 있습니다.

트래킹 링크 생성 옵션

키	타입	설명
AirbridgeTrackingLinkOption.CAMPAIGN	String	캠페인 이름
AirbridgeTrackingLinkOption.AD_GROUP	String	광고 그룹
AirbridgeTrackingLinkOption.AD_CREATIVE	String	광고 소재
AirbridgeTrackingLinkOption.CONTENT	String	광고 콘텐츠
AirbridgeTrackingLinkOption.TERM	String	검색 광고 키워드
AirbridgeTrackingLinkOption.SUB_ID	String	하위 네트워크 혹은 제휴 매체사 등을 나타내는 아이디.
AirbridgeTrackingLinkOption.SUB_ID_1	String	하위 네트워크 또다른 하위 네트워크 아이디.(sub-sub publisher)하위 매체 순서(계층)에 맞게 사용해야합니다.(sub_id_1 > sub_id_2 > sub_id_3)
AirbridgeTrackingLinkOption.SUB_ID_2	String	하위 네트워크 또다른 하위 네트워크 아이디.(sub-sub publisher)하위 매체 순서(계층)에 맞게 사용해야합니다.(sub_id_1 > sub_id_2 > sub_id_3)
AirbridgeTrackingLinkOption.SUB_ID_3	String	하위 네트워크 또다른 하위 네트워크 아이디.(sub-sub publisher)하위 매체 순서(계층)에 맞게 사용해야합니다.(sub_id_1 > sub_id_2 > sub_id_3)
AirbridgeTrackingLinkOption.DEEPLINK_URL	(Custom Scheme URL String)	Deeplink URL
AirbridgeTrackingLinkOption.DEEPLINK_STOPOVER	Boolean	Deeplink 의 스탑오버 기능 활성화 여부 true : 활성화 false : 비활성화
AirbridgeTrackingLinkOption.FALLBACK_IOS	(“store” \| Web URL String)	App 미설치시 ios fallback
AirbridgeTrackingLinkOption.FALLBACK_ANDROID	(“store” \| Web URL String)	App 미설치시 android fallback
AirbridgeTrackingLinkOption.FALLBACK_DESKTOP	(Web URL String)	App 미설치시 desktop fallback
AirbridgeTrackingLinkOption.FALLBACK_IOS_STORE_PPID	String	애플 앱 스토어의 맞춤형 제품 페이지(Custom Product Page)의 ppid. 앱 스토어로 랜딩할 경우 맞춤형 제품 페이지를 보여줄 수 있도록 설정합니다.
AirbridgeTrackingLinkOption.FALLBACK_ANDROID_STORE_LISTING	String	구글 플레이 스토어의 맞춤 스토어 등록정보(Custom Store Listing) listing 값. 구글 플레이 스토어로 랜딩할 경우 맞춤 스토어 등록정보를 보여줄 수 있도록 설정합니다.
AirbridgeTrackingLinkOption.OGTAG_TITLE	String	트래킹 링크의 og:title
AirbridgeTrackingLinkOption.OGTAG_DESCRIPTION	String	트래킹 링크의 og:description
AirbridgeTrackingLinkOption.OGTAG_IMAGE_URL	(Web URL String)	트래킹 링크의 og:image
AirbridgeTrackingLinkOption.OGTAG_WEBSITE_CRAWL	(“desktop”)	트래킹 링크가 소셜 미디어에 공유될 때 소셜 미디어가 fallbackPaths에 지정된 desktop URL의 Open Graph 태그를 직접 크롤링해 소셜 쉐어 프리뷰에 사용합니다. 동적(Dynamic) URL도 지원하며, Open Graph 태그의 변경 사항은 다음 공유 시점부터 자동으로 반영됩니다. 이때 title, description, imageUrl로 설정한 값은 무시됩니다.
AirbridgeTrackingLinkOption.CUSTOM_SHORT_ID	String	Custom 채널의 트래킹 링크 생성시 축약된 링크 숏 아이디. 커스텀 도메인 설정을 해야 사용할 수 있습니다. 입력하지 않으면 랜덤 아이디가 생성되며, 트래킹 링크 생성 완료 후에는 변경할 수 없습니다.
AirbridgeTrackingLinkOption.IS_REENGAGEMENT	(“off” \| “on_true” \| “on_false”)	re-engagement 파라미터. off: 해당 트래킹 링크에 발생한 터치포인트로 설치 및 인앱 이벤트를 기여합니다. on_true: 딥링크 오픈 및 그에 기인한 이벤트만 기여됩니다. Re-engagement 캠페인에 활용 가능합니다. on_false: 설치 이벤트 및 그에 기인한 인앱 이벤트만 기여됩니다. UA 캠페인에 활용 가능합니다.

CreateTrackingLink 함수는 onSuccess 콜백을 통해 AirbridgeTrackingLink 를 전달합니다.

public class AirbridgeTrackingLink
{
    public string ShortURL { get; }
    public string QrcodeURL { get; }
}

이름	타입	설명
ShortURL	string	트래킹 링크의 단축 URL
QrcodeURL	string	트래킹 링크의 QR Code URL

아래 예시 코드를 참고해 주세요.

앱이 열리거나 스토어로 이동하는 트래킹 링크 생성하기

Airbridge.CreateTrackingLink(
    channel: "test_channel",
    option: new Dictionary<string, object>
    {
        { AirbridgeTrackingLinkOption.CAMPAIGN, "test_campaign" },
        { AirbridgeTrackingLinkOption.DEEPLINK_URL, "YOUR_SCHEME://..." },
        { AirbridgeTrackingLinkOption.FALLBACK_IOS, "store" },
        { AirbridgeTrackingLinkOption.FALLBACK_ANDROID, "store" },
        { AirbridgeTrackingLinkOption.FALLBACK_DESKTOP, "https://example.com/" }
    },
    onSuccess: trackingLink => { },
    onFailure: exception => { }
);

앱이 열리거나 웹페이지로 이동하는 트래킹 링크 생성

Airbridge.CreateTrackingLink(
    channel: "test_channel",
    option: new Dictionary<string, object>
    {
        { AirbridgeTrackingLinkOption.CAMPAIGN, "test_campaign" },
        { AirbridgeTrackingLinkOption.DEEPLINK_URL, "sample://home" },
        { AirbridgeTrackingLinkOption.FALLBACK_IOS, "https://example.com/" },
        { AirbridgeTrackingLinkOption.FALLBACK_ANDROID, "https://example.com/" },
        { AirbridgeTrackingLinkOption.FALLBACK_DESKTOP, "https://example.com/" }
    },
    onSuccess: trackingLink => { },
    onFailure: exception => { }
);

스토어로만 이동하는 트래킹 링크 생성하기

Airbridge.CreateTrackingLink(
    channel: "test_channel",
    option: new Dictionary<string, object>
    {
        { AirbridgeTrackingLinkOption.CAMPAIGN, "test_campaign" },
        { AirbridgeTrackingLinkOption.FALLBACK_IOS, "store" },
        { AirbridgeTrackingLinkOption.FALLBACK_ANDROID, "store" },
        { AirbridgeTrackingLinkOption.FALLBACK_DESKTOP, "https://example.com/" }
    },
    onSuccess: trackingLink => { },
    onFailure: exception => { }
);

웹페이지로만 이동하는 트래킹 링크 생성하기

Airbridge.CreateTrackingLink(
    channel: "test_channel",
    option: new Dictionary<string, object>
    {
        { AirbridgeTrackingLinkOption.CAMPAIGN, "test_campaign" },
        { AirbridgeTrackingLinkOption.FALLBACK_IOS, "https://example.com" },
        { AirbridgeTrackingLinkOption.FALLBACK_ANDROID, "https://example.com" },
        { AirbridgeTrackingLinkOption.FALLBACK_DESKTOP, "https://example.com" }
    },
    onSuccess: trackingLink => { },
    onFailure: exception => { }
);

에어브릿지 딥링크만 전달받기

에어브릿지 유니티 SDK의 Airbridge.SetOnDeeplinkReceived 메소드를 통해 전달된 딥링크는 에어브릿지 딥링크 뿐만 아니라 다른 솔루션의 딥링크 또는 직접 개발한 딥링크도 포함합니다.

Airbridge.SetOnDeeplinkReceived((string deeplink) =>
{
    // show proper content using url
});

SDK 설정하기에서 Is Handle Airbridge Deeplink Only를 true 로 설정하면 onDeeplinkReceived 콜백을 통해 에어브릿지 딥링크만 전달됩니다. 여러 솔루션의 딥링크나 직접 개발한 딥링크를을 사용하는 경우 딥링크를 따로 처리할 수 있습니다.

인앱에서 트래킹 링크 활용하기

링크를 여는 방식에 따라 인앱에서 해당 앱의 트래킹 링크를 정상적으로 활용하기 어려울 수 있습니다. Airbridge.Click 함수 또는 Airbridge.Impression 함수를 이용하면 외부 브라우저를 거치지 않고 트래킹 링크를 정상적으로 활용할 수 있습니다.

인앱에서 트래킹 링크를 클릭

유저가 인앱에서 트래킹 링크를 클릭하면 Airbridge.Click 함수를 호출합니다. 해당 함수를 호출하면 트래킹 링크 설정에 따라 스킴 딥링크를 전달하거나 앱마켓, 웹 사이트로 보냅니다.

Airbridge.Click(
    trackingLink: "https://abr.ge/~~~",
    onSuccess: () =>
    {
        // when url is tracking link and succeed
    },
    onFailure: (Exception e) =>
    {
        // when url is tracking link and failed
        // example: url is another app's tracking link, internet is not connected
    }
);

인앱에서 트래킹 링크에 노출

유저가 트래킹 링크에 노출되면 Airbridge.Impression 함수를 호출합니다. 해당 함수를 호출하면 노출(Impression) 이벤트를 수집합니다.

Airbridge.Impression(
    trackingLink: "https://abr.ge/~~~",
    onSuccess: () =>
    {
        // when url is tracking link and succeed
    },
    onFailure: (Exception e) =>
    {
        // when url is tracking link and failed
        // example: url is another app's tracking link, internet is not connected
    }
);

주의하세요에어브릿지 SDK에서 인앱에서 트래킹 링크 활용하기를 설정하면 앱에서 트래킹 링크를 사용할 때마다 딥링크 페이지뷰(Deeplink Pageview)가 타겟 이벤트로 집계됩니다. 딥링크 실행(Deeplink Open) 직후에 딥링크 페이지뷰가 빈번하게 발생하면 딥링크 실행 성과에 영향을 줄 수 있습니다.딥링크 페이지뷰의 어트리뷰션 윈도우 기본 설정은 3일입니다. 딥링크 페이지뷰의 어트리뷰션 윈도우 변경을 원하는 고객사는 에어브릿지 CSM에게 문의해 주세요.

어트리뷰션 결과 활용하기

주의하세요에어브릿지 SDK가 어트리뷰션 결과를 수집하는데 시간이 필요합니다. 실시간 처리가 필요한 기능에 어트리뷰션 결과를 활용하는 것을 권장하지 않습니다.

Airbridge.SetOnAttributionReceived 함수로 설치 이벤트에 대한 어트리뷰션 결과를 받을 수 있습니다.

Airbridge.SetOnAttributionReceived((Dictionary<string, object> result) =>
{
    // Process attribution data
});

어트리뷰션 결과 존재 여부에 따라 아래와 같이 값이 전달됩니다.

어트리뷰션 결과 존재

어트리뷰션 결과가 존재하면 아래 값을 포함한 Dictionary가 콜백으로 전달됩니다. 모든 키는 광고 성과에 기여한 데이터를 제공합니다. 예를 들어 attributedChannel에는 광고 성과에 기여한 광고 채널에 대한 정보가 있습니다.어트리뷰션 결과는 SDK 초기화 이후 1분 이내에 콜백으로 전달됩니다. 앱이 종료되어 전달되지 않은 이전 어트리뷰션 결과는 다음에 앱을 실행하면 1분 이내에 콜백으로 전달됩니다. 네트워크 환경 등에 따라 최대 5분까지 지연될 수 있습니다.

키	타입	설명
attributedChannel	String	채널
attributedCampaign	String	캠페인
attributedAdGroup	String	광고 그룹
attributedAdCreative	String	광고 소재
attributedContent	String	콘텐츠
attributedTerm	String	키워드
attributedSubPublisher	String	하위매체
attributedSubSubPublisher1	String	하하위매체 1
attributedSubSubPublisher2	String	하하위매체 2
attributedSubSubPublisher3	String	하하위매체 3

어트리뷰션 결과 없음 (오가닉)

어트리뷰션 결과가 없으면 아래 Dictionary가 콜백으로 전달됩니다.

{
    "attributedChannel": "unattributed"
}

푸시 알림으로 딥링크 이벤트 수집하기

알립니다커스텀 iOS AppDelegate를 사용하여 하단 코드를 적용해 주세요.

푸시 알림을 클릭한 이후 페이로드에 있는 딥링크 정보를 에어브릿지 SDK에 전달해야 딥링크 이벤트를 수집할 수 있습니다. Airbridge.trackDeeplink 함수를 설정해 주세요.

iOS

커스텀 AppDelegate에 아래와 같은 코드를 추가해 주세요.

#import "UnityAppController.h"

#import <Airbridge/Airbridge.h>
#import <UserNotifications/UserNotifications.h>

@interface SomeAppController : UnityAppController<UNUserNotificationCenterDelegate>

@end

@implementation SomeAppController

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    UIApplicationState state = UIApplication.sharedApplication.applicationState;
    if (state == UIApplicationStateInactive) {
        NSURL *url = // Deep links in push notification payloads
        
        Airbridge.trackDeeplink(url)
    }
}

- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    UIApplicationState state = UIApplication.sharedApplication.applicationState;
    if ((state == UIApplicationStateInactive || state == UIApplicationStateBackground)
        && [response.actionIdentifier isEqualToString:UNNotificationDefaultActionIdentifier]) {
        NSURL *url = // Deep links in push notification payloads
        
        Airbridge.trackDeeplink(url)
    }
}

IMPL_APP_CONTROLLER_SUBCLASS(SomeAppController)

안드로이드

안드로이드에서는 자동으로 수집되기 때문에 별도의 설정이 필요하지 않습니다.

에어브릿지 딥링크만 추적하기

에어브릿지 SDK는 딥링크를 생성한 서비스와 관계 없이 딥링크로 앱이 실행되면 딥링크 이벤트를 수집합니다. 딥링크 이벤트가 과도하게 수집되면 SDK 설정하기의 Track Airbridge Link Only 를 true로 설정해 에어브릿지 딥링크만 수집할 수 있습니다.

세션에서 생명 주기 이벤트 수집하기

에어브릿지 SDK는 새로운 세션을 시작하는 실행(Open), 포그라운드(Foreground) 이벤트는 수집합니다. 세션이 유지되는 중에는 해당 이벤트를 수집하지 않습니다. SDK 설정하기의 Track In Session Life Cycle Event Enabled 를 true로 설정하면 세션이 유지되는 중에 실행(Open), 포그라운드(Foreground) 이벤트를 수집할 수 있습니다. 수집된 포그라운드(Foreground) 이벤트는 모두 실행(Open) 이벤트로 기록됩니다.

구글 디지털 시장법(DMA) 준수

구글 디지털 시장법을 준수하기 위해서는 유저 동의 정보(User Consent)를 에어브릿지에 전달해야 합니다. 구글 디지털 시장법과 적용 대상 등에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

주의하세요2024년 3월 6일부터 EEA 지역에 있는 기존 유저와 신규 유저에 대한 유저 동의 정보를 최소 1회 수집해야 합니다.

투명성 및 동의 프레임워크(Transparency and Consent Framework) v2.2 프로토콜을 준수하는 사용자 동의 관리 플랫폼(CMP)을 사용하여 유저 동의 정보를 저장하고 있다면, 다음 방법을 통해 에어브릿지 SDK로 유저 동의 정보를 수집할 수 있습니다.

사용자 동의 관리 플랫폼을 통해 유저 응답 정보 수집

알립니다에어브릿지 유니티 SDK 4.4.0 이상이 필요합니다.

SDK 설정하기에서 Collect TCF Data Enabled 를 true 로 Auto Start Tracking Enabled 를 false 로 설정합니다.

사용자 동의 관리 플랫폼을 사용하여 유저 동의 정보를 저장한 이후에 StartTracking 함수를 호출하세요.

Airbridge.StartTracking();

그외의 경우, 에어브릿지 SDK로 유저 동의 정보를 수집하려면 다음 방법을 참고하세요.

Airbridge.SetDeviceAlias 함수를 사용하여 유저 응답 정보 수집

알립니다에어브릿지는 유저 동의 정보 저장과 프롬프트 구현 방식 등에 관해 도움을 드릴 수 없습니다. 법률 자문사와 함께 검토해 주세요.

앱을 실행한 유저의 지역 정보를 확인하세요. 유저가 앱을 실행한 지역이 EEA(eea=1)라면 기존에 수집한 유저 동의 정보가 있는지 확인하세요. 유저가 앱을 실행한 지역이 EEA가 아니라면 유저 동의 정보를 수집하지 않아도 됩니다.
SDK 설정하기의 Auto Start Tracking Enabled 를 false로 설정해 주세요.

기존에 수집한 유저 동의 정보가 없다면 프롬프트 등으로 유저 동의 정보를 수집해야 합니다. 수집해야 하는 유저 동의 정보는 adPersonalization, adUserData입니다.

에어브릿지 SDK를 초기화한 후, Airbridge.SetDeviceAlias 함수를 통해 유저의 지역 정보와 수집한 유저 동의 정보를 에어브릿지 SDK에 전달하세요.

// Based on actual region
Airbridge.SetDeviceAlias("eea", "0" /* or "1" */);

// Based on actual user consent
Airbridge.SetDeviceAlias("adPersonalization", "0" /* or "1" */);
Airbridge.SetDeviceAlias("adUserData", "0" /* or "1" */);

수집한 유저 동의 정보를 전달할 때, 반드시 에어브릿지에서 지정한 필드명과 값을 사용해야 합니다. 에어브릿지 SDK에 전달해야하는 유저 동의 정보에 대한 자세한 내용은 아래를 참고하세요.

에어브릿지 필드 이름	구글 필드 이름	설명
`eea` <string>	`eea`	디지털 시장법 준수 지역 여부. - `0`: 디지털 시장법 준수와 관계 없는 지역. EEA 지역에 해당하지 않음. - `1`: 디지털 시장법 준수 지역. EEA 지역에 해당함.
`adPersonalization` <string>	`ad_personalization`	개인 맞춤형 광고 제공을 위한 정보 수집에 대한 동의 여부. - `0`: 유저가 정보 수집에 동의하지 않음. - `1`: 유저가 정보 수집에 동의함.
`adUserData` <string>	`ad_user_data`	유저 데이터를 구글에 전송하는 것에 대한 동의 여부. - `0`: 유저가 전송에 동의하지 않음. - `1`: 유저가 전송에 동의함.

에어브릿지 SDK에 유저 동의 정보를 전달한 이후에 StartTracking 함수를 호출하세요.

Airbridge.StartTracking();

메타 디퍼드 앱 링크 설정하기

아래 방법으로 메타 애즈에서 디퍼드 딥링크를 제공할 수 있습니다. 에어브릿지 SDK는 메타 디퍼드 앱 링크를 먼저 수집합니다. 메타 디퍼드 앱 링크가 없으면 에어브릿지 디퍼드 딥링크를 수집합니다. 메타 애즈의 SKAdNetwork 캠페인은 메타 디퍼드 앱 링크를 지원하지 않습니다.

페이스북 SDK를 설치합니다. 메타 애즈 가이드 (유니티) 를 참고해 주세요.
SDK 설정하기의 Facebook Deferred App Link Enabled 를 true로 설정합니다.

비활성화 상태로 에어브릿지 SDK 초기화하기

주의하세요에어브릿지 SDK 초기화 이후 바로 활성화하지 않으면 설치, 오픈, 딥링크 이벤트가 수집되지 않을 수 있습니다.

에어브릿지 SDK를 초기화하면 모든 기능을 활성화합니다. SDK 설정하기의 SDK Enabled 를 false로 설정하면 모든 기능을 비활성화한 상태로 에어브릿지 SDK를 초기화할 수 있습니다. 또는 아래 방식으로 에어브릿지 SDK의 활성화 여부를 확인하고 모든 기능을 활성화하거나 비활성화할 수 있습니다.

Airbridge.IsSDKEnabled();
Airbridge.EnableSDK();
Airbridge.DisableSDK();

메타 인스톨 리퍼러 수집 설정

메타 인스톨 리퍼러(Meta Install Referrer) 수집에 필요한 설정입니다. SDK 초기화 단계에서 SDK 설정하기의 Meta Install Referrer (Facebook App ID) 에 Facebook App ID 를 전달합니다. 설정한 이후에 암호 해독 키를 에어브릿지 대시보드에 입력해야 복호화된 메타 인스톨 리퍼러를 확인할 수 있습니다. 암호 해독 키를 입력하는 방법은 에어브릿지 가이드를 참고해 주세요.

앱 삭제 트래킹 설정하기

에어브릿지는 앱 이벤트를 최근 6개월 동안 1번이라도 트래킹한 유저를 대상으로 사일런트 푸시를 매일 KST(한국표준시) 0시~1시 사이에 보내서 앱 삭제 여부를 확인합니다. 앱 삭제 이벤트는 에어브릿지 리포트와 원본 데이터 추출 등으로 확인할 수 있습니다. 자세한 설정 방법과 설명은 에어브릿지 가이드를 참고해 주세요.

앱 삭제 트래킹 설정하기 - 유니티 SDK (v4)

서드파티 연동하기

일부 서드파티 솔루션을 연동하기 위해서는 SDK 설정이 필요합니다. 에어브릿지 SDK로 데이터를 수집하기 전에 서드파티 솔루션에 필요한 설정을 마치는 것을 권장합니다. 각 서드파티 솔루션 연동에 필요한 설정은 아래 가이드를 참고해 주세요.

에어브릿지와 연동된 서드파티

SDK 로그 확인하기

에어브릿지 SDK가 제공하는 로그는 Debug, Info, Warning, Error, Fault 레벨로 구성됩니다. Debug 레벨이 가장 덜 치명적인 로그이고, Fault 레벨이 가장 치명적인 로그입니다. 에어브릿지 SDK는 Warning, Error, Fault 레벨 이상의 로그를 기본적으로 제공합니다. SDK 설정하기의 Log Level 에 로그 레벨을 입력하면 해당 로그 레벨부터 Fault 레벨까지 로그를 확인할 수 있습니다.

​유니티 SDK 설치하기

​SDK 초기화하기

​SDK 설정하기

​ATT 프롬프트 제공하기

​옵트인(Opt-In) 설정하기

​옵트아웃(Opt-Out) 설정하기

​SDK 시그니처 설정하기

​딥링크

​에어브릿지의 딥링크 작동 방식

​딥링크 설정하기

​iOS

​안드로이드

​iOS

​Android

​iOS

​안드로이드

​디퍼드 딥링크 설정하기

​커스텀 도메인 설정하기

​인앱 이벤트

​인앱 이벤트 전송하기

​인앱 이벤트 추가 설정하기

​인앱 이벤트 예시 코드

회원가입

로그인

로그아웃

홈화면 조회

상품리스트 조회

검색결과 조회

상품상세페이지 조회

결제수단 등록

위시리스트 추가

장바구니 담기

결제 시작

구매 완료

구매 취소

체험판 시작

구독

구독 취소

광고 노출

광고 클릭

튜토리얼 완료

레벨 달성

과제 달성

평가

공유

일정 예약

크레딧 사용

​유저 정보

​유저 ID 설정하기

​유저 속성 설정하기

​유저 속성 해쉬화하기

​유저 정보 초기화하기

​설치/오픈 이벤트에 유저 정보 포함하기

​추가 설정하기

​SKAdNetwork ConversionValue 계산을 서버에서 하기

​식별자 추적 제한하기

​빌드 설정에 따른 SDK 설정하기

​ICM 어트리뷰션 데이터 확인하기

​인앱에서 트래킹 링크 생성하기

​에어브릿지 딥링크만 전달받기

​인앱에서 트래킹 링크 활용하기

​어트리뷰션 결과 활용하기

​푸시 알림으로 딥링크 이벤트 수집하기

​iOS

​안드로이드

​에어브릿지 딥링크만 추적하기

​세션에서 생명 주기 이벤트 수집하기

​구글 디지털 시장법(DMA) 준수

​메타 디퍼드 앱 링크 설정하기

​비활성화 상태로 에어브릿지 SDK 초기화하기

​메타 인스톨 리퍼러 수집 설정

​앱 삭제 트래킹 설정하기

​서드파티 연동하기

​SDK 로그 확인하기

유니티 SDK 설치하기

SDK 초기화하기

SDK 설정하기

ATT 프롬프트 제공하기

옵트인(Opt-In) 설정하기

옵트아웃(Opt-Out) 설정하기

SDK 시그니처 설정하기

딥링크

에어브릿지의 딥링크 작동 방식

딥링크 설정하기

iOS

안드로이드

iOS

Android

iOS

안드로이드

디퍼드 딥링크 설정하기

커스텀 도메인 설정하기

인앱 이벤트

인앱 이벤트 전송하기

인앱 이벤트 추가 설정하기

인앱 이벤트 예시 코드

유저 정보

유저 ID 설정하기

유저 속성 설정하기

유저 속성 해쉬화하기

유저 정보 초기화하기

설치/오픈 이벤트에 유저 정보 포함하기

추가 설정하기

SKAdNetwork ConversionValue 계산을 서버에서 하기

식별자 추적 제한하기

빌드 설정에 따른 SDK 설정하기

ICM 어트리뷰션 데이터 확인하기

인앱에서 트래킹 링크 생성하기

에어브릿지 딥링크만 전달받기

인앱에서 트래킹 링크 활용하기

어트리뷰션 결과 활용하기

푸시 알림으로 딥링크 이벤트 수집하기

iOS

안드로이드

에어브릿지 딥링크만 추적하기

세션에서 생명 주기 이벤트 수집하기

구글 디지털 시장법(DMA) 준수

메타 디퍼드 앱 링크 설정하기

비활성화 상태로 에어브릿지 SDK 초기화하기

메타 인스톨 리퍼러 수집 설정

앱 삭제 트래킹 설정하기

서드파티 연동하기

SDK 로그 확인하기