すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:データ収集 V2.0

最終更新日:Apr 09, 2025

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 を使用して行動データをアップロードすることをお勧めします。次のセクションでは、行動データのアップロードに使用されるフィールドについて説明します。 説明:

  1. SDK を使用して行動データをアップロードするには、次のフィールドを指定する必要があります: imei または user_id、biz_id、trace_id、rn、bhv_type、bhv_time、item_id、および item_type。

  2. API 操作を呼び出して行動データをアップロードするには、上記のフィールドに加えて reach_time フィールドも指定する必要があります。

  3. 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。

  • 1: OpenSearch SDK を呼び出して行動データがアップロードされたことを示します。

  • 2: モバイル SDK を呼び出して行動データが収集されたことを示します。

  • 3: OpenSearch API 操作を呼び出して行動データがアップロードされたことを示します。

  • 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

  • buy_price フィールドの値は、注文が行われた時点でのアイテムの価格を示します。

  • デフォルトでは、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

アイテムについて苦情を申し立てる行動。

空。

データレポートを表示する

データ収集機能を有効にして、特定量の行動データをアップロードすると、データ収集ページでデータの状態と品質を表示できます。

验证报告

データの状態

データの状態は、正常 (使用可能) または異常 (使用不可) です。正常 (使用可能) は、行動データに品質の問題が発生しておらず、行動データが検証されていることを示します。異常 (使用不可) は、行動データに品質の問題が発生していることを示します。

データの状態が異常 (使用不可) の場合、人気モデルとカテゴリ予測の作成とトレーニングに影響を与える可能性があります

異常データ

5

正常データ

6

データの品質

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