以前はデータをスナップショットに追加するためだけに使用されていた既存の API メソッドのうち 2 つは、コントローラ上の現在のビジネストランザクションに対して分析が有効になっている場合、分析データを送信するようになりました。

• スナップショットに URL を設定：スナップショットを取得している場合は、URL が設定されます。データは 7 ビット ASCII または UTF-8 である必要があります。スナップショットを取得しない場合も、この関数を呼び出せます。指定のビジネストランザクションでスナップショットが取得されていないときは、この関数がすぐに戻ります。ただし、この関数に渡すデータの抽出はコストが高い場合、appd_bt_is_snapshotting を使用して、データが抽出され、この関数が呼び出される前にビジネストランザクションでスナップショットが取得されているかどうかを確認できます。

  void appd_bt_set_url(appd_bt_handle bt, const char* url);

  • param bt：ユーザデータを追加するビジネストランザクション（スナップショットを取得している場合）。
  • param url：7 ビット ASCII または UTF-8 として取得されるスナップショットの URL 値。

• ユーザデータをスナップショットに追加：データは 7 ビット ASCII または UTF-8 である必要があります。スナップショットが取得されていない、または分析が有効になっていない場合も、この関数を呼び出せます。このデータはスナップショット専用であり、この関数に渡すデータの抽出はコストが高い場合は、appd_bt_is_snapshotting を使用して、データを抽出してこの関数を呼び出す前にビジネストランザクションでスナップショットが取得されているかどうかを確認できます。

  void appd_bt_add_user_data(appd_bt_handle bt, const char* key, const char* value);

  • param bt：ユーザデータを追加するビジネストランザクション（スナップショットを取得している場合）。
  • param key：7 ビット ASCII または UTF-8 としてスナップショットに追加するユーザデータの名前。
  • param value：7 ビット ASCII または UTF-8 としてスナップショットに追加するユーザデータの値。

これらの API メソッドはすでに存在しましたが、分析へのデータの報告はできませんでした。分析に正常に接続するには、次の構成 API を使用して初期化します。

void appd_config_set_analytics_host(struct appd_config* cfg, const char* host);

• param host：分析エージェントのホスト（デフォルトは localhost）。

void appd_config_set_analytics_port(struct appd_config* cfg, const unsigned short port);

• param port：分析エージェントが待機しているポート（デフォルトは 9090）。