menu 이용가이드
close
Getting Start chevron_right SDK Installation
iOS SDK 설치
에어브릿지 iOS SDK는 에어브릿지 서비스를 통해 iOS앱에 유입된 설치, 실행, 인앱이벤트, 잔존율 트래킹에 반드시 필요합니다.

광고식별자(IDFA) 이용약관 동의

에어브릿지 iOS SDK의 설치 트래킹을 위해 앱스토어에 앱을 게시할 때 광고 식별자(IDFA) 이용약관 동의가 필요합니다. 이때 광고 식별자는 설치 트래킹을 위한 고객의 유니크 식별값으로서만 활용되며, 개인정보 매칭 등의 용도로 사용되지 않습니다. 에어브릿지는 Apple Program License Agreement의 내용을 준수합니다.

  1. 앱스토어에 앱을 게시할 때 Advertising Identifier 항목에 'Yes'라고 체크해주세요.
  2. 'Attribute this app installation to a previously served advertisement.', 'Limit Ad Tracking Setting in iOS' 두 개 항목을 체크해주세요.

빠르게 설치

iOS에서 지원하는 트래킹링크 설치 방법은 두 가지로, Cocoapods을 이용하는 방법과 Framework를 직접 다운로드하여 설치하는 방법입니다. Cocoapods은 iOS Thrid-party 라이브러리의 호환성을 자동, 단순화 시켜주는 관리 툴로 버전에 따라 자동으로 SDK를 설치하고 관리할 수 있습니다. 따라서 Framework를 직접 다운로드 받아 설치하기 보다는 Cocoapods를 사용하시기를 적극 권장합니다.

Cocoapods으로 설치하기
podfile을 다음과 같이 설정해주세요.

pod 'AirBridge'

Framework 직접 다운로드하여 설치하기
이 링크에서 Framework 파일을 다운받아 해당 파일을 프로젝트안에 Drog-and-Drop 해주세요.

.Zip file MD5 Checksum: C830370CBA965D4E0B0A923E64B6232E Swift로 작성된 앱에서 트래킹링크 전용 SDK 사용하기 해당 프레임워크는 Objective-C 언어로 작성이 되었기 때문에, Swift로 작성된 프로젝트에서 이용하기 위해 Bridging Header File을 해당 프로젝트에 추가해야 합니다.

  1. [Command + N] 또는 [File > New > File...] > iOS - Source > Header File 을 클릭합니다.
  2. <YOUR_PROJECT_NAME>-Bridging-Header.h의 이름으로 저장합니다.
  3. 헤더파일 안에 #import <AirBridge/AirBridge.h> 을 추가합니다.
  4. Build SettingsObjective-C Bridging Header 속성안에 /PATH/TO/<YOUR_PROJECT_NAME>-Bridging-Header.h 를 추가합니다.

빠르게 설정

앱의 appdelegate 클래스의 didFinishLaunchingWithOptions 메서드에 다음 코드를 추가해주세요.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  /.../
  [AirBridge getInstance:<"YOUR_APP_TOKEN(앱 토큰)"> appName:<"YOUR_APP_NAME(앱 영문명)"> withLaunchOptions:launchOptions facebookSDKInstalled:NO];
}
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    /.../
    AirBridge.getInstance(<"YOUR_APP_TOKEN(앱 토큰)">, appName:<"YOUR_APP_NAME(앱 영문명)">, withLaunchOptions:launchOptions, facebookSDKInstalled:false)
    return true
}

앱 영문명과 앱 토큰은 대시보드의 '앱정보 관리 > 앱 기본 정보'에서 확인할 수 있습니다.

SDK 작동 여부 테스트하기

현재 에어브릿지에서는 임의의 트래킹링크를 생성하여 설치와 인앱이벤트 달성 테스트를 진행하고 삭제하는 방법을 권장하고 있습니다. SDK 작동 여부 테스트는 앱마켓 업로드 전후로 나누어집니다.

앱마켓 배포 전

앱마켓 배포 전 아래 테스트를 통해 SDK 작동 여부를 테스트할 수 있습니다.

  1. 테스트 전에 해당 타겟 디바이스에서 앱이 삭제되어있어야 합니다.
  2. 에어브릿지 애널리틱스에서 임의의 트래킹링크를 생성합니다.
  3. 생성한 트래킹링크를 타겟 디바이스에서 실행하고 앱마켓(구글 플레이스토어 혹은 애플 앱스토어)으로 이동하는지 확인합니다.
  4. 개발 툴로 앱을 빌드하여 타겟 디바이스에 설치하고 빌드된 앱을 실행합니다.
  5. SDK가 정상적으로 설치되었다면 최초 실행 시 대시보드의 '트래킹링크 통계' 페이지에서 해당 트래킹링크의 설치 카운트가 올라가는 것을 확인할 수 있습니다. 설치가 카운팅되지 않는다면 SDK 설치 가이드를 다시 한번 확인해주세요.

앱마켓 배포 후

앱마켓 배포 후 아래 테스트를 통해 SDK 작동 여부를 테스트할 수 있습니다.

  1. 에어브릿지 애널리틱스에서 임의의 트래킹링크를 생성합니다.
  2. 생성한 트래킹링크를 타겟 디바이스에서 실행하고 앱마켓(구글 플레이스토어 혹은 애플 앱스토어)으로 이동하는지 확인합니다.
  3. SDK가 정상적으로 설치되었다면 최초 실행 시 대시보드의 '트래킹링크 통계' 페이지에서 해당 트래킹링크의 설치 카운트가 올라가는 것을 확인할 수 있습니다. 설치가 카운팅되지 않는다면 SDK 설치 가이드를 다시 한번 확인해주세요.

iOS SDK v1.x 업그레이드 변경사항 안내


V 1.0.5 - 2017.10.18

  1. 앱이 백그라운드 상태에서 포그라운드 상태로 변경될때, 포그라운드 이벤트가 전송되도록 변경되었습니다
  2. 구매와 관련한 이벤트 전송시 transactionID를 포함하여 전송되도록 변경되었습니다.

V 1.0.0 - 2017.09.13

기존 에어브릿지 SDK를 이용하셨다면 아래 변경사항을 참조해주세요.

SDK initialize 변경사항

보안체계를 강화하기 위해 기존 SDK에서 사용하던 UserToken과 기존의 숫자형태의 AppToken을 더 이상 사용하지 않습니다. 그 대신 새롭게 생성된 AppToken을 사용하며, 여기에 사용자가 앱 등록시 입력한 ‘앱 영문명‘을 사용합니다.

자세한 내용은 sdk 앱 이름 및 앱 토큰 확인 방법 에서 참고 부탁드립니다.

  • 기존: AirBridge* getInstance:(NSString *)userToken appToken:(NSString *)appToken
    (여기서 AppToken은 암호화되기 전 숫자 방식으로, 변경된 AppToken에 사용하시면 안됩니다!!)
  • 변경: AirBridge* getInstance:(NSString *)appToken appName:(NSString *)appName

변경된 새로운 값들은 대시보드 내 '앱정보 관리>앱 기본 정보'에서 확인할 수 있습니다. 이 변경사항을 적용하지 않을 경우 설치 이후 통계 데이터를 받아볼 수 없습니다. Throw Exception을 실행하므로 꼭 변경해주세요.

기본 인앱이벤트 변경사항

정식 1.0.0 버전이 배포되면서, 새로운 기본 목표가 생겼으며 회원가입, 로그인 이벤트에도 변경이 있었습니다. 최대한 Instance 의존도를 없애고 사용자가 자유롭게 작업할 수 있도록 새로운 Event 모듈을 만들었습니다.

커스텀 인앱이벤트 메소드 변경사항

더욱 가치있는 인앱이벤트 트래킹 서비스를 제공할 수 있도록 인메소드 파라미터를 변경하고, 메소드명을 보다 직관적으로 변경하였습니다.
기존에 사용하시던 goalDescription에 해당하는 파라미터 값을 category에 넣어주시면 됩니다.

  • 기존: BOOL simpleGoalWithDescription:(NSString *)goalDescription
  • 변경: BOOL goalWithCategory:(NSString *)category
    category에는 인앱이벤트 식별자를 적용해주세요.

인앱이벤트 식별자는 대시보드 내 '인앱이벤트 관리' 메뉴에서 확인할 수 있습니다.

검색결과
keyboard_return이전으로