PutDocumentsRequest.Builder.AddTakenActionGenericDocuments Metodo

Definizione

Spazio dei nomi:: Android.App.AppSearch

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Nome	Descrizione
AddTakenActionGenericDocuments(GenericDocument[])	Aggiunge uno o più oggetti GenericDocument contenenti le metriche delle azioni eseguite alla richiesta.
AddTakenActionGenericDocuments(ICollection<GenericDocument>)	Aggiunge una raccolta di oggetti GenericDocument contenenti le metriche di azione eseguite alla richiesta.

AddTakenActionGenericDocuments(GenericDocument[])

Aggiunge uno o più oggetti GenericDocument contenenti le metriche delle azioni eseguite alla richiesta.

[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

Parametri

takenActionGenericDocuments: GenericDocument[]

uno o più oggetti GenericDocument contenenti campi metrica azione intrapresi. Questo valore non può essere Null.

Valori restituiti

PutDocumentsRequest.Builder

Attributi: RegisterAttribute

Commenti

Aggiunge uno o più oggetti GenericDocument contenenti le metriche delle azioni eseguite alla richiesta. È consigliabile usare le classi di documenti di azione intraprese nella libreria Jetpack per costruire documenti di azione intrapresi. Il timestamp di creazione del documento di GenericDocument deve essere impostato sul timestamp effettivo dell'azione tramite GenericDocument.Builder.setCreationTimestampMillis. I client devono segnalare la ricerca e fare clic su azioni ordinate in base a GenericDocument.getCreationTimestampMillis in ordine cronologico. Ad esempio, se sono presenti 2 azioni di ricerca, con un'azione di clic associata alla prima e 2 azioni di clic associate al secondo, i client devono segnalare [searchAction1, clickAction1, searchAction2, clickAction2, clickAction3]. Tipi diversi di azioni eseguite e metriche da raccogliere da AppSearch: search actiontype: LONG, il valore enumerazione del tipo di azione. Deve essere 1 per le azioni di ricerca. query: STRING, input di ricerca immesso dall'utente (senza operatori o riscrittura). fetchedResultCount: LONG, numero di documenti SearchResult recuperati da AppSearch in questa azione di ricerca. Fare clic su action actionType: LONG, il valore enumerazione del tipo di azione. Deve essere 2 per le azioni di clic. query: STRING, input di ricerca immesso dall'utente (senza operatori o riscrittura) che ha restituito SearchResult su cui l'utente ha eseguito l'azione. referencedQualifiedId: STRING, ID completo del documento SearchResult su cui l'utente esegue l'azione. Un ID completo è una stringa generata da pacchetto, database, spazio dei nomi e ID documento. Per altri dettagli, vedere DocumentIdUtil.createQualifiedId(String, String, GenericDocument). resultRankInBlock: LONG, classificazione del documento SearchResult tra il blocco definito dall'utente. Il client può definire la propria definizione personalizzata per il blocco, ad esempio nome del corpus, gruppo e così via. Ad esempio, un client definisce il blocco come corpus e AppSearch restituisce 5 documenti con corpus = ["corpus1", "corpus1", "corpus2", "corpus3", "corpus2"]. Quindi il blocco li classifica = [1, 2, 1, 1, 2]. Se il client non presenta i risultati in più blocchi, deve impostare questo valore in modo che corrisponda a resultRankGlobal. resultRankGlobal: LONG, classificazione globale del documento SearchResult. La classificazione globale riflette l'ordine dei documenti SearchResult restituiti da AppSearch. Ad esempio, AppSearch restituisce 2 pagine con 10 documenti SearchResult per ogni pagina. I ranghi globali saranno quindi da 1 a 10 per la prima pagina e da 11 a 20 per la seconda pagina. timeStayOnResultMillis: LONG, il tempo in millisecondi in cui l'utente rimane nel documento SearchResult dopo aver fatto clic su di esso. Alcune informazioni anonime sulle azioni segnalate tramite questa API possono essere caricate usando statistiche e possono essere usate per migliorare la qualità degli algoritmi di ricerca. La maggior parte delle informazioni in questa classe è già non identificabile, ad esempio le durate e la relativa posizione nel set di risultati. Le informazioni identificabili che si sceglie di fornire, ad esempio la stringa di query, verranno rese anonime usando tecniche come Federated Analytics per garantire che solo i termini ricercati più frequentemente nell'intero popolamento degli utenti vengano conservati e disponibili per lo studio. In alternativa, è possibile usare addGenericDocuments(GenericDocument...) API per mantenere i vantaggi dell'aggiunta e dell'uso nel dispositivo, senza attivare il caricamento delle statistiche anonime descritto in precedenza.

Informazioni di riferimento su Android per android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

AddTakenActionGenericDocuments(ICollection<GenericDocument>)

Aggiunge una raccolta di oggetti GenericDocument contenenti le metriche di azione eseguite alla richiesta.

[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