> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# インジェクションブループリント
> サンプルコードを含む一般的なユースケース向けの既製イベントインジェクションパターン。
インジェクションブループリントは、一般的なシナリオでの使用状況を追跡するための事前構築されたパターンです。イベント構造やメーター設定をゼロから考えるのではなく、実績のあるブループリントから始めて、ニーズに合わせてカスタマイズします。
## ブループリントとは？
各ブループリントには以下が含まれます：
* **イベント構造の推奨**：最適なイベント名付けとメタデータ設計
* **メーター設定**：推奨される集約タイプとフィルター
* **サンプルコード**：複数の言語での動作実装例
* **ベストプラクティス**：精度、パフォーマンス、コスト最適化のためのヒント
ブループリントはセットアップ時間を何時間も節約し、一般的な落とし穴を回避するのに役立ちます。ブループリントから始めて、特定の要件に合わせて調整してください。
## なぜブループリントを使用するのか？
使用状況の追跡を数時間ではなく数分で機能させましょう。ゼロから設計する代わりに実績のあるパターンをコピーしてください。
テスト済みのイベント構造、適切なメタデータ、最適な集計の選択でよくあるミスを回避します。
サンプルコードは実際の実装に基づいています。APIキーを入力するだけで準備完了です。
## 利用可能なブループリント
あなたのユースケースに合ったブループリントを選択してください：
OpenAI、Anthropic、Groq、Gemini、Vercel AI SDK などにわたる AI トークン使用量を追跡します。
**最適な用途**：AIチャットボット、コードジェネレーター、コンテンツ作成ツール、AI駆動アプリ。
**追跡対象**: 入力トークン、出力トークン、モデル使用量、リクエスト数。
ゲートウェイレベルで API リクエストを計測し、エンドポイントフィルタリングとレート制限をサポートします。
**最適な用途**：REST API、GraphQLサービス、Webhookプロバイダー、APIファーストプラットフォーム。
**追跡対象**: リクエスト数、エンドポイントの利用、HTTP メソッド、応答時間。
クラウドストレージサービスのファイルアップロード、ストレージ消費、帯域幅を追跡します。
**最適な用途**：ファイルホスティング、メディアプラットフォーム、バックアップサービス、ドキュメント管理。
**追跡対象**: 保存されたバイト数、ファイルのアップロード、ダウンロード、ストレージスナップショット。
ビデオ、オーディオ、リアルタイムデータ配信のストリーミング帯域幅を測定します。
**最適な用途**：ビデオストリーミング、オーディオプラットフォーム、ライブ放送、リアルタイムデータフィード。
**追跡対象**: 消費された帯域幅、ストリームの継続時間、品質レベル、同時ストリーム数。
コンピュートリソース、サーバーレス関数、長時間実行ジョブの経過時間で請求します。
**最適な用途**：サーバーレスプラットフォーム、コンテナホスティング、コンピュートインスタンス、バッチ処理。
**追跡対象**: 実行時間、コンピュート時間、関数の呼び出し、ジョブの継続時間。
## ブループリントの使用方法
請求シナリオに最も適したブループリントを選択してください。各ブループリントページには詳細な実装ガイドが含まれています。
推奨されるイベント命名とメタデータ設計を理解してください。イベント構造をユースケースにコピーします。
ブループリントのメーター構成手順に従ってください。推奨される集計タイプやフィルタを使用します。
使用する言語/フレームワークのサンプルコードをコピーします。プレースホルダー値を実際の API キーや顧客 ID に置き換えてください。
テストイベントを送信し、正しい集計でメーターダッシュボードに表示されることを確認します。
ブループリントを特定の要件に合わせて調整します—カスタムメタデータを追加したり、フィルタを調整したり、価格設定を変更したりしてください。
## ブループリントの比較
どのブループリントがあなたのニーズに合うか分からない？ここに簡単な比較があります：
| ユースケース | ブループリント | 集約 | 一般的なメタデータ |
| ----------- | ----------- | --------- | ------------------------------------ |
| AIチャットアプリ | LLM | 合計 (トークン) | model, input\_tokens, output\_tokens |
| REST API | APIゲートウェイ | カウント | endpoint, method, status\_code |
| ファイルストレージ | オブジェクトストレージ | 合計 (バイト) | file\_size, file\_type, operation |
| ビデオプラットフォーム | ストリーム | 合計 (帯域幅) | duration, quality, bitrate |
| サーバーレス | 時間範囲 | 合計 (時間) | function\_name, execution\_time\_ms |
## カスタム実装
正確なユースケースに合ったブループリントが見つからない？問題ありません：
1. **最も近いブループリントから始める**：ニーズに最も似たものを選択します
2. **イベント構造を適応させる**：メタデータフィールドを要件に合わせて変更します
3. **メーター設定を調整する**：必要に応じて集約タイプやフィルターを変更します
4. **徹底的にテストする**：サンプル使用量で請求計算を確認します
すべてのブループリントは出発点です。異なるブループリントの概念を組み合わせたり、完全にカスタムの実装を作成したりして構いません。
## ヘルプが必要ですか？
どのブループリントを使用すべきか分からない場合や、カスタマイズの手助けが必要な場合：
使用状況課金付きの AI 画像生成のエンドツーエンドチュートリアルを参考にしてください。
使用ベースの課金実装のすべての側面を網羅した包括的ガイドです。