REST Resource: projects.locations.dataStores.userEvents

Ressource: UserEvent

Mit UserEvent werden alle Metadaten erfasst, die für die Discovery Engine API erforderlich sind, um zu erfahren, wie Endnutzer mit Ihrer Website interagieren.

JSON-Darstellung 
{
  "eventType": string,
  "conversionType": string,
  "userPseudoId": string,
  "engine": string,
  "dataStore": string,
  "eventTime": string,
  "userInfo": {
    object (UserInfo)
  },
  "directUserRequest": boolean,
  "sessionId": string,
  "pageInfo": {
    object (PageInfo)
  },
  "attributionToken": string,
  "filter": string,
  "documents": [
    {
      object (DocumentInfo)
    }
  ],
  "panel": {
    object (PanelInfo)
  },
  "searchInfo": {
    object (SearchInfo)
  },
  "completionInfo": {
    object (CompletionInfo)
  },
  "transactionInfo": {
    object (TransactionInfo)
  },
  "tagIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "attributes": {
    string: {
      "text": [
        string
      ],
      "numbers": [
        number
      ]
    },
    ...
  },
  "mediaInfo": {
    object (MediaInfo)
  },
  "panels": [
    {
      object (PanelInfo)
    }
  ]
}
Felder
eventType

string

Erforderlich. Nutzerereignistyp. Zulässige Werte sind:

Generische Werte:

  • search: Nach Dokumenten suchen.
  • view-item: Detaillierte Seitenansicht eines Dokuments.
  • view-item-list: Ansicht eines Bereichs oder einer sortierten Liste von Dokumenten.
  • view-home-page: Ansicht der Startseite.
  • view-category-page: Ansicht einer Kategorieseite, z.B. „Startseite“ > „Herren“ > „Jeans“

Einzelhandelsbezogene Werte:

  • add-to-cart: Artikel in den Einkaufswagen legen, z.B. beim Online-Shopping im Einzelhandel
  • purchase: Artikel kaufen

Media-bezogene Werte:

  • media-play: Ein Video oder einen Song starten oder die Wiedergabe fortsetzen
  • media-complete: Das Video, Lied usw. wurde beendet oder mittendrin angehalten.

Benutzerdefinierter Conversion-Wert:

  • conversion: Vom Kunden definiertes Conversion-Ereignis.
conversionType

string

Optional. Conversion-Typ

Erforderlich, wenn UserEvent.event_type conversion ist. Dies ist ein vom Kunden definierter Conversion-Name in Kleinbuchstaben oder Ziffern, die durch „-“ getrennt sind, z. B. „watch“ oder „good-visit“.

Legen Sie das Feld nicht fest, wenn UserEvent.event_type nicht conversion ist. Dadurch wird das benutzerdefinierte Conversion-Ereignis mit vordefinierten Ereignissen wie search, view-item usw. kombiniert.
userPseudoId

string

Erforderlich. Eine eindeutige Kennung für das Tracking von Besuchern.

Dies kann beispielsweise mit einem HTTP-Cookie implementiert werden, mit dem ein Besucher auf einem einzelnen Gerät eindeutig identifiziert werden kann. Diese eindeutige ID sollte sich nicht ändern, wenn sich der Besucher auf der Website an- oder abmeldet.

Legen Sie für verschiedene Nutzer nicht dieselbe feste ID für das Feld fest. Dadurch wird der Ereignisverlauf dieser Nutzer vermischt, was zu einer geringeren Modellqualität führt.

Das Feld muss ein UTF-8-codierter String mit einer Längenbeschränkung von 128 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Das Feld darf keine personenidentifizierbaren Informationen oder Nutzerdaten enthalten. Wir empfehlen, für dieses Feld die Client-ID von Google Analytics zu verwenden.
engine

string

Der Ressourcenname von Engine im Format projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Optional. Nur für von Engine erstellte Nutzerereignisse erforderlich. Das können beispielsweise Nutzerereignisse aus der kombinierten Suche sein.
dataStore

string

Der vollständige Name der DataStore-Ressource im Format projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId}.

Optional. Nur für Nutzerereignisse erforderlich, deren Datenspeicher nicht durch UserEvent.engine oder UserEvent.documents bestimmt werden kann. Wenn der Datenspeicher im übergeordneten Element von Anfragen zum Schreiben, Importieren oder Erfassen von Nutzerereignissen festgelegt ist, kann dieses Feld weggelassen werden.
eventTime

string (Timestamp format)

Nur für die Methode UserEventService.ImportUserEvents erforderlich. Zeitstempel des Nutzerereignisses.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
userInfo

object (UserInfo)

Informationen zum Endnutzer.
directUserRequest

boolean

Sollte auf „true“ gesetzt werden, wenn die Anfrage direkt vom Endnutzer gestellt wird. In diesem Fall kann UserEvent.user_info.user_agent aus der HTTP-Anfrage übernommen werden.

Dieses Flag sollte nur gesetzt werden, wenn die API-Anfrage direkt vom Endnutzer, z. B. über eine mobile App, erfolgt und nicht, wenn ein Gateway oder ein Server die Nutzerereignisse verarbeitet und überträgt.

Dieser Wert sollte nicht festgelegt werden, wenn das JavaScript-Tag in UserEventService.CollectUserEvent verwendet wird.
sessionId

string

Eine eindeutige Kennung zum Tracking einer Besuchersitzung mit einer Längenbeschränkung von 128 Byte. Eine Sitzung ist eine Zusammenfassung des Endnutzerverhaltens in einem bestimmten Zeitraum.

Allgemeine Richtlinie zum Ausfüllen der „sessionId“:

  1. Wenn ein Nutzer 30 Minuten lang inaktiv ist, sollte ihm eine neue „sessionId“ zugewiesen werden.
  2. Die sessionId sollte für alle Nutzer eindeutig sein. Verwenden Sie uuid oder fügen Sie UserEvent.user_pseudo_id als Präfix hinzu.
pageInfo

object (PageInfo)

Seitenmetadaten wie Kategorien und andere wichtige Informationen für bestimmte Ereignistypen wie view-category-page.
attributionToken

string

Token zum Zuordnen einer API-Antwort zu Nutzeraktionen, die das Ereignis auslösen.

Für Nutzerereignisse, die das Ergebnis von RecommendationService.Recommend sind, dringend empfohlen. Dieses Feld ermöglicht eine genaue Attribution der Leistung des Empfehlungsmodells.

Der Wert muss einer der folgenden sein:

Mit diesem Token können wir Seitenaufrufe oder Conversion-Abschlüsse dem Ereignis und der jeweiligen Vorhersageantwort zuordnen, die dieses angeklickte/gekaufte Produkt enthält. Wenn ein Nutzer in den Empfehlungsergebnissen auf Produkt K klickt, übergeben Sie RecommendResponse.attribution_token als URL-Parameter an die Seite von Produkt K. Wenn Sie Ereignisse auf der Seite von Produkt K aufzeichnen, geben Sie die RecommendResponse.attribution_token in dieses Feld ein.
filter

string

Die Filtersyntax besteht aus einer Ausdruckssprache zum Erstellen eines Prädikats aus einem oder mehreren Feldern der gefilterten Dokumente.

Bei search-Ereignissen kann das zugehörige SearchRequest beispielsweise einen Filterausdruck in SearchRequest.filter enthalten, der https://google.aip.dev/160#filtering entspricht.

Bei view-item-list-Ereignissen, die aus einem RecommendRequest generiert werden, kann dieses Feld direkt aus RecommendRequest.filter gemäß https://google.aip.dev/160#filtering ausgefüllt werden.

Der Wert muss ein UTF‑8-codierter String mit einer Längenbeschränkung von 1.000 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
documents[]

object (DocumentInfo)

Liste der Document, die mit diesem Nutzerereignis verknüpft sind.

Dieses Feld ist mit Ausnahme der folgenden Ereignistypen optional:

  • view-item
  • add-to-cart
  • purchase
  • media-play
  • media-complete

Bei einem search-Ereignis stellt dieses Feld die Dokumente dar, die dem Endnutzer auf der aktuellen Seite zurückgegeben wurden. Der Endnutzer hat die gesamte Seite möglicherweise noch nicht durchsucht. Wenn dem Endnutzer nach der Paginierung, Filterung oder Sortierung eine neue Seite zurückgegeben wird, auch wenn es sich um dieselbe Anfrage handelt, ist ein neues search-Ereignis mit einem anderen UserEvent.documents-Wert erforderlich.
panel

object (PanelInfo)

Panel-Metadaten, die mit diesem Nutzerereignis verknüpft sind.
searchInfo

object (SearchInfo)

SearchService.Search – Details zum Ereignis.

Dieses Feld sollte für das Ereignis search festgelegt werden.
completionInfo

object (CompletionInfo)

CompletionService.CompleteQuery – Details zum Ereignis.

Dieses Feld sollte für das search-Ereignis festgelegt werden, wenn die Funktion zur automatischen Vervollständigung aktiviert ist und der Nutzer auf einen Suchvorschlag klickt.
transactionInfo

object (TransactionInfo)

Die mit diesem Nutzerereignis verknüpften Transaktionsmetadaten (falls vorhanden).
tagIds[]

string

Eine Liste mit Kennungen für die unabhängigen Testgruppen, zu denen dieses Nutzerereignis gehört. Damit wird zwischen Nutzerereignissen unterschieden, die mit verschiedenen Testkonfigurationen verknüpft sind.
promotionIds[]

string

Die Promotions-IDs, wenn es sich um ein Ereignis handelt, das mit Promotions verknüpft ist. Derzeit ist dieses Feld auf maximal eine ID beschränkt.
attributes

map (key: string, value: object)

Zusätzliche Nutzerereignis-Features, die in das Empfehlungsmodell aufgenommen werden sollen. Diese Attribute dürfen KEINE Daten enthalten, die weiter analysiert oder verarbeitet werden müssen, z.B. JSON oder andere Codierungen.

Wenn Sie benutzerdefinierte Attribute für aufgenommene Nutzerereignisse angeben, müssen Sie sie auch in die Nutzerereignisse einbeziehen, die Sie mit Vorhersageanfragen verknüpfen. Die Formatierung benutzerdefinierter Attribute muss zwischen importierten Ereignissen und Ereignissen, die mit Vorhersageanfragen bereitgestellt werden, einheitlich sein. So kann die Discovery Engine API diese benutzerdefinierten Attribute beim Trainieren von Modellen und Bereitstellen von Vorhersagen verwenden, was die Qualität der Empfehlungen verbessert.

Dieses Feld muss alle unten aufgeführten Kriterien erfüllen, andernfalls wird ein INVALID_ARGUMENT-Fehler zurückgegeben:

  • Der Schlüssel muss ein UTF‑8-codierter String mit einer Längenbeschränkung von 5.000 Zeichen sein.
  • Für Textattribute sind maximal 400 Werte zulässig. Leere Werte sind nicht zulässig. Jeder Wert muss ein UTF-8-codierter String mit einer Längenbeschränkung von 256 Zeichen sein.
  • Für Zahlenattribute sind maximal 400 Werte zulässig.

Ein Beispiel für zusätzliche Nutzerinformationen für Produktempfehlungen ist traffic_channel. Damit wird angegeben, wie ein Nutzer auf die Website gelangt. Nutzer können die Website direkt, über die Google Suche oder auf andere Weise aufrufen.
attributes.text[]

string

Die Textwerte dieses benutzerdefinierten Attributs. Beispiel: ["yellow", "green"], wenn der Schlüssel „color“ ist.

Ein leerer String ist nicht zulässig. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es sollte genau eines von CustomAttribute.text und CustomAttribute.numbers festgelegt sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
attributes.numbers[]

number

Die numerischen Werte dieses benutzerdefinierten Attributs. Beispiel: [2.3, 15.4], wenn der Schlüssel „lengths_cm“ ist.

Es sollte genau eines von CustomAttribute.text und CustomAttribute.numbers festgelegt sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
mediaInfo

object (MediaInfo)

Medienspezifische Informationen
panels[]

object (PanelInfo)

Optional. Liste der Panels, die mit diesem Ereignis verknüpft sind. Wird für Impressionen auf Seitenebene verwendet.

UserInfo

Informationen eines Endnutzers.

JSON-Darstellung 
{
  "userId": string,
  "userAgent": string,
  "timeZone": string
}
Felder
userId

string

Für angemeldete Nutzer dringend empfohlen. Eindeutige Kennung für den angemeldeten Nutzer, z. B. ein Nutzername. Nicht für anonyme Nutzer festlegen.

Verwenden Sie immer einen gehashten Wert für diese ID.

Legen Sie für verschiedene Nutzer nicht dieselbe feste ID für das Feld fest. Dadurch wird der Ereignisverlauf dieser Nutzer vermischt, was zu einer geringeren Modellqualität führt.

Das Feld muss ein UTF-8-codierter String mit einer Längenbeschränkung von 128 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
userAgent

string

User-Agent, wie im HTTP-Header enthalten.

Das Feld muss ein UTF-8-codierter String mit einer Längenbeschränkung von 1.000 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Dieser Wert sollte nicht festgelegt werden, wenn Sie die clientseitige Ereignisberichterstellung mit GTM oder dem JavaScript-Tag in UserEventService.CollectUserEvent verwenden oder wenn UserEvent.direct_user_request festgelegt ist.
timeZone

string

Optional. IANA-Zeitzone, z.B. Europe/Budapest.

PageInfo

Detaillierte Seiteninformationen.

JSON-Darstellung 
{
  "pageviewId": string,
  "pageCategory": string,
  "uri": string,
  "referrerUri": string
}
Felder
pageviewId

string

Eine eindeutige ID einer Webseitenaufrufs.

Dieser Wert sollte für alle Nutzerereignisse, die durch denselben Seitenaufruf ausgelöst werden, gleich bleiben. Ein Aufruf der Detailseite eines Artikels kann beispielsweise mehrere Ereignisse auslösen, während der Nutzer die Seite durchsucht. Die pageviewId-Property sollte für alle diese Ereignisse gleich bleiben, damit sie richtig gruppiert werden können.

Wenn Sie die clientseitige Ereignisberichterstellung mit JavaScript-Pixel und Google Tag Manager verwenden, wird dieser Wert automatisch ausgefüllt.
pageCategory

string

Die spezifischste Kategorie, die einer Kategorieseite zugeordnet ist.

Verwenden Sie das Zeichen „>“, um verschiedene Hierarchien zu trennen und den vollständigen Pfad der Kategorie darzustellen. Wenn „>“ Teil des Kategorienamens ist, ersetzen Sie es durch andere Zeichen.

Kategorieseiten umfassen spezielle Seiten wie Verkaufs- oder Werbeaktionsseiten. Eine spezielle Angebotsseite kann beispielsweise die Kategoriehierarchie "pageCategory" : "Sales > 2017 Black Friday Deals" haben.

Erforderlich für view-category-page-Ereignisse. Bei anderen Ereignistypen sollte dieses Feld nicht festgelegt werden. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
uri

string

Vollständige URL (window.location.href) der aktuellen Seite des Nutzers.

Wenn Sie die clientseitige Ereignisberichterstellung mit JavaScript-Pixel und Google Tag Manager verwenden, wird dieser Wert automatisch ausgefüllt. Maximale Länge: 5.000 Zeichen.
referrerUri

string

Die Referrer-URL der aktuellen Seite.

Wenn Sie die clientseitige Ereignisberichterstellung mit JavaScript-Pixel und Google Tag Manager verwenden, wird dieser Wert automatisch ausgefüllt. Aufgrund von Datenschutzbeschränkungen in einigen Browsern kann dieses Feld jedoch leer sein.

DocumentInfo

Detaillierte Dokumentinformationen, die mit einem Nutzerereignis verknüpft sind.

JSON-Darstellung 
{
  "promotionIds": [
    string
  ],
  "joined": boolean,

  // Union field document_descriptor can be only one of the following:
  "id": string,
  "name": string,
  "uri": string
  // End of list of possible types for union field document_descriptor.
  "quantity": integer,
  "conversionValue": number
}
Felder
promotionIds[]

string

Die mit diesem Dokument verknüpften Angebots-IDs. Derzeit ist dieses Feld auf maximal eine ID beschränkt.
joined

boolean

Nur Ausgabe. Gibt an, ob das referenzierte Dokument im Datenspeicher gefunden werden kann.

Union-Feld document_descriptor. Ein erforderlicher Deskriptor der zugehörigen Document.

  • Wenn id angegeben ist, werden die Standardwerte für {location}, {collection_id}, {data_store_id} und {branch_id} verwendet, wenn Anmerkungen mit dem gespeicherten Dokument erstellt werden.

  • Wenn name angegeben ist, werden die angegebenen Werte (Standardwerte sind zulässig) für {location}, {collection_id}, {data_store_id} und {branch_id} verwendet, wenn das gespeicherte Dokument annotiert wird. Für document_descriptor ist nur einer der folgenden Werte zulässig:
id

string

Die Ressourcen-ID von Document.
name

string

Der vollständige Name der Document-Ressource im Format projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId}/branches/{branchId}/documents/{documentId}.
uri

string

Der Document-URI ist nur für Website-Datenspeicher zulässig.
quantity

integer

Menge des Dokuments, das mit dem Nutzerereignis verknüpft ist. Der Standardfaktor ist 1.

Dieser Wert ist beispielsweise „2“, wenn bei einem add-to-cart-Ereignis zwei Mengen desselben Dokuments beteiligt sind.

Erforderlich für Ereignisse der folgenden Ereignistypen:

  • add-to-cart
  • purchase
conversionValue

number

Optional. Der mit diesem Dokument verknüpfte Conversion-Wert. Muss festgelegt werden, wenn UserEvent.event_type „conversion“ ist.

Ein Wert von 1.000 bedeutet beispielsweise, dass ein Dokument für den Conversion-Typ watch 1.000 Sekunden lang angesehen wurde.

PanelInfo

Detaillierte Informationen zum Panel, das einem Nutzerereignis zugeordnet ist.

JSON-Darstellung 
{
  "panelId": string,
  "displayName": string,
  "documents": [
    {
      object (DocumentInfo)
    }
  ],
  "panelPosition": integer,
  "totalPanels": integer
}
Felder
panelId

string

Erforderlich. Die Bereichs-ID.
displayName

string

Der Anzeigename des Bereichs.
documents[]

object (DocumentInfo)

Optional. Die mit diesem Bereich verknüpften Dokument-IDs.
panelPosition

integer

Die geordnete Position des Felds, wenn es dem Nutzer zusammen mit anderen Feldern angezeigt wird. Wenn dieser Wert festgelegt ist, muss auch totalPanels festgelegt werden.
totalPanels

integer

Die Gesamtzahl der Bereiche, einschließlich dieses, die dem Nutzer angezeigt wurden. Muss festgelegt werden, wenn panelPosition festgelegt ist.

SearchInfo

Detaillierte Suchinformationen

JSON-Darstellung 
{
  "searchQuery": string,
  "orderBy": string,
  "offset": integer
}
Felder
searchQuery

string

Die Suchanfrage des Nutzers.

Eine Definition finden Sie unter SearchRequest.query.

Der Wert muss ein UTF‑8-codierter String mit einer Längenbeschränkung von 5.000 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Für search-Ereignisse muss mindestens searchQuery oder PageInfo.page_category angegeben werden. Bei anderen Ereignistypen sollte dieses Feld nicht festgelegt werden. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
orderBy

string

Die Reihenfolge, in der Produkte zurückgegeben werden (falls zutreffend).

Definition und Syntax finden Sie unter SearchRequest.order_by.

Der Wert muss ein UTF‑8-codierter String mit einer Längenbeschränkung von 1.000 Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Dieser Wert kann nur für search-Ereignisse festgelegt werden. Bei anderen Ereignistypen sollte dieses Feld nicht festgelegt werden. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
offset

integer

Eine Ganzzahl, die den aktuellen Offset für die Paginierung angibt (die 0-basierte Startposition unter den Produkten, die von der API als relevant eingestuft werden).

Eine Definition finden Sie unter SearchRequest.offset.

Wenn dieses Feld negativ ist, wird ein INVALID_ARGUMENT zurückgegeben.

Dieser Wert kann nur für search-Ereignisse festgelegt werden. Bei anderen Ereignistypen sollte dieses Feld nicht festgelegt werden. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

CompletionInfo

Detaillierte Informationen zum Abschluss, einschließlich des Attributions-Tokens für den Abschluss und der Informationen zum angeklickten Abschluss.

JSON-Darstellung 
{
  "selectedSuggestion": string,
  "selectedPosition": integer
}
Felder
selectedSuggestion

string

Endnutzer CompleteQueryResponse.QuerySuggestion.suggestion ausgewählt.
selectedPosition

integer

Die vom Endnutzer ausgewählte Position CompleteQueryResponse.QuerySuggestion.suggestion, beginnend mit 0.

TransactionInfo

Eine Transaktion umfasst die gesamte Kauftransaktion.

JSON-Darstellung 
{
  "currency": string,
  "transactionId": string,
  "value": number,
  "tax": number,
  "cost": number,
  "discountValue": number
}
Felder
currency

string

Erforderlich. Währungscode. Verwenden Sie den dreistelligen ISO‑4217-Code.
transactionId

string

Die Transaktions-ID mit einer Längenbeschränkung von 128 Zeichen.
value

number

Erforderlich. Der Gesamtwert der Transaktion, der nicht null ist. Der Wert kann Versandkosten, Steuern und andere Anpassungen des Gesamtwerts enthalten, die berücksichtigt werden sollen.
tax

number

Alle Steuern, die mit der Transaktion verbunden sind.
cost

number

Alle Kosten, die mit den Produkten verbunden sind. Dazu können Fertigungskosten, Versandkosten, die nicht vom Endnutzer getragen werden, oder andere Kosten gehören, sodass gilt:
discountValue

number

Der Gesamtwert der Rabatte, die auf diese Transaktion angewendet wurden. Diese Zahl sollte aus TransactionInfo.value ausgeschlossen werden.

Wenn ein Nutzer beispielsweise den Betrag TransactionInfo.value bezahlt hat, ist der nominale Wert (vor Rabatt) der Transaktion die Summe aus TransactionInfo.value und TransactionInfo.discount_value.

Das bedeutet, dass der Gewinn unabhängig vom Rabattwert auf dieselbe Weise berechnet wird und TransactionInfo.discount_value größer als TransactionInfo.value sein kann:

MediaInfo

Medienspezifische Nutzerereignisinformationen

JSON-Darstellung 
{
  "mediaProgressDuration": string,
  "mediaProgressPercentage": number
}
Felder
mediaProgressDuration

string (Duration format)

Die Zeit, die seit Beginn der Wiedergabe vergangen ist, in Sekunden (falls zutreffend). Wenn der Endnutzer beispielsweise 90 Sekunden eines Wiedergabevideos angesehen hat, sollte MediaInfo.media_progress_duration.seconds auf 90 gesetzt werden.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
mediaProgressPercentage

number

Der Fortschritt von Media sollte nur anhand von mediaProgressDuration im Verhältnis zur Gesamtlänge der Media berechnet werden.

Dieser Wert muss zwischen [0, 1.0] liegen.

Wenn es sich nicht um eine Wiedergabe handelt oder der Fortschritt nicht berechnet werden kann (z.B. bei einem laufenden Livestream), sollte dieses Feld nicht festgelegt werden.

Methoden

collect

 Schreibt ein einzelnes Nutzerereignis aus dem Browser.

import

 Bulk-Import von Nutzerereignissen

purge

 Löscht alle Nutzerereignisse, die durch den angegebenen Filter definiert werden, dauerhaft.

write

 Schreibt ein einzelnes Nutzerereignis.