Reference documentation and code samples for the Google Cloud Recommendation Engine V1beta1 Client class UserEvent.
UserEvent captures all metadata information recommendation engine needs to know about how end users interact with customers' website.
Generated from protobuf message google.cloud.recommendationengine.v1beta1.UserEvent
Namespace
Google \ Cloud \ RecommendationEngine \ V1beta1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ event_type
string
Required. User event type. Allowed values are: * * add-to-cart
Products being added to cart. * * add-to-list
Items being added to a list (shopping list, favorites etc). * * category-page-view
Special pages such as sale or promotion pages viewed. * * checkout-start
User starting a checkout process. * * detail-page-view
Products detail page viewed. * * home-page-view
Homepage viewed. * * page-visit
Generic page visits not included in the event types above. * * purchase-complete
User finishing a purchase. * * refund
Purchased items being refunded or returned. * * remove-from-cart
Products being removed from cart. * * remove-from-list
Items being removed from a list. * * search
Product search. * * shopping-cart-page-view
User viewing a shopping cart. * * impression
List of items displayed. Used by Google Tag Manager.
↳ user_info
↳ event_detail
↳ product_event_detail
ProductEventDetail
Optional. Retail product specific user event metadata. This field is required for the following event types: * * add-to-cart
* * add-to-list
* * category-page-view
* * checkout-start
* * detail-page-view
* * purchase-complete
* * refund
* * remove-from-cart
* * remove-from-list
* * search
This field is optional for the following event types: * * page-visit
* * shopping-cart-page-view
- note that 'product_event_detail' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types: * * home-page-view
↳ event_time
Google\Protobuf\Timestamp
Optional. Only required for ImportUserEvents method. Timestamp of user event created.
↳ event_source
int
Optional. This field should not
be set when using JavaScript pixel or the Recommendations AI Tag. Defaults to EVENT_SOURCE_UNSPECIFIED
.
getEventType
Required. User event type. Allowed values are:
-
add-to-cart
Products being added to cart. -
add-to-list
Items being added to a list (shopping list, favorites etc). -
category-page-view
Special pages such as sale or promotion pages viewed. -
checkout-start
User starting a checkout process. -
detail-page-view
Products detail page viewed. -
home-page-view
Homepage viewed. -
page-visit
Generic page visits not included in the event types above. -
purchase-complete
User finishing a purchase. -
refund
Purchased items being refunded or returned. -
remove-from-cart
Products being removed from cart. -
remove-from-list
Items being removed from a list. -
search
Product search. -
shopping-cart-page-view
User viewing a shopping cart. -
impression
List of items displayed. Used by Google Tag Manager.
string
setEventType
Required. User event type. Allowed values are:
-
add-to-cart
Products being added to cart. -
add-to-list
Items being added to a list (shopping list, favorites etc). -
category-page-view
Special pages such as sale or promotion pages viewed. -
checkout-start
User starting a checkout process. -
detail-page-view
Products detail page viewed. -
home-page-view
Homepage viewed. -
page-visit
Generic page visits not included in the event types above. -
purchase-complete
User finishing a purchase. -
refund
Purchased items being refunded or returned. -
remove-from-cart
Products being removed from cart. -
remove-from-list
Items being removed from a list. -
search
Product search. -
shopping-cart-page-view
User viewing a shopping cart. -
impression
List of items displayed. Used by Google Tag Manager.
var
string
$this
getUserInfo
Required. User information.
hasUserInfo
clearUserInfo
setUserInfo
Required. User information.
$this
getEventDetail
Optional. User event detailed information common across different recommendation types.
hasEventDetail
clearEventDetail
setEventDetail
Optional. User event detailed information common across different recommendation types.
$this
getProductEventDetail
Optional. Retail product specific user event metadata.
This field is required for the following event types:
-
add-to-cart
-
add-to-list
-
category-page-view
-
checkout-start
-
detail-page-view
-
purchase-complete
-
refund
-
remove-from-cart
-
remove-from-list
-
search
This field is optional for the following event types: -
page-visit
-
shopping-cart-page-view
- note that 'product_event_detail' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types: -
home-page-view
hasProductEventDetail
clearProductEventDetail
setProductEventDetail
Optional. Retail product specific user event metadata.
This field is required for the following event types:
-
add-to-cart
-
add-to-list
-
category-page-view
-
checkout-start
-
detail-page-view
-
purchase-complete
-
refund
-
remove-from-cart
-
remove-from-list
-
search
This field is optional for the following event types: -
page-visit
-
shopping-cart-page-view
- note that 'product_event_detail' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types: -
home-page-view
$this
getEventTime
Optional. Only required for ImportUserEvents method. Timestamp of user event created.
hasEventTime
clearEventTime
setEventTime
Optional. Only required for ImportUserEvents method. Timestamp of user event created.
$this
getEventSource
Optional. This field should not
be set when using JavaScript pixel
or the Recommendations AI Tag. Defaults to EVENT_SOURCE_UNSPECIFIED
.
int
setEventSource
Optional. This field should not
be set when using JavaScript pixel
or the Recommendations AI Tag. Defaults to EVENT_SOURCE_UNSPECIFIED
.
var
int
$this