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

빠르게 설치

프로젝트의 앱 모듈 폴더 (일반적으로 app/) 안에 있는 build.gradle 파일을 열고, dependencies 블럭 안에 다음 내용을 추가해주세요.

compile 'io.airbridge:sdk-android:1.0.+'

Android Studio 이외의 플랫폼의 경우 Maven으로 설치 혹은 Eclipse로 설치 가이드를 참조해주세요.

빠르게 설정

앱의 Application 클래스나, 맨 처음 실행되는 ActivityonCreate메서드에 다음 코드를 추가해주세요.

public void onCreate() {
    super.onCreate();
    // ...
    AirBridge.init(this, "YOUR_APP_NAME(앱 영문명)", "YOUR_APP_TOKEN(앱 토큰)");
}

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

기존에 INSTALL_REFERRER 이벤트를 받는 리시버가 등록되어 있다면 (예: Google Analytics), 서드파티 리시버 연동 가이드를 참조해 Airbridge가 해당 리시버를 호출하게 해야 합니다.

SDK 작동 여부 테스트하기

  1. 테스트 전, 먼저 디바이스에서 앱이 삭제되어있어야 합니다.
  2. 대시보드에서 임의의 트래킹 링크를 생성한 후, 디바이스의 웹 브라우저에서 열어주세요.
  3. 앱을 빌드하여 디바이스에서 실행합니다.
  4. '트래킹 링크 통계' 페이지에서 해당 트래킹 링크의 설치 카운트가 올라가는것을 확인할 수 있습니다. 설치가 카운팅되지 않는다면 SDK 설치 가이드를 다시 한번 확인해주세요.

다른 방법으로 설치

Maven으로 설치

Maven으로 설치하려면 pom.xmldependencies란에 다음 내용을 추가해주세요.

<dependency>
    <groupId>io.airbridge</groupId>
    <artifactId>sdk-android</artifactId>
    <version>1.0.0-beta1</version>
</dependency>

Eclipse에서 설치

  1. 이 링크에서 SDK의 .jar 파일을 다운로드하고, 프로젝트 설정의 Java Build Path >. Libraries에서 해당 .jar 파일을 추가해주세요.

  2. AndroidManifest.xml에 다음 권한을 추가해주세요.

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    
  3. 설치 이벤트를 수신하기 위한 Receiver를 등록해주세요.

        <receiver
            android:name="io.airbridge.DeferredLinkReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
            </intent-filter>
        </receiver>
    
  4. 만약 Proguard를 사용 중이고 Google Play Services (GMS)를 사용중이시라면, proguard-rules.pro 파일에 다음 내용을 추가해주세요.

    -keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {public *;}
    -keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info { public *;}
    

Android SDK v1.0.0 업그레이드 변경사항 안내

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

SDK Initialization 변경사항

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

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

  • 기존: AirBridge.init("YOUR_APP_ID", "YOUR_USER_TOKEN");
  • 변경: AirBridge.init("YOUR_APP_NAME(앱 영문명)", "YOUR_APP_TOKEN(앱 토큰)");

변경된 새로운 값들은 대시보드 내 '앱정보 관리 > 앱 기본 정보'에서 확인할 수 있습니다.

이 변경사항을 적용하지 않을 경우 설치 이후 통계 데이터를 받아볼 수 없습니다. Throw Exception을 실행하므로 꼭 변경해주세요.

기본 인앱이벤트 API 변경사항

AirBridge.userSignup 등의 기본 인앱이벤트 API는 더 이상 사용되지 않습니다. io.airbridge.statistics.goals 패키지 안의 기본 인앱이벤트 이벤트 빌더를 사용해 주세요.

GoalEvent event = new SignUpGoalBuilder()
        .setUserEmail("you@gmail.com")
        .setUserId("1234")
        .build();

AirBridge.getTracker().send(event);

커스텀 인앱이벤트 API 변경사항

기존 Airbridge.goal(label, value) 메서드는 더 이상 사용하지 않습니다. GoalEvent 클래스를 사용하여 목표 달성 이벤트를 보내주세요.
커스텀 인앱이벤트를 추가하기 위해서는 우선 에어브릿지 대시보드에서 인앱이벤트를 등록해야 하며(인앱이벤트 등록 페이지 참고), 모바일 SDK에서는 인앱이벤트 식별자를 담아 앱 내부에서 해당 인앱이벤트가 달성될 때 다음과 같이 메서드를 호출해주세요.

GoalEvent event = new GoalEvent("인앱이벤트 식별자");

AirBridge.getTracker().send(event);

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

검색결과
keyboard_return이전으로