メインコンテンツまでスキップ
バージョン: 1.1.4.1

インストールおよび初期化

BotManager Browser Agentは以下の2つの方式でインストールできます。

事前準備​

エージェントをインストールする前にBotManagerコンソールで以下の情報を確認してください：

  1. ドメイン選択：エージェントをインストールするドメインを選択します。
  2. 設定値確認：コンソールで提供する以下の値を確認します：
    • TENANT_ID：顧客社識別ID
    • DOMAIN：ドメイン名
    • ENGINE_URL：検出サーバーURL
    • AGENT_URL：エージェントファイルURL

インストール方法​

方法1：HTMLファイルに直接挿入​

ページの<head>タグに直接インストールコードを挿入します。これは簡単で速やかに適用できる方法です。

以下は例示コードです。{}括弧内の値は顧客専用コンソールで自動生成されて提供されます。

<script>
  (function(cfg) {
    cfg.tenantId = '{{ TENANT_ID }}';
    cfg.domainName = '{{ DOMAIN }}';
    cfg.customId = '{{ USER_CUSTOM_ID }}';  // optional
    cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
  })(window['BotManager-config'] || (window['BotManager-config'] = {}));
</script>
<script src="{{ AGENT_URL }}/agents/client/javascript/botmanager-browser-agent.js" async></script>

方法2：共通JavaScriptファイルに挿入​

サイトで共通に使用するJavaScriptファイルにインストールコードを追加して適用できます。この方法はメンテナンスおよび管理の面で効率的です。

// 共通JavaScriptファイルに挿入
(function(cfg) {
  cfg.tenantId = '{{ TENANT_ID }}';
  cfg.domainName = '{{ DOMAIN }}';
  cfg.customId = '{{ USER_CUSTOM_ID }}'; // optional
  cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
})(window['BotManager-config'] || (window['BotManager-config'] = {}));

// ライブラリダウンロードおよび実行
var scriptBM = document.createElement('script');
scriptBM.src = '{{ AGENT_URL }}/agents/client/javascript/botmanager-browser-agent.js';
scriptBM.async = true;
document.head.appendChild(scriptBM);

customId設定​

customIdはサービスページでユーザーを特定できる値として明示できるオプション設定値です。

例示：

  • ログイン認証を通じてログインした場合のユーザーID
  • ログイン認証を通じてログインした場合のセッション値

主要機能および利点​

  1. BotManager接続者管理コンソール統合：

    • customIdを設定するとサービス内で確認可能な特定ユーザー基準で検出情報を確認できます。

  2. 多重デバイスブロック：

    • 同一のcustomIdを使用するユーザーが複数デバイスを通じて接続する場合、ブロック設定が該当デバイスにも同一に適用されます。
    • これを通じてブロックされたユーザーの多重デバイス使用を防止できます。

初期化確認​

インストールが完了するとブラウザコンソールで以下を確認できます：

// BotManagerオブジェクトがグローバルにロードされたか確認
console.log(window.BotManager); // BotManagerオブジェクトが出力される必要があります

次のステップ​

インストールが完了すると以下の文書を参照してください：