1. 프로젝트 build.gradle 파일의 repositories 블럭 안에 Airbridge maven 저장소를 선언합니다.

allprojects {
    repositories {
        maven { url "https://sdk-download.airbridge.io/maven" }
    }
}

allprojects {
    repositories {
        maven("https://sdk-download.airbridge.io/maven")
    }
}

2. 어플리케이션 gradle 파일에서 Airbridge android SDK 패키지를 추가합니다.

dependencies {
    // Get the latest version from https://sdk-download.airbridge.io/maven
    implementation "io.airbridge:sdk-android:HERE_LATEST_VERSION"
    // For example
    // implementation "io.airbridge:sdk-android:0.0.0"
}

dependencies {
    // Get the latest version from https://sdk-download.airbridge.io/maven
    implementation("io.airbridge:sdk-android:HERE_LATEST_VERSION")
    // For example
    // implementation("io.airbridge:sdk-android:0.0.0")
}

알립니다

Kotlin stdlib 및 Kotlinx coroutines 라이브러리 버전이 1.4 이상이어야 합니다.

에어브릿지 안드로이드 SDK는 JetBrains의 Kotlin과 Coroutines 라이브러리를 함께 사용합니다.

.aar을 통해 직접 설치하면 dependency 라이브러리를 프로젝트에 포함해야 합니다. 아래를 참고해 주세요.

1. 프로젝트 build.gradle 파일의 repositories 블럭 안에 Airbridge maven 저장소를 선언합니다.

allprojects {
    repositories {
        maven { url "https://sdk-download.airbridge.io/maven" }
    }
}

allprojects {
    repositories {
        maven("https://sdk-download.airbridge.io/maven")
    }
}

2. 어플리케이션 gradle 파일에서 Airbridge android SDK 패키지를 추가합니다.

dependencies {
    // Get the latest version from https://sdk-download.airbridge.io/maven
    implementation "io.airbridge:sdk-android-restricted:HERE_LATEST_VERSION"
    // For example
    // implementation "io.airbridge:sdk-android-restricted:0.0.0"
}

dependencies {
    // Get the latest version from https://sdk-download.airbridge.io/maven
    implementation("io.airbridge:sdk-android-restricted:HERE_LATEST_VERSION")
    // For example
    // implementation("io.airbridge:sdk-android-restricted:0.0.0")
}

알립니다

Kotlin stdlib 및 Kotlinx coroutines 라이브러리 버전이 1.4 이상이어야 합니다.

에어브릿지 안드로이드 SDK는 JetBrains의 Kotlin과 Coroutines 라이브러리를 함께 사용합니다.

.aar을 통해 직접 설치하면 dependency 라이브러리를 프로젝트에 포함해야 합니다. 아래를 참고해 주세요.

에어브릿지 안드로이드 SDK가 이벤트를 네트워크를 통해 전송할 수 있는 권한이 필요합니다.

아래 권한을 어플리케이션 AndroidManifest.xml에 추가합니다.

<manifest ...>
  ...
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  ...
</manifest>

구글에 따르면 안드로이드 13(API 33) 이상을 대상으로 하는 앱은 디바이스의 광고 ID를 획득하기 위해 AndroidManifest.xml 파일에서 Google Play 서비스 일반 권한을 선언해야 합니다.

에어브릿지 안드로이드 SDK 는 V2.13.0 부터 광고 ID를 획득할 수 있는 AD_ID 권한을 자동으로 추가합니다.

LAT(LimitAdTracking)를 설정하지 않았는데 GAID가 00000000-0000-0000-0000-000000000000으로 발생하면 AD_ID 권한을 아래 코드로 추가해야 합니다. 다른 서드파티 라이브러리 등으로 인해 AD_ID 권한이 제외되어서 발생한 현상입니다.

<manifest ...>
  ...
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
  ...
</manifest>

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

• 안드로이드 URI 스킴: 안드로이드 URI 스킴을 기준으로 에어브릿지 딥링크를 스킴 딥링크로 변환합니다. 앱 링크와 URI 스킴에 필요한 딥링크 정보입니다.

• 패키지 이름: 안드로이드 앱을 식별합니다. 앱 링크와 URI 스킴에 필요한 딥링크 정보입니다.

• Android sha256_cert_fingerprints: 앱 링크 도메인을 설정하는 기준입니다. 앱 링크에 필요한 딥링크 정보입니다.

주의하세요

실제 출시 앱과 개발용 앱의 안드로이드 URI 스킴과 sha256_cert_fingerprints를 다르게 등록해야 유저를 정상적으로 이동 시킬 수 있습니다.

에어브릿지에 안드로이드 URI 스킴, 패키지 이름과 Android sha256_cert_fingerprints를 등록해 주세요.

1. 에어브릿지 대시보드의 [트래킹 링크]>[딥링크]로 이동합니다.

2. [안드로이드 URI 스킴]에 Android URI 스킴을 입력합니다. ://와 함께 입력해야 합니다. 예를 들어 Android URI 스킴이 demo면 demo://와 같이 입력합니다.

3. [패키지 이름]에 패키지 이름을 입력합니다.

4. sha256_cert_fingerprints를 확인해야 합니다. 배포하는 keystore 파일에서 아래 명령을 실행합니다.

keytool -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

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

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

1. 딥링크를 처리하는 Activity를 추가합니다. src에 Activity 클래스 파일을 추가합니다.

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class DeeplinkActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}

import android.os.Bundle;

import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

public class DeeplinkActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }
}

AndroidManifest.xml 파일에 Activity를 추가합니다.

<application
    ...>

    <activity android:name=".DeeplinkActivity" />

</application>

2. 에어브릿지 딥링크의 스킴(Scheme) 딥링크 앱 설정이 필요합니다. AndroidManifest.xml에 딥링크를 처리하는 Activity에 Intent Filter를 추가합니다.

추가하는 Intent Filter는 대시보드에 입력한 안드로이드 URI Scheme를 사용해야 합니다. ://를 제외한 안드로이드 URI 스킴을 입력합니다.

<activity ...>
    ...
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="YOUR_SCHEME" />
    </intent-filter>
    ...
</activity>

주의하세요

://를 제외한 안드로이드 URI 스킴을 입력해야 합니다.

3. 에어브릿지 딥링크의 앱 링크(App Links) 앱 설정이 필요합니다. AndroidManifest.xml에 딥링크를 처리하는 Activity 아래 Intent Filter를 추가합니다.

YOUR_APP_NAME은 에어브릿지 앱 이름입니다.

<activity ...>
    ...
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.abr.ge" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.abr.ge" />
    </intent-filter>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
    </intent-filter>
    ...
</activity>

에어브릿지 딥링크가 실행되면 딥링크를 처리하는 Activity가 Airbridge.handleDeeplink 함수를 활용해 에어브릿지 딥링크를 스킴 딥링크로 변환합니다.

변환된 스킴 딥링크를 활용해 유저를 설정한 목적지로 보냅니다.

// when activity is opened with scheme deeplink or app links
override fun onResume() {
	super.onResume()
	
	// handle airbridge deeplink
	val isHandled = Airbridge.handleDeeplink(intent) {
		// when app is opened with airbridge deeplink
        // show proper content using url (YOUR_SCHEME://...)
	}
	if (isHandled) return

	// when app is opened with other deeplink
    // use existing logic as it is
}

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

// when activity is opened with scheme deeplink or app links
@Override
protected void onResume() {
    super.onResume();

    boolean isHandled = Airbridge.handleDeeplink(
                getIntent(),
                uri -> {
                    // when app is opened with airbridge deeplink
                    // show proper content using url (YOUR_SCHEME://...)
                }
        );
    if (isHandled) return;

    // when app is opened with other deeplink
    // use existing logic as it is
}

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

Airbridge.handleDeeplink 함수는 에어브릿지 딥링크가 입력되면 true와 함께 변환된 스킴 딥링크를 onSuccess에 전달합니다. 에어브릿지 딥링크가 아니면 false와 함께 콜백을 제공하지 않습니다.

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

• 옵트인(Opt-In)을 설정한 상태에서 Airbridge.startTracking 함수를 호출합니다. 또는 옵트인을 설정하지 않았습니다.

• ATT 추적 동의 여부가 결정되었습니다. 또는 ATT 프롬프트에서 설정한 이벤트 수집 지연 시간이 종료되었습니다.

• Event packet is stored in storage: categories={...}: 해당 Event category가 단말에 적재됐습니다.

• Send event packets to Airbridge: categories={...}: 해당 Event category를 전송합니다.

• Succeed to send event packets to Airbridge: categories={...}: 해당 Event category가 네트워크를 통해 성공적으로 전송됐습니다.

Test HTTP Deeplink Type-1를 클릭하면 SDK 로그를 통해서 아래 항목을 확인해야 합니다.

• eventData.deeplink가 https://{YOUR_APP_NAME}.abr.ge...입니다.

• {YOUR_SCHEME}://main...이 딥링크 콜백 함수에 전달됩니다.

• 딥링크 테스트 사이트에서 딥링크 URL을 입력했다면 전달되는 정보가 변경됩니다. 예를 들어 딥링크 URL로 {YOUR_SCHEME}://path를 입력하면 ${YOUR_SCHEME}://path...가 전달됩니다.

Test HTTP Deeplink Type-2를 클릭하면 SDK 로그를 통해서 아래 항목을 확인해야 합니다.

• eventData.deeplink가 https://{YOUR_APP_NAME}.airbridge.io...입니다.

• {YOUR_SCHEME}://main...이 딥링크 콜백 함수에 전달됩니다.

• 딥링크 테스트 사이트에서 딥링크 URL을 입력했다면 전달되는 정보가 변경됩니다. 예를 들어 딥링크 URL로 {YOUR_SCHEME}://path를 입력하면 ${YOUR_SCHEME}://path...가 전달됩니다.

Test Scheme Deeplink를 클릭하면 SDK 로그를 통해서 아래 항목을 확인해야 합니다.

• eventData.deeplink가 {YOUR_SCHEME}://main...입니다.

• {YOUR_SCHEME}://main...이 딥링크 콜백 함수에 전달됩니다.

• 딥링크 테스트 사이트에서 딥링크 URL을 입력했다면 전달되는 정보가 변경됩니다. 예를 들어 딥링크 URL로 {YOUR_SCHEME}://path를 입력하면 ${YOUR_SCHEME}://path...가 전달됩니다.

Test Deferred Deeplink를 클릭하면 SDK 로그를 통해서 아래 항목을 확인해야 합니다.

• eventData.deeplink가 {YOUR_SCHEME}://main...입니다.

• {YOUR_SCHEME}://main...이 딥링크 콜백 함수에 전달됩니다.

• 딥링크 테스트 사이트에서 딥링크 URL을 입력했다면 전달되는 정보가 변경됩니다. 예를 들어 딥링크 URL로 {YOUR_SCHEME}://path를 입력하면 ${YOUR_SCHEME}://path...가 전달됩니다.

Test Custom Domain Deeplink를 클릭하면 SDK 로그를 통해서 아래 항목을 확인해야 합니다.

• eventData.deeplink가 https://{YOUR_CUSTOM_DOMAIN}...입니다.

• {YOUR_SCHEME}://main...이 딥링크 콜백 함수에 전달됩니다.

• 딥링크 테스트 사이트에서 딥링크 URL을 입력했다면 전달되는 정보가 변경됩니다. 예를 들어 딥링크 URL로 {YOUR_SCHEME}://path를 입력하면 ${YOUR_SCHEME}://path...가 전달됩니다.