リアルタイムデバッグ

最終更新 2026/10/03

注意

SDKのデバッグモードは、接続時のデバッグ専用です。本番環境では絶対に使用しないでください。

SDKの接続中は、IDEのコンソールでSDKのログを確認するか、AEのDebug機能を使用して、リアルタイムでデバッグできます。

1. SDKログの出力

local tdAnalytics = require "ThinkingDataSdk"
-- enable log
TDAnalytics.enableLog(true)

2. Debugモードの有効化

Debugモードを有効にするには、次の2つの手順が必要です：

1. DebugConsumerを使用する

DebugConsumerを使用するサンプルコードは次のとおりです:

-- DebugConsumer:データを1件ずつ送信します。問題が発生した場合は、ログと例外でユーザーに通知します。本番環境での使用は推奨しません
local tdAnalytics = require "ThinkingDataSdk"
local consumer = tdAnalytics.TDDebugConsumer("SERVER_URL", "APP_ID", false, "DeviceId")
local sdk = tdAnalytics(consumer)
--ゲストID"ABCDEFG123456789"を設定
local distinctId = "ABCDEFG123456789"
--アカウントID"AE_10001"を設定
local accountId = "AE_10001"
--イベントプロパティを設定
local properties = {}
--ユーザーのIPアドレスを設定。AEシステムはIPアドレスからユーザーの地理位置情報を解析します。設定しない場合、デフォルトでは送信されません
properties["#ip"] = "192.168.1.1"
properties["#device_id"] = "te_device_id"
--イベントをアップロード。ユーザーのゲストIDとアカウントIDを含みます。アカウントIDとゲストIDの順序に注意してください。両方を空にすることはできません
sdk:track(accountId, distinctId, "payment", properties)

2. AE管理画面でDebugデバイスを追加する

Debugモードが本番環境でリリースされるのを防ぐため、指定されたデバイスのみがDebugモードを有効にできるようになっています。クライアントでDebugモードを有効にし、かつAEの管理画面の「データ → データ収集管理 → デバッグモード」ページでデバイスIDを追加したデバイスのみが、Debugモードを有効にできます。追加方法：ページ右上の「デバイスに接続」をクリックし、「デバイスの選択」ドロワーで「デバイスを追加」をクリックして、デバイスIDを入力します。

Debugモードはデータ収集の品質やAppの安定性に影響する可能性があります。統合段階でのデータ検証にのみ使用し、本番環境では使用しないでください。