E-commerce

Event Parameters

• COMPLETEPURCHASE

  This event is reported after a user completes payment. It can be used to analyze the products or content that users are more interested in, which helps you optimize operations strategies.

  

  For payments completed through IAP, the COMPLETEPURCHASE event does not need to be reported.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	ID of the product added to the shopping cart.
  PRODUCTNAME	Product name	String	Yes	Name of the product added to the shopping cart.
  QUANTITY	Purchase quantity	Long	Yes	Number of units of a product that a user wants to purchase.
  CURRNAME	Currency type	String	No	Revenue currency type. This parameter must be used with REVENUE.
  REVENUE	Revenue	Double	No	Revenue from the transaction. This parameter must be used with CURRNAME.
  TAXFEE	Tax	Double	No	Tax generated for the transaction.
  SHIPPING	Shipping fee	Double	No	Shipping fee generated for the transaction.
  VOUCHER	Voucher	String	No	Voucher used in the transaction.
  BRAND	Product brand	String	No	Product brand.
  CATEGORY	Product category	String	Yes	Product category.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.

• CREATEPAYMENTINFO

  This event is reported when a user has added payment information but has not initiated payment during check-out.

  Parameter ID	Name	Type	Mandatory	Description
  PAYTYPE	Payment method	String	Yes	Payment method selected by a user.

• VIEWPRODUCT

  This event is reported when a user views a product. It can be used to analyze the products that users are interested in, or used with other events for funnel analysis.

  Parameter ID	Name	Type	Mandatory	Description
  CURRNAME	Currency type	String	No	Revenue currency type. This parameter must be used with REVENUE.
  REVENUE	Revenue	Double	No	Your expected revenue after a user purchases the product. This parameter must be used with CURRNAME.
  SEARCHKEYWORDS	Search keyword	String	No	Keyword for search.
  VOUCHERS	Voucher names	String	No	Names of vouchers applicable to a product.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.
  PRODUCTID	Product ID	String	Yes	ID of the product viewed by a user.
  PRODUCTNAME	Product name	String	Yes	Name of the product viewed by a user.
  PRODUCTFEATURE	Product features	String	No	Features of the product viewed by a user.
  CATEGORY	Product category	String	Yes	Category of the product viewed by a user.
  BRAND	Product brand	String	No	Brand of the product viewed by a user.

• ADDPRODUCT2CART

  This event is reported when a user adds a product to the shopping cart.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	ID of the product added to the shopping cart.
  PRODUCTNAME	Product name	String	Yes	Name of the product added to the shopping cart.
  PRODUCTFEATURE	Product features	String	No	Features of the product added to the shopping cart.
  BRAND	Product brand	String	No	Brand of the product added to the shopping cart.
  CATEGORY	Product category	String	No	Category of the product added to the shopping cart.
  STORENAME	Store name	String	No	Store of the product added to the shopping cart.
  PRICE	Purchase price	Double	No	Product price.
  REVENUE	Expected revenue	Double	No	Your expected revenue after a user purchases the product. This parameter must be used with CURRNAME.
  CURRNAME	Currency type	String	No	Revenue currency type. This parameter must be used with REVENUE.

• ADDPRODUCT2WISHLIST

  This event is reported when a user adds a product to favorites.

  It can be used to analyze products that users are interested in, helping you promote the products to the users.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	ID of the product added to favorites.
  PRODUCTNAME	Product name	String	Yes	Name of the product added to favorites.
  PRODUCTFEATURE	Product features	String	No	Features of the product added to favorites.
  BRAND	Product brand	String	No	Brand of the product added to favorites.
  CATEGORY	Product category	String	No	Category of the product added to favorites.
  STORENAME	Store name	String	No	Store of the product added to favorites.
  PRICE	Purchase price	Double	No	Product price.
  REVENUE	Expected revenue	Double	No	Your expected revenue after a user purchases the product. This parameter must be used with CURRNAME.
  CURRNAME	Currency type	String	No	Revenue currency type. This parameter must be used with REVENUE.
  CONTENTTYPE	Content type	String	Yes	Type of the content added by a user to favorites, for example, articles, queries, rankings, and products.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENTNAME	Name	String	Yes	Name of the content added by a user to favorites.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.

• CREATEORDER

  This event is reported when a user creates an order.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	Product ID.
  PRODUCTNAME	Product name	String	Yes	Product name.
  PRODUCTFEATURE	Product features	String	No	Product features.
  BRAND	Product brand	String	No	Product brand.
  CATEGORY	Product category	String	No	Product category.
  STORENAME	Store name	String	No	Store that a product belongs to.
  QUANTITY	Purchase quantity	Long	No	Number of units of a product purchased by a user.
  PRICE	Product price	Double	No	Product price.
  REVENUE	Revenue	Double	No	Revenue you will get from the transaction.
  CURRNAME	Currency type	String	No	Revenue currency type.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.

• CANCELORDER

  This event is reported when a user cancels an order.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	Product ID.
  PRODUCTNAME	Product name	String	Yes	Product name.
  PRODUCTFEATURE	Product features	String	No	Product features.
  BRAND	Product brand	String	No	Product brand.
  CATEGORY	Product category	String	No	Product category.
  STORENAME	Store name	String	No	Store that a product belongs to.
  QUANTITY	Purchase quantity	Long	No	Number of units of a product purchased by a user.
  PRICE	Product price	Double	No	Product price.
  REVENUE	Revenue	Double	No	Revenue you will get from the transaction.
  CURRNAME	Currency type	String	No	Revenue currency type.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.
  REASON	Cancellation reason	String	Yes	Reason for canceling an order.

• REFUNDORDER

  This event is reported when a user cancels an order and applies for a refund. It can be used to help you analyze the loss caused by the refund and formulate targeted optimization strategies.

  Parameter ID	Name	Type	Mandatory	Description
  CURRNAME	Currency type	String	No	Refund currency type.
  REVENUE	Refund amount	Double	No	Your revenue loss due to the refund.
  PRODUCTID	Product ID	String	Yes	ID of a refunded product.
  PRODUCTNAME	Product name	String	Yes	Name of a refunded product.
  QUANTITY	Purchase quantity	Long	Yes	Number of units of a product that a user wants to purchase.
  BRAND	Product brand	String	No	Product brand.
  CATEGORY	Product category	String	Yes	Product category.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.
  MEDIUM	Marketing type	String	No	Type of a marketing activity, for example, CPC, email, operations slot, or banner.
  PROMOTIONNAME	Marketing name	String	No	Name of a marketing activity.
  CONTENT	Marketing content	String	No	Content of a marketing activity.
  KEYWORDS	Keywords	String	No	Keywords of a marketing activity, for example, keywords for search advertising.
  MATERIALNAME	Creative name	String	No	Name of the creative material used in a marketing activity.
  MATERIALSLOT	Material display slot	String	No	Slot where a creative material is displayed.
  REASON	Refund reason	String	Yes	Reason for applying for a refund.

• SEARCH

  This event is reported when a user searches for content in an app.

  Parameter ID	Name	Type	Mandatory	Description
  SEARCHKEYWORDS	Search keyword	String	Yes	Keyword for search.
  SOURCE	Marketing source	String	No	ID of a marketing activity provider, for example, HUAWEI PPS.

• EXCHANGEGOODS

  This event is reported when a user applies to replace a product.

  Parameter ID	Name	Type	Mandatory	Description
  PRODUCTID	Product ID	String	Yes	ID of the returned product.
  PRODUCTNAME	Product name	String	Yes	Name of the returned product.
  REASON	Replacement reason	String	Yes	Product replacement reason.
  PRODUCTFEATURE	Product features	String	No	Features of the replaced product.
  BRAND	Product brand	String	No	Brand of the replaced product.
  CATEGORY	Product category	String	No	Category the replaced product.

• VIEWPRODUCTLIST

  This event is reported when a user views a list of products, for example, by category. It can be used to analyze the types of contents that users are more interested in.

  Parameter ID	Name	Type	Mandatory	Description
  CATEGORY	Product category	String	No	Category by which a user views the product list.