PutDocumentsRequest.Builder.AddTakenActionGenericDocuments Methode

Definition

Namespace:: Android.App.AppSearch

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
AddTakenActionGenericDocuments(GenericDocument[])	Fügt der Anforderung mindestens ein GenericDocument-Objekt hinzu, das Aktionsmetriken enthält.
AddTakenActionGenericDocuments(ICollection<GenericDocument>)	Fügt der Anforderung eine Auflistung von GenericDocument-Objekten hinzu, die Aktionsmetriken enthalten.

AddTakenActionGenericDocuments(GenericDocument[])

Fügt der Anforderung mindestens ein GenericDocument-Objekt hinzu, das Aktionsmetriken enthält.

[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

Parameter

takenActionGenericDocuments: GenericDocument[]

mindestens ein GenericDocument-Objekt, das Aktionsmetrikfelder enthält. Dieser Wert darf nicht NULL sein.

Gibt zurück

PutDocumentsRequest.Builder

Attribute: RegisterAttribute

Hinweise

Fügt der Anforderung mindestens ein GenericDocument-Objekt hinzu, das Aktionsmetriken enthält. Es wird empfohlen, ausgeführte Aktionsdokumentklassen in der Jetpack-Bibliothek zu verwenden, um ausgeführte Aktionsdokumente zu erstellen. Der Zeitstempel für die Dokumenterstellung des GenericDocument sollte auf den tatsächlichen Aktionszeitstempel über GenericDocument.Builder.setCreationTimestampMillis festgelegt werden. Clients sollten die Suche melden und auf Aktionen klicken, die nach GenericDocument.getCreationTimestampMillis in chronologischer Reihenfolge sortiert sind. Wenn beispielsweise zwei Suchaktionen vorhanden sind, mit einer Klickaktion, die der ersten und zwei Klickaktionen zugeordnet ist, die der zweiten zugeordnet sind, sollten Clients [searchAction1, clickAction1, searchAction2, clickAction2, clickAction3] melden. Verschiedene Arten von ausgeführten Aktionen und Metriken, die von AppSearch gesammelt werden: Search actionType: LONG, der Enumerationswert des Aktionstyps. Erfordert 1 für Suchaktionen. query: STRING, the user-entered search input (without any operators or rewriting). fetchedResultCount: LONG, die Anzahl der von AppSearch abgerufenen SearchResult-Dokumente in dieser Suchaktion. Klicken Sie auf actionType: LONG, der Enumerationswert des Aktionstyps. Erfordert 2 für Klickaktionen. query: STRING, the user-entered search input (without any operators or rewriting), that yielded the SearchResult on which the user took action. referencedQualifiedId: STRING, die qualifizierte ID des SearchResult-Dokuments, für das der Benutzer Eine Aktion ausführt. Eine qualifizierte ID ist eine Zeichenfolge, die von Paket, Datenbank, Namespace und Dokument-ID generiert wird. Weitere Informationen finden Sie unter DocumentIdUtil.createQualifiedId(String, String, GenericDocument). resultRankInBlock: LONG, der Rang des SearchResult-Dokuments unter dem benutzerdefinierten Block. Der Client kann eine eigene benutzerdefinierte Definition für Block definieren, z. B. Korpusname, Gruppe usw. Beispielsweise definiert ein Client den Block als Korpus, und AppSearch gibt 5 Dokumente mit Korpus = ["corpus1", "corpus1", "corpus2", "corpus3", "corpus2" zurück. Dann rangiert der Block von ihnen = [1, 2, 1, 1, 2]. Wenn der Client die Ergebnisse nicht in mehreren Blöcken darstellt, sollte dieser Wert auf "resultRankGlobal" festgelegt werden. resultRankGlobal: LONG, der globale Rang des SearchResult-Dokuments. Die globale Rangfolge spiegelt die Reihenfolge von SearchResult-Dokumenten wider, die von AppSearch zurückgegeben werden. Beispielsweise gibt AppSearch 2 Seiten mit 10 SearchResult-Dokumenten für jede Seite zurück. Dann sind die globalen Rangfolgen für die erste Seite 1 bis 10 und 11 bis 20 für die zweite Seite. timeStayOnResultMillis: LONG, die Zeit in Millisekunden, die der Benutzer nach dem Klicken auf das SearchResult-Dokument verbleibt. Bestimmte anonymisierte Informationen zu Aktionen, die mithilfe dieser API gemeldet werden, können mithilfe von Statistiken hochgeladen werden und können verwendet werden, um die Qualität der Suchalgorithmen zu verbessern. Die meisten Informationen in dieser Klasse sind bereits nicht identifizierbar, z. B. Dauer und Position im Resultset. Identifizierbare Informationen, die Sie bereitstellen möchten, z. B. die Abfragezeichenfolge, werden mithilfe von Techniken wie Federated Analytics anonymisiert, um sicherzustellen, dass nur die am häufigsten durchsuchten Begriffe in der gesamten Benutzerpopulation aufbewahrt und für die Studie verfügbar sind. Alternativ können Sie das addGenericDocuments(GenericDocument...) verwenden. API, um die Vorteile des Verknüpfens und Verwendens auf dem Gerät beizubehalten, ohne dass eine der oben beschriebenen anonymisierten Statistiken ausgelöst wird.

Android-Referenz für android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

AddTakenActionGenericDocuments(ICollection<GenericDocument>)

Fügt der Anforderung eine Auflistung von GenericDocument-Objekten hinzu, die Aktionsmetriken enthalten.

[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