iOS SDK 利用ガイド

TIP

データをインポートする前に、インポート前の準備をご参照ください。

GitHub (opens new window)でiOS SDKソースコードを取得することができます。

iOS SDKに必要な最低システムバージョンはiOS 8.0です。

iOS SDK(Framework形式)サイズは約5.5 MBです。

**最新バージョン:**2.7.42.7.4

**更新時間:**2022-01-18

ダウンロード (opens new window)

1、SDKの統合と初期化

1.1 自動SDK統合

• CocoaPodsでSDKをインストール

1.Podfileの作成と編集(既にある場合は直接編集):

Podfileを作成し、プロジェクト（. xcodeproj）テキストの同ディレクトリのコマンドラインでコマンドを実行します:

pod init

Podfileの内容を次のように編集します：

platform :ios, '9.0'
target 'YourProjectTarget' do
  pod 'ThinkingSDK'  #ThinkingSDK
end

2.インストールコマンドを実行：

pod install

成功すると、次のような記録が現れます：

3.インポートに成功し、プロジェクトを開始

コマンドの実行が成功すると、. xcworkspaceテキストが生成され、iOS SDKの導入に成功したことを示します。.xcworkspaceテキストを開き、プロジェクトを立ち上げます。(注意:同時 xcodeprojテキストを同時に開くことはできません。)

• CarthageでSDKをインストール

1.Cartfileテキストに次のコードを追加します。

github "ThinkingDataAnalytics/ios-sdk"

2.carthage update --platform iOSを実行し、ThinkingSDK. frameworkをプロジェクトに追加します。

1.2 手動SDK統合

1.iOS SDK (opens new window)をダウンロードして解凍します。

2.ThinkingSDK. frameworkをXCode Project Workspaceプロジェクトにドラッグします。

3.プロジェクト設定Targetsオプションの Build SettingsタブのOther linker flagsの設定を追加-ObjC

4.Build Phasesタブに切り替え、Link Binary With Libraries欄の下に次の依頼コードを追加します。

libz.dylib``、``Security.framework``、``SystemConfiguration.framework``、``libsqlite3.tbd

1.3 SDKの初期化

v1.2.0では、マルチAPPIDインスタンスの特性が追加されました。マルチAPPIDの使用ガイドについては、iOS SDKマルチAPPIDガイドをご参照ください。

AppDelegate. mに#import<ThinkingSDK/ThinkingAnalyticsSDK. h>を追加します。

その後、application: didFinishLaunchingWithOptions:に初期化を追加します。

以下の通り

// 初期化
ThinkingAnalyticsSDK *instance = [ThinkingAnalyticsSDK startWithAppId:APP_ID withUrl:SERVER_URL];

// マルチAPPIDインスタンスをサポート
// ThinkingAnalyticsSDK *instance2 = [ThinkingAnalyticsSDK startWithAppId:APP_ID2 withUrl:SERVER_URL2];

// 初期化
let instance = ThinkingAnalyticsSDK.start(withAppId: "YOUR_APPID", withUrl: "YOUR_SERVER_URL")

// マルチAPPIDインスタンスをサポート
// let instance2 = ThinkingAnalyticsSDK.start(withAppId: "YOUR_APPID2", withUrl: "YOUR_SERVER_URL2")

パラメーターAPP_IDはプロジェクトのAPP_IDであり、プロジェクトを申請するときに付与されます。ここにご入力ください。

パラメーターSERVER_URLは、データアップロードのURLです。

クラウドサービスを使用している場合は、次のURLを入力してください。

https://ta-receiver.thinkingdata.io

オンプレミスサービスを使用している場合は、次のURLを入力してください。

https://数据采集地址

httpsプロトコルを使用するには、ご自身でSSL証明書を持つドメイン名を申請してください。TAスタッフはポート設定をサポートします。

初期化が完了したら、次の方法でSDKを使用することができます。

// 後続以下の2つ方法でSDKを使用
[instance track:@"event_name" properties:eventProperties];
// [[ThinkingAnalyticsSDK sharedInstanceWithAppid:APP_ID] track:@"event_name" properties:eventProperties];

// v1.2.0前のバージョン，あるいはシングルインスタンスでは以下のようにSDKの使用が可能
// [[ThinkingAnalyticsSDK sharedInstance] track:@"event_name" properties:eventProperties];

// 後続以下の2つ方法でSDKを使用
let properties:Dictionary<String,String>=["key":"value"];
instance.track("event_name", properties:properties)

// v1.2.0前のバージョン，あるいはシングルインスタンスでは以下のようにSDKの使用が可能
// ThinkingAnalyticsSDK.sharedInstance(withAppid: "YOUR_APPID").track("event_name", properties:eventProperties)

v2.7.3では、新しいインスタンス名特性が追加され、インスタンスの初期化時にインスタンス名nameが渡され、インスタンスを識別します。インスタンス名nameに基づいてインスタンスを取得することもできます。

// v2.7.2以降のバージョンはインスタンスにnameを設定
TDConfig *config = [[TDConfig alloc] initWithAppId:@"YOUR_APPID" serverUrl:@"YOUR_SERVER_URL"];
config.name = @"YOUR_NAME";
[ThinkingAnalyticsSDK startWithConfig:config];

// nameによってインスタンスを取得
ThinkingAnalyticsSDK *instance = [ThinkingAnalyticsSDK sharedInstanceWithAppid: @"YOUR_NAME"];

// v2.7.2以降のバージョンはインスタンスにnameを設定
let config = TDConfig.init(appId: "YOUR_APPID", serverUrl: "YOUR_SERVER_URL")
config.name = "YOUR_NAME"
ThinkingAnalyticsSDK.start(with: config)

// nameによってインスタンスを取得
let instance = ThinkingAnalyticsSDK.sharedInstance(withAppid: "YOUR_NAME")

1.4 バックグラウンド自動起動イベントの説明

iOS 12以降のバージョン(iOS 13はEnableSceneSupportを使用していない)は、バックグラウンド自動起動イベントはデフォルトではカウントされず、trackRelaunchedInBackgroundEventsで設定され、YESは収集、NOは収集しないことを表します。

iOS 13はEnableSceneSupportを使用しており、launchOptionsパラメーターを渡す必要があります。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // ...
    TDConfig *config = [[TDConfig alloc] init];
    config.launchOptions = launchOptions;
    config.trackRelaunchedInBackgroundEvents = YES;
    ThinkingAnalyticsSDK *instance = [ThinkingAnalyticsSDK startWithAppId:@"YOUR_APPID" withUrl:@"YOUR_SERVER_URL" withConfig:config];
    return YES;
}

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    let config = TDConfig()
    config.launchOptions = launchOptions ?? [:]
    config.trackRelaunchedInBackgroundEvents = true
    ThinkingAnalyticsSDK.start(withAppId: "APP_ID", withUrl: "SERVICE_URL", with: config)

    return true
}

1.5 H5ページとの連携(任意)

H5ページのデータを収集するJavaScript SDKと連携する必要がある場合は、以下のインターフェイスを呼び出します。詳細はH5とAPP SDKの連携をご参照ください。

// H5ページデータと連携
[instance addWebViewUserAgent];
// [[ThinkingAnalyticsSDK sharedInstanceWithAppid:APP_ID] addWebViewUserAgent];

// H5ページデータと連携
instance.addWebViewUserAgent()

2、ユーザーIDの設定

SDKインスタンスは、ランダムなUUIDをユーザーのデフォルトのゲストIDとして使用します。ゲストIDは、ユーザーが未ログイン状態でユーザーを識別するIDになります。しかし、アプリを再インストールしたり、デバイスを変更したりすると、ゲストIDが変更されます。

2.1 ゲストIDの設定（任意）

ユーザーが未ログインの状態で製品を使用したり、未ログイン状態でのゲストIDを設定する必要がある場合は、identify:を呼び出して設定することができます。

[instance identify:@"123ABCabc"];

instance.identify("123ABCabc")

ゲストIDを置き換えたい場合、SDKの初期化が終了した直後に呼び出す必要があります。無効なアカウントを回避するため、複数回に呼び出さないようにご注意ください。

現在のゲストIDを取得するには、getDistinctIdを呼び出して取得することができます。

// ゲストIDに戻る.マルチインスタンスの場合はインスタンスを呼びだすゲストIDに戻る.
[instance getDistinctId];

// ゲストIDに戻る.マルチインスタンスの場合はインスタンスを呼びだすゲストIDに戻る.
instance.getDistinctId()

2.2 アカウントIDの設定

ユーザーがログインするとき、login::を呼び出してユーザーのアカウントIDを設定します。TAプラットフォームはアカウントIDを身分を識別IDとして優先し、設定後のアカウントIDは保存されます。login:を複数回に呼び出すと以前のアカウントIDが上書きされます:

[instance login:@"123ABCabc@thinkingdata.cn"];

instance.login("123ABCabc@thinkingdata.cn")

この方法はユーザーログインイベントがアップロードされません**。**

2.3 アカウントIDの削除

ユーザーがログアウトした後、logout てアカウントIDを削除することができます。次のlogoutが呼び出されるまで、ゲストIDを識別IDとして使用します。

[instance logout];

instance.logout()

明示的なログアウトイベントでlogoutを呼び出すことをお勧めします。例えば、ユーザーがアカウントを削除する時に呼び出す必要があるが、アプリを閉じる時に呼び出す必要がありません。

この方法は、ユーザーのログアウトイベントがアップロードされません。

3、イベントの送信

SDKの初期化が完了した後、track:、track: properties:でイベントをアップロードすることができます。通常、20~100の異なるイベントをアップロードする必要があります。TAを初めて使用する場合は、いくつかの重要なイベントをアップロードすることをお勧めします。

3.1 イベントの送信

track:、track: properties:を呼び出してイベントをアップロードすることができます。前の内容をもとに、イベントのプロパティと情報送信の条件を設定することをお勧めします。

// このイベントはプロパティが設定されていない
[instance track:@"StartApp"];

// 商品購入イベントをアップロード
NSDictionary *eventProperties = @{
    @"product_name": @"商品名",
    @"product_num": @(1),
    @"IsFirstBuy": @(YES)
};
[instance track:@"product_buy" properties:eventProperties];

// このイベントはプロパティが設定されていない
instance.track("StartApp")

// 商品購入イベントをアップロード
let properties = [
    "productName": "商品名",
    "productNumber": 1,
    "isFirstBuy": true
] as [String: Any]
ThinkingAnalyticsSDK.sharedInstance()?.track("event_name", properties: properties)

イベントの名前はNSString型であり、アルファベットで始まり、数値、アルファベット、下線「_」を含むことができます。長さは最大50文字で大文字と小文字を区別しません。

• イベントのプロパティはNSDictionary オブジェクトであり、各要素は1つのプロパティを表します。
• Keyの値はプロパティの名前であり、NSString型で、アルファベットで始まり、数値、アルファベット、下線「_」を含むことができます。長さは最大50文字で大文字と小文字を区別しません。
• Valueはプロパティの値であり、NSString、NSNumber、NSDate、NSDate 、 NSArray、オブジェクトおよびオブジェクトグループを含むことができます。
• プール型のプロパティをアップロードするには、@YESと**@NOまたは[NSNumber numberWithBool: YES]と[NSNumber numberWithBool: NO]でデータを割り当てまてください。**

@true**、@false、@TRUE、@FALSEでプール型データを****割り当てることはできません。**

注意:

NSArrayタイプはv2.4.0からサポートされており、TAプラットフォームv2.5以降と併用する必要があります。

v2.7.3からオブジェクトとオブジェクトグループをサポートします。

v2.2.0では、イベントの時間トリガーとタイムシフトを設定するメソッドオーバーロードが追加され、NSDate型パラメーターを取り込むことでイベントの時間トリガーを設定し、NSTimeZone型パラメーターでタイムシフトを設定します。このパラメーターを取り込まないと、trackが呼び出された時のシステム時間とタイムシフトをイベントの時間トリガーとタイムゾーンオフセットとして取得します。

NSDictionary *properties = @{
    @"product_name": @"商品名",
    @"product_num": @1,
    @"IsFirstBuy": @YES
};
[instance track:@"product_buy"
     properties:properties
           time:[NSDate date]
       timeZone:[NSTimeZone timeZoneWithName:@"Asia/Shanghai"]];

let properties = ["product_name": "商品名", "product_num": NSNumber.init(value: 1), "IsFirstBuy": true] as [String: Any]
instance.track("product_buy", properties:properties time: Date(), timeZone: NSTimeZone(name: "Asia/Shanghai")! as TimeZone)

注意:イベントは時間トリガーを設定することができますが、受信側は次のように制限し、システム時間の10日前から3日後までのデータしか受信しません。期間を超えたデータは異常データとみなされ、データ全体は格納されません。

v2.3.1以降、SDKのデフォルトタイムゾーンを設定することで、複数のタイムゾーンでのイベント時間を揃えることができます。詳細はデフォルトタイムゾーンの設定をご参照ください。

v2.5.0以降、SDKタイムインターフェイスを校正することで、サーバー側の時間を使用してデータを収集します。詳細は時間校正をご参照ください。

3.2 パブリックイベントプロパティの設定

ユーザーの会員ランク、加入ルートなどの重要なプロパティは、イベントごとに設定する必要があり、パブリックイベントのプロパティとして設定することができます。パブリックイベントプロパティは各イベントに含まれるプロパティのことです。setSuperPropertiesを呼び出してパブリックイベントプロパティを設定することができます。イベントを送信する前に、パブリックイベントプロパティを設定することをお勧めします。

パブリックイベントプロパティの形式は、イベントプロパティと一致します。

[instance setSuperProperties:@{@"Channel": @"ABC", @"isTest": @YES}];

// 設定後にデータをアップロード：
[instance track:@"product_view"
     properties:@{@"product_id": @"A1234"}];

// イベントに対してプロパティを設定：
NSDictionary *properties = @{
    @"Channel": @"ABC",
    @"isTest": @YES,
    @"product_id": @"A1234"
};
[instance track:@"product_view"
     properties:properties];

instance.setSuperProperties(["Channel" : "ABC", "isTest": true])

// 設定後にデータをアップロード：
instance.track("product_view", properties: ["product_id" : "A1234"])

// イベントに対してプロパティを設定：
let properties = ["Channel": "ABC", "isTest": true, "product_id": "A1234"] as [String: Any]
instance.track("product_view", properties: properties)

パブリックイベントプロパティはキャッシュに保存され、アプリを起動するたびに呼び出す必要はありません。setSuperPropertiesを呼び出して設定済みのパブリックイベントプロパティをアップロードすると、プロパティが上書きされます。パブリックイベントプロパティはtrack:properties: でアップロードされたプロパティのKeyと重複している場合、そのイベントのプロパティがパブリックイベントプロパティを上書きします。

[instance setSuperProperties:@{@"Channel": @"ABC", @"isTest": @YES}];

// "Channel"をカバー，プロパティ"Channel"の値は"XYZ"
[instance setSuperProperties:@{@"Channel": @"XYZ"}];

// "isTest"をカバー，"isTest"の值はFalse
[instance track:@"product_view"
     properties:@{@"isTest": @NO}];

instance.setSuperProperties(["Channel": "ABC", "isTest": true])

// "Channel"をカバー，プロパティ"Channel"の値は"XYZ"
instance.setSuperProperties(["Channel": "XYZ"])

// "isTest"をカバー，"isTest"の值はFalse
instance.track("product_view", properties: ["isTest": false])

パブリックイベントプロパティを削除するには、unsetSuperPropertyを呼び出して、指定したパブリックイベントプロパティを削除します。すべてのパブリックイベントプロパティを削除するには、clearSuperPropertiesを呼び出します。すべてのパブリックイベントプロパティを取得するには、currentSuperPropertiesを呼び出します。

//パブリックイベントプロパティを削除する. 例えば、"isTest" プロパティを削除する.
[instance unsetSuperProperty:@"isTest"];

//すべてのパブリックイベントプロパティを削除する
[instance clearSuperProperties];

//すべてのパブリックイベントプロパティを取得する
[instance currentSuperProperties];

//パブリックイベントプロパティを削除する. 例えば、"isTest" プロパティを削除する.
instance.unsetSuperProperty("isTest")

//すべてのパブリックイベントプロパティを削除する
instance.clearSuperProperties()

//すべてのパブリックイベントプロパティを取得する
instance.currentSuperProperties()

3.3 動的パブリックプロパティの設定

v1.2.0では、動的パブリックプロパティの特性が新たに追加されました。パブリックプロパティはアップロード時にその時の値を取得し、会員等級などの可変なパブリックプロパティを便利にアップロードすることができます。registerDynamicSuperPropertiesを使用して動的パブリックプロパティを設定すると、SDKはイベントアップロード時に自動的に実行し、戻り値のプロパティを取得し、イベントに追加します。次の例は、イベントをアップロードするたびに現在時間を取得し、タイムゾーンを切り替えます。イベントが発生するとSDKは戻り値の時間をイベントプロパティに追加します。

// パブリックプロパティを設定し，イベントアップロード時に動的にイベント時間を取得
[instance registerDynamicSuperProperties:^NSDictionary * _Nonnull{
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss.SSS"];
    formatter.timeZone = [NSTimeZone timeZoneWithName:@"America/Chicago"];
    NSDate *datenow = [NSDate date];
    NSString *currentTimeString = [formatter stringFromDate:datenow];
    return @{@"AmericaTime": currentTimeString};
}];

// パブリックプロパティを設定し，イベントアップロード時に動的にイベント時間を取得
instance.registerDynamicSuperProperties { () -> [String : Any] in
    let formatter = DateFormatter()
    formatter.dateFormat = "yyyy-MM-dd HH:mm:ss.SSS"
    formatter.timeZone = TimeZone(abbreviation: "CDT")
    let currentTimeString = formatter.string(from: Date())
    return ["AmericaTime": currentTimeString]
}

3.4 イベント時間の記録

あるイベントの継続時間を記録するにはtimeEventを呼び出して記録し、イベント名を設定します。このイベントをアップロードする際に、自動的にイベントプロパティに#durationプロパティを追加し、記録時間を秒単位で表します。

// 時間記録を開始し，イベント名は"product_view"
[instance timeEvent:@"product_view"];

//その他のコード...

// イベントをアップロードし，時間記録を終了する.イベント"product_view" には時間の長さを表すプロパティ "#duration"を含む
[instance track:@"product_view"];

// 時間記録を開始し，イベント名は"product_view"
instance.timeEvent("product_view")

//その他のコード...

// イベントをアップロードし，時間記録を終了する.イベント"product_view" には時間の長さを表すプロパティ "#duration"を含む
[instance track:@"product_view"];
instance.track("product_view")

4、ユーザープロパティ

TAプラットフォームが現在サポートしているユーザープロパティ設定インターフェイスはuser_set:、user_setOnce:、user_add:、user_unset:、user_deleteとuser_appendです。

4.1 user_set

通常のユーザープロパティは、user_set:を呼び出して設定することができます。このインターフェイスを使用してアップロードしたプロパティは、元のプロパティ値を上書きします。過去にこのユーザープロパティが存在しなかった場合は、新しいユーザープロパティが作成され、アップロードしたプロパティ型と同様です。

// ユーザープロパティを設定
[instance user_set:@{@"UserName": @"TA", @"Age": @20}];

// ユーザープロパティを設定
instance.user_set(["UserName": "TA", "Age": 20])

user_set:設定するユーザープロパティはNSDictionaryオブジェクトであり、一つの要素が一つのプロパティを表します。

user_setで設定したユーザーのプロパティ型は、イベントプロパティと一致する必要があります。

4.2 user_set Once

アップロードするユーザープロパティが1回しか設定しない場合、user_setOnce:を呼び出して設定することができます。このプロパティは既に値がある場合、この情報が無視されます。

// ユーザー名を設定
[instance user_setOnce:@{@"UserName": @"TA"}];
// ユーザー名はTA

[instance user_setOnce:@{@"UserName": @"ABC"}];
// ユーザー名はTA.このデータが無視される.

// ユーザー名を設定
instance.user_setOnce(["UserName": "TA"])
// ユーザー名はTA

instance.user_setOnce(["UserName": "ABC"])
// ユーザー名はTA.このデータが無視される.

user_setOnceで設定したユーザープロパティ型は、イベントプロパティと一致する必要があります。

4.3 user_add

数値型プロパティをアップロードするには、user_add:を呼び出して、そのプロパティに対して累積操作を行います。そのプロパティが設定されていない場合は、0を割り当ててから計算します。

// 累積支払い金額を設定
[instance user_add:@{@"TotalRevenue": @6}];
// 現在の累積支払い金額は6

[instance user_add:@{@"TotalRevenue": @30}];
// 現在の累積支払い金額は36

// 累積支払い金額を設定
instance.user_add(["TotalRevenue": 6])
// 現在の累積支払い金額は6

instance.user_add(["TotalRevenue": 30])
// 現在の累積支払い金額は36

user_add: 設定したユーザープロパティ型およびKey値の制限は user_set:と一致するが、ValueはNSNumber型のみが許可されます。

4.4 user_unset

ユーザーのユーザープロパティ値を削除したい場合、user_unset:を呼び出して指定したプロパティを空にすることができます。そのプロパティはクラスターで作成されていない場合、user_unset:がそのプロパティを作成しません。

// ユーザーの累積支払い金額のプロパティを削除
[instance user_unset:@"TotalRevenue"];

// ユーザーの累積支払い金額のプロパティを削除
instance.user_unset("TotalRevenue")

user_unset:の値は削除されたプロパティのKey値です。

4.5 user_delete

あるユーザーを削除したい場合、user_deleteを呼び出してユーザーを削除することができます。それ以降、このユーザーのユーザープロパティを参照することができなくなるが、発生したイベントを参照することができます。

[instance user_delete];

instance.user_delete()

4.6 user_append

v2.4.0から、user_appendを呼び出してNSArray のユーザープロパティを追加することができます。

// user_appendを呼び出し、ユーザープロパティproduct_buyに要素を追加.存在しない場合，この要素を新規作成する.
[instance user_append:@{@"product_buy": @[@"product_name1", @"product_name2"]}];

instance.user_append(["product_buy": ["product_name1", "product_name2"]])

5、イベントの自動収集

イベント自動収集の具体的な使い方については、iOS SDK自動収集ガイドをご参照ください。

6、SDK構成

6.1 アップロードするためのネットワーク条件の設定

デフォルトでは、SDKインスタンスは、ネットワークが2G、3G、4G、5G、Wifiの時にデータをアップロードします。以下の方法でアプロード可能のネットワーク条件を設定することができます。

//2G, 3G, 4G, 5G, Wifi の時,データをアップロード.
[instance setNetworkType:TDNetworkTypeALL];

//Wifi環境のみデータをアップロード/ダウンロード
[instance setNetworkType:TDNetworkTypeOnlyWIFI];

//2G, 3G, 4G, 5G, Wifi の時,データをアップロード. デフォルト設定
[instance setNetworkType:TDNetworkTypeDefault];

//2G, 3G, 4G, 5G, Wifi の時,データをアップロード.
ThinkingAnalyticsSDK.sharedInstance()?.setNetworkType(ThinkingAnalyticsNetworkType.TDNetworkTypeALL)

//Wifi環境のみデータをアップロード/ダウンロード
ThinkingAnalyticsSDK.sharedInstance()?.setNetworkType(ThinkingAnalyticsNetworkType.TDNetworkTypeOnlyWIFI)

//2G, 3G, 4G, 5G, Wifi の時,データをアップロード. デフォルト設定
ThinkingAnalyticsSDK.sharedInstance()?.setNetworkType(ThinkingAnalyticsNetworkType.TDNetworkTypeDefault)

6.2 データアップロードの一時停止/中止

v2.1.0では、SDKインスタンスのデータアップロードを停止する機能が追加されました。SDKインスタンスのアップロードを停止するインターフェイスが2種類あります。

6.2.1 SDKアップロードの一時停止（enableTracking）

ユーザーがテスト環境にいる、またはテストアカウントでログインしているなどの場合、データの収集やアップロードを一時的に停止したいことがあります。その場合、次のインターフェイスを呼び出してSDKインスタンスのアップロードを一時的に停止することができます。

特定のインスタンス(メインインスタンスとライトインスタンスを含む)を通してenableTracking:を呼び出し、falseに取り込むことで、SDKインスタンスのアップロードを一時停止することができます。そのインスタンスに設定済の#distinct_id、#account_id、パブリックプロパティなどが保持されます。そのインスタンスが収集したがアップロード未完了のデータは引き続きアップロードされます。そのインスタンスはそれ以降新しいデータを収集したりアップロードしたりすることはできません。ゲストID、アカウントID、パブリックプロパティなどを設定することはできませんが、設定済のパブリックプロパティ、デバイスID、ゲストID、アカウントIDなどの情報を読み取ることはできます。

インスタンスの停止状態はenableTracking:が呼び出されるまでローカルのキャッシュに保存されます。enableTrackingを呼び出して、trueに取り込むと、SDKインスタンスはデータ収集とアップロードを再開します。ライトインスタンスはキャッシュに保存されないため、アプリを開くたびにライトインスタンスの一時停止状態は保持されず、アップロードが再開されます。

// アップロードを一時停止
[instance enableTracking:NO];

// アップロードを再開
[instance enableTracking:YES];

// アップロードを一時停止
instance.enableTracking(false)

// アップロードを再開
instance.enableTracking(true)

6.2.2 SDKアップロードの中止（optOutTracking）

GDPRが適用される地域でユーザーがデータ収集権限を提供しないなどの特殊の場合、次のインターフェイスを呼び出してSDKインスタンスの機能を完全に停止することができます。

optOutTrackingはメインインスタンスからしか呼び出すことができません。enableTrackingとの最大の違いは、インスタンスのローカルキャッシュ(ゲストID、アカウントID、パブリックプロパティ、およびアップロードしていないデータキューを含む)が削除されます。その後、インスタンスの収集とアップロード機能をオフにします。

// アップロードを中止し，ローカルキャッシュをリセット
[instance optOutTracking];

// アップロードを中止し，ローカルキャッシュをリセット
instance.optOutTracking()

SDK機能をオフにしている間にTAクラスタ内のユーザーデータを削除したい場合、optOutTrackingAndDeleteUserを呼び出すと、SDKインスタンス機能を停止する前にuser_delデータをアップロードしてユーザーデータを削除することができます。

// アップロードを中止し，ユーザー削除リクエストを送信
[instance optOutTrackingAndDeleteUser];

// 停止上报，并发送删除用户请求
instance.optOutTrackingAndDeleteUser()

インスタンスの停止状態もoptInTrackingが呼び出されるまでローカルキャッシュに保存されます。それ以降はアップロードを続けることができますが、新しいインスタンスとなります。

// アップロードを再開
[instance optInTracking];

// アップロードを再開
instance.optInTracking()

6.3 データログの印刷

setLogLevelを呼び出すことでオンにすることができます(デフォルトはオフ):

[ThinkingAnalyticsSDK setLogLevel:TDLoggingLevelDebug];
// TDLoggingLevelError :Error Log
// TDLoggingLevelInfo  :Info  Log
// TDLoggingLevelDebug :Debug Log

ThinkingAnalyticsSDK.setLogLevel(TDLoggingLevel.debug)
// TDLoggingLevel.error :Error Log
// TDLoggingLevel.info  :Info  Log
// TDLoggingLevel.debug :Debug Log

6.4 デバイスIDの取得

v2.0.0では、デバイスID(プリセットプロパティ#device_id)のインターフェイスが追加されました。getDeviceIdを呼び出すことでデバイスIDを取得することができます。

[instance getDeviceId];

 //デバイスIDをゲストIDに設定する必要があれば下記のように呼び出す
 // [instance identify:[instance getDeviceId]];

6.5 HTTPS検証メソッドの設定:

v2.3.0以降、SDKではHTTPS検証メソッドを設定することができます。初期化時にTDConfigインスタンスを取得し、TDConfigで初期化を完了します。

 TDConfig *config = [[TDConfig alloc] init];
 TDSecurityPolicy *securityPolicy = [TDSecurityPolicy policyWithPinningMode:TDSSLPinningModeNone];
 // TDSSLPinningModeNone:デフォルト検証メソッド，システムが信頼されている証明書リストでサーバー側で戻った証明書に対して検証を行う.
 // TDSSLPinningModePublicKey:証明書検証の公開鍵
 // TDSSLPinningModeCertificate:証明書検証のすべての内容
 securityPolicy.allowInvalidCertificates = YES; // 自己作成証明書、有効期限が過ぎたSSL証明書を許容するか.デフォルトはNO
 securityPolicy.validatesDomainName = NO; // ドメイン名を検証するか.デフォルトはYES.
 config.securityPolicy = securityPolicy;
 [ThinkingAnalyticsSDK startWithAppId:@"YOUR_APPID" withUrl:@"YOUR_SERVER_URL" withConfig:config];

let tdconfig = TDConfig();
let tdSecurityPolicy = TDSecurityPolicy(pinningMode: TDSSLPinningMode.publicKey);
// TDSSLPinningMode [] デフォルト検証メソッド，システムが信頼されている証明書リストでサーバー側で戻った証明書に対して検証を行う.
 // TDSSLPinningModePublicKey 証明書検証の公開鍵
// TDSSLPinningMode.publicKey 証明書検証のすべての内容
// TDSSLPinningMode.certificate 証明書検証のすべての内容
tdSecurityPolicy.allowInvalidCertificates = true // 自己作成証明書、有効期限が過ぎたSSL証明書を許容するか.デフォルトはNO
tdSecurityPolicy.validatesDomainName = false // ドメイン名を検証するか.デフォルトはYES.
tdconfig.securityPolicy = tdSecurityPolicy;
ThinkingAnalyticsSDK.start(withAppId: "YOUR_APPID", withUrl: "YOUR_SERVER_URL", with: tdconfig);

6.6 デフォルトタイムゾーンの設定

ユーザーがイベントの発生時間を指定しない場合、SDKはデフォルトで、インターフェイス呼び出し時のシステム時間をイベント発生時間としてアップロードします。v2.3.1以降では、デフォルトのタイムゾーンインターフェイスを設定することでデフォルトのタイムゾーンを指定することができます。すべてのイベント(自動収集のイベントを含む)は設定されたタイムゾーンに沿ってイベント時間を揃えることができます。

// TDConfig インスタンスを取得
TDConfig *config = [[TDConfig alloc] init];
// デフォルトタイムゾーンを UTCに設定
config.defaultTimeZone = [NSTimeZone timeZoneWithName:@"UTC"];
// SDK初期化
ThinkingAnalyticsSDK *instance = [ThinkingAnalyticsSDK startWithAppId:@"YOUR_APPID" withUrl:@"YOUR_SERVER_URL" withConfig:config];

注意：指定したタイムゾーンでイベント時間を揃えると、システムのタイムゾーン情報がなくなります。システムタイムゾーン情報を保持したい場合は、イベントに関連するプロパティを手動で追加する必要があります。

6.7 Debugモードの有効化

v2.4.0以降、クライアントSDKは Debug モードをサポートし、TA Platform 2.5以降のバージョンと併用する必要があります。

Debugモードは、データ収集の品質とアプリの安定性に影響を与える可能性があります。データの結合テストに使用することができますが、オンライン環境で使用しないようにご注意ください。

現在のSDKインスタンスは、3つの実行モードがサポートしています。TDConfigで定義されています。

/**
Debugモード

- ThinkingAnalyticsDebugOff : デフォルトでDebugモードをオフ
*/
typedef NS_OPTIONS(NSInteger, ThinkingAnalyticsDebugMode) {
    /**
     デフォルトでDebugモードをオフ
     */
    ThinkingAnalyticsDebugOff      = 0,

    /**
     Debug_onlyモードをオンにし，データ検証のみ，格納しない
     */
    ThinkingAnalyticsDebugOnly     = 1 << 0,

    /**
     Debugモード，データは1つずつアプロード。問題発生時にログと異常値でユーザーに報告
     */
    ThinkingAnalyticsDebug         = 1 << 1
};

SDKインスタンスの実行モードを設定するには、TDConfigでSDKの初期化を完了します：

// TDConfig インスタンスを取得
TDConfig *config = [[TDConfig alloc] init];
// 実行モードを Debug モードに設定
config.debugMode = ThinkingAnalyticsDebug;
// SDK初期化
ThinkingAnalyticsSDK *instance = [ThinkingAnalyticsSDK startWithAppId:@"YOUR_APPID" withUrl:@"YOUR_SERVER_URL" withConfig:config];

Debugモードが本番環境でオンラインにならないように、指定されたデバイスのみがDebugモードをオンにすることができます。クライアントのDebugモードが有効で、且つデバイスIDがTAプラットフォームの「埋め込みポイント管理」ページの「Debugデータ」に構成されているデバイスでのみDebugモードを有効にすることができます。

デバイスIDは、次の3つの方法で取得することができます。

• TAプラットフォームのイベントデータの#device_idプロパティ
• クライアントログ：SDKの初期化が完了すると、デバイスDeviceIdが印刷される
• インスタンスインターフェイスを介する呼び出し：デバイスIDの取得

6.8 時間校正

SDKはデフォルトでシステム時間をイベント発生時刻として使用し、ユーザーが手動でシステム時間を変更すると業務分析に影響を与える可能性があります。v2.5.0以降、サーバー側から取得した現在のタイムスタンプでSDK時間を校正することができます。それ以降、時間が指定されていない呼び出し(イベントデータやユーザープロパティ設定の操作を含む)はすべて校正後の時間をイベント発生時間とします。

// 1585633785954 は現在の unix タイムスタンプ，単位はミリ秒，北京時間 2020-03-31 13:49:45に相当
[ThinkingAnalyticsSDK calibrateTime:1585633785954];

// 1585633785954 は現在の unix タイムスタンプ，単位はミリ秒，北京時間 2020-03-31 13:49:45に相当
ThinkingAnalyticsSDK.calibrateTime(1585633785954)

NTPから時間を取得しSDKを校正する機能も提供しています。ユーザーがアクセスできるNTPサーバーアドレスを入力する必要があり、SDKは受信したNTPサーバーアドレスから現在の時間を取得し、SDK時間を校正します。ただし、デフォルトのタイムアウト時間(3秒)以内に正しい結果が得られない場合、システム時間を使用してデータをアップロードします。

// Appleの NTP サービスで時間校正を行う
[ThinkingAnalyticsSDK calibrateTimeWithNtp:@"time.apple.com"];

ThinkingAnalyticsSDK.calibrateTime(withNtp: "time.apple.com")

注意:

• ネットワークが良好の状態で、ユーザーのデバイスがスムーズにサーバーの到着時間を取得できるように、NTPサーバーアドレスを慎重に選択する必要があります。
• NTPサービスを用いる時間校正は不確実性があるので、タイムスタンプによる時間校正を優先的にご検討ください。

上記の時間校正インターフェイスに加えて、v2.5.0は、すべてのユーザープロパティインターフェイスの時間関数オーバーロードを提供しています。ユーザープロパティ関連のインターフェイスを呼び出すときに、Dateオブジェクトを取り込むと、受信したDateオブジェクトを使用してデータの#timeフィールドを設定します。

7、関連のプリセットプロパティ

7.1 すべてのイベントのプリセットプロパティ

次のプリセットプロパティは、 iOS SDKのすべてのイベント(自動収集イベントを含む)に含まれるプリセットプロパティです。

プロパティ名	日本語	説明
#ip	IPアドレス	ユーザーのIPアドレス。TAはユーザーの位置情報を取得。
#country	国	ユーザーの国。IPアドレスに基づいて生成。
# country_code	国コード	ユーザーがいる国の国コード(ISO 3166-1 alpha-2、2大文字のアルファベット)。IPアドレスに基づいて生成。
#province	省	ユーザーがいる省。IPアドレスに基づいて生成。
#city	都市	ユーザーがいる都市。IPアドレスに基づいて生成。
#os_version	オペレーティングシステムのバージョン	iOS 1 1.2.2、Android 8.0.0など。
#manufacturer	機器メーカー	Apple、vivoなど、ユーザーのデバイスのメーカー。
#os	オペレーティングシステム	Android、iOSなど
#device_id	デバイスID	ユーザーのデバイスID、iOSはユーザーのIDFVかUUID、AndroidはandroidIDを取得。
#screen_height	画面の高さ	ユーザーのデバイスの画面高さ。例：1920
#screen_width	画面の幅	ユーザーのデバイスの画面の幅。例：1080
#device_model	デバイスモデル	ユーザーデバイスのモデル。例：iPhone 8
#app_version	APPバージョン	アプリのバージョン
#bundle_id	アプリケーション固有のID	アプリケーションのパッケージ名
#lib	SDKタイプ	SDKのタイプ。Android、iOSなど。
#lib_version	SDKバージョン	SDKのバージョン。
#network_type	ネットワーク状態	イベントアップロード時のネットワーク状態。 WIFI、3G、4G など。
#carrier	ネットワークキャリア	ユーザーデバイスのネットワークキャリア。中国移動、中国電信など。
#zone_offset	タイムゾーンオフセット	UTC時間に対するデータ時間のオフセット時間数

7.2 自動収集イベントのプリセットプロパティ

以下のプリセットプロパティは、各自動収集イベントに特有のプリセットプロパティです。

• APP起動イベント(ta_app_start)のプリセットプロパティ

プロパティ名	日本語	説明
#resume_from_background	バックグラウンドから起こすか	APPが起動されたかバックグラウンドから起こされたかを示す。trueはバックグラウンドから起こす。falseは直接に起動する。

• APPクローズイベント(ta_app_end)のプリセットプロパティ

プロパティ名	日本語	説明
#duration	イベントの長さ	アプリの起動から終了までの時間を秒単位で表す。

• APPページビューイベント(ta_app_view)のプリセットプロパティ

プロパティ名	日本語	説明
#title	ページタイトル	View Controller のタイトル。値は controller.navigationItem.title のプロパティ 値。
#screen_name	ページ名	View Controller のタイプ名。
#url	ページアドレス	現ページのアドレス。 getScreenUrl を呼び出してurlの設定を行う。
#referrer	前ページアドレス	前ページのアドレスに戻る。 getScreenUrl を呼び出してurlの設定を行う。

• APPコントロールクリックイベント(ta_app_click)のプリセットプロパティ

プロパティ名	日本語	説明
#title	ページタイトル	View Controllerのタイトル。値は controller.navigationItem.title のプロパティ 値。
#screen_name	ページ名	View Controllerのタイプ名。
#element_id	要素ID	コントロールのID。 thinkingAnalyticsViewID で 設定可能。
#element_type	要素の種類	コントロールタイプ
#element_selector	要素セレクタ	コントロールの viewPath の補足
#element_position	要素の位置	コントロールの位置情報。コントロールタイプは UITableView か UICollectionView の時 にある。コントロールがクリックされた時の位置を表す。値は グループ番号 (Section): 行番号 (Row)
#element_content	要素の内容	コントロールの内容。

• APPクラッシュイベント(ta_app_crash)のプリセットプロパティ

プロパティ名	日本語	説明
#app_crashed_reason	異常情報	文字型で、クラッシュ時のスタック軌跡を記録

7.3 その他のプリセットプロパティ

以上のプリセットプロパティに加えて、一部のプリセットプロパティを記録するにはそれに対応するインタフェースを呼び出す必要があります。

プロパティ名	日本語	説明
#duration	イベントの長さ	時間記録機能インターフェイス timeEvent を呼び出してイベントの長さを記録する。単位は秒。
#backgroud_duration	バックグラウンドイベントの長さ	#background_duration はv2.7.4から追加された新しいプロパティ。このプロパティは起動イベントと期間イベントにある。 単位は秒。

7.4 プリセットプロパティの取得

v2.7.0以降では、getPresetPropertiesを呼び出してプリセットプロパティを取得することができます。

サーバー側の埋め込みポイントにアプリ側のプリセットプロパティが必要な場合、この方法でアプリ側のプリセットプロパティを取得してサービス側に渡します。

//プロパティオブジェクトを取得
TDPresetProperties *presetProperties = [instance getPresetProperties];

//イベントプリセットプロパティの生成
NSDictionary *properties = [presetProperties toEventPresetProperties];
/*
   {
	"#carrier": "中国电信",
	"#os": "iOS",
	"#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
	"#screen_height": 2264,
	"#bundle_id": "com.sw.thinkingdatademo",
	"#manufacturer": "Apple",
	"#device_model": "iPhone7",
	"#screen_width": 1080,
	"#system_language": "zh",
	"#os_version": "10",
	"#network_type": "WIFI",
	"#zone_offset": 8
    }
*/

//プリセットプロパティの取得
NSString *bundle_id = presetProperties.bundle_id;//パッケージ名
NSString *os = presetProperties.os;//os種類，例：iOS
NSString *system_language = presetProperties.system_language;//デバイスシステム言語
NSNumber *screen_width = presetProperties.screen_width;//画面の幅
NSNumber *screen_height = presetProperties.screen_height;//画面の高さ
NSString *device_model = presetProperties.device_model;//デバイスモデル
NSString *device_id = presetProperties.device_id;//デバイスID
NSString *carrier = presetProperties.carrier;//ネットワークキャリア，2つのSIMがある場合，メインSIMの情報を取得
NSString *manufacture = presetProperties.manufacturer;// デバイスメーカー　例：Apple
NSString *network_type = presetProperties.network_type;//ネットワーク種類
NSString *os_version = presetProperties.os_version;//システムバージョン
NSNumber *zone_offset = presetProperties.zone_offset;//タイムゾーンオフセット

let presetProperties = instance.getPresetProperties();

//プロパティオブジェクトを取得
let properties = presetProperties.toEventPresetProperties();

//イベントプリセットプロパティの生成
let bundle_id = presetProperties.bundle_id;//パッケージ名
let os = presetProperties.os;//os種類，例：iOS
let system_language = presetProperties.system_language;//デバイスシステム言語
let screen_width = presetProperties.screen_width;//画面の幅
let screen_height = presetProperties.screen_height;//画面の高さ
let device_model = presetProperties.device_model;//デバイスモデル
let device_id = presetProperties.device_id;//デバイスID
let carrier = presetProperties.carrier;//ネットワークキャリア，2つのSIMがある場合，メインSIMの情報を取得
let manufacture = presetProperties.manufacturer;// デバイスメーカー　例：Apple
let network_type = presetProperties.network_type;//ネットワーク種類
let os_version = presetProperties.os_version;//システムバージョン
let zone_offset = presetProperties.zone_offset;//タイムゾーンオフセット

IP、国の都市情報はサーバー側で解析して生成されるので、クライアント側はこれらのプロパティを取得するインタフェースを提供しません。

7.5 パフォーマンス関連指標のプリセットプロパティ

v2.7.4以降、SDKはデフォルトでパフォーマンス関連のプリセットプロパティをアップロードします：

プロパティ名	日本語	説明
#ram	使用可能なメモリサイズ/メモリの合計	単位はGB
#disk	使用可能なディスク容量/ディスク総量	単位はGB
#fps	FPS	整数
#simulator	携帯シミュレーターかどうか	ブール値
#install_time	アプリのインストール時間

7.6 プリセットプロパティのスイッチ

v2.7.4以降、SDKは指定されたプリセットプロパティのアップロードをブロックすることをサポートしています。

プロジェクトのinfo.plistテキストにTDDisPresetPropertiesフィールドを追加します。タイプはArrayです。追加したフィールドに対応するプリセットプロパティはアップロードされません。

"#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator"などのプリセットプロパティをブロックするには、次のように設定します。

8、高度な機能

v2.6.0以降、SDKは、初期イベント、更新可能なイベント、書き換え可能なイベントとの3つの特殊イベントのアップロードをサポートしています。この3つのイベントは、TAシステム2.8以降のバージョンと併用する必要があります。特殊イベントは特定の場面でしか適用されないので、TAのクライアントとアナリストのもとに、特殊イベントのアップロードを行うようにしましょう。

8.1 初期イベント

初期イベントとは、あるデバイスや他のディメンションのIDに対して、一度しか記録されないイベントです。たとえば、デバイスで最初に発生したイベントを記録したい場合は、初期イベントを用いてデータをアップロードすることができます。

// 例：初期イベントをアップロード. イベント名は DEVICE_FIRST.
TDFirstEventModel *firstModel = [[TDFirstEventModel alloc] initWithEventName:@"DEVICE_FIRST"];

// 選択可能なパラメーター
firstModel.properties = @{};
[firstModel configTime:<# __kindof NSDate * #> timeZone:<# __kindof NSTimeZone *_Nullable #>];

// イベントアップロードAPI
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:firstModel];

// 例：初期イベントをアップロード. イベント名は DEVICE_FIRST.
let firstModel = TDFirstEventModel(eventName:"DEVICE_FIRST")
// 選択可能なパラメーター
firstModel.properties = ["KEY": "VALUE"]
firstModel.configTime(<#T##time: Date##Date#>, timeZone: <#T##TimeZone?#>)

ThinkingAnalyticsSDK.sharedInstance()?.track(with: firstModel)

デバイス以外のディメンションで初回かどうかを判断するには、初期イベントにFIRST_CHECK_IDを設定します。たとえば、あるアカウントの初期イベントを記録する必要がある場合、アカウントIDを初期イベントのFIRST_CHECK_IDに設定します。

// #first_check_idの構造方法をカスタマイズする
TDFirstEventModel *firstModel = [[TDFirstEventModel alloc] initWithEventName:@"DEVICE_FIRST" firstCheckID:@"YOUR_ACCOUNT_ID"];

// 選択可能なパラメーター
firstModel.properties = @{};
[firstModel configTime:<# __kindof NSDate * #> timeZone:<# __kindof NSTimeZone *_Nullable #>];

// イベントアップロードAPI
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:firstModel];

// 例：ユーザーアカウントの初期イベント. イベント名はUSER_FIRSTに仮定
let firstModel = TDFirstEventModel(eventName:"DEVICE_FIRST", firstCheckID:"YOUR_ACCOUNT_ID")
// 選択可能なパラメーター
firstModel.properties = ["KEY": "VALUE"]
firstModel.configTime(<#T##time: Date##Date#>, timeZone: <#T##TimeZone?#>)

ThinkingAnalyticsSDK.sharedInstance()?.track(with: firstModel)

注意:サーバー側で初回かどうかをチェックするため、初期イベントはデフォルトで1時間遅れて格納します。

8.2 更新可能なイベント

更新可能なイベントを通して、特定の場面でのイベントデータの変更要件を満たすことができます。更新可能なイベントは、イベントを識別するIDを指定し、更新可能なイベントオブジェクトの作成時に読み込むする必要があります。TAプラットフォームは、イベント名とイベントIDに基づいて更新するデータを決定します。

// 例： 更新可能なイベントをアップロード，イベント名は UPDATABLE_EVENTに仮定
TDUpdateEventModel *updateModel = [[TDUpdateEventModel alloc] initWithEventName:@"UPDATABLE_EVENT" eventID:@"test_event_id"];
updateModel.properties = @{@"status": @3, @"price": @100};
// イベントプロパティアップロード後に status は 3, price は 100
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:updateModel];

TDUpdateEventModel *updateModel_new = [[TDUpdateEventModel alloc] initWithEventName:@"UPDATABLE_EVENT" eventID:@"test_event_id"];
updateModel_new.properties = @{@"status": @5};
// イベントプロパティアップロード後に status は 5に更新され, price は変わらない
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:updateModel_new];

// 例： 更新可能なイベントをアップロード，イベント名は UPDATABLE_EVENTに仮定
let updateModel = TDUpdateEventModel(eventName: "UPDATABLE_EVENT", eventID: "test_event_id")
updateModel.properties = ["status": 3, "price": 100]

// 選択可能なパラメーター
updateModel.configTime(<#T##time: Date##Date#>, timeZone: <#T##TimeZone?#>)

// イベントプロパティアップロード後に status は 3, price は 100
ThinkingAnalyticsSDK.sharedInstance()?.track(with: updateModel)


let updateModel_new =TDUpdateEventModel(eventName: "UPDATABLE_EVENT", eventID: "test_event_id")
updateModel_new.properties = ["status": 5]
// イベントプロパティアップロード後に status は 5に更新され, price は変わらない
ThinkingAnalyticsSDK.sharedInstance()?.track(with: updateModel_new)

8.3 書き換え可能なイベント

書き換え可能なイベントは更新可能なイベントと似ており、違いとしては書き換え可能なイベントは最新のデータで過去データを完全に上書きするので、過去データを削除し、最新のデータを格納することに相当します。TAプラットフォームは、イベント名とイベントIDに基づいて更新するデータを決定します。

// 例： 書き換え可能なイベントをアップロードし，イベント名は OVERWRITE_EVENTに仮定
TDOverwriteEventModel *overwriteModel = [[TDOverwriteEventModel alloc] initWithEventName:@"OVERWRITE_EVENT" eventID:@"test_event_id"];
overwriteModel.properties = @{@"status": @3, @"price": @100};
// イベントプロパティアップロード後に status は 3, price は 100
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:overwriteModel];

TDOverwriteEventModel *overwriteModel_new = [[TDOverwriteEventModel alloc] initWithEventName:@"OVERWRITE_EVENT" eventID:@"test_event_id"];
overwriteModel_new.properties = @{@"status": @5};
// イベントプロパティアップロード後に status は 5に更新され, price は削除される
[[ThinkingAnalyticsSDK sharedInstance] trackWithEventModel:overwriteModel_new];

// 例： 書き換え可能なイベントをアップロードし，イベント名は OVERWRITE_EVENTに仮定
let overwriteModel = TDOverwriteEventModel(eventName: "OVERWRITE_EVENT", eventID: "test_event_id")
overwriteModel.properties = ["status": 3, "price": 100]

// 選択可能なパラメーター
overwriteModel.configTime(<#T##time: Date##Date#>, timeZone: <#T##TimeZone?#>)

// イベントプロパティアップロード後に status は 3, price は 100
ThinkingAnalyticsSDK.sharedInstance()?.track(with: overwriteModel)


let overwriteModel_new = TDOverwriteEventModel(eventName: "UPDATABLE_EVENT", eventID: "test_event_id")
overwriteModel_new.properties = ["status": 5]
// イベントプロパティアップロード後に status は 5に更新され, price は削除される
ThinkingAnalyticsSDK.sharedInstance()?.track(with: overwriteModel_new)

ChangeLog

省略します。詳細は中国語版をご参照ください。