ae-data-integration-helper

ae-data-integration-helper

会話の言語：このスキル文書は英語ですが、ユーザーへの出力はすべて、ユーザーが入力した言語でなければなりません。 中国語の入力 → 中国語で返信、英語の入力 → 英語で返信、日本語の入力 → 日本語で返信。 判断に迷った場合は、英語を使用してください。 これは、見出し、手順の説明、コードコメント、例など、すべての出力に適用されます。 ⚠️ 重要：多くの参考資料（FAQ、Wiki）は中国語です。英語または日本語のユーザーに回答するために中国語の資料を読む場合は、内容をユーザーの言語に翻訳しなければなりません。参考資料の言語は、ユーザーの言語ではありません。Wiki ページが中国語だからといって、英語のユーザーに中国語で回答しないでください。用語を正確に対応させるには、上記の用語集を使用してください。 この文書の中国語の文章を、英語または日本語の回答にそのままコピーしないでください。

用語集

中国語	英語	備考
埋点 / 数据上报	Tracking / Data Ingestion	イベントデータを AE に送信
用户识别规则	User Identification Rule	distinct_id / account_id のマッピング
访客 ID	Visitor ID / Guest ID	ログイン前の匿名ユーザー
登录 ID	Login ID / Account ID	識別済みユーザーのログイン ID
预置属性	Preset Property	#device_id、#time、#ip など
系统字段	System Field	# を接頭辞とする AE の組み込みフィールド
事件格式	Event Format	イベント名とプロパティの構造
属性类型	Property Type	String / Number / Boolean / Date / Array
数据校验	Data Validation	イベント形式とプロパティの型を検証
公共事件属性	Super Property	すべてのイベントに付加されるプロパティ。⚠️ 正しい中国語の AE 用語は「公共事件属性」または「公共属性」です。「Super Property」を「超级属性」と訳してはいけません。これは正しい AE 用語ではありません。
可更新事件	Updatable Event	作成後にプロパティを更新できるイベント
首次事件校验	First Event Check	イベントの初回発生を検証
自动采集	Auto-track	自動収集されるイベント（アプリのインストール、起動、ページビューなど）
实时调试	Real-time Debug / Debug Mode	デバイスのバインドとリアルタイムのデータ検証
合规 / 隐私	Compliance / Privacy	GDPR、プライバシーポリシー、SDK のデータ収集ルール
数据导入	Data Import	LogBus2 / RESTful API / DataX
缓存上报	Batch Upload / Buffered Upload	イベントをローカルにキャッシュし、まとめてアップロード
重试策略	Retry Strategy	失敗したデータを自動的に再アップロード
数据加密	Data Encryption	アップロード前にイベントデータを暗号化
时间校准	Time Calibration	デバイスの時刻をサーバー時刻と同期
多端上报	Multi-platform Tracking	複数のクライアント／サービスからイベントを送信
用户割裂	User Fragmentation	同一ユーザーが複数の AE ユーザープロファイルに分割されること
上报模式	Upload Mode	Normal / Debug / Debug_Only
LoggerConsumer	LoggerConsumer	イベントをローカルのログファイルに書き込むサーバー SDK のコンシューマー
BatchConsumer	BatchConsumer	イベントをまとめてアップロードするサーバー SDK のコンシューマー
DebugConsumer	DebugConsumer	デバッグモード用のサーバー SDK のコンシューマー（本番環境では使用しない）

トリガーするタイミング

ユーザーが次の内容について質問した場合にトリガーします。

• 取り込み前の準備：
  • ユーザー識別ルール（distinct_id / account_id / visitor ID / login ID）
  • データルール（イベント形式 / プロパティの型 / 検証）
  • プリセットプロパティとシステムフィールド（#device_id、#time など）
• クライアント SDK の統合：Android / iOS / JavaScript / Unity / OpenHarmony / ミニプログラムなど
• サーバー SDK の統合：Java / Python / Go / Node.js / PHP / C# など
• データインポート：LogBus2 / RESTful API / DataX
• 高度なデータ型：更新可能イベント / 初回イベントチェック
• 自動トラッキング：ページビュー / ボタンクリック / アプリ起動など
• リアルタイムデバッグ：デバッグモード / デバイスのバインド / データ検証
• コンプライアンス / プライバシー：GDPR / プライバシーポリシー / SDK のデータ収集ルール
• API の使用方法：init / track / user_set / LoggerConsumer など
• 設定：デバッグモード / データ検証 / リトライ戦略
• トラブルシューティング：アップロードの失敗 / データの欠落 / 形式エラー

トリガーしない場合：ae-generate-tracking-plan または ae-generate-tracking-code のセッション内でのインライン Q&A（これらのスキルには独自のワークフローがあります）。オフラインのローカルファイルインポート（CSV / Excel / JSONL → AE）と Feishu シート URL のインポートは ae-data-integration スキルの担当です。LogBus / REST に関する案内で回答せず、これらのリクエストはそちらに振り分けてください。

ワークフロー

ステップ 1：質問を解析する

ユーザーのクエリから次の情報を抽出します。

• トピックのカテゴリ：
  • 取り込み前の準備：ユーザー識別 / データルール / プリセットプロパティ
  • クライアント SDK：Android / iOS / JavaScript / Unity / OpenHarmony / ミニプログラムなど
  • サーバー SDK：Java / Python / Go / Node.js / PHP / C# など
  • データインポート：LogBus2 / RESTful API / DataX
  • 高度なデータ型：更新可能イベント / 初回イベントチェック
  • 自動トラッキング：ページビュー / ボタンクリック / アプリ起動
  • リアルタイムデバッグ：デバッグモード / デバイスのバインド / データ検証
  • コンプライアンス：GDPR / プライバシーポリシー / SDK のデータ収集ルール
• クエリの種類：統合方法 / API の使用方法 / 設定 / デプロイ / エラー / ログ記録

ステップ 1.5：情報を収集する

⚠️ 重要な原則：質問が曖昧な場合は、回答する前にまず情報を収集してください。推測したり、長々と説明したりしないでください。

ユーザーの質問が次のいずれかの状況に該当する場合は、先に重要な情報を収集してから進めてください。

状況	必ず収集する情報
「データが表示されない」／「データを確認できない」／「アップロードは成功したが、ダッシュボードに何も表示されない」	アップロード方法（SDK / LogBus / HTTP）、データの種類（イベント / ユーザープロパティ）、具体的な症状（データがまったくない / 一部のデータがない）
「エラー」／「失敗」に関する質問	エラーメッセージ全文、再現手順
「接続できない」／「アップロードできない」	使用しているプラットフォーム／言語、エラーの症状
「X の実装方法」	使用しているプラットフォーム／言語、X が具体的に何を意味するか

先に質問し、その後に回答してください。例：

• 「データログでは成功と表示されていますが、ダッシュボードには何も表示されません。SDK、LogBus、HTTP のどれを使ってアップロードしていますか？」
• 「接続できません。使用している言語／プラットフォームを教えてください。エラーメッセージも共有していただけますか？」

Step 2: 関連ドキュメントを探す

まずFAQドキュメントを確認してください（特定の問題をすばやく調べる場合）：

1. skills/ae-data-integration-helper/references/ にある該当するFAQを読みます（例：android_sdk_faq.md、logbus2_guide.md など）
2. FAQドキュメントには、具体的なトラブルシューティング、コード例、パラメータテーブル、ベストプラクティスが記載されています

FAQに回答がない場合は、Wikiを確認してください（フレームワークレベルの権威ある情報を調べる場合）：

1. ~/.ae-cli/wiki/te-docs/index.md を読み、ドキュメントのパスを確認します
2. ~/.ae-cli/wiki/te-docs/synthesis/ にある概要ドキュメントを優先します
3. 詳細なAPIリファレンスについては、~/.ae-cli/wiki/te-docs/raw/ にある該当するメインドキュメントを確認します

よく使用するFAQドキュメント：

• references/android_sdk_faq.md — Android SDKの統合とFAQ
• references/ios_sdk_faq.md — iOS SDKの統合とFAQ
• references/java_sdk_faq.md — Java SDKの統合とFAQ
• references/logbus2_guide.md — LogBus2の設定に関する完全ガイド
• references/sdk_usage_notes.md — クライアント／サーバーSDKの使用上の注意
• references/restful_api_notes.md — RESTful APIの使用上の注意
• 全リスト：references/index.md を参照してください

Step 3: 読んで要約する

関連ドキュメントを読んだ後、次の形式で出力します。

## <Topic> (<Platform>)

### Summary
<1-2 sentence description>

### Integration / Usage Steps
1. <Step 1>
2. <Step 2>
...

### Code Example
```<language>
<code>

注意事項

• <Note 1>
• <Note 2>

参照元ドキュメント

<WikiドキュメントのsourceUrlを優先してください。言語ルール：

• ユーザーが中国語でやり取りしている場合 → 中国語のドキュメントを提示する（lan=zh-CN）
• ユーザーがその他の言語でやり取りしている場合 → 英語のドキュメントを提示する（lan=en-US）
• 中国語のみ対応のSDK（Mini-program / OpenHarmony / Cocos2d-Lua / LayaAir / Egret）→ 中国語のみ 例：https://docs-v2.thinkingdata.cn/?version=v6.0&lan=en-US&code=xxx> （sourceUrlがない場合は、ローカルの.mdファイルパスを提示してください）

**⚠️ Terminology Rules**:
- **Only output what is in the documentation**. Do NOT speculate, imagine, or fill in defaults.
- **Never translate "Super Property" as "超级属性"** — the correct AE Chinese term is "公共事件属性" or "公共属性". This applies to all user-facing output: headings, step descriptions, code comments, examples, etc.
- For uncertain information (e.g., data delay times, specific limit values), **do NOT fabricate**.
- If the document has no direct answer but allows inference: mark under "Source Document" as "Synthesized inference; recommend verification".
- If the documentation truly does not cover the question, fall back to Step 4. Do NOT force an answer.

### Step 4: Fallback

If neither FAQ nor wiki has relevant content:
- Provide the official online documentation link: https://docs-v2.thinkingdata.cn
- Optionally suggest running the `te-wiki-synthesize` skill to generate a new synthesis document.

## Example Conversations

**User**: What is distinct_id and how do I use it?

**Agent**:
1. Read `references/index.md` to find user identification rule document paths
2. If `sdk_usage_notes.md` or wiki has relevant sections, read those first
3. Output in the Step 3 format

**User**: How do I configure LogBus2?

**Agent**:
1. Read `references/logbus2_guide.md`
2. Output in the Step 3 format

**User**: Java SDK is losing data — what should I do?

**Agent**:
1. Read `references/java_sdk_faq.md`, section on "LoggerConsumer data loss risks"
2. Output in the Step 3 format

**User**: How do I integrate the Android SDK?

**Agent**:
1. Read `references/android_sdk_faq.md` or `~/.ae-cli/wiki/te-docs/index.md` to find Android SDK path
2. Read the relevant sections
3. Output in the Step 3 format

Android SDKの統合

概要

Android SDKは、Gradleと手動でのAAR統合に対応しています。Gradleを推奨します。

統合手順（Gradle）

1. プロジェクトレベルのbuild.gradleにmavenCentralを追加します：

   repositories { mavenCentral() }
   

2. モジュールレベルのbuild.gradleに依存関係を追加します：

   dependencies {
       implementation 'cn.thinkingdata.android:ThinkingAnalyticsSDK:3.3.6'
   }
   

3. SDKを初期化します：

   TDAnalytics.init(this, SERVER_URL, APPID);
   

参照元ドキュメント

~/.ae-cli/wiki/te-docs/raw/data-ingestion-guide/client-sdk/android.md

**User**: How do I enable real-time debugging for Android SDK?

**Agent**:
1. Read `~/.ae-cli/wiki/te-docs/raw/data-ingestion-guide/client-sdk/android/android-advanced/debugging-and-logging.md`
2. Output in the Step 3 format

## Internal Reference

**FAQ Documents** (check first):
- `references/index.md` — All FAQ document index
- `references/android_sdk_faq.md` — Android SDK FAQ
- `references/logbus2_guide.md` — LogBus2 complete guide
- `references/sdk_usage_notes.md` — SDK usage notes

**Wiki Documents** (check when FAQ has no answer):
- `~/.ae-cli/wiki/te-docs/index.md` — All wiki document index
- `~/.ae-cli/wiki/te-docs/schema.md` — Wiki layout description
- `~/.ae-cli/wiki/te-docs/raw/preparations-before-data-ingestion/user-identification-rules.md` — User Identification Rules
- `~/.ae-cli/wiki/te-docs/raw/preparations-before-data-ingestion/data-rules.md` — Data Rules
- `~/.ae-cli/wiki/te-docs/raw/preparations-before-data-ingestion/preset-properties-and-system-fields.md` — Preset Properties
- `~/.ae-cli/wiki/te-docs/raw/advanced-data-type/updated-event.md` — Updatable Event
- `~/.ae-cli/wiki/te-docs/raw/advanced-data-type/first-event-check.md` — First Event Check
- `~/.ae-cli/wiki/te-docs/raw/data-ingestion-guide/data-import-tools/logbus2-user-guide.md` — LogBus2