PutDocumentsRequest.Builder.AddTakenActionGenericDocuments メソッド

定義

名前空間:: Android.App.AppSearch

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
AddTakenActionGenericDocuments(GenericDocument[])	実行されたアクションメトリックを含む 1 つ以上の GenericDocument オブジェクトを要求に追加します。
AddTakenActionGenericDocuments(ICollection<GenericDocument>)	実行されたアクションメトリックを含む GenericDocument オブジェクトのコレクションを要求に追加します。

AddTakenActionGenericDocuments(GenericDocument[])

実行されたアクションメトリックを含む 1 つ以上の GenericDocument オブジェクトを要求に追加します。

[Android.Runtime.Register("addTakenActionGenericDocuments", "([Landroid/app/appsearch/GenericDocument;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)]
public Android.App.AppSearch.PutDocumentsRequest.Builder AddTakenActionGenericDocuments(params Android.App.AppSearch.GenericDocument[] takenActionGenericDocuments);

[<Android.Runtime.Register("addTakenActionGenericDocuments", "([Landroid/app/appsearch/GenericDocument;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)>]
member this.AddTakenActionGenericDocuments : Android.App.AppSearch.GenericDocument[] -> Android.App.AppSearch.PutDocumentsRequest.Builder

パラメーター

takenActionGenericDocuments: GenericDocument[]

アクションを実行したメトリックフィールドを含む 1 つ以上の GenericDocument オブジェクト。この値は null にすることはできません。

返品

PutDocumentsRequest.Builder

属性: RegisterAttribute

注釈

実行されたアクションメトリックを含む 1 つ以上の GenericDocument オブジェクトを要求に追加します。 Jetpack ライブラリで実行済みアクションドキュメントクラスを使用して、実行済みアクションドキュメントを作成することをお勧めします。 GenericDocument.Builder.setCreationTimestampMillis を使用して、GenericDocument のドキュメント作成タイムスタンプを実際のアクションタイムスタンプに設定する必要があります。クライアントは、検索を報告し、GenericDocument.getCreationTimestampMillis 順に並べ替えられたアクションをまとめてクリックする必要があります。たとえば、2 つの検索アクションがあり、1 つ目に関連付けられたクリックアクションが 1 つ、2 番目のクリックアクションが関連付けられている場合、クライアントは [searchAction1、clickAction1、searchAction2、clickAction2、clickAction3] を報告する必要があります。 AppSearch: Search action actionType: LONG (アクションの種類の列挙値) によって収集されるさまざまな種類のアクションとメトリック。検索アクションには 1 である必要があります。 query: STRING、ユーザーが入力した検索入力 (演算子や書き換えなし)。 fetchedResultCount: LONG。この検索アクションで AppSearch からフェッチされた SearchResult ドキュメントの数。 actionType: LONG (アクションの種類の列挙値) をクリックします。クリック操作の場合は 2 にする必要があります。 query: STRING。ユーザーがアクションを実行した SearchResult を生成したユーザー入力の検索入力 (演算子や書き換えなし)。 referencedQualifiedId: STRING。ユーザーがアクションを実行する SearchResult ドキュメントの修飾 ID。修飾 ID は、パッケージ、データベース、名前空間、およびドキュメント ID によって生成される文字列です。詳細については、DocumentIdUtil.createQualifiedId(String、String、GenericDocument) を参照してください。 resultRankInBlock: LONG。ユーザー定義ブロック内の SearchResult ドキュメントのランク。クライアントは、ブロックの独自のカスタム定義 (コーパス名、グループなど) を定義できます。たとえば、クライアントはブロックをコーパスとして定義し、AppSearch は corpus = ["corpus1"、"corpus1"、"corpus2"、"corpus3"、"corpus2"] の 5 つのドキュメントを返します。次に、それらのブロックランクは [1, 2, 1, 1, 1, 2] です。クライアントが結果を複数のブロックで表示しない場合は、resultRankGlobal と一致するようにこの値を設定する必要があります。 resultRankGlobal: LONG(SearchResult ドキュメントのグローバルランク)。グローバルランクは、AppSearch によって返される SearchResult ドキュメントの順序を反映します。たとえば、AppSearch は、各ページに対して 10 個の SearchResult ドキュメントを含む 2 ページを返します。その後、それらのグローバルランクは最初のページでは 1 から 10、2 番目のページでは 11 から 20 になります。 timeStayOnResultMillis: LONG(ユーザーが SearchResult ドキュメントをクリックした後に保持する時間 (ミリ秒単位)。この API を使用して報告されたアクションに関する特定の匿名化された情報は、統計を使用してアップロードされ、検索アルゴリズムの品質を向上させるために使用される場合があります。このクラスの情報のほとんどは、期間や結果セット内での位置など、既に識別不可能です。クエリ文字列など、指定する識別可能な情報は、Federated Analytics などの手法を使用して匿名化され、ユーザー全体で最も頻繁に検索される用語のみが保持され、調査に使用できるようになります。または、addGenericDocuments(GenericDocument...) を使用することもできます。上記の匿名化された統計のアップロードをトリガーすることなく、デバイス上で参加して使用する利点を保持する API。

android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocumentsの Android リファレンス。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更であり Creative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

適用対象

AddTakenActionGenericDocuments(ICollection<GenericDocument>)

実行されたアクションメトリックを含む GenericDocument オブジェクトのコレクションを要求に追加します。

[Android.Runtime.Register("addTakenActionGenericDocuments", "(Ljava/util/Collection;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)]
public Android.App.AppSearch.PutDocumentsRequest.Builder AddTakenActionGenericDocuments(System.Collections.Generic.ICollection<Android.App.AppSearch.GenericDocument> takenActionGenericDocuments);

[<Android.Runtime.Register("addTakenActionGenericDocuments", "(Ljava/util/Collection;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)>]
member this.AddTakenActionGenericDocuments : System.Collections.Generic.ICollection<Android.App.AppSearch.GenericDocument> -> Android.App.AppSearch.PutDocumentsRequest.Builder