PageSense Node.js SDKの初期化

PageSense Node.js SDKの初期化

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

開始する前に  

PageSenseClientは、テストを実行するための中核となるインターフェースです。テストの有効化、目標の追跡、バリエーションの評価など、すべての処理はこのクライアントを通じて行われます。これらの機能を使用する前に、一度初期化する必要があります。
初期化は非同期で、1つの手順で完了します。SDKがPageSenseサーバーにアクセスしてプロジェクトの設定を取得し、クライアントをセットアップします。プロジェクトの設定には、次の情報が含まれます。
  • プロジェクトに設定されているすべてのフルスタックテスト。
  • 各テストの現在のステータス。
  • トラフィックの割り当てとオーディエンスのターゲティングルール。

メソッド  

  1. const pageSenseClient = await PageSenseClientBuilder.createNewPageSenseClient(
  2. accountId,
  3. sdkKey,
  4. projectName,
  5. sdkOptions
  6. );

パラメーター  

パラメーター
種類
説明
accountId
文字列
PageSenseアカウントの識別子です。
sdkKey
文字列
環境のSDKキーです。フルスタックプロジェクトの設定ページにある［SDKの設定］で確認できます。
projectName
文字列
テストが保存されているPageSenseプロジェクトです。
sdkOptions
オブジェクト
任意です。こちらでログ記録、ポーリング、リクエストの動作を設定できます。

内部処理  

createNewPageSenseClient()が実行されると、以下の処理が行われます。
  1. SDKがPageSenseサーバーにプロジェクトの設定を要求します。
  2. テストの設定、ターゲティングルール、トラフィックの割り当てを解析します。
  3. PageSenseClientインスタンスを初期化して返します。
これで、クライアントでテストを評価し、イベントを追跡できるようになります。
認証情報の誤り、ネットワークの問題、設定の欠落などにより初期化に失敗した場合、SDKはnullを返すか、エラーをスローします。

使用例  

  1. const { PageSenseClientBuilder } = require('@zoho/pagesense-node-sdk');
  2. async function initializeSDK() {
  3. const accountId = 'YOUR_ACCOUNT_ID';
  4. const sdkKey = 'YOUR_SDK_KEY';
  5. const projectName = 'YOUR_PROJECT_NAME';
  6. const sdkOptions = {};
  7. const pageSenseClient = await PageSenseClientBuilder.createNewPageSenseClient(
  8. accountId,
  9. sdkKey,
  10. projectName,
  11. sdkOptions
  12. );
  13. if (!pageSenseClient) {
  14. console.error('PageSense SDK initialization failed.');
  15. return;
  16. }
  17. console.log('PageSense SDK initialized successfully.');
  18. }
  19. initializeSDK();

注意事項  

  • createNewPageSenseClient()は非同期です。必ずawaitを使用するか、Promiseチェーンを使用してください。
  • クライアントの準備が完了する前に、テストAPIや追跡APIを呼び出さないでください。
  • 失敗時の処理を実装してください。nullが返された場合は、初期化中に問題が発生したことを意味します。





このドキュメントでは、各手順をわかりやすく案内しています。さらにサポートが必要な場合やご不明な点がある場合は、support@zohopagesense.com - までお気軽にお問い合わせください。いつでもサポートいたします。