Langue

PutDocumentsRequest.Builder.AddTakenActionGenericDocuments Méthode

Définition

Surcharges

Nom Description
AddTakenActionGenericDocuments(GenericDocument[])

Ajoute un ou plusieurs objets GenericDocument contenant des métriques d’action effectuées à la requête.

AddTakenActionGenericDocuments(ICollection<GenericDocument>)

Ajoute une collection d’objets GenericDocument contenant des métriques d’action effectuées à la requête.

AddTakenActionGenericDocuments(GenericDocument[])

Ajoute un ou plusieurs objets GenericDocument contenant des métriques d’action effectuées à la requête.

[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

Paramètres

takenActionGenericDocuments
GenericDocument[]

un ou plusieurs objets GenericDocument contenant des champs de métrique d’action pris. Cette valeur ne peut pas être null.

Retours

Attributs

Remarques

Ajoute un ou plusieurs objets GenericDocument contenant des métriques d’action effectuées à la requête. Il est recommandé d’utiliser des classes de document d’action dans la bibliothèque Jetpack pour construire des documents d’action. L’horodatage de création de document du GenericDocument doit être défini sur l’horodatage d’action réel via GenericDocument.Builder.setCreationTimestampMillis. Les clients doivent signaler la recherche et cliquer ensemble sur des actions triées par GenericDocument.getCreationTimestampMillis dans l’ordre chronologique. Par exemple, s’il existe 2 actions de recherche, avec 1 action de clic associée au premier et 2 actions de clic associées au deuxième, les clients doivent signaler [searchAction1, clickAction1, searchAction2, clickAction2, clickAction3]. Différents types d’actions et de métriques prises à collecter par AppSearch : ActionType d’action de recherche : LONG, valeur d’énumération du type d’action. Doit être 1 pour les actions de recherche. requête : STRING, entrée de recherche entrée par l’utilisateur (sans opérateurs ni réécriture). fetchedResultCount : LONG, le nombre de documents SearchResult récupérés à partir d’AppSearch dans cette action de recherche. Cliquez sur action actionType : LONG, valeur d’énumération du type d’action. Doit être 2 pour les actions de clic. requête : STRING, entrée par l’utilisateur dans la recherche (sans opérateurs ou réécriture) qui a généré le SearchResult sur lequel l’utilisateur a pris des mesures. referencedQualifiedId : STRING, ID qualifié du document SearchResult sur lequel l’utilisateur effectue des actions. Un ID qualifié est une chaîne générée par un package, une base de données, un espace de noms et un ID de document. Pour plus d’informations, voir DocumentIdUtil.createQualifiedId(String, String, GenericDocument). resultRankInBlock : LONG, le rang du document SearchResult parmi le bloc défini par l’utilisateur. Le client peut définir sa propre définition personnalisée pour le bloc, par exemple, le nom du corpus, le groupe, etc. Par exemple, un client définit le bloc en tant que corpus et AppSearch retourne 5 documents avec corpus = ["corpus1 », « corpus1 », « corpus2 », « corpus3 », « corpus2"]. Ensuite, les rangs des blocs = [1, 2, 1, 1, 2]. Si le client ne présente pas les résultats dans plusieurs blocs, il doit définir cette valeur pour qu’elle corresponde à resultRankGlobal. resultRankGlobal : LONG, classement global du document SearchResult. Le classement global reflète l’ordre des documents SearchResult retournés par AppSearch. Par exemple, AppSearch retourne 2 pages avec 10 documents SearchResult pour chaque page. Ensuite, les rangs globaux seront de 1 à 10 pour la première page, et de 11 à 20 pour la deuxième page. timeStayOnResultMillis : LONG, durée en millisecondes pendant laquelle l’utilisateur reste sur le document SearchResult après avoir cliqué dessus. Certaines informations anonymisées sur les actions signalées à l’aide de cette API peuvent être chargées à l’aide de statistiques et peuvent être utilisées pour améliorer la qualité des algorithmes de recherche. La plupart des informations de cette classe sont déjà non identifiables, telles que les durées et sa position dans le jeu de résultats. Les informations d’identification que vous choisissez de fournir, telles que la chaîne de requête, seront rendues anonymes à l’aide de techniques telles que Federated Analytics pour garantir que seuls les termes les plus fréquemment recherchés dans toute la population utilisateur sont conservés et disponibles pour l’étude. Vous pouvez également utiliser l’addGenericDocuments(GenericDocument...) API pour conserver les avantages de la jointure et de l’utiliser sur l’appareil, sans déclencher l’un des chargements de statistiques anonymes décrits ci-dessus.

Référence Android pour android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

AddTakenActionGenericDocuments(ICollection<GenericDocument>)

Ajoute une collection d’objets GenericDocument contenant des métriques d’action effectuées à la requête.

[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

Paramètres

takenActionGenericDocuments
ICollection<GenericDocument>

collection d’objets GenericDocument contenant des champs de métrique d’action pris. Cette valeur ne peut pas être null.

Retours

Attributs

Remarques

Ajoute une collection d’objets GenericDocument contenant des métriques d’action effectuées à la requête.

Référence Android pour android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à