PutDocumentsRequest.Builder.AddTakenActionGenericDocuments Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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.
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.