Developer Guide
SDK 集成
Android SDK (v4)

SDK 迁移指南 - Android SDK (v4)

Last updated a day ago

您可以查看更新 Airbridge Android SDK 过程中需要注意的内容。建议查看当前版本至目标更新版本之间的所有更新详情。

从 v2.x 更新至 v4.0

如果您将 Airbridge Android SDK 更新至 v4.0，请查看以下内容。

Airbridge Interface

Summary


Unit	`initializeSDK(app: Application, config: 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()` Starts 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 and value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Long)` Sets the key and value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Float)` Sets the key and value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Double)` Sets the key and value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: Boolean)` Sets the key and value pair to the user attribute.
Unit	`setUserAttribute(key: String, value: String)` Sets the key and 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 and 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. This determines whether it is a push notification to track uninstalls.
Unit	`trackEevnt(category: String, semanticAttributes: Map<String, Any> = null, customAttributes: Map<String, Any> = null)` Tracks events.
Boolean	`handleDeeplink(intent: Intent, onSuccess: OnSuccess<Uri>, onFailure: OnFailure? = null)` Handles Airbridge's deep links from the provided intent and invokes a callback based on the result.
Boolean	`handleDeferredDeeplink(onSuccess: OnSuccess<Uri?>, onFailure: OnFailure? = null)` Handles deferred deep links and invokes 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 deep link information and then moves according to that information if a deep link 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)` Fetches the Google Install Referrer.
Boolean	`fetchHuaweiInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` Fetched the Huawei Install Referrer.
Boolean	`fetchOneStoreInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` Fetchs the Onestore Install Referrer.
Boolean	`fetchGalaxyStoreInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` Fetches the Galaxy Store Install Referrer.
Boolean	`fetchMetaInstallReferrerDetails(onSuccess: OnSuccess<ReferrerDetails?>, onFailure: OnFailure? = null)` Fetches the Meta Install Referrer.
Boolean	`fetchGoogleAdvertisingIdInfo(onSuccess: OnSuccess<AdvertisingIdInfo>, onFailure: OnFailure? = null)` Fetches the Google Advertising ID info.
Boolean	`fetchHuaweiAdvertisingIdInfo(onSuccess: OnSuccess<AdvertisingIdInfo>, onFailure: OnFailure? = null)` Fetches the 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 changes

Added

Class name	Description
AirbridgeOption	`initializeSDK(Application, AirbridgeOption)` 에서 사용하는 Option class
AirbridgeCategory	Key of Standard Event used on `trackEvent(String, Map<String, Any>?, Map<String, Any>?)`
AirbridgeAttributes	Key of Semantic Attribute used on `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	Moved to `co.ab180.airbridge.common` package
ReferrerDetails	Moved `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 = { }
)
val result = Airbridge.handleDeeplink(
    intent = intent
    onSuccess = { },
    onFailure = { }
)

为便于实现页面跳转，改进了添加 listener 的原有延迟深度链接代码逻辑。原有的 listener 添加方式已被删除，现在可以通过 Airbridge 接口接收延迟深度链接。

可以在 activity 组件中调用 handleDeeplink 并获取其值。
通过 result 值，可以检查是否处于可处理延迟深度链接的状态。
延迟深度链接设计为仅在 App 安装后获取一次。如果已获取 result 值或提前调用，则 result 值为 false。

1234
val result = Airbridge.handleDeferredDeeplink(
    onSuccess = { },
    onFailure = { }
)
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 预定义。Custom Attribute 可直接以 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",
    )
)
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 已被删除。可以通过 Airbridge 接口访问原先通过 AirbridgeUser 访问的接口。

请使用以下 Airbridge 接口替换原先通过 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()
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 访问的接口已更改为通过 Airbridge 接口访问。

AirbridgeCallback 已被删除，并新增 OnSuccess 和 OnFailure listener。您可以通过 listener 接收操作的成功与否。

请使用以下 Airbridge 接口替换原先通过 Airbridge.getDeviceInfo() 访问的代码。

Device UUID

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

1234
boolean result = Airbridge.fetchDeviceUUID(
        uuid -> { },
        throwable -> { }
    );
boolean result = Airbridge.fetchDeviceUUID(
        uuid -> { },
        throwable -> { }
    );

Install referrer

fetch Google Install referrer

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

1234
boolean result = Airbridge.fetchGoogleInstallReferrerDetails(
        referrerDetails -> { },
        throwable -> { }
);
boolean result = Airbridge.fetchGoogleInstallReferrerDetails(
        referrerDetails -> { },
        throwable -> { }
);

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 = { }
)
val result = Airbridge.fetchMetaInstallReferrerDetails(
    onSuccess = { },
    onFailure = { }
)

1234
boolean result = Airbridge.fetchMetaInstallReferrerDetails(
        referrerDetails -> { },
        throwable -> { }
    );
boolean result = Airbridge.fetchMetaInstallReferrerDetails(
        referrerDetails -> { },
        throwable -> { }
    );

Advertising ID

fetch Google Advertising ID

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

fetch Huawei Advertising ID

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

AirbridgeDeviceInfo 已被删除，且不提供通过 Airbridge 接口接收 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)
    }
}
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
fun click(
    trackingLink: String,
    onSuccess: OnSuccess<Unit>? = null,
    onFailure: OnFailure? = null
): Boolean

12345
boolean click(
    @NonNull String trackingLink,
    @Nullable OnSuccess<Unit> onSuccess,
    @Nullable OnFailure onFailure
)
boolean click(
    @NonNull String trackingLink,
    @Nullable OnSuccess<Unit> onSuccess,
    @Nullable OnFailure onFailure
)

impression（展示）

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

Hybrid 集成

函数名称已从 setJavascriptInterface() 更改为 setWebInterface()。

1
Airbridge.setWebInterface(webview, "YOUR_WEB_TOKEN")

v2.x 更新

请参考各 Android SDK 版本的主要变更内容。

v2.24.0

修复了 Android SDK v.2.22.0～v.2.23.0 中出现的，2023-09-04 及以后创建的 Airbridge App 在深度链接回调中提供的深度链接 URL 被解码两次的问题。

v2.21.2

新增初始化选项，可在 App 处于后台（background）状态时停止事件发送。

可通过 AirbridgeConfig#setTransmitEventOnBackgroundEnabled 函数进行设置。
默认值为 true，意味 App 在后台状态下仍会发送未发送的事件。

v2.21.1

deeplink.page 已被弃用。从 v2.21.1 起，请使用 abr.ge 作为深度链接域名进行代码编写。

为了保持向后兼容性，deeplink.page 仍然受支持并可正常运行。

v2.19.1

更改为默认不收集在会话中发生的 ORGANIC_REOPEN 和 FOREGROUND 事件。

如果正在使用低于 v2.19.1 的版本并收集 ORGANIC_REOPEN 和 FOREGROUND 事件，可以通过设置 AirbridgeConfig#setTrackInSessionLifeCycleEventEnabled 继续收集这些事件。
默认值为 false，意味不收集 ORGANIC_REOPEN 和 FOREGROUND 事件。

删除了 BACKGROUND 事件。

v2.18.0

更改为只有在调用 Airbridge.click 时收集深度链接页面浏览（Deeplink Pageview）事件。

Was this page helpful?

Have any questions or suggestions?

SDK 迁移指南 - Android SDK (v4)

从 v2.x 更新至 v4.0

全部变更详情

Airbridge Interface

Summary

Deprecated Interface

Class changes

Added

Hidden

Removed

Moved

AirbridgeOption

SDK 初始化

深度链接

必需操作 - 延迟深度链接处理

应用内事件及用户信息

SDK 提供的标准事件 Category（AirbridgeCategory）

SDK 提供的 Semantic Attribute（AirbridgeAttribute）

示例：trackEvent 函数

必需操作 - Airbridge 接口

必需操作 - OnSuccess、OnFailure

Device UUID

Install referrer

Advertising ID

示例：点击、展示

Hybrid 集成

v2.x 更新

v2.24.0

v2.21.2

v2.21.1

v2.19.1

v2.18.0

SDK 迁移指南 - Android SDK (v4)self.__wrap_n!=1&&self.__wrap_b(":R29jtt7ppjtsba:",0.5)

从 v2.x 更新至 v4.0

全部变更详情

Airbridge Interface

Summary

Deprecated Interface

Class changes

Added

Hidden

Removed

Moved

AirbridgeOption

SDK 初始化

深度链接

必需操作 - 延迟深度链接处理

应用内事件及用户信息

SDK 提供的标准事件 Category（AirbridgeCategory）

SDK 提供的 Semantic Attribute（AirbridgeAttribute）

示例：trackEvent 函数

必需操作 - Airbridge 接口

必需操作 - OnSuccess、OnFailure

Device UUID

Install referrer

Advertising ID

示例：点击、展示

Hybrid 集成

v2.x 更新

v2.24.0

v2.21.2

v2.21.1

v2.19.1

v2.18.0

SDK 迁移指南 - Android SDK (v4)