Google Cloud Recommendation Engine V1beta1 Client - Class ProductEventDetail (0.4.12)

Reference documentation and code samples for the Google Cloud Recommendation Engine V1beta1 Client class ProductEventDetail.

ProductEventDetail captures user event information specific to retail products.

Generated from protobuf message google.cloud.recommendationengine.v1beta1.ProductEventDetail

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ search_query string

Required for search events. Other event types should not set this field. The user's search query as UTF-8 encoded text with a length limit of 5 KiB.

↳ page_categories array<Google\Cloud\RecommendationEngine\V1beta1\CatalogItem\CategoryHierarchy>

Required for category-page-view events. Other event types should not set this field. The categories associated with a category page. Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: categories : ["Sales", "2017 Black Friday Deals"].

↳ product_details array<Google\Cloud\RecommendationEngine\V1beta1\ProductDetail>

The main product details related to the event. This field is required for the following event types: * add-to-cart * add-to-list * checkout-start * detail-page-view * purchase-complete * refund * remove-from-cart * remove-from-list This field is optional for the following event types: * page-visit * shopping-cart-page-view - note that 'product_details' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types: * category-page-view * home-page-view * search

↳ list_id string

Required for add-to-list and remove-from-list events. The id or name of the list that the item is being added to or removed from. Other event types should not set this field.

↳ cart_id string

Optional. 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, remove-from-cart, checkout-start, purchase-complete, or shopping-cart-page-view events.

↳ purchase_transaction Google\Cloud\RecommendationEngine\V1beta1\PurchaseTransaction

Optional. A transaction represents the entire purchase transaction. Required for purchase-complete events. Optional for checkout-start events. Other event types should not set this field.

getSearchQuery

Required for search events. Other event types should not set this field.

The user's search query as UTF-8 encoded text with a length limit of 5 KiB.

Returns
TypeDescription
string

setSearchQuery

Required for search events. Other event types should not set this field.

The user's search query as UTF-8 encoded text with a length limit of 5 KiB.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getPageCategories

Required for category-page-view events. Other event types should not set this field.

The categories associated with a category page. Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: categories : ["Sales", "2017 Black Friday Deals"].

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setPageCategories

Required for category-page-view events. Other event types should not set this field.

The categories associated with a category page. Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: categories : ["Sales", "2017 Black Friday Deals"].

Parameter
NameDescription
var array<Google\Cloud\RecommendationEngine\V1beta1\CatalogItem\CategoryHierarchy>
Returns
TypeDescription
$this

getProductDetails

The main product details related to the event.

This field is required for the following event types:

  • add-to-cart
  • add-to-list
  • checkout-start
  • detail-page-view
  • purchase-complete
  • refund
  • remove-from-cart
  • remove-from-list This field is optional for the following event types:
  • page-visit
  • shopping-cart-page-view - note that 'product_details' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types:
  • category-page-view
  • home-page-view
  • search
Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setProductDetails

The main product details related to the event.

This field is required for the following event types:

  • add-to-cart
  • add-to-list
  • checkout-start
  • detail-page-view
  • purchase-complete
  • refund
  • remove-from-cart
  • remove-from-list This field is optional for the following event types:
  • page-visit
  • shopping-cart-page-view - note that 'product_details' should be set for this unless the shopping cart is empty. This field is not allowed for the following event types:
  • category-page-view
  • home-page-view
  • search
Parameter
NameDescription
var array<Google\Cloud\RecommendationEngine\V1beta1\ProductDetail>
Returns
TypeDescription
$this

getListId

Required for add-to-list and remove-from-list events. The id or name of the list that the item is being added to or removed from. Other event types should not set this field.

Returns
TypeDescription
string

setListId

Required for add-to-list and remove-from-list events. The id or name of the list that the item is being added to or removed from. Other event types should not set this field.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCartId

Optional. 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, remove-from-cart, checkout-start, purchase-complete, or shopping-cart-page-view events.

Returns
TypeDescription
string

setCartId

Optional. 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, remove-from-cart, checkout-start, purchase-complete, or shopping-cart-page-view events.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getPurchaseTransaction

Optional. A transaction represents the entire purchase transaction.

Required for purchase-complete events. Optional for checkout-start events. Other event types should not set this field.

Returns
TypeDescription
Google\Cloud\RecommendationEngine\V1beta1\PurchaseTransaction|null

hasPurchaseTransaction

clearPurchaseTransaction

setPurchaseTransaction

Optional. A transaction represents the entire purchase transaction.

Required for purchase-complete events. Optional for checkout-start events. Other event types should not set this field.

Parameter
NameDescription
var Google\Cloud\RecommendationEngine\V1beta1\PurchaseTransaction
Returns
TypeDescription
$this