public final class UserEvent extends com.google.protobuf.GeneratedMessageV3 implements UserEventOrBuilder
UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with customers' website.Protobuf type
google.cloud.discoveryengine.v1beta.UserEvent| Modifier and Type | Class and Description |
|---|---|
static class |
UserEvent.Builder
UserEvent captures all metadata information Discovery Engine API needs to
know about how end users interact with customers' website.
|
com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>,BuilderT extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT,BuilderT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable, com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter| Modifier and Type | Field and Description |
|---|---|
static int |
ATTRIBUTES_FIELD_NUMBER |
static int |
ATTRIBUTION_TOKEN_FIELD_NUMBER |
static int |
COMPLETION_INFO_FIELD_NUMBER |
static int |
DIRECT_USER_REQUEST_FIELD_NUMBER |
static int |
DOCUMENTS_FIELD_NUMBER |
static int |
EVENT_TIME_FIELD_NUMBER |
static int |
EVENT_TYPE_FIELD_NUMBER |
static int |
FILTER_FIELD_NUMBER |
static int |
MEDIA_INFO_FIELD_NUMBER |
static int |
PAGE_INFO_FIELD_NUMBER |
static int |
PANEL_FIELD_NUMBER |
static int |
PROMOTION_IDS_FIELD_NUMBER |
static int |
SEARCH_INFO_FIELD_NUMBER |
static int |
SESSION_ID_FIELD_NUMBER |
static int |
TAG_IDS_FIELD_NUMBER |
static int |
TRANSACTION_INFO_FIELD_NUMBER |
static int |
USER_INFO_FIELD_NUMBER |
static int |
USER_PSEUDO_ID_FIELD_NUMBER |
| Modifier and Type | Method and Description |
|---|---|
boolean |
containsAttributes(String key)
Extra user event features to include in the recommendation model.
|
boolean |
equals(Object obj) |
Map<String,CustomAttribute> |
getAttributes()
Deprecated.
|
int |
getAttributesCount()
Extra user event features to include in the recommendation model.
|
Map<String,CustomAttribute> |
getAttributesMap()
Extra user event features to include in the recommendation model.
|
CustomAttribute |
getAttributesOrDefault(String key,
CustomAttribute defaultValue)
Extra user event features to include in the recommendation model.
|
CustomAttribute |
getAttributesOrThrow(String key)
Extra user event features to include in the recommendation model.
|
String |
getAttributionToken()
Token to attribute an API response to user action(s) to trigger the event.
|
com.google.protobuf.ByteString |
getAttributionTokenBytes()
Token to attribute an API response to user action(s) to trigger the event.
|
CompletionInfo |
getCompletionInfo()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery]
details related to the event.
|
CompletionInfoOrBuilder |
getCompletionInfoOrBuilder()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery]
details related to the event.
|
static UserEvent |
getDefaultInstance() |
UserEvent |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
boolean |
getDirectUserRequest()
Should set to true if the request is made directly from the end user, in
which case the
[UserEvent.user_info.user_agent][google.cloud.discoveryengine.v1beta.UserInfo.user_agent]
can be populated from the HTTP request.
|
DocumentInfo |
getDocuments(int index)
List of [Document][google.cloud.discoveryengine.v1beta.Document]s
associated with this user event.
|
int |
getDocumentsCount()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s
associated with this user event.
|
List<DocumentInfo> |
getDocumentsList()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s
associated with this user event.
|
DocumentInfoOrBuilder |
getDocumentsOrBuilder(int index)
List of [Document][google.cloud.discoveryengine.v1beta.Document]s
associated with this user event.
|
List<? extends DocumentInfoOrBuilder> |
getDocumentsOrBuilderList()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s
associated with this user event.
|
com.google.protobuf.Timestamp |
getEventTime()
Only required for
[UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents]
method.
|
com.google.protobuf.TimestampOrBuilder |
getEventTimeOrBuilder()
Only required for
[UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents]
method.
|
String |
getEventType()
Required.
|
com.google.protobuf.ByteString |
getEventTypeBytes()
Required.
|
String |
getFilter()
The filter syntax consists of an expression language for constructing a
predicate from one or more fields of the documents being filtered.
|
com.google.protobuf.ByteString |
getFilterBytes()
The filter syntax consists of an expression language for constructing a
predicate from one or more fields of the documents being filtered.
|
MediaInfo |
getMediaInfo()
Media-specific info.
|
MediaInfoOrBuilder |
getMediaInfoOrBuilder()
Media-specific info.
|
PageInfo |
getPageInfo()
Page metadata such as categories and other critical information for certain
event types such as `view-category-page`.
|
PageInfoOrBuilder |
getPageInfoOrBuilder()
Page metadata such as categories and other critical information for certain
event types such as `view-category-page`.
|
PanelInfo |
getPanel()
Panel metadata associated with this user event.
|
PanelInfoOrBuilder |
getPanelOrBuilder()
Panel metadata associated with this user event.
|
com.google.protobuf.Parser<UserEvent> |
getParserForType() |
String |
getPromotionIds(int index)
The promotion IDs if this is an event associated with promotions.
|
com.google.protobuf.ByteString |
getPromotionIdsBytes(int index)
The promotion IDs if this is an event associated with promotions.
|
int |
getPromotionIdsCount()
The promotion IDs if this is an event associated with promotions.
|
com.google.protobuf.ProtocolStringList |
getPromotionIdsList()
The promotion IDs if this is an event associated with promotions.
|
SearchInfo |
getSearchInfo()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]
details related to the event.
|
SearchInfoOrBuilder |
getSearchInfoOrBuilder()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]
details related to the event.
|
int |
getSerializedSize() |
String |
getSessionId()
A unique identifier for tracking a visitor session with a length limit of
128 bytes.
|
com.google.protobuf.ByteString |
getSessionIdBytes()
A unique identifier for tracking a visitor session with a length limit of
128 bytes.
|
String |
getTagIds(int index)
A list of identifiers for the independent experiment groups this user event
belongs to.
|
com.google.protobuf.ByteString |
getTagIdsBytes(int index)
A list of identifiers for the independent experiment groups this user event
belongs to.
|
int |
getTagIdsCount()
A list of identifiers for the independent experiment groups this user event
belongs to.
|
com.google.protobuf.ProtocolStringList |
getTagIdsList()
A list of identifiers for the independent experiment groups this user event
belongs to.
|
TransactionInfo |
getTransactionInfo()
The transaction metadata (if any) associated with this user event.
|
TransactionInfoOrBuilder |
getTransactionInfoOrBuilder()
The transaction metadata (if any) associated with this user event.
|
UserInfo |
getUserInfo()
Information about the end user.
|
UserInfoOrBuilder |
getUserInfoOrBuilder()
Information about the end user.
|
String |
getUserPseudoId()
Required.
|
com.google.protobuf.ByteString |
getUserPseudoIdBytes()
Required.
|
boolean |
hasCompletionInfo()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery]
details related to the event.
|
boolean |
hasEventTime()
Only required for
[UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents]
method.
|
int |
hashCode() |
boolean |
hasMediaInfo()
Media-specific info.
|
boolean |
hasPageInfo()
Page metadata such as categories and other critical information for certain
event types such as `view-category-page`.
|
boolean |
hasPanel()
Panel metadata associated with this user event.
|
boolean |
hasSearchInfo()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]
details related to the event.
|
boolean |
hasTransactionInfo()
The transaction metadata (if any) associated with this user event.
|
boolean |
hasUserInfo()
Information about the end user.
|
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable |
internalGetFieldAccessorTable() |
protected com.google.protobuf.MapField |
internalGetMapField(int number) |
boolean |
isInitialized() |
static UserEvent.Builder |
newBuilder() |
static UserEvent.Builder |
newBuilder(UserEvent prototype) |
UserEvent.Builder |
newBuilderForType() |
protected UserEvent.Builder |
newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) |
protected Object |
newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused) |
static UserEvent |
parseDelimitedFrom(InputStream input) |
static UserEvent |
parseDelimitedFrom(InputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static UserEvent |
parseFrom(byte[] data) |
static UserEvent |
parseFrom(byte[] data,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static UserEvent |
parseFrom(ByteBuffer data) |
static UserEvent |
parseFrom(ByteBuffer data,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static UserEvent |
parseFrom(com.google.protobuf.ByteString data) |
static UserEvent |
parseFrom(com.google.protobuf.ByteString data,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static UserEvent |
parseFrom(com.google.protobuf.CodedInputStream input) |
static UserEvent |
parseFrom(com.google.protobuf.CodedInputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static UserEvent |
parseFrom(InputStream input) |
static UserEvent |
parseFrom(InputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
static com.google.protobuf.Parser<UserEvent> |
parser() |
UserEvent.Builder |
toBuilder() |
void |
writeTo(com.google.protobuf.CodedOutputStream output) |
canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapFieldReflection, isStringEmpty, makeExtensionsImmutable, makeMutableCopy, makeMutableCopy, mergeFromAndMakeImmutableInternal, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBooleanList, newBuilderForType, newDoubleList, newFloatList, newIntList, newLongList, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, writeReplace, writeString, writeStringNoTagfindInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toStringaddAll, addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeToclone, finalize, getClass, notify, notifyAll, wait, wait, waitpublic static final int EVENT_TYPE_FIELD_NUMBER
public static final int USER_PSEUDO_ID_FIELD_NUMBER
public static final int EVENT_TIME_FIELD_NUMBER
public static final int USER_INFO_FIELD_NUMBER
public static final int DIRECT_USER_REQUEST_FIELD_NUMBER
public static final int SESSION_ID_FIELD_NUMBER
public static final int PAGE_INFO_FIELD_NUMBER
public static final int ATTRIBUTION_TOKEN_FIELD_NUMBER
public static final int FILTER_FIELD_NUMBER
public static final int DOCUMENTS_FIELD_NUMBER
public static final int PANEL_FIELD_NUMBER
public static final int SEARCH_INFO_FIELD_NUMBER
public static final int COMPLETION_INFO_FIELD_NUMBER
public static final int TRANSACTION_INFO_FIELD_NUMBER
public static final int TAG_IDS_FIELD_NUMBER
public static final int PROMOTION_IDS_FIELD_NUMBER
public static final int ATTRIBUTES_FIELD_NUMBER
public static final int MEDIA_INFO_FIELD_NUMBER
protected Object newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
newInstance in class com.google.protobuf.GeneratedMessageV3public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
protected com.google.protobuf.MapField internalGetMapField(int number)
internalGetMapField in class com.google.protobuf.GeneratedMessageV3protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3public String getEventType()
Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.
string event_type = 1 [(.google.api.field_behavior) = REQUIRED];getEventType in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getEventTypeBytes()
Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.
string event_type = 1 [(.google.api.field_behavior) = REQUIRED];getEventTypeBytes in interface UserEventOrBuilderpublic String getUserPseudoId()
Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.
string user_pseudo_id = 2 [(.google.api.field_behavior) = REQUIRED];getUserPseudoId in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getUserPseudoIdBytes()
Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Do not set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. The field should not contain PII or user-data. We recommend to use Google Analytics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.
string user_pseudo_id = 2 [(.google.api.field_behavior) = REQUIRED];getUserPseudoIdBytes in interface UserEventOrBuilderpublic boolean hasEventTime()
Only required for [UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents] method. Timestamp of when the user event happened.
.google.protobuf.Timestamp event_time = 3;hasEventTime in interface UserEventOrBuilderpublic com.google.protobuf.Timestamp getEventTime()
Only required for [UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents] method. Timestamp of when the user event happened.
.google.protobuf.Timestamp event_time = 3;getEventTime in interface UserEventOrBuilderpublic com.google.protobuf.TimestampOrBuilder getEventTimeOrBuilder()
Only required for [UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1beta.UserEventService.ImportUserEvents] method. Timestamp of when the user event happened.
.google.protobuf.Timestamp event_time = 3;getEventTimeOrBuilder in interface UserEventOrBuilderpublic boolean hasUserInfo()
Information about the end user.
.google.cloud.discoveryengine.v1beta.UserInfo user_info = 4;hasUserInfo in interface UserEventOrBuilderpublic UserInfo getUserInfo()
Information about the end user.
.google.cloud.discoveryengine.v1beta.UserInfo user_info = 4;getUserInfo in interface UserEventOrBuilderpublic UserInfoOrBuilder getUserInfoOrBuilder()
Information about the end user.
.google.cloud.discoveryengine.v1beta.UserInfo user_info = 4;getUserInfoOrBuilder in interface UserEventOrBuilderpublic boolean getDirectUserRequest()
Should set to true if the request is made directly from the end user, in which case the [UserEvent.user_info.user_agent][google.cloud.discoveryengine.v1beta.UserInfo.user_agent] can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in [UserEventService.CollectUserEvent][google.cloud.discoveryengine.v1beta.UserEventService.CollectUserEvent].
bool direct_user_request = 5;getDirectUserRequest in interface UserEventOrBuilderpublic String getSessionId()
A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add [UserEvent.user_pseudo_id][google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id] as prefix.
string session_id = 6;getSessionId in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getSessionIdBytes()
A unique identifier for tracking a visitor session with a length limit of 128 bytes. A session is an aggregation of an end user behavior in a time span. A general guideline to populate the session_id: 1. If user has no activity for 30 min, a new session_id should be assigned. 2. The session_id should be unique across users, suggest use uuid or add [UserEvent.user_pseudo_id][google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id] as prefix.
string session_id = 6;getSessionIdBytes in interface UserEventOrBuilderpublic boolean hasPageInfo()
Page metadata such as categories and other critical information for certain event types such as `view-category-page`.
.google.cloud.discoveryengine.v1beta.PageInfo page_info = 7;hasPageInfo in interface UserEventOrBuilderpublic PageInfo getPageInfo()
Page metadata such as categories and other critical information for certain event types such as `view-category-page`.
.google.cloud.discoveryengine.v1beta.PageInfo page_info = 7;getPageInfo in interface UserEventOrBuilderpublic PageInfoOrBuilder getPageInfoOrBuilder()
Page metadata such as categories and other critical information for certain event types such as `view-category-page`.
.google.cloud.discoveryengine.v1beta.PageInfo page_info = 7;getPageInfoOrBuilder in interface UserEventOrBuilderpublic String getAttributionToken()
Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of [RecommendationService.Recommend][google.cloud.discoveryengine.v1beta.RecommendationService.Recommend]. This field enables accurate attribution of recommendation model performance. The value must be one of: * [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] for events that are the result of [RecommendationService.Recommend][google.cloud.discoveryengine.v1beta.RecommendationService.Recommend]. * [SearchResponse.attribution_token][google.cloud.discoveryengine.v1beta.SearchResponse.attribution_token] for events that are the result of [SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] as a URL parameter to product K's page. When recording events on product K's page, log the [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] to this field.
string attribution_token = 8;getAttributionToken in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getAttributionTokenBytes()
Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of [RecommendationService.Recommend][google.cloud.discoveryengine.v1beta.RecommendationService.Recommend]. This field enables accurate attribution of recommendation model performance. The value must be one of: * [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] for events that are the result of [RecommendationService.Recommend][google.cloud.discoveryengine.v1beta.RecommendationService.Recommend]. * [SearchResponse.attribution_token][google.cloud.discoveryengine.v1beta.SearchResponse.attribution_token] for events that are the result of [SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] as a URL parameter to product K's page. When recording events on product K's page, log the [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] to this field.
string attribution_token = 8;getAttributionTokenBytes in interface UserEventOrBuilderpublic String getFilter()
The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated [SearchRequest][google.cloud.discoveryengine.v1beta.SearchRequest] may contain a filter expression in [SearchRequest.filter][google.cloud.discoveryengine.v1beta.SearchRequest.filter] conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a [RecommendationService.RecommendRequest][], this field may be populated directly from [RecommendationService.RecommendRequest.filter][] conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
string filter = 9;getFilter in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getFilterBytes()
The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated [SearchRequest][google.cloud.discoveryengine.v1beta.SearchRequest] may contain a filter expression in [SearchRequest.filter][google.cloud.discoveryengine.v1beta.SearchRequest.filter] conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a [RecommendationService.RecommendRequest][], this field may be populated directly from [RecommendationService.RecommendRequest.filter][] conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
string filter = 9;getFilterBytes in interface UserEventOrBuilderpublic List<DocumentInfo> getDocumentsList()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different [UserEvent.documents][google.cloud.discoveryengine.v1beta.UserEvent.documents] is desired.
repeated .google.cloud.discoveryengine.v1beta.DocumentInfo documents = 10;getDocumentsList in interface UserEventOrBuilderpublic List<? extends DocumentInfoOrBuilder> getDocumentsOrBuilderList()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different [UserEvent.documents][google.cloud.discoveryengine.v1beta.UserEvent.documents] is desired.
repeated .google.cloud.discoveryengine.v1beta.DocumentInfo documents = 10;getDocumentsOrBuilderList in interface UserEventOrBuilderpublic int getDocumentsCount()
List of [Document][google.cloud.discoveryengine.v1beta.Document]s associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different [UserEvent.documents][google.cloud.discoveryengine.v1beta.UserEvent.documents] is desired.
repeated .google.cloud.discoveryengine.v1beta.DocumentInfo documents = 10;getDocumentsCount in interface UserEventOrBuilderpublic DocumentInfo getDocuments(int index)
List of [Document][google.cloud.discoveryengine.v1beta.Document]s associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different [UserEvent.documents][google.cloud.discoveryengine.v1beta.UserEvent.documents] is desired.
repeated .google.cloud.discoveryengine.v1beta.DocumentInfo documents = 10;getDocuments in interface UserEventOrBuilderpublic DocumentInfoOrBuilder getDocumentsOrBuilder(int index)
List of [Document][google.cloud.discoveryengine.v1beta.Document]s associated with this user event. This field is optional except for the following event types: * `view-item` * `add-to-cart` * `purchase` * `media-play` * `media-complete` In a `search` event, this field represents the documents returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different [UserEvent.documents][google.cloud.discoveryengine.v1beta.UserEvent.documents] is desired.
repeated .google.cloud.discoveryengine.v1beta.DocumentInfo documents = 10;getDocumentsOrBuilder in interface UserEventOrBuilderpublic boolean hasPanel()
Panel metadata associated with this user event.
.google.cloud.discoveryengine.v1beta.PanelInfo panel = 11;hasPanel in interface UserEventOrBuilderpublic PanelInfo getPanel()
Panel metadata associated with this user event.
.google.cloud.discoveryengine.v1beta.PanelInfo panel = 11;getPanel in interface UserEventOrBuilderpublic PanelInfoOrBuilder getPanelOrBuilder()
Panel metadata associated with this user event.
.google.cloud.discoveryengine.v1beta.PanelInfo panel = 11;getPanelOrBuilder in interface UserEventOrBuilderpublic boolean hasSearchInfo()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search] details related to the event. This field should be set for `search` event.
.google.cloud.discoveryengine.v1beta.SearchInfo search_info = 12;hasSearchInfo in interface UserEventOrBuilderpublic SearchInfo getSearchInfo()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search] details related to the event. This field should be set for `search` event.
.google.cloud.discoveryengine.v1beta.SearchInfo search_info = 12;getSearchInfo in interface UserEventOrBuilderpublic SearchInfoOrBuilder getSearchInfoOrBuilder()
[SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search] details related to the event. This field should be set for `search` event.
.google.cloud.discoveryengine.v1beta.SearchInfo search_info = 12;getSearchInfoOrBuilder in interface UserEventOrBuilderpublic boolean hasCompletionInfo()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery] details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search.
.google.cloud.discoveryengine.v1beta.CompletionInfo completion_info = 13;hasCompletionInfo in interface UserEventOrBuilderpublic CompletionInfo getCompletionInfo()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery] details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search.
.google.cloud.discoveryengine.v1beta.CompletionInfo completion_info = 13;getCompletionInfo in interface UserEventOrBuilderpublic CompletionInfoOrBuilder getCompletionInfoOrBuilder()
[CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery] details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search.
.google.cloud.discoveryengine.v1beta.CompletionInfo completion_info = 13;getCompletionInfoOrBuilder in interface UserEventOrBuilderpublic boolean hasTransactionInfo()
The transaction metadata (if any) associated with this user event.
.google.cloud.discoveryengine.v1beta.TransactionInfo transaction_info = 14;hasTransactionInfo in interface UserEventOrBuilderpublic TransactionInfo getTransactionInfo()
The transaction metadata (if any) associated with this user event.
.google.cloud.discoveryengine.v1beta.TransactionInfo transaction_info = 14;getTransactionInfo in interface UserEventOrBuilderpublic TransactionInfoOrBuilder getTransactionInfoOrBuilder()
The transaction metadata (if any) associated with this user event.
.google.cloud.discoveryengine.v1beta.TransactionInfo transaction_info = 14;getTransactionInfoOrBuilder in interface UserEventOrBuilderpublic com.google.protobuf.ProtocolStringList getTagIdsList()
A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups on the customer end.
repeated string tag_ids = 15;getTagIdsList in interface UserEventOrBuilderpublic int getTagIdsCount()
A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups on the customer end.
repeated string tag_ids = 15;getTagIdsCount in interface UserEventOrBuilderpublic String getTagIds(int index)
A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups on the customer end.
repeated string tag_ids = 15;getTagIds in interface UserEventOrBuilderindex - The index of the element to return.public com.google.protobuf.ByteString getTagIdsBytes(int index)
A list of identifiers for the independent experiment groups this user event belongs to. This is used to distinguish between user events associated with different experiment setups on the customer end.
repeated string tag_ids = 15;getTagIdsBytes in interface UserEventOrBuilderindex - The index of the value to return.public com.google.protobuf.ProtocolStringList getPromotionIdsList()
The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.
repeated string promotion_ids = 16;getPromotionIdsList in interface UserEventOrBuilderpublic int getPromotionIdsCount()
The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.
repeated string promotion_ids = 16;getPromotionIdsCount in interface UserEventOrBuilderpublic String getPromotionIds(int index)
The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.
repeated string promotion_ids = 16;getPromotionIds in interface UserEventOrBuilderindex - The index of the element to return.public com.google.protobuf.ByteString getPromotionIdsBytes(int index)
The promotion IDs if this is an event associated with promotions. Currently, this field is restricted to at most one ID.
repeated string promotion_ids = 16;getPromotionIdsBytes in interface UserEventOrBuilderindex - The index of the value to return.public int getAttributesCount()
UserEventOrBuilderExtra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
map<string, .google.cloud.discoveryengine.v1beta.CustomAttribute> attributes = 17;
getAttributesCount in interface UserEventOrBuilderpublic boolean containsAttributes(String key)
Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
map<string, .google.cloud.discoveryengine.v1beta.CustomAttribute> attributes = 17;
containsAttributes in interface UserEventOrBuilder@Deprecated public Map<String,CustomAttribute> getAttributes()
getAttributesMap() instead.getAttributes in interface UserEventOrBuilderpublic Map<String,CustomAttribute> getAttributesMap()
Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
map<string, .google.cloud.discoveryengine.v1beta.CustomAttribute> attributes = 17;
getAttributesMap in interface UserEventOrBuilderpublic CustomAttribute getAttributesOrDefault(String key, CustomAttribute defaultValue)
Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
map<string, .google.cloud.discoveryengine.v1beta.CustomAttribute> attributes = 17;
getAttributesOrDefault in interface UserEventOrBuilderpublic CustomAttribute getAttributesOrThrow(String key)
Extra user event features to include in the recommendation model. These attributes must NOT contain data that needs to be parsed or processed further, e.g. JSON or other encodings. If you provide custom attributes for ingested user events, also include them in the user events that you associate with prediction requests. Custom attribute formatting must be consistent between imported events and events provided with prediction requests. This lets the Discovery Engine API use those custom attributes when training models and serving predictions, which helps improve recommendation quality. This field needs to pass all below criteria, otherwise an `INVALID_ARGUMENT` error is returned: * The key must be a UTF-8 encoded string with a length limit of 5,000 characters. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed. For product recommendations, an example of extra user information is `traffic_channel`, which is how a user arrives at the site. Users can arrive at the site by coming to the site directly, coming through Google search, or in other ways.
map<string, .google.cloud.discoveryengine.v1beta.CustomAttribute> attributes = 17;
getAttributesOrThrow in interface UserEventOrBuilderpublic boolean hasMediaInfo()
Media-specific info.
.google.cloud.discoveryengine.v1beta.MediaInfo media_info = 18;hasMediaInfo in interface UserEventOrBuilderpublic MediaInfo getMediaInfo()
Media-specific info.
.google.cloud.discoveryengine.v1beta.MediaInfo media_info = 18;getMediaInfo in interface UserEventOrBuilderpublic MediaInfoOrBuilder getMediaInfoOrBuilder()
Media-specific info.
.google.cloud.discoveryengine.v1beta.MediaInfo media_info = 18;getMediaInfoOrBuilder in interface UserEventOrBuilderpublic final boolean isInitialized()
isInitialized in interface com.google.protobuf.MessageLiteOrBuilderisInitialized in class com.google.protobuf.GeneratedMessageV3public void writeTo(com.google.protobuf.CodedOutputStream output)
throws IOException
writeTo in interface com.google.protobuf.MessageLitewriteTo in class com.google.protobuf.GeneratedMessageV3IOExceptionpublic int getSerializedSize()
getSerializedSize in interface com.google.protobuf.MessageLitegetSerializedSize in class com.google.protobuf.GeneratedMessageV3public boolean equals(Object obj)
equals in interface com.google.protobuf.Messageequals in class com.google.protobuf.AbstractMessagepublic int hashCode()
hashCode in interface com.google.protobuf.MessagehashCode in class com.google.protobuf.AbstractMessagepublic static UserEvent parseFrom(ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(com.google.protobuf.ByteString data) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(byte[] data) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
com.google.protobuf.InvalidProtocolBufferExceptionpublic static UserEvent parseFrom(InputStream input) throws IOException
IOExceptionpublic static UserEvent parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
IOExceptionpublic static UserEvent parseDelimitedFrom(InputStream input) throws IOException
IOExceptionpublic static UserEvent parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
IOExceptionpublic static UserEvent parseFrom(com.google.protobuf.CodedInputStream input) throws IOException
IOExceptionpublic static UserEvent parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
IOExceptionpublic UserEvent.Builder newBuilderForType()
newBuilderForType in interface com.google.protobuf.MessagenewBuilderForType in interface com.google.protobuf.MessageLitepublic static UserEvent.Builder newBuilder()
public static UserEvent.Builder newBuilder(UserEvent prototype)
public UserEvent.Builder toBuilder()
toBuilder in interface com.google.protobuf.MessagetoBuilder in interface com.google.protobuf.MessageLiteprotected UserEvent.Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
newBuilderForType in class com.google.protobuf.GeneratedMessageV3public static UserEvent getDefaultInstance()
public static com.google.protobuf.Parser<UserEvent> parser()
public com.google.protobuf.Parser<UserEvent> getParserForType()
getParserForType in interface com.google.protobuf.MessagegetParserForType in interface com.google.protobuf.MessageLitegetParserForType in class com.google.protobuf.GeneratedMessageV3public UserEvent getDefaultInstanceForType()
getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuildergetDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilderCopyright © 2024 Google LLC. All rights reserved.