takt-angular

@vskstudio/takt-angular パッケージは、Takt分析プラットフォームのネイティブなAngular統合を提供し、プライバシー優先のデータ収集に焦点を当てています。これはAngular 17以降向けに設計されており、単一のパッケージマネージャー コマンドでプロジェクトに追加できます。 インストール 実行: pnpm add @vskstudio/takt-angular @vskstudio/takt-core ブートストラップ統合 ルートのブートストラップ呼び出しで、provideTakt を使用してプロバイダーを登録します。このプロバイダーはブラウザでのみコア分析ライブラリを初期化し、初期ページビューを送信し、オプションの自動キャプチャ機能（外部リンククリック、ファイルダウンロード、SPAナビゲーションなど）を有効にし、Angularアプリが破棄されたときにクリーンアップを行います。サーバーサイドではプロバイダーは無効であり、ライブラリはサーバーサイドレンダリングに安全です。 インジェクタブルサービス TaktService はアプリケーション内の任意の場所に注入できます。track(eventName, options)、pageview()、optOut()、optIn() などのメソッドを公開します。すべてのメソッドはライブラリが初期化される前またはサーバー上で実行されている場合は何も行わず、常に例外を投げません。 宣言的クリック追跡 TaktEventDirective を使用すると、taktEvent 属性を通じて任意のクリック可能な要素に追跡をアタッチでき、オプションの taktProps および taktRevenue 入力があります。ディレクティブはクリック時にライブ分析インスタンスを解決し、マークアップをクリーンに保ちます。 UIウィジェット 2つのスタンドアロンコンポーネントが提供されます： - TaktBadgeComponent は指定されたドメインのサーバー生成SVGバッジをレンダリングします。 - TaktEmbedComponent は公開された分析ダッシュボードを表示するサンドボックス化されたiframeをレンダリングします。 これらのコンポーネントは任意のAngularテンプレートで使用でき、domain、theme、size、language、および視覚的なバリエーションの入力をサポートします。 公開統計API createStats ヘルパーは公開Takt APIのクライアントを作成します。asyncメソッドの summary、timeseries、realtime、breakdown を提供し、開発者がプログラム的に集約された分析データを取得できるようにします。 フレームワーク非依存カスタム要素 非Angularページの場合、takt-analytics という名前の自己完結型カスタム要素がエクスポートされています。defineTaktElement を呼び出す（または自動登録を実行するモジュールをインポートする）ことで、要素をプレーンHTMLに配置でき、外部リンククリックやファイルダウンロードの追跡など、プライバシー設定を自動的に尊重します。ビルド手順なしで素早く含めるためのCDNバンドルも利用可能です。 構成オプション TaktConfig は、ドメイン、エンドポイント、外部リンク追跡、ファイルダウンロード追跡、SPAナビゲーション、Do Not Trackの尊重、ローカルホストの除外、サンプルレート、クエリ文字列処理、パスの除外、URLのスクラブ、タグ付き要素の追跡など、豊富なオプションをサポートします。デフォルト値はほとんどのサイトに適しており、構成は bootstrap 時の provideTakt に渡すことができます。 ライセンス このライブラリはMITライセンスの下でリリースされています。