コンテンツにスキップ

カスタムタグと BridgeContext¶

MobileAgent の取得¶

通常の uni-app は GC-UniPlugin から、uni ミニアプリは GC-JSPlugin からインポートします：

// 通常の uni-app
import { mobileAgent } from '@/uni_modules/GC-UniPlugin';

// uni ミニアプリは以下のインポートで上記を置き換えます
// import { mobileAgent } from '@/uni_modules/GC-JSPlugin';

初期化時のグローバルタグの設定¶

通常の uni-app では、sdkConfig または rum.setConfig 内の globalContext を使用してカスタムタグを渡せます：

mobileAgent.sdkConfig({
    datakitUrl: 'YOUR_DATAKIT_URL',
    globalContext: {
        custom_key: 'custom value'
    }
});

uni ミニアプリは SDK を再初期化せず、ホスト App が Native SDK の初期化設定で初期グローバルタグを設定します。

実行時のカスタムタグの追加¶

mobileAgent.appendGlobalContext({
    ft_global_key: 'ft_global_value'
});

mobileAgent.appendRUMGlobalContext({
    ft_global_rum_key: 'ft_global_rum_value'
});

mobileAgent.appendLogGlobalContext({
    ft_global_log_key: 'ft_global_log_value'
});

API	説明
appendGlobalContext(object)	RUM と Log に適用されるグローバルパラメータを追加します
appendRUMGlobalContext(object)	RUM のみに適用されるグローバルパラメータを追加します
appendLogGlobalContext(object)	Log のみに適用されるグローバルパラメータを追加します

BridgeContext の追加¶

mobileAgent.appendBridgeContext({
    wgt_id: 'wgt_id_1'
});

appendBridgeContext は、uni-app または uni ミニアプリの JS 側で収集した RUM および Log データにのみ注入され、ホスト App のネイティブ側で独自に収集したデータには影響しません。この機能は、ホスト App と異なる uni ミニアプリのデータソースを区別するのに適しています。

フィールド	型	必須	説明
なし	object	はい	uni-app または uni ミニアプリの環境パラメータ