Method: projects.locations.dataStores.userEvents.collect

Schreibt ein einzelnes Nutzerereignis aus dem Browser. Hier wird eine GET-Anfrage verwendet, da Browser die POST-Übertragung an eine Drittanbieterdomain einschränken.

Diese Methode wird nur vom JavaScript-Pixel der Discovery Engine API und von Google Tag Manager verwendet. Nutzer sollten diese Methode nicht direkt aufrufen.

HTTP-Anfrage

GET https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/dataStores/*}/userEvents:collect

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name der übergeordneten Ressource. Wenn die Aktion zur Erfassung eines Nutzerereignisses auf DataStore-Ebene angewendet wird, lautet das Format projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Wenn die Aktion zur Erfassung eines Nutzerereignisses beispielsweise auf Location-Ebene angewendet wird, lautet das Format für das Ereignis mit Document über mehrere DataStore hinweg projects/{project}/locations/{location}.

Anfrageparameter

Parameter
userEvent

string

Erforderlich. URL-codiertes UserEvent-Proto mit einer Längenbeschränkung von 2.000.000 Zeichen
uri

string

Die URL, einschließlich CGI-Parametern, aber ohne das Hash-Fragment. Die Länge ist auf 5.000 Zeichen beschränkt. Das ist oft nützlicher als die Referrer-URL, da viele Browser nur die Domain für Anfragen von Drittanbietern senden.
ets

string (int64 format)

Der Zeitstempel des Ereignisses in Millisekunden. Dadurch wird verhindert, dass Browser ansonsten identische GET-Anfragen im Cache speichern. Der Name wird abgekürzt, um die Nutzlastbyte zu reduzieren.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist die Antwort eine allgemeine HTTP-Antwort, deren Format von der Methode vorgegeben wird.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Weitere Informationen finden Sie unter Authentication Overview.