Quick Tracking:YonBuilder SDK

qtAnalytics ネイティブプラグインの使用方法

1. 使用する前に、QuickTracking からアカウントを申請し、アプリケーションを作成して アプリケーションキー と受信 ドメイン名 を取得する必要があります。

Quick Tracking 公式ウェブサイト統合プロセスリファレンス

2. config.xml ファイルを構成します。構成が完了したら、有効にするためにクラウドでファイルをコンパイルする必要があります。構成方法は次のとおりです。

• 名前: qtAnalytics

• パラメーター: ios_appkey、ios_channel、android_appkey、android_channel、primaryDomain、および standbyDomain

• 構成例:

<feature name="qtAnalytics">
  <param name="ios_appkey" value="YOUR_IOS_APP_KEY"/>
  <param name="ios_channel" value="YOUR_IOS_CHANNEL"/>
  <param name="android_appkey" value="YOUR_ANDROID_APP_KEY"/>
  <param name="android_channel" value="YOUR_ANDROID_CHANNEL"/>
  <param name="primaryDomain" value="YOUR_primaryDomain"/>
  <param name="standbyDomain" value="YOUR_standbyDomain"/>
</feature>

• フィールドの説明:

  1. ios_appkey: iOS アプリのキー。

  2. ios_channel: iOS チャネルの ID。

  3. android_appkey: Android アプリのキー。

  4. android_channel: Android チャネル番号。

  5. primaryDomain: データ追跡 プライマリ エンドポイント。

  6. standbyDomain: データ追跡 サブエンドポイント。

ネイティブプラグイン API

初期化 API

init

パラメーター

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.init(
    {logEnabled:true},
    function(ret, err) {
        if (ret.status) {
            api.alert({
                msg: JSON.stringify(ret)
            })
        } else {
            api.alert({
                msg: JSON.stringify(err)
            })
        }
    }
);

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

追跡の無効化

disableSDK

• アプリ側のプライバシーポリシー操作プロセス制御を考慮すると、SDK にはオンオフ識別のための追加のキャッシュステータス制御がありません。つまり、このコールドスタート後に SDK 機能を無効にし、すべてのコールドスタートで追跡を無効にする場合は、ビジネスの研究開発のために disableSDK API 関数をアクティブに呼び出す必要があります。

• iOS SDK は EDAS アプリケーションライフサイクル内で一度だけ初期化でき、初期化シナリオはネットワークとサーバー間の通信に依存します。したがって、SDK を呼び出して機能を無効化または有効化する場合は、次のシナリオに注意してください。

  

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.disableSDK();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

SDK の有効化

enableSDK

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.enableSDK();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

パス設定

resetStorePath

Umeng+ SDK を使用したかどうかを確認します。SDK を使用した場合は、SDK ファイルパスを変更します。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.resetStorePath();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

カスタム Android デバイス識別子

setAndroidDeviceInfo

SDK はデフォルトのデバイス識別子追跡を実装します。このデフォルトの実装クラスは、デフォルトで次の識別子を追跡します。

開発者が上記の表にある特定のデバイス識別子の追跡を制御したい場合、たとえば、IMEI フィールドと Serial フィールドは追跡されず、OAID 追跡方法は開発者によって実装されます。これらのフィールドをカスタマイズできます。

注

1. パラメーターをカスタマイズしない場合、システムは Quick Tracking SDK を使用してデータを追跡します。

2. SDK 初期化関数を呼び出す前に、setAndroidDeviceInfo 設定関数を呼び出します

3. デバイス識別子追跡を制御する必要がない場合は、呼び出す必要はありません。

パラメーター

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.setAndroidDeviceInfo({
    IMEI:null,
    Serial:null,
    OAID:"custom_oaid"
});
qtAnalytics.init(
    {logEnabled:true},
    function(ret, err) {
        if (ret.status) {
            api.alert({
                msg: JSON.stringify(ret)
            })
        } else {
            api.alert({
                msg: JSON.stringify(err)
            })
        }
    }
);

可用性

Android

1.0.0 以降で使用可能

idfa のカスタマイズ

customSetIdfa

カスタム設定 idfa、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetIdfa({
    idfa: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

idfv のカスタマイズ

customSetIdfv

カスタム設定 idfv、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetIdfv({
    idfv: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

custom openUdid

customSetOpenUdid

カスタム設定 openUdid、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetOpenUdid({
    openUdid: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

カスタム utdid

customSetUtdid

カスタム設定 utdid、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetUtdid({
    utdid: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

カスタム mcc

customSetMcc

カスタム設定 mcc、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetMcc({
    mcc: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

カスタム mnc

customSetMnc

カスタム設定 mnc、追跡なしで返却 ''

注: 対応するメソッドを実装するかどうかを慎重に決定してください。追跡方法を自分で実装することを選択すると、このデバイス識別子の追跡を引き継ぎ、SDK はこのデバイス識別子の追跡を再試行しません。SDK で追跡できるデバイス識別子が少ないほど、統計データの精度と安定性に悪影響を及ぼします。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.customSetMnc({
    mnc: ''
});

可用性

iOS でのトラブルシューティング

1.0.0 以降で使用可能

カスタムデバイス ID

setCustomDeviceId

注

したがって、この関数は umid が取得されない場合に有効になります。umid がすでにローカルコンピューターに存在する場合、設定後は無効になります。umid をローカルで取得した場合は、アンインストールして再読み込みすることでこの機能を確認できます。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.setCustomDeviceId({
    deviceId: 'xxxxxx'
});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

デバイス ID の取得

getUMIDString

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
var umidStr = qtAnalytics.getUMIDString();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

クライアントへのログイン

ユーザーはデバイスに基づいてカウントされます。アプリケーションのアカウントをカウントするには、次の API 操作を呼び出します。

onProfileSignIn

注: アカウント ID は ローカル記憶域 に保存されます。アカウント ID は、アプリケーションがアンインストールされた場合、アプリケーションデータがクリアされた場合、または次のログイン API が呼び出された場合にのみ無効になります。それ以外の場合、各イベントにはアカウント ID が含まれます。

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onProfileSignIn({userId:"custom_userId"});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

ログアウト

アカウントからログオフするときは、この操作を呼び出す必要があります。この操作を呼び出した後、アカウント関連のコンテンツは送信されません。

onProfileSignOff

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onProfileSignOff()

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

ユーザー プロパティの構成

ユーザー属性を報告する前に、ユーザーアカウントを報告するために userId を設定する必要があります。そうしないと、Quick Tracking はユーザー属性の相関計算を実行しません。報告ユーザーのアカウント ID を確認した後、ユーザー属性を報告するための API は次のとおりです。

setUserProfile

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.setUserProfile({
    properties:{
        sex:"girl", // 性別。
        age:"8"// 年齢
    }
});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

グローバル属性の登録

グローバル属性が登録されると、後続のすべてのイベントにこれらの属性が自動的に含まれます。これらの属性と属性値はキャッシュに保存され、APP の終了後にクリアされます。データを分析するときに、この プロパティ に基づいて表示およびフィルタリングできます。

registerGlobalProperties

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
var param = {properties:{a:"1",b:"2"}};
qtAnalytics.registerGlobalProperties(param);// 現在の globalproperty は a:1 と b:2

var param = {properties:{b:"3",c:"4"}};
qtAnalytics.registerGlobalProperties(param);// 現在の globalproperty は a:1、b:3、c:4

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

グローバル属性の削除

unregisterGlobalProperty

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
var param = {propertyName:"lnch_Source"};
qtAnalytics.unregisterGlobalProperty(param);

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

キーに基づいてグローバル属性を取得する

getGlobalProperty

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
var param = {propertyName:"lnch_Source"};
var gp = qtAnalytics.getGlobalProperty(param);

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

すべてのグローバル属性を取得する

getGlobalProperties

• 説明: すべてのグローバル属性とそれに対応する属性値を含む文字列を返します。グローバル属性と属性値は K-V キーと値のペアで表されます。複数のキーと値のペアはコンマ (,) で区切ります。データの外側のレイヤーは中かっこです。例:{"id":"SA1375","userName":"Mike","account_type":"vip", "MemberLevel":"Level1"}

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
var allgp = qtAnalytics.getGlobalProperties();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

すべてのグローバル属性をクリアする

clearGlobalProperties

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.clearGlobalProperties();

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

ページの手動追跡

ページパスとページ滞在時間の統計を追跡および追跡したい開発者向け。onPageStart または onPageEnd 操作を呼び出して、手動で追跡できます。

注:

• onPageStart SDK はページエントリ情報を記録します。onPageStart SDK はイベントを報告しません。onPageEnd SDK は、onPageEnd SDK を呼び出したときにのみページ閲覧イベントを報告します。

• onPageStart と onPageEnd はペアで呼び出す必要があり、渡される値の pageName は同じである必要があります。onPageEnd が使用されない場合、または onPageEnd によって渡される値の pageName が onPageStart の値と一致しない場合、onPageStart に記録された情報は有効になりません。

onPageStart

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onPageStart({pageName:"MainScreen"});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

ページの手動追跡終了

onPageEnd

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onPageEnd({pageName:"MainScreen"});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

ページ プロパティ のアップロード

カスタム プロパティ を現在のページに添付することをサポートします。

setPageProperty

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onPageStart({pageName:"MainScreen"});
qtAnalytics.setPageProperty({
    pageName:"MainScreen",
    properties:{
        home_param_1:"value11" // 現在のページの プロパティ を設定します。
    }
});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

カスタム プロパティ を次のページに添付する

次のページで onPageStart 操作を実行する前に、onPageStart 操作を呼び出す必要があります。

setNextPageProperty

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.setNextPageProperty({
    properties: {
                nextPageProperty: "secondPageProperty"
            }
        });

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

イベント追跡ポイント

カスタムイベントを使用してユーザーの行動を追跡し、行動 発生 の詳細を記録できます。

onEventObject

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onEventObject({
    eventId:"play_music",
    pageName:"MainScreen",
    properties:{
        music_type:"popular", // カスタム パラメーター : 音楽の種類。値: 人気
        singer:"JJ", // 歌手: (Junjie Lin) JJ
        Song_name:"A_Thousand_Years_Later", // 曲名: 千年後
        Song_price: 100 // 価格: 100 元
    }
});

可用性

iOS システム、Android システム

1.0.0 以降で使用可能

プロセス強制終了保護方法

kill や exit などのメソッドを呼び出してプロセスを強制終了する場合は、統計を保存するために onKillProcess を呼び出す必要があります。

onKillProcess

サンプルコード

var qtAnalytics = api.require('qtAnalytics');
qtAnalytics.onKillProcess();

可用性

Android

1.0.0 以降で使用可能

使用上の注意

• YonBuilder プラットフォームは openURL API を提供していません。したがって、追跡検証機能は iOS では使用できません。リアルタイムログ検証機能を使用してテストを実行できます。デバイス ID の取得方法の詳細については、「デバイス ID の取得」をご参照ください。

• YonBuilder は自動追跡機能をサポートしていません。

• YonBuilder は共有分裂機能をサポートしていません。