# Ruby
最新バージョン:1.2.0
更新時間:2020-08-28
ダウンロード:Source Code (opens new window)
# SDK 実装
gem
を利用して SDK 実装してください
# install SDK
gem install thinkingdata-ruby
- Logbus をインストール
TE システムにより迅速かつ正確なデータを転送するために、SDK + LogBus の併用でサーバデータのデータレポートを推奨しております。
# 初期設定
SDK の初期設定のコード例:
require 'thinkingdata-ruby'
consumer = TDAnalytics::LoggerConsumer.new(LOG_DIRECTORY)
te = TDAnalytics::Tracker.new(consumer)
LOG_DIRECTORY
はローカルアクセスファイルのアドレスとなります。LogBus のモニターアドレスをこのアドレスに設定すれば自動でアップロードされます。
# メイン機能
ゲスト ID とアカウント ID をうまく紐付けるために、もしゲーム内でゲスト ID とアカウント ID 両方を使われる場合は、それらの ID を同時にアップロードするのを推奨しております。同時にアップロードしない場合は、ユーザーを重複にカウントされてしまう可能性があります。
# 3.1 イベント送信
track
を利用してイベントの送信を行います。事前にデータプランをご用意の上、送信してください。以下はモデルコードとなります。
event = {
'event_name' => 'test_event',
'account_id' =>'ruby_test_aid',
'distinct_id'=>'ruby_distinct_id',
'ip' => '202.38.64.1',
'properties' =>{
'prop_string' =>'hello world',
},
# skip_local_check: true,
}
te.track(event)
- イベント名称は string タイプで、英文字と数字、 "_"を含め、最大 50 文字
- Key は当プロパティの名称で string タイプで、英文字と数字、 "_"を含め、最大 50 文字。TE システムは一律で小英文字に統一されます
- Value は当プロパティの値で、String, Number, Bloon, Time, object, array, list object を対応しております。
ユーザープロパティはイベントプロパティと一致する必要があります
# 3.2 ユーザープロパティを設定
一般のユーザープロパティに関しては、user_set
を利用して設定することができますが、 UserSet は元の値を上書きされます。本来該当プロパティに値がない場合は、プロパティが新規作成されます。以下はコード例となります。
user_data = {
'account_id' =>'ruby_test_aid',
'distinct_id' => 'ruby_distinct_id',
properties => {
'user_name' => 'te'
}
}
te.user_set(user_data)
# コード例のまとめ
以下のコード例で全ての操作が含まれます、以下の順で利用推奨しております。
require 'thinkingdata-ruby'
consumer = TDAnalytics::LoggerConsumer.new(LOG_DIRECTORY)
te = TDAnalytics::Tracker.new(consumer)
event = {
'event_name' => 'test_event',
'account_id' =>'ruby_test_aid',
'distinct_id'=>'ruby_distinct_id',
'ip' => '202.38.64.1',
'properties' =>{
'prop_string' =>'hello world',
},
# skip_local_check: true,
}
te.track(event)
user_data = {
'account_id' =>'ruby_test_aid',
'distinct_id' => 'ruby_distinct_id',
properties => {
'user_name' => 'te'
}
}
te.user_set(user_data)
te.flush