OpenSearch に行動データをアップロードするメリット
行動データを使用すると、閲覧、クリック、滞在、いいね、共有、お気に入りに追加、購入など、検索結果に対するユーザーの反応を理解できます。これは、検索効果を最適化するためのガイダンスとなります。
OpenSearch のレポート統計機能を使用すると、ページビュー (PV)、商品ページビュー (IPV)、クリック率 (CTR) のレポートなど、アプリケーションのさまざまな検索レポートを表示できます。レポートに基づいてビジネス運用を改善できます。
OpenSearch はアルゴリズムプラットフォームを提供しており、検索行動のフィードバックデータを使用して検索およびソートアルゴリズムモデルをトレーニングできます。これは、検索効果の向上に役立ちます。
使用上の注意
データ収集機能は、アプリケーションの作成後に自動的に有効になります。
データとは、検索結果に対するユーザーの反応のフィードバックデータを指します。
収集とは、 OpenSearch SDK を使用して検索行動データを OpenSearch にアップロードするプロセスを指します。最新バージョンでは、OpenSearch ではサーバー SDK を使用する場合にのみ検索行動データを収集できます。モバイル SDK または Web SDK を使用して検索行動データを収集する機能は開発中です。
以前のデータ収集機能と比較して、データ収集 V2.0 機能では、パラメーターの受け渡しと SDK の使用が容易になります。 OpenSearch を初めて使用する場合は、このトピックで説明されているフィールドを使用して、OpenSearch SDK を使用して行動データをアップロードできます。 注: Java 3.4.0 用 SDK および PHP 3.2.0 用 SDK は、データ収集 V2.0 をサポートしています。
行動データをアップロードする
注: OpenSearch コンソールで行動データの収集機能を有効にした後、SDK を使用して行動データをアップロードすることをお勧めします。次のセクションでは、行動データのアップロードに使用されるフィールドについて説明します。 説明:
SDK を使用して行動データをアップロードするには、次のフィールドを指定する必要があります: imei または user_id、biz_id、trace_id、rn、bhv_type、bhv_time、item_id、および item_type。
API 操作を呼び出して行動データをアップロードするには、上記のフィールドに加えて reach_time フィールドも指定する必要があります。
SDK を使用した行動データのアップロード、または API 操作の呼び出しによる行動データのアップロードのデモの詳細については、「データ収集 V2.0 用 SDK」をご参照ください。
行動データフィールドの説明
ID | フィールド | タイプ | 説明 | 値 | 必須 |
1 | app_version | STRING | 行動データを収集する Web サイトまたはモバイルアプリのバージョン番号。 | いいえ | |
2 | sdk_type | STRING | 行動データのアップロードに使用される SDK のタイプ。 OpenSearch はこのフィールドを使用して、行動データがサーバー SDK またはモバイル SDK を使用してアップロードされたか、収集されたかを区別します。 | いいえ。 OpenSearch SDK を使用して行動データをアップロードする場合、このフィールドはデフォルトで opensearch_sdk に設定されます。 | |
3 | sdk_version | STRING | 行動データのアップロードに使用される SDK のバージョン番号。 | いいえ。 OpenSearch SDK を使用して行動データをアップロードする場合、このフィールドはデフォルトで指定されます。 | |
4 | login | STRING | ユーザーが行動データを収集する Web サイトまたはモバイルアプリにログオンしているかどうかを指定します。 | 有効な値: 0 および 1。 0: ユーザーがログオンしていないことを示します。 1: ユーザーがログオンしていることを示します。 | いいえ |
5 | user_id | STRING | ユーザーを一意に識別するために使用される ID。 | いいえ。ただし、 imei フィールドまたは user_id フィールドのいずれかを指定する必要があります。 | |
6 | imei | STRING | ユーザーデバイスの ID。有効な値: imei、device_id、および idfa。 | いいえ。ただし、 imei フィールドまたは user_id フィールドのいずれかを指定する必要があります。 | |
7 | biz_id | STRING | 異なる検索サービスを区別するために使用される数値 ID。一般に、biz_id フィールドは OpenSearch アプリケーションを表します。 Web、iOS、Android アプリケーションを表すために複数の biz_id フィールドを指定できます。これらのフィールドを使用して、後続のステップでトラフィックを分割し、テストを実行できます。 | 検索サービスを区別しない場合は、このフィールドを default に設定することをお勧めします。検索サービスを区別する場合は、ビジネス要件に基づいてこのフィールドを pc、ios、または android に設定できます。 | はい |
8 | trace_id | STRING | ドキュメントが検索および収集される検索サービスのプロバイダー。 | ドキュメントが OpenSearch から検索および収集される場合は、このフィールドを Alibaba に設定します。ドキュメントが別のサービスプロバイダーから検索および収集される場合は、ビジネス要件に基づいてこのフィールドを指定します。 | はい |
9 | trace_info | STRING | このフィールドの値は、OpenSearch が検索結果で返す ops_request_misc パラメーターの値です。 ops_request_misc パラメーターの値をそのまま渡します。 | いいえ 注: trace_id フィールドが Alibaba に設定されている場合は、このフィールドを渡す必要があります。このフィールドは、検索結果が OpenSearch から提供されているかどうかを確認するために使用されます。 | |
10 | rn | STRING | このフィールドは、PV を識別するために使用されます。このフィールドの値は、OpenSearch が検索結果で返す request_id パラメーターの値です。 request_id パラメーターの値をそのまま渡します。 | はい | |
11 | item_id | STRING | ドキュメントのプライマリキー値。このフィールドの値は、OpenSearch アプリケーションのプライマリテーブルのプライマリキー値です。 | はい | |
12 | item_type | STRING | ドキュメントのビジネスタイプ。 | このフィールドの有効な値の詳細については、このトピックの「 item_type フィールドの説明」セクションをご参照ください。 | はい |
13 | bhv_type | STRING | 行動のタイプ (公開、滞在、閲覧、お気に入りに追加、ダウンロードなど)。 | このフィールドの有効な値の詳細については、このトピックの「一般的な行動タイプ」セクションをご参照ください。 | はい |
14 | bhv_value | STRING | 行動を測定するために使用される値 (滞在時間、購入された商品の数など)。 | このフィールドの有効な値の詳細については、このトピックの「一般的な行動タイプ」セクションをご参照ください。 | いいえ |
15 | bhv_time | STRING | 行動が発生した時刻。値は秒単位の UNIX タイムスタンプです。 | はい | |
16 | bhv_detail | STRING | 行動の詳細な説明。 | このフィールドの形式は key=value{,key=value} です。値には 1 つ以上の key=value ペアを含めることができます。 | いいえ |
17 | ip | STRING | 行動が発生する携帯電話または端末デバイスの IP アドレス。 | いいえ。ただし、このフィールドを指定することをお勧めします。 | |
18 | longitude | STRING | 行動が発生する場所の経度。 | いいえ。ただし、このフィールドを指定することをお勧めします。 | |
19 | latitude | STRING | 行動が発生する場所の緯度。 | いいえ。ただし、このフィールドを指定することをお勧めします。 | |
20 | session_id | STRING | ユーザーセッションの ID。 | いいえ。ただし、このフィールドを指定することをお勧めします。 | |
21 | spm | STRING | このフィールドは、行動が発生するページモジュールを追跡するために使用されます。 | このフィールドのエンコード形式は a.b.c.d で、サイト ID、ページ ID、モジュール ID、および場所 ID を示します。 | いいえ |
22 | report_src | STRING | このフィールドは、行動データのアップロードに使用されるメソッドを識別するために使用されます。 | 有効な値: 1、2、3、および patch_data。
| いいえ |
23 | mac | STRING | 行動データを収集する携帯電話または端末デバイスのメディアアクセス制御 (MAC) アドレス。 | いいえ | |
24 | brand | STRING | 行動データを収集する携帯電話または端末デバイスのブランド。 | いいえ。ただし、このフィールドを指定することをお勧めします。 | |
25 | device_model | STRING | 行動データを収集する携帯電話または端末デバイスのモデル。 | いいえ | |
26 | resolution | STRING | 行動データを収集する携帯電話または端末デバイスの画面の解像度。 | いいえ | |
27 | carrier | STRING | 行動データを収集する携帯電話または端末デバイスのキャリア。 | いいえ | |
28 | access | STRING | 行動データを収集する携帯電話または端末デバイスに接続されているネットワーク。 | いいえ | |
29 | access_subtype | STRING | 行動データを収集する携帯電話または端末デバイスに接続されているネットワークのタイプ。 | いいえ | |
30 | os | STRING | 行動データを収集する携帯電話または端末デバイスのオペレーティングシステム。 | いいえ | |
31 | os_version | STRING | 行動データを収集する携帯電話または端末デバイスのオペレーティングシステムのバージョン。 | いいえ | |
32 | language | STRING | 行動データを収集する携帯電話または端末デバイスに設定されている言語。 | いいえ | |
33 | phone_md5 | STRING | 携帯電話番号の MD5 ハッシュ値。 | いいえ | |
34 | reserve1 | STRING | 予約フィールド。 | いいえ | |
35 | reserve2 | STRING | 予約フィールド。 report_src フィールドが patch_data に設定されている場合は、reserve2 フィールドを raw_query フィールドの値に設定する必要があります。 | いいえ | |
36 | reach_time | BIGINT | サーバーがデータを受信した時刻。値は秒単位の UNIX タイムスタンプです。 | はい。 OpenSearch SDK を使用して行動データをアップロードする場合、このフィールドは SDK によって自動的に設定されます。 OpenSearch の API 操作を呼び出して行動データをアップロードする場合は、このフィールドを指定する必要があります。 |
item_type フィールドの説明
ID | item_type | 説明 |
1 | goods | 商品 |
2 | article | 記事、ブログ、小説 |
3 | ask | Q&A |
4 | bbs | フォーラムの投稿 |
5 | download | アイテムのダウンロード |
6 | image | 画像 |
7 | media | 映画、テレビ番組、音楽などのマルチメディア |
8 | recipe | 食品とレシピ |
9 | news | ニュースと情報 |
10 | institution | 組織 |
11 | other | その他 |
一般的な行動タイプ
ID | bhv_type | 説明 | bhv_value | bhv_detail |
1 | expose | アイテムを公開する行動。 | 空。 | 空 |
2 | stay | ページに滞在する行動。 | 滞在時間。単位: 秒。 | 空 |
3 | click | アイテムをクリックする行動。 | クリック数。デフォルト値: 1。 | 空 |
4 | cart | ショッピングカート、本棚、またはプレイリストにアイテムを追加する行動。 | 空。 | 空 |
5 | buy | アイテムを購入する行動。 | 購入されたアイテムの数。デフォルト値: 1。 | 例: buy_price=12,price_unit=CNY |
6 | collect | アイテムをお気に入りに追加する行動。 | 空。 | 空 |
7 | like | アイテムに「いいね」をする行動。 | 「いいね」の数。デフォルト値: 1。 | 空 |
8 | dislike | アイテムに「よくないね」をする行動。 | 「よくないね」の数。デフォルト値: 1。 | 空 |
9 | comment | アイテムにコメントする行動。 | コメント数。デフォルト値: 1。 | 空 |
10 | share | アイテムを共有または転送する行動。 | 共有数または転送数。デフォルト値: 1。 | 空 |
11 | subscribe | アイテムをフォローまたはサブスクライブする行動。 | 空。 | 空 |
12 | gift | ギフトを送信する行動。 | 空。 | 空 |
13 | download | アイテムをダウンロードする行動。 | 空。 | 空 |
14 | read | アイテムを読む行動。 | 空。 | 空 |
15 | tip | アイテムに報酬を与える行動。 | 空。 | 空 |
16 | complain | アイテムについて苦情を申し立てる行動。 | 空。 | 空 |
データレポートを表示する
データ収集機能を有効にして、特定量の行動データをアップロードすると、データ収集ページでデータの状態と品質を表示できます。

データの状態
データの状態は、正常 (使用可能) または異常 (使用不可) です。正常 (使用可能) は、行動データに品質の問題が発生しておらず、行動データが検証されていることを示します。異常 (使用不可) は、行動データに品質の問題が発生していることを示します。
データの状態が異常 (使用不可) の場合、人気モデルとカテゴリ予測の作成とトレーニングに影響を与える可能性があります。
異常データ

正常データ

データの品質
行動データの品質チェックが失敗した場合、OpenSearch コンソールのデータ検証ページにエラーメッセージが表示されます。品質チェックに合格した場合、データ検証ページにはエラーメッセージは表示されません。
注: 上記の図でチェックされたサンプルデータは、毎時の始めにサンプル品質チェックが実行される 1 時間前に OpenSearch に同期された行動データです。