Method: projects.locations.userEvents.collect

Scrive un singolo evento utente dal browser. Viene utilizzata una richiesta GET a causa della limitazione del browser di POST a un dominio di terze parti.

Questo metodo viene utilizzato solo dal pixel JavaScript dell'API Discovery Engine e da Google Tag Manager. Gli utenti non devono chiamare direttamente questo metodo.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa padre. Se l'azione di raccolta degli eventi utente viene applicata a livello DataStore, il formato è: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Se l'azione di raccolta degli eventi utente viene applicata a livello Location, ad esempio l'evento con Document in più DataStore, il formato è: projects/{project}/locations/{location}.

Parametri di query

Parametri
userEvent

string

Obbligatorio. Proto UserEvent codificato con URL con un limite di lunghezza di 2.000.000 di caratteri.
uri

string

L'URL, inclusi i parametri CGI ma escluso il frammento hash, con un limite di lunghezza di 5000 caratteri. Spesso è più utile dell'URL referrer, perché molti browser inviano solo il dominio per le richieste di terze parti.
ets

string (int64 format)

Il timestamp dell'evento in millisecondi. In questo modo si impedisce la memorizzazione nella cache del browser di richieste GET altrimenti identiche. Il nome è abbreviato per ridurre i byte del payload.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, la risposta è una risposta HTTP generica il cui formato è definito dal metodo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta Authentication Overview.