public final class UserEvent extends com.google.protobuf.GeneratedMessageV3 implements UserEventOrBuilder
UserEvent captures all metadata information Retail API needs to know about how end users interact with customers' website.Protobuf type
google.cloud.retail.v2beta.UserEvent| Modifier and Type | Class and Description |
|---|---|
static class |
UserEvent.Builder
UserEvent captures all metadata information Retail 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 |
CART_ID_FIELD_NUMBER |
static int |
COMPLETION_DETAIL_FIELD_NUMBER |
static int |
ENTITY_FIELD_NUMBER |
static int |
EVENT_TIME_FIELD_NUMBER |
static int |
EVENT_TYPE_FIELD_NUMBER |
static int |
EXPERIMENT_IDS_FIELD_NUMBER |
static int |
FILTER_FIELD_NUMBER |
static int |
OFFSET_FIELD_NUMBER |
static int |
ORDER_BY_FIELD_NUMBER |
static int |
PAGE_CATEGORIES_FIELD_NUMBER |
static int |
PAGE_VIEW_ID_FIELD_NUMBER |
static int |
PRODUCT_DETAILS_FIELD_NUMBER |
static int |
PURCHASE_TRANSACTION_FIELD_NUMBER |
static int |
REFERRER_URI_FIELD_NUMBER |
static int |
SEARCH_QUERY_FIELD_NUMBER |
static int |
SESSION_ID_FIELD_NUMBER |
static int |
URI_FIELD_NUMBER |
static int |
USER_INFO_FIELD_NUMBER |
static int |
VISITOR_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()
Highly recommended for user events that are the result of
[PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict].
|
com.google.protobuf.ByteString |
getAttributionTokenBytes()
Highly recommended for user events that are the result of
[PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict].
|
String |
getCartId()
The ID or name of the associated shopping cart.
|
com.google.protobuf.ByteString |
getCartIdBytes()
The ID or name of the associated shopping cart.
|
CompletionDetail |
getCompletionDetail()
The main auto-completion details related to the event.
|
CompletionDetailOrBuilder |
getCompletionDetailOrBuilder()
The main auto-completion details related to the event.
|
static UserEvent |
getDefaultInstance() |
UserEvent |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
String |
getEntity()
The entity for customers that may run multiple different entities, domains,
sites or regions, for example, `Google US`, `Google Ads`, `Waymo`,
`google.com`, `youtube.com`, etc.
|
com.google.protobuf.ByteString |
getEntityBytes()
The entity for customers that may run multiple different entities, domains,
sites or regions, for example, `Google US`, `Google Ads`, `Waymo`,
`google.com`, `youtube.com`, etc.
|
com.google.protobuf.Timestamp |
getEventTime()
Only required for
[UserEventService.ImportUserEvents][google.cloud.retail.v2beta.UserEventService.ImportUserEvents]
method.
|
com.google.protobuf.TimestampOrBuilder |
getEventTimeOrBuilder()
Only required for
[UserEventService.ImportUserEvents][google.cloud.retail.v2beta.UserEventService.ImportUserEvents]
method.
|
String |
getEventType()
Required.
|
com.google.protobuf.ByteString |
getEventTypeBytes()
Required.
|
String |
getExperimentIds(int index)
A list of identifiers for the independent experiment groups this user event
belongs to.
|
com.google.protobuf.ByteString |
getExperimentIdsBytes(int index)
A list of identifiers for the independent experiment groups this user event
belongs to.
|
int |
getExperimentIdsCount()
A list of identifiers for the independent experiment groups this user event
belongs to.
|
com.google.protobuf.ProtocolStringList |
getExperimentIdsList()
A list of identifiers for the independent experiment groups this user event
belongs to.
|
String |
getFilter()
The filter syntax consists of an expression language for constructing a
predicate from one or more fields of the products 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 products being filtered.
|
int |
getOffset()
An integer that specifies the current offset for pagination (the 0-indexed
starting location, amongst the products deemed by the API as relevant).
|
String |
getOrderBy()
The order in which products are returned.
|
com.google.protobuf.ByteString |
getOrderByBytes()
The order in which products are returned.
|
String |
getPageCategories(int index)
The categories associated with a category page.
|
com.google.protobuf.ByteString |
getPageCategoriesBytes(int index)
The categories associated with a category page.
|
int |
getPageCategoriesCount()
The categories associated with a category page.
|
com.google.protobuf.ProtocolStringList |
getPageCategoriesList()
The categories associated with a category page.
|
String |
getPageViewId()
A unique ID of a web page view.
|
com.google.protobuf.ByteString |
getPageViewIdBytes()
A unique ID of a web page view.
|
com.google.protobuf.Parser<UserEvent> |
getParserForType() |
ProductDetail |
getProductDetails(int index)
The main product details related to the event.
|
int |
getProductDetailsCount()
The main product details related to the event.
|
List<ProductDetail> |
getProductDetailsList()
The main product details related to the event.
|
ProductDetailOrBuilder |
getProductDetailsOrBuilder(int index)
The main product details related to the event.
|
List<? extends ProductDetailOrBuilder> |
getProductDetailsOrBuilderList()
The main product details related to the event.
|
PurchaseTransaction |
getPurchaseTransaction()
A transaction represents the entire purchase transaction.
|
PurchaseTransactionOrBuilder |
getPurchaseTransactionOrBuilder()
A transaction represents the entire purchase transaction.
|
String |
getReferrerUri()
The referrer URL of the current page.
|
com.google.protobuf.ByteString |
getReferrerUriBytes()
The referrer URL of the current page.
|
String |
getSearchQuery()
The user's search query.
|
com.google.protobuf.ByteString |
getSearchQueryBytes()
The user's search query.
|
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 |
getUri()
Complete URL (window.location.href) of the user's current page.
|
com.google.protobuf.ByteString |
getUriBytes()
Complete URL (window.location.href) of the user's current page.
|
UserInfo |
getUserInfo()
User information.
|
UserInfoOrBuilder |
getUserInfoOrBuilder()
User information.
|
String |
getVisitorId()
Required.
|
com.google.protobuf.ByteString |
getVisitorIdBytes()
Required.
|
boolean |
hasCompletionDetail()
The main auto-completion details related to the event.
|
boolean |
hasEventTime()
Only required for
[UserEventService.ImportUserEvents][google.cloud.retail.v2beta.UserEventService.ImportUserEvents]
method.
|
int |
hashCode() |
boolean |
hasPurchaseTransaction()
A transaction represents the entire purchase transaction.
|
boolean |
hasUserInfo()
User information.
|
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 VISITOR_ID_FIELD_NUMBER
public static final int SESSION_ID_FIELD_NUMBER
public static final int EVENT_TIME_FIELD_NUMBER
public static final int EXPERIMENT_IDS_FIELD_NUMBER
public static final int ATTRIBUTION_TOKEN_FIELD_NUMBER
public static final int PRODUCT_DETAILS_FIELD_NUMBER
public static final int COMPLETION_DETAIL_FIELD_NUMBER
public static final int ATTRIBUTES_FIELD_NUMBER
public static final int CART_ID_FIELD_NUMBER
public static final int PURCHASE_TRANSACTION_FIELD_NUMBER
public static final int SEARCH_QUERY_FIELD_NUMBER
public static final int FILTER_FIELD_NUMBER
public static final int ORDER_BY_FIELD_NUMBER
public static final int OFFSET_FIELD_NUMBER
public static final int PAGE_CATEGORIES_FIELD_NUMBER
public static final int USER_INFO_FIELD_NUMBER
public static final int URI_FIELD_NUMBER
public static final int REFERRER_URI_FIELD_NUMBER
public static final int PAGE_VIEW_ID_FIELD_NUMBER
public static final int ENTITY_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: * `add-to-cart`: Products being added to cart. * `category-page-view`: Special pages such as sale or promotion pages viewed. * `detail-page-view`: Products detail page viewed. * `home-page-view`: Homepage viewed. * `promotion-offered`: Promotion is offered to a user. * `promotion-not-offered`: Promotion is not offered to a user. * `purchase-complete`: User finishing a purchase. * `search`: Product search. * `shopping-cart-page-view`: User viewing a shopping cart.
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: * `add-to-cart`: Products being added to cart. * `category-page-view`: Special pages such as sale or promotion pages viewed. * `detail-page-view`: Products detail page viewed. * `home-page-view`: Homepage viewed. * `promotion-offered`: Promotion is offered to a user. * `promotion-not-offered`: Promotion is not offered to a user. * `purchase-complete`: User finishing a purchase. * `search`: Product search. * `shopping-cart-page-view`: User viewing a shopping cart.
string event_type = 1 [(.google.api.field_behavior) = REQUIRED];getEventTypeBytes in interface UserEventOrBuilderpublic String getVisitorId()
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. Don't 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 visitor_id = 2 [(.google.api.field_behavior) = REQUIRED];getVisitorId in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getVisitorIdBytes()
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. Don't 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 visitor_id = 2 [(.google.api.field_behavior) = REQUIRED];getVisitorIdBytes 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 sesion_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 visitor_id as prefix.
string session_id = 21;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 sesion_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 visitor_id as prefix.
string session_id = 21;getSessionIdBytes in interface UserEventOrBuilderpublic boolean hasEventTime()
Only required for [UserEventService.ImportUserEvents][google.cloud.retail.v2beta.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.retail.v2beta.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.retail.v2beta.UserEventService.ImportUserEvents] method. Timestamp of when the user event happened.
.google.protobuf.Timestamp event_time = 3;getEventTimeOrBuilder in interface UserEventOrBuilderpublic com.google.protobuf.ProtocolStringList getExperimentIdsList()
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 (e.g. using Retail API, using different recommendation models).
repeated string experiment_ids = 4;getExperimentIdsList in interface UserEventOrBuilderpublic int getExperimentIdsCount()
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 (e.g. using Retail API, using different recommendation models).
repeated string experiment_ids = 4;getExperimentIdsCount in interface UserEventOrBuilderpublic String getExperimentIds(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 (e.g. using Retail API, using different recommendation models).
repeated string experiment_ids = 4;getExperimentIds in interface UserEventOrBuilderindex - The index of the element to return.public com.google.protobuf.ByteString getExperimentIdsBytes(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 (e.g. using Retail API, using different recommendation models).
repeated string experiment_ids = 4;getExperimentIdsBytes in interface UserEventOrBuilderindex - The index of the value to return.public String getAttributionToken()
Highly recommended for user events that are the result of [PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict]. This field enables accurate attribution of recommendation model performance. The value must be a valid [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] for user events that are the result of [PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict]. The value must be a valid [SearchResponse.attribution_token][google.cloud.retail.v2beta.SearchResponse.attribution_token] for user events that are the result of [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]. This token enables us to accurately attribute page view or purchase 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 [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] as a URL parameter to product K's page. When recording events on product K's page, log the [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] to this field.
string attribution_token = 5;getAttributionToken in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getAttributionTokenBytes()
Highly recommended for user events that are the result of [PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict]. This field enables accurate attribution of recommendation model performance. The value must be a valid [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] for user events that are the result of [PredictionService.Predict][google.cloud.retail.v2beta.PredictionService.Predict]. The value must be a valid [SearchResponse.attribution_token][google.cloud.retail.v2beta.SearchResponse.attribution_token] for user events that are the result of [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]. This token enables us to accurately attribute page view or purchase 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 [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] as a URL parameter to product K's page. When recording events on product K's page, log the [PredictResponse.attribution_token][google.cloud.retail.v2beta.PredictResponse.attribution_token] to this field.
string attribution_token = 5;getAttributionTokenBytes in interface UserEventOrBuilderpublic List<ProductDetail> getProductDetailsList()
The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products 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 [product_details][google.cloud.retail.v2beta.UserEvent.product_details] is desired. The end user may have not finished browsing the whole page yet.
repeated .google.cloud.retail.v2beta.ProductDetail product_details = 6;getProductDetailsList in interface UserEventOrBuilderpublic List<? extends ProductDetailOrBuilder> getProductDetailsOrBuilderList()
The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products 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 [product_details][google.cloud.retail.v2beta.UserEvent.product_details] is desired. The end user may have not finished browsing the whole page yet.
repeated .google.cloud.retail.v2beta.ProductDetail product_details = 6;getProductDetailsOrBuilderList in interface UserEventOrBuilderpublic int getProductDetailsCount()
The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products 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 [product_details][google.cloud.retail.v2beta.UserEvent.product_details] is desired. The end user may have not finished browsing the whole page yet.
repeated .google.cloud.retail.v2beta.ProductDetail product_details = 6;getProductDetailsCount in interface UserEventOrBuilderpublic ProductDetail getProductDetails(int index)
The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products 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 [product_details][google.cloud.retail.v2beta.UserEvent.product_details] is desired. The end user may have not finished browsing the whole page yet.
repeated .google.cloud.retail.v2beta.ProductDetail product_details = 6;getProductDetails in interface UserEventOrBuilderpublic ProductDetailOrBuilder getProductDetailsOrBuilder(int index)
The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products 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 [product_details][google.cloud.retail.v2beta.UserEvent.product_details] is desired. The end user may have not finished browsing the whole page yet.
repeated .google.cloud.retail.v2beta.ProductDetail product_details = 6;getProductDetailsOrBuilder in interface UserEventOrBuilderpublic boolean hasCompletionDetail()
The main auto-completion 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.retail.v2beta.CompletionDetail completion_detail = 22;hasCompletionDetail in interface UserEventOrBuilderpublic CompletionDetail getCompletionDetail()
The main auto-completion 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.retail.v2beta.CompletionDetail completion_detail = 22;getCompletionDetail in interface UserEventOrBuilderpublic CompletionDetailOrBuilder getCompletionDetailOrBuilder()
The main auto-completion 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.retail.v2beta.CompletionDetail completion_detail = 22;getCompletionDetailOrBuilder in interface UserEventOrBuilderpublic int getAttributesCount()
UserEventOrBuilderExtra user event features to include in the recommendation model. 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 Retail 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.retail.v2beta.CustomAttribute> attributes = 7;getAttributesCount in interface UserEventOrBuilderpublic boolean containsAttributes(String key)
Extra user event features to include in the recommendation model. 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 Retail 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.retail.v2beta.CustomAttribute> attributes = 7;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. 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 Retail 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.retail.v2beta.CustomAttribute> attributes = 7;getAttributesMap in interface UserEventOrBuilderpublic CustomAttribute getAttributesOrDefault(String key, CustomAttribute defaultValue)
Extra user event features to include in the recommendation model. 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 Retail 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.retail.v2beta.CustomAttribute> attributes = 7;getAttributesOrDefault in interface UserEventOrBuilderpublic CustomAttribute getAttributesOrThrow(String key)
Extra user event features to include in the recommendation model. 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 Retail 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.retail.v2beta.CustomAttribute> attributes = 7;getAttributesOrThrow in interface UserEventOrBuilderpublic String getCartId()
The ID or name of the associated shopping cart. This ID is used to associate multiple items added or present in the cart before purchase. This can only be set for `add-to-cart`, `purchase-complete`, or `shopping-cart-page-view` events.
string cart_id = 8;getCartId in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getCartIdBytes()
The ID or name of the associated shopping cart. This ID is used to associate multiple items added or present in the cart before purchase. This can only be set for `add-to-cart`, `purchase-complete`, or `shopping-cart-page-view` events.
string cart_id = 8;getCartIdBytes in interface UserEventOrBuilderpublic boolean hasPurchaseTransaction()
A transaction represents the entire purchase transaction. Required for `purchase-complete` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
.google.cloud.retail.v2beta.PurchaseTransaction purchase_transaction = 9;hasPurchaseTransaction in interface UserEventOrBuilderpublic PurchaseTransaction getPurchaseTransaction()
A transaction represents the entire purchase transaction. Required for `purchase-complete` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
.google.cloud.retail.v2beta.PurchaseTransaction purchase_transaction = 9;getPurchaseTransaction in interface UserEventOrBuilderpublic PurchaseTransactionOrBuilder getPurchaseTransactionOrBuilder()
A transaction represents the entire purchase transaction. Required for `purchase-complete` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
.google.cloud.retail.v2beta.PurchaseTransaction purchase_transaction = 9;getPurchaseTransactionOrBuilder in interface UserEventOrBuilderpublic String getSearchQuery()
The user's search query. See [SearchRequest.query][google.cloud.retail.v2beta.SearchRequest.query] for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
string search_query = 10;getSearchQuery in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getSearchQueryBytes()
The user's search query. See [SearchRequest.query][google.cloud.retail.v2beta.SearchRequest.query] for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
string search_query = 10;getSearchQueryBytes in interface UserEventOrBuilderpublic String getFilter()
The filter syntax consists of an expression language for constructing a predicate from one or more fields of the products being filtered. See [SearchRequest.filter][google.cloud.retail.v2beta.SearchRequest.filter] for definition and syntax. 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 = 16;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 products being filtered. See [SearchRequest.filter][google.cloud.retail.v2beta.SearchRequest.filter] for definition and syntax. 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 = 16;getFilterBytes in interface UserEventOrBuilderpublic String getOrderBy()
The order in which products are returned. See [SearchRequest.order_by][google.cloud.retail.v2beta.SearchRequest.order_by] for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
string order_by = 17;getOrderBy in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getOrderByBytes()
The order in which products are returned. See [SearchRequest.order_by][google.cloud.retail.v2beta.SearchRequest.order_by] for definition and syntax. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
string order_by = 17;getOrderByBytes in interface UserEventOrBuilderpublic int getOffset()
An integer that specifies the current offset for pagination (the 0-indexed starting location, amongst the products deemed by the API as relevant). See [SearchRequest.offset][google.cloud.retail.v2beta.SearchRequest.offset] for definition. If this field is negative, an INVALID_ARGUMENT is returned. This can only be set for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
int32 offset = 18;getOffset in interface UserEventOrBuilderpublic com.google.protobuf.ProtocolStringList getPageCategoriesList()
The categories associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"]. Required for `category-page-view` events. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
repeated string page_categories = 11;getPageCategoriesList in interface UserEventOrBuilderpublic int getPageCategoriesCount()
The categories associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"]. Required for `category-page-view` events. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
repeated string page_categories = 11;getPageCategoriesCount in interface UserEventOrBuilderpublic String getPageCategories(int index)
The categories associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"]. Required for `category-page-view` events. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
repeated string page_categories = 11;getPageCategories in interface UserEventOrBuilderindex - The index of the element to return.public com.google.protobuf.ByteString getPageCategoriesBytes(int index)
The categories associated with a category page. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: "pageCategories" : ["Sales > 2017 Black Friday Deals"]. Required for `category-page-view` events. At least one of [search_query][google.cloud.retail.v2beta.UserEvent.search_query] or [page_categories][google.cloud.retail.v2beta.UserEvent.page_categories] is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.
repeated string page_categories = 11;getPageCategoriesBytes in interface UserEventOrBuilderindex - The index of the value to return.public boolean hasUserInfo()
User information.
.google.cloud.retail.v2beta.UserInfo user_info = 12;hasUserInfo in interface UserEventOrBuilderpublic UserInfo getUserInfo()
User information.
.google.cloud.retail.v2beta.UserInfo user_info = 12;getUserInfo in interface UserEventOrBuilderpublic UserInfoOrBuilder getUserInfoOrBuilder()
User information.
.google.cloud.retail.v2beta.UserInfo user_info = 12;getUserInfoOrBuilder in interface UserEventOrBuilderpublic String getUri()
Complete URL (window.location.href) of the user's current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically. Maximum length 5,000 characters.
string uri = 13;getUri in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getUriBytes()
Complete URL (window.location.href) of the user's current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically. Maximum length 5,000 characters.
string uri = 13;getUriBytes in interface UserEventOrBuilderpublic String getReferrerUri()
The referrer URL of the current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
string referrer_uri = 14;getReferrerUri in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getReferrerUriBytes()
The referrer URL of the current page. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
string referrer_uri = 14;getReferrerUriBytes in interface UserEventOrBuilderpublic String getPageViewId()
A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
string page_view_id = 15;getPageViewId in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getPageViewIdBytes()
A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
string page_view_id = 15;getPageViewIdBytes in interface UserEventOrBuilderpublic String getEntity()
The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is recommended to set this field to get better per-entity search, completion and prediction results.
string entity = 23;getEntity in interface UserEventOrBuilderpublic com.google.protobuf.ByteString getEntityBytes()
The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is recommended to set this field to get better per-entity search, completion and prediction results.
string entity = 23;getEntityBytes 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.