개발자 가이드
SDK Integration
Android SDK (v4) (Beta)

SDK 마이그레이션 가이드 - 안드로이드 SDK (v4)

2024년 9월 4일에 업데이트됨

에어브릿지 안드로이드 SDK를 업데이트하는 과정에 필요한 내용을 확인할 수 있습니다. 현재 버전 이후부터 업데이트 이후 버전까지의 내용을 모두 확인하는 것을 권장합니다.

v2.x에서 v4.0으로 업데이트

에어브릿지 안드로이드 SDK를 v4.0으로 업데이트하면 확인해 주세요. 아래에서 모든 변경사항을 확인할 수 있습니다.

Airbridge interface

Summary


Unit	`initializeSDK(app: Application, option: AirbridgeOption)` Initializes the SDK with the provided app and AirbridgeOption.
Unit	`enableSDK()` Enables the SDK.
Unit	`disableSDK()` Disables the SDK.
Boolean	`isSDKEnabled()` Checks whether the SDK is currently enabled.
Unit	`startTracking()` Start collecting and transferring events.
Unit	`setDeviceAlias(key: String, value: String)` Sets the key, value pair to the device alias.
Unit	`removeDeviceAlias(key: String)` Removes the device alias with the given key.
Unit	`clearDeviceAlias()` Clears all device aliases.
Unit	`setUserID(String)` Sets the user ID.
Unit	`setUserEmail(String)` Sets the user email.
Unit	`setUserPhone(String)` Sets the user phone number.
Unit	`setUserAttribute(key: String, value: Int)` Sets the key, value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Long)` Sets the key, value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Float)` Sets the key, value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Double)` Sets the key, value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Boolean)` Sets the key, value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: String)` Sets the key, value pair to the user attribute.
Unit	`removeUserAttribute(key: String)` Removes the user attribute with the given key.
Unit	`clearUserAttributes()` Clears all user attributes.
Unit	`setUserAlias(key: String, value: String)` Sets the key, value pair to the user alias.
Unit	`removeUserAlias(key: String)` Removes the user alias with the given key.
Unit	`clearUserAlias()` Clears all user aliases.
Unit	`clearUser()` Clears all user information.
Unit	`registerPushToken(token: String)` Registers the FCM registration token to track app uninstalls.
Boolean	`isUninstallTrackingNotification(RemoteMessage)` Silent notifications are sent without any data. However, the notification may be shown to the user depending on the onMessageReceived settings. determine whether it is an app deletion tracking push message.
Unit	`trackEevnt(category: String, semanticAttributes: Map<String, Any> = null, customAttributes: Map<String, Any> = null)` track events.
Boolean	`handleDeeplink(intent: Intent, onSuccess: OnSuccess<Uri>, onFailure: OnFailure? = null)` Handle Airbridge's deep link from the provided intent and invoke a callback based on the result.
Boolean	`handleDeferredDeeplink(onSuccess: OnSuccess<Uri?>, onFailure: OnFailure? = null)` Handle deferred deep link and invoke a callback based on the result.
Boolean	`click(trackingLink: URL, onSuccess: OnSuccess<Unit>, onFailure: OnFailure? = null)` Queries the tracking link to the server to get the deeplink information and then moves according to that information if a deeplink is set up. It also adds a click event for the tracking link.
Boolean	`impression(trackingLink: String, onSuccess: OnSuccess<Unit>, onFailure: OnFailure? = null)` Adds an impression event for the tracking link.
Unit	`setWebInterface(webView: WebView, webToken: String)` Enables the Android SDK to automatically pull all events from the web SDK that is installed on the website of the WebView environment.
Boolean	`fetchDeviceUUID(onSuccess: OnSuccess<String>, onFailure: OnFailure? = null)` Fetches the Device UUID using the provided callbacks for success and failure.
Boolean	`fetchGoogleInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` fetch Google install referrer
Boolean	`fetchHuaweiInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` fetch Huawei install referrer
Boolean	`fetchOneStoreInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` fetch One store install referrer
Boolean	`fetchGalaxyStoreInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` fetch Galaxy store install referrer
Boolean	`fetchMetaInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` fetch Meta install referrer
Boolean	`fetchGoogleAdvertisingIdInfo(onSuccess: OnSuccess<AdvertisingIdInfo>, onFailure: OnFailure? = null)` fetch Google Advertising ID info
Boolean	`fetchHuaweiAdvertisingIdInfo(onSuccess: OnSuccess<AdvertisingIdInfo>, onFailure: OnFailure? = null)` fetch Huawei Advertising ID info

Deprecated interface


Unit	`init(app: Application, config: AirbridgeConfig)` This method was deprecated in v4. use `initializeSDK(Application, AirbridgeOption)` instead
AirbridgeDeviceInfo	`getDeviceInfo()` This method was deprecated in v4. use `setDeviceAlias(String, String)`instead use `removeDeviceAlias(String)` instead use `clearDeviceAlias()` instead use `fetchDeviceUUID(OnSuccess<String>, OnFailure?)` instead use `fetchGoogleInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchHuaweiInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchOneStoreInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchGalaxyStoreInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchMetaInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchGoogleAdvertisingIdInfo(OnSuccess<AdvertisingIdInfo>, OnFailure?)` instead use `fetchHuaweiAdvertisingIdInfo(OnSuccess<AdvertisingIdInfo>, OnFailure?)` instead
AirbridgeUser	`getCurrentUser()` This method was deprecated in v4. use `setUserID(String)` instead use `setUserEmail(String)` instead use `setUserPhone(String)` instead use `setUserAttribute(String, Int)` instead use `setUserAttribute(String, Long)`instead use `setUserAttribute(String, Float)` instead use `setUserAttribute(String, Double)` instead use `setUserAttribute(String, Boolean)` instead use `setUserAttribute(String, String)` instead use `removeUserAttribute(String)` instead use `clearUserAttributes()` instead use `setUserAlias(String, String)` instead use `removeUserAlias(String)` instead use `clearUserAlias()` instead
Unit	`expireUser()` This method was deprecated in v4. use `clearUser()` instead
Unit	`trackEvent(category: StandardEventCategory, action: String? = null, label: String? = null, value: Number? = null, customAttributes: Map<String, Any?>? = null, semanticAttributes: Map<String, Any?>? = null)` This method was removed in v4. use `trackEvent(String, Map<String, Any>?, Map<String, Any>?)` instead
Unit	`trackEvent(category: String, action: String? = null, label: String? = null, value: Number? = null, customAttributes: Map<String, Any?>? = null, semanticAttributes: Map<String, Any?>? = null)` This method was deprecated in v4. use `trackEvent(String, Map<String, Any>?, Map<String, Any>?)` instead
Unit	`trackEvent(event: Event)` This method was deprecated in v4. use `trackEvent(String, Map<String, Any>?, Map<String, Any>?)` instead
Unit	`getDeeplink(intent: Intent, callback: AirbridgeCallback<Uri>)` This method was deprecated in v4. use `handleDeeplink(Intent, OnSuccess<Uri>, OnFailure?)` instead
Unit	`click(trackingLink: String, callback: AirbridgeCallback<Boolean>? = null)` This method was deprecated in v4. use `click(String, OnSuccess<Unit>, OnFailure?)` instead
Unit	`impression(trackingLink: String)` This method was deprecated in v4. use `impression(String, OnSuccess<Unit>, OnFailure?)` instead
Unit	`setJavascriptInterface(webView: WebView, webToken: String)` This method was deprecated in v4. use `setWebInterface(WebView, String)` instead

Class 변경 사항

Added

Class name	Description
AirbridgeOption	`initializeSDK(Application, AirbridgeOption)` 에서 사용하는 Option class
AirbridgeCategory	`trackEvent(String, Map<String, Any>?, Map<String, Any>?)`에서 사용되는 스탠다드 이벤트의 키
AirbridgeAttributes	`trackEvent(String, Map<String, Any>?, Map<String, Any>?)`에서 사용되는 시멘틱 어트리뷰트의 키
OnSuccess	OnSuccess callback
OnFailure	OnFailure callback
AirbridgeLogLevel	Airbridge log level

Hidden

Class name	Description
Event	This class was hidden in v4. use `trackEvent(String, Map<String, Any>?, Map<String, Any>?)` instead

Class name

Description

Event

This class was hidden in v4.

use trackEvent(String, Map<String, Any>?, Map<String, Any>?) instead

Removed

Class name	Description
AirbridgeConfig	This class was removed in v4. use `setWebInterface(WebView, String)` instead
StandardEventCategory	This class was removed in v4. use `AirbridgeCategory` instead
SemanticAttributes	This class was removed in v4. use `AirbridgeAttributes` instead
Product	This class was removed in v4. use `AirbridgeProduct` instead
AirbridgeCallback	This class was removed in v4. use `OnSuccess<T>`, `OnFailure` instead
OnDeferredDeeplinkReceiveListener	This class was removed in v4. use `handleDeferredDeeplink(OnSuccess<T>, OnFailure)` instead
OnDeferredDeeplinkDetermineListener	This class was removed in v4.
AirbridgeDeviceInfo	This method was removed in v4. use `setDeviceAlias(String, String)` instead use `removeDeviceAlias(String)` instead use `clearDeviceAlias()` instead use `fetchDeviceUUID(OnSuccess<String>, OnFailure?)` instead use `fetchGoogleInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchHuaweiInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchOneStoreInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchGalaxyStoreInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchMetaInstallReferrerDetails(OnSuccess<ReferrerDetails?>, OnFailure?)` instead use `fetchGoogleAdvertisingIdInfo(OnSuccess<AdvertisingIdInfo>, OnFailure?)` instead use `fetchHuaweiAdvertisingIdInfo(OnSuccess<AdvertisingIdInfo>, OnFailure?)` instead
AirbridgeUser	This method was removed in v4. use `setUserID(String)` instead use `setUserEmail(String)` instead use `setUserPhone(String)` instead use `setUserAttribute(String, Int)` instead use `setUserAttribute(String, Long)` instead use `setUserAttribute(String, Float)` instead use `setUserAttribute(String, Double)` instead use `setUserAttribute(String, Boolean)` instead use `setUserAttribute(String, String)` instead use `removeUserAttribute(String)` instead use `clearUserAttributes()` instead use `setUserAlias(String, String)` instead use `removeUserAlias(String)` instead use `clearUserAlias()` instead

Moved

Class name	Description
AdvertisingIdInfo	move `co.ab180.airbridge.common` package
ReferrerDetails	move `co.ab180.airbridge.common` package

AirbridgeOption

AirbridgeConfig	AirbridgeOption	default value
`constructor(String, String)`	`constructor(String, String)`	-
`setSDKSignatureSecret(String, String)`	`setSDKSignatureSecret(String, String)`	-
`setLogLevel(int)`	`setLogLevel(AirbridgeLogLevel)`	`AirbridgeLogLevel.WARNING`
`setSessionTimeoutSeconds(Long)`	`setSessionTimeout(Long)`	300
`setUserInfoHashEnabled(Boolean)`	`setHashUserInformationEnabled(Boolean)`	true
`setAutoStartTrackingEnabled(Boolean)`	`setAutoStartTrackingEnabled(Boolean)`	true
`setTrackInSessionLifeCycleEventEnabled(Boolean)`	`setTrackInSessionLifeCycleEventEnabled(Boolean)`	false
`setTrackAirbridgeLinkOnly(Boolean)`	`setTrackAirbridgeDeeplinkOnlyEnabled(Boolean)`	false
`setTransmitEventOnBackgroundEnabled(Boolean)`	`setPauseEventTransmitOnBackgroundEnabled(Boolean)`	false
`setLocationCollectionEnabled(Boolean)`	`setCollectLocationEnabled(Boolean)`	false
`setFacebookDeferredAppLinkEnabled(Boolean)`	`setTrackMetaDeferredAppLinkEnabled(Boolean)`	false
`setErrorLogCollectionEnabled(Boolean)`	`setErrorLogCollectionEnabled(Boolean)`	true
`setResetEventBufferEnabled(Boolean)`	`setClearEventBufferOnInitializeEnabled(Boolean)`	false
`setSdkEnabled(Boolean)`	`setSdkEnabled(Boolean)`	true
`setAppMarketIdentifier(String)`	`setAppMarketIdentifier(String)`	“”
`setPlatform(String)`	`setSDKDevelopmentPlatform(String)`	“native”
`setEventMaximumBufferCount(Int)`	`setEventBufferCountLimit(Int)`	Int.MAX_VALUE
`setEventMaximumBufferSize(Long)`	`setEventBufferSizeLimit(Long)`	Long.MAX_VALUE
`setEventTransmitInterval(Long)`	`setEventTransmitInterval(Long)`	0
`setCustomDomains(List<String>)`	`setCustomDomains(List<String>)`	emptyList()
`setOnDeferredDeeplinkReceiveListener(OnDeferredDeeplinkReceiveListener)`	remove	-
`setOnDeferredDeeplinkDetermineListener(OnDeferredDeeplinkDetermineListener)`	remove	-
`setOnAttributionResultReceiveListener(OnAttributionResultReceiveListener)`	`setOnAttributionReceived(OnAttributionResultReceiveListener)`	null
`setFacebookOnDeviceAttribution(String)`	`setMetaInstallReferrer(String)`	null
`setLifecycleIntegration(AirbridgeLifecycleIntegration)`	`setLifecycleIntegration(AirbridgeLifecycleIntegration)`	null

SDK 초기화

Airbridge.init(Application, AirbridgeConfig)가Airbridge.initializeSDK(Application, AirbridgeOption)으로 변경됐습니다.

AirbridgeConfig가 AirbridgeOption으로 변경됐습니다. AirbridgeConfig.Builder가 AirbridgeOptionBuilder로 변경됐습니다. AirbridgeOptionBuilder에 있는 일부 함수 이름이 변경되거나 삭제됐습니다.

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

123456
override fun onCreate() {
    super.onCreate()
    val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        .build()
    Airbridge.initializeSDK(this, option)
}

1234567
@Override
public void onCreate() {
    super.onCreate();
    AirbridgeOption option = new AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        .build();
    Airbridge.initializeSDK(this, option);
}

딥링크

함수 이름이 getDeeplink()에서 handleDeeplink()로 변경되었습니다. AirbridgeCallback이 삭제 되고 OnSuccess, OnFailure listener가 추가되었습니다. return 값을 통해 해당 함수의 동작 여부를 확인할 수 있습니다.

12345
val result = Airbridge.handleDeeplink(
    intent = intent
    onSuccess = { },
    onFailure = { }
)

listener을 추가하는 기존 디퍼드 딥링크 코드 로직을 더 편하게 화면 이동을 구현할 수 있도록 개선했습니다. listener을 추가하는 기존 방식은 삭제됐습니다. 대신 에어브릿지 인터페이스로 디퍼드 딥링크를 전달 받을 수 있습니다.

handleDeeplink 와 값을 activity 구성에서 호출할 수 있습니다.
result 값으로 디퍼드 딥링크를 처리할 수 있는 상태인지 확인할 수 있습니다.
디퍼드 딥링크는 앱 설치 이후에 1번만 획득하도록 설계됐습니다. 값을 이미 획득했거나 먼저 호출하면 result는 false입니다.

1234
val result = Airbridge.handleDeferredDeeplink(
    onSuccess = { },
    onFailure = { }
)

인앱 이벤트 및 유저 정보

아래 기존 API가 삭제되었습니다. 또한 StandardEventCategory, SemanticAttributes, Product가 삭제되었습니다.

trackEvent(category: StandardEventCategory, action: String? = null, label: String? = null, value: Number? = null, customAttributes: Map<String, Any?>? = null, semanticAttributes: Map<String, Any?>? = null)
trackEvent(category: String, action: String? = null, label: String? = null, value: Number? = null, customAttributes: Map<String, Any?>? = null, semanticAttributes: Map<String, Any?>? = null)
trackEvent(event: Event)

새로운 API 가 추가되었습니다.

trackEvent(category: String, semanticAttributes: Map<String, Any>? = null, customAttributes: Map<String, Any>? = null)
AirbridgeCategory가 추가되었습니다. event category string은 미리 정의되어 있습니다.
기타 정보 전달을 위한 함수 override 와 객체(SemanticAttributes, Product)가 삭제됐습니다.
대신 map 을 통해 어트리뷰트(attribute)을 전달하도록 수정되었습니다. map의 키 값은 AirbridgeAttribute에 string으로 미리 정의되어 있습니다. 커스텀 어트리뷰트는 string으로 직접하여 전달할 수 있습니다.

아래에서 AirbridgeCategory, AirbridgeAttribute 매핑과 trackEvent 함수를 참고해 주세요.

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

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

123456789101112131415161718192021222324252627
Airbridge.trackEvent(
    AirbridgeCategory.ORDER_COMPLETED,
    mapOf(
        // action
        AirbridgeAttribute.ACTION to "Tool",
        // label
        AirbridgeAttribute.LABEL to "Hammer",
        // value
        AirbridgeAttribute.VALUE to 10,
        // semantic attribute (provided by sdk)
        AirbridgeAttribute.CURRENCY to "USD",
        AirbridgeAttribute.PRODUCTS to listOf(
            mapOf(
                // semantic attribute value (provided by sdk)
                AirbridgeAttribute.PRODUCT_ID to "12345",
                // semantic attribute value (not provided by sdk)
                "name" to "PlasticHammer",
            ),
        ),
        // semantic attribute (not provided by sdk)
        "totalQuantity" to 1,
    ),
    mapOf(
        // custom attribute
        "promotion" to "FirstPurchasePromotion",
    )
)

12345678910111213141516171819202122232425262728
Airbridge.trackEvent(
        AirbridgeCategory.ORDER_COMPLETED,
        new HashMap() {{
            // action
            put(AirbridgeAttribute.ACTION, "Tool");
            // label
            put(AirbridgeAttribute.LABEL, "Hammer");
            // value
            put(AirbridgeAttribute.VALUE, 10);
            // semantic attribute (provided by sdk)
            put(AirbridgeAttribute.CURRENCY, "USD");
            put(AirbridgeAttribute.PRODUCTS, Arrays.asList(
                new HashMap() {{
                    // semantic attribute value (provided by sdk)
                    put(AirbridgeAttribute.PRODUCT_ID, "12345");
                    // semantic attribute value (not provided by sdk)
                    put("name", "PlasticHammer");
                }}
            ));
            // semantic attribute (not provided by sdk)
            put("totalQuantity", 1);
            
        }},
        new HashMap() {{
            // custom attribute
            put("promotion", "FirstPurchasePromotion");
        }}
);

AirbridgeUser가 삭제되었습니다. 에어브릿지 인터페이스로 AirbridgeUser를 통해서 접근하는 인터페이스를 접근할 수 있습니다.

Airbridge.getUserInfo()를 통해서 접근하는 코드 대신 아래 에어브릿지 인터페이스로 교체해 사용해야 합니다.

123456789101112131415161718
fun setUserID(id: String)
fun setUserEmail(email: String)
fun setUserPhone(phone: String)

fun setUserAttribute(key: String, value: Int)
fun setUserAttribute(key: String, value: Long)
fun setUserAttribute(key: String, value: Float)
fun setUserAttribute(key: String, value: Double)
fun setUserAttribute(key: String, value: Boolean)
fun setUserAttribute(key: String, value: String)
fun removeUserAttribute(key: String)
fun clearUserAttributes()

fun setUserAlias(key: String, value: String)
fun removeUserAlias(key: String)
fun clearUserAlias()

fun clearUser()

123456789101112131415161718
void setUserID(String id)
void setUserEmail(String email)
void setUserPhone(String phone)

void setUserAttribute(String key, int value)
void setUserAttribute(String key, long value)
void setUserAttribute(String key, float value)
void setUserAttribute(String key, double value)
void setUserAttribute(String key, boolean value)
void setUserAttribute(String key, String value)
void removeUserAttribute(String key)
void clearUserAttributes()

void setUserAlias(String key, String value)
void removeUserAlias(key: String)
void clearUserAlias()

void clearUser()

AirbridgeDeviceInfo가 삭제되었습니다. AirbridgeDeviceInfo를 통해서 접근하던 인터페이스는 에어브릿지 인터페이스로 접근할 수 있도록 수정되었습니다.

AirbridgeCallback이 삭제되고 OnSuccess, OnFailure listener가 추가되었습니다. 해당 listener 를 통해 성공 여부를 전달 받을 수 있습니다.

Airbridge.getDeviceInfo()를 통해서 접근하는 코드 대신 아래 에어브릿지 인터페이스로 교체해서 사용해야 합니다.

Device UUID

1234
val result = Airbridge.fetchDeviceUUID(
    onSuccess = { },
    onFailure = { }
)

Install referrer

fetch Google Install referrer

1234
val result = Airbridge.fetchGoogleInstallReferrerDetails(
    onSuccess = { },
    onFailure = { }
)

fetch Huawei Install referrer

1234
val result = Airbridge.fetchHuaweiInstallReferrerDetails(
    onSuccess = { },
    onFailure = { }
)

fetch Galaxy store Install referrer

1234
val result = Airbridge.fetchGalaxyStoreInstallReferrerDetails(
    onSuccess = { },
    onFailure = { }
)

fetch Meta Install referrer

1234
val result = Airbridge.fetchMetaInstallReferrerDetails(
    onSuccess = { },
    onFailure = { }
)

Advertising ID

fetch Google Advertising ID

1234
val result = Airbridge.fetchGoogleAdvertisingIdInfo(
    onSuccess = { },
    onFailure = { }
)

fetch Huawei Advertising ID

1234
val result = Airbridge.fetchHuaweiAdvertisingIdInfo(
	onSuccess = { },
	onFailure = { }
)

AirbridgeDeviceInfo가 삭제되었습니다. 에어브릿지 인터페이스를 통해서 attribution result를 전달 받는 함수는 제공되지 않습니다. 다만, AirbridgeOption의 listener를 통해 전달 받을 수 있습니다. 기존에도 제공하는 방법입니다.

123456789101112
class App : Application() {

    override fun onCreate() {
        super.onCreate()
        val option: AirbridgeOption = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
            .setOnAttributionReceived { result ->
                // do something
            }
            .build()
        Airbridge.initializeSDK(this, option)
    }
}

123456789101112131415
class App extends Application {
    
    @Override
    public void onCreate() {
        super.onCreate();
        
        Airbridge.initializeSDK(this,
                new AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
                        .setOnAttributionReceived(result -> {
                            // do something
                        })
                        .build()
                );
    }
}

AirbridgeCallback이 삭제되고 OnSuccess, OnFailure listener가 추가되었습니다. return 값을 통해 해당 함수의 동작 여부를 확인할 수 있습니다.

click

12345
fun click(
    trackingLink: String,
    onSuccess: OnSuccess<Unit>? = null,
    onFailure: OnFailure? = null
): Boolean

impression

12345
fun impression(
    trackingLink: String,
    onSuccess: OnSuccess<Unit>? = null,
    onFailure: OnFailure? = null
): Boolean

하이브리드 연동

함수 이름이 setJavascriptInterface()에서 setWebInterface()로 변경되었습니다.

1
Airbridge.setWebInterface(webview, "YOUR_WEB_TOKEN")

v2.x 업데이트

Android SDK 각 버전의 주요 변경사항을 참고해 주세요.

v2.24.0

2023년 9월 4일 이후 생성된 에어브릿지 앱은 딥링크 콜백에서 제공되는 딥링크 URL이 에어브릿지 대시보드에 입력된 내용을 2번 디코딩해 제공하는 문제를 해결했습니다.

해당 문제는 안드로이드 SDK v2.22.0 ~ v2.23.0에서 발생했습니다.

v2.21.2

앱이 background 상태에서 이벤트 전송을 중지하는 초기화 옵션이 추가되었습니다.

AirbridgeConfig#setTransmitEventOnBackgroundEnabled 함수로 앱이 background 상태에서 이벤트 중지를 설정할 수 있습니다.
기본 값은 true입니다. true는 background 상태에서도 남은 이벤트를 전송합니다.

v2.21.1

deeplink.page를 지원하지 않습니다. 2.21.1 부터는 abr.ge 로 딥링크 도메인을 사용 하여 코드를 작성 권장 드립니다.

deeplink.page는 하위 호환을 위해 여전히 지원 및 동작은 되고 있습니다.

v2.19.1

세션 타임 이내에 발생된 ORGANIC_REOPEN, FOREGROUND 이벤트는 기본적으로 수집을 하지 않는 구조로 변경되었습니다.

2.19.1 이전 버전을 사용 중 ORGANIC_REOPEN, FOREGROUND 이벤트를 수집하고 있다면 AirbridgeConfig#setTrackInSessionLifeCycleEventEnabled 을 통해 계속 해서 해당 이벤트를 수집할 수 있습니다.
default 값은 false 로 ORGANIC_REOPEN, FOREGROUND이벤트를 수집을 하지 않습니다.

BACKGROUND이벤트가 제거되었습니다.

v2.18.0

딥링크 페이지뷰 이벤트가 Airbridge.click 호출의 경우에만 수집될 수 있도록 변경되었습니다.

도움이 되었나요?

더 필요한 내용이 있나요?

SDK 마이그레이션 가이드 - 안드로이드 SDK (v4)

v2.x에서 v4.0으로 업데이트

전체 변경사항

Airbridge interface

Summary

Deprecated interface

Class 변경 사항

Added

Hidden

Removed

Moved

AirbridgeOption

SDK 초기화

딥링크

필요한 작업 - 디퍼드 딥링크 처리

인앱 이벤트 및 유저 정보

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

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

예시) trackEvent 함수

필요한 작업 - 에어브릿지 인터페이스

필요한 작업 - OnSuccess, OnFailure

Device UUID

Install referrer

Advertising ID

예시) click, impression

하이브리드 연동

v2.x 업데이트

v2.24.0

v2.21.2

v2.21.1

v2.19.1

v2.18.0

SDK 마이그레이션 가이드 - 안드로이드 SDK (v4)self.__wrap_n!=1&&self.__wrap_b(":R29jtt7ppjtsba:",0.5)

v2.x에서 v4.0으로 업데이트

전체 변경사항

Airbridge interface

Summary

Deprecated interface

Class 변경 사항

Added

Hidden

Removed

Moved

AirbridgeOption

SDK 초기화

딥링크

필요한 작업 - 디퍼드 딥링크 처리

인앱 이벤트 및 유저 정보

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

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

예시) trackEvent 함수

필요한 작업 - 에어브릿지 인터페이스

필요한 작업 - OnSuccess, OnFailure

Device UUID

Install referrer

Advertising ID

예시) click, impression

하이브리드 연동

v2.x 업데이트

v2.24.0

v2.21.2

v2.21.1

v2.19.1

v2.18.0

SDK 마이그레이션 가이드 - 안드로이드 SDK (v4)