代码主要由参数及条件两部分组成,下面以“HUAWEI Analytics”为例对创建代码操作进行详细介绍:
操作类型 | 操作说明 |
|---|---|
添加事件 | 当满足条件的事件发生时,应用发送一个附加的指定事件至HUAWEI Analytics平台。支持配置附加事件ID,附加事件的事件参数默认继承自源事件,您也可以添加、修改、删除事件参数。 |
修改事件 | 当满足条件的事件发生时,将该事件ID修改为新的ID后发送至HUAWEI Analytics平台,您同样可以对事件参数进行添加、修改和删除。 |
阻塞事件 | 当满足条件的事件发生时,会阻止事件发送到HUAWEI Analytics平台,但是对于其他代码中的添加事件和修改事件则不受影响。 |

事件ID必须以字母或引用开头,且只能包含数字、字母和下划线。如果事件ID引用了变量,您需要确保被引用变量的取值满足事件ID约束条件,否则可能导致事件上报失败。





为上报数据至Firebase平台,您不仅需要集成DTM SDK,还需要集成Firebase-analytics SDK。详情请参见将Firebase添加到您的Android项目。
增加对GA模板增强型电子商务的支持,可以让您轻松、容易、简单地跟踪用户在其购物历程中与产品的互动,包括产品展示、产品点击、查看产品详情、将产品添加到购物车、开始结账流程、交易以及退款等。
当“新建代码”页面中配置的信息与代码中不一致时,DTM将以“新建代码”页面中配置的信息来处理。
事件名称 | HA键值 | 实际值 |
|---|---|---|
HAEventType.VIEWPRODUCTLIST | $ViewProductList | |
HAEventType.VIEWCONTENT | $ViewContent | |
HAEventType.VIEWPRODUCT | $ViewProduct | |
HAEventType.ADDPRODUCT2CART | $AddProduct2Cart | |
HAEventType.DELPRODUCTFROMCART | $DelProductFromCart | |
HAEventType.VIEWPRODUCT | $ViewProduct | |
HAEventType.VIEWCONTENT | $ViewContent | |
HAEventType.STARTCHECKOUT | $StartCheckout | |
HAEventType.VIEWCHECKOUTSTEP | $ViewCheckoutStep | |
HAEventType.UPDATECHECKOUTOPTION | $UpdateCheckoutOption | |
HAEventType.COMPLETEPURCHASE | $CompletePurchase | |
HAEventType.REFUNDORDER | $RefundOrder |
HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
POSITIONID | 产品位置 | pr<productIndex>ps | 1 |
PRODUCTLIST | 产品展示列表名称 | pal | Search Results |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.POSITIONID, 1);
Bundle product2 = new Bundle();
product2.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03QJ2J90");
product2.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product2.putString(HAParamType.CATEGORY, "Phone/Mate/Yellow");
product2.putString(HAParamType.PRODUCTFEATURE, "Yellow");
product2.putString(HAParamType.BRAND, "HUAWEI");
product2.putDouble(HAParamType.PRICE, 6999.00);
product2.putString(HAParamType.CURRNAME, "CNY");
product2.putLong(HAParamType.POSITIONID, 2);
ArrayList items = new ArrayList();
items.add(product1);
items.add(product2);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("items", items);
ecommerceBundle.putString(HAParamType.PRODUCTLIST, "Search Results");
hiAnalytics.onEvent(HAEventType.VIEWPRODUCTLIST, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
POSITIONID | 产品位置 | pr<productIndex>ps | 1 |
PRODUCTLIST | 产品展示列表名称 | pal | Search Results |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.POSITIONID, 1);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle("items", product1);
ecommerceBundle.putString(HAParamType.PRODUCTLIST, "Search Results");
hiAnalytics.onEvent(HAEventType.VIEWCONTENT, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle("items", product1);
hiAnalytics.onEvent(HAEventType.VIEWPRODUCT, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.QUANTITY, 1);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle("items", product1);
hiAnalytics.onEvent(HAEventType.ADDPRODUCT2CART, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.QUANTITY, 1);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putBundle("items", product1);
hiAnalytics.onEvent(HAEventType.DELPRODUCTFROMCART, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
CLICKID | 促销ID | promo<promoIndex>id | PROMO_NEW_PHONE_XXX |
PROMOTIONNAME | 促销名称 | promo<promoIndex>nm | New Phone Promotion |
MATERIALNAME | 促销广告素材 | promo<promoIndex>cr | new_phone_banner_x |
MATERIALSLOT | 促销位置 | promo<promoIndex>ps | banner_slot_x |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle promotion = new Bundle();
promotion.putString(HAParamType.TRANSACTIONID, "PROMO_NEW_PHONE_XXX");
promotion.putString(HAParamType.PROMOTIONNAME, "New Phone Promotion");
promotion.putString(HAParamType.MATERIALNAME, "new_phone_banner_x");
promotion.putString(HAParamType.MATERIALSLOT, "banner_slot_x");
ArrayList promotions = new ArrayList();
promotions.add(promotion);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("promotions", promotions);
hiAnalytics.onEvent(HAEventType.VIEWPRODUCT, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
CLICKID | 促销ID | promo<promoIndex>id | PROMO_NEW_PHONE_XXX |
PROMOTIONNAME | 促销名称 | promo<promoIndex>nm | New Phone Promotion |
MATERIALNAME | 促销广告素材 | promo<promoIndex>cr | new_phone_banner_x |
MATERIALSLOT | 促销位置 | promo<promoIndex>ps | banner_slot_x |
CONTENTTYPE | 产品操作列表 | pal | Internal Promotions |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle promotion = new Bundle();
promotion.putString(HAParamType.TRANSACTIONID, "PROMO_NEW_PHONE_XXX");
promotion.putString(HAParamType.PROMOTIONNAME, "New Phone Promotion");
promotion.putString(HAParamType.MATERIALNAME, "new_phone_banner_x");
promotion.putString(HAParamType.MATERIALSLOT, "banner_slot_x");
ArrayList promotions = new ArrayList();
promotions.add(promotion);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("promotions", promotions);
ecommerceBundle.putString(HAParamType.MEDIUM, "Internal Promotions");
hiAnalytics.onEvent(HAEventType.VIEWCONTENT, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
STEP | 结账步骤 | cos | 1 |
OPTION | 结账步骤选项 | col | Visa |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.QUANTITY, 1);
ArrayList items = new ArrayList();
items.add(product1);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("items", items);
ecommerceBundle.putLong(HAParamType.STEP, 1);
ecommerceBundle.putString(HAParamType.OPTION, "Visa");
hiAnalytics.onEvent(HAEventType.STARTCHECKOUT, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
STEP | 结账步骤 | cos | 2 |
OPTION | 结账步骤选项 | col | Visa |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.QUANTITY, 1);
ArrayList items = new ArrayList();
items.add(product1);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("items", items);
ecommerceBundle.putLong(HAParamType.STEP, 2);
ecommerceBundle.putString(HAParamType.OPTION, "Visa");
hiAnalytics.onEvent(HAEventType.VIEWCHECKOUTSTEP, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
STEP | 结账步骤 | cos | 2 |
OPTION | 结账步骤选项 | col | Mastercard |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putLong(HAParamType.STEP, 2);
ecommerceBundle.putString(HAParamType.OPTION, "Mastercard");
hiAnalytics.onEvent(HAEventType.UPDATECHECKOUTOPTION, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
PRODUCTNAME | 产品名称 | pr<productIndex>nm | HUAWEI Mate 40 Pro |
CATEGORY | 产品类别 | pr<productIndex>ca | Phone/Mate/Black |
PRODUCTFEATURE | 产品款式 | pr<productIndex>va | Black |
BRAND | 产品品牌 | pr<productIndex>br | HUAWEI |
PRICE | 产品价格 | pr<productIndex>pr | 6999.00 |
CURRNAME | 货币代码 | cu | CNY |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
TRANSACTIONID | 交易ID | ti | T12345 |
STORENAME | 交易关联商户 | ta | HUAWEI Store - Online |
REVENUE | 交易收入 | tr | 37.39 |
TAXFEE | 交易税费 | tt | 2.85 |
SHIPPING | 交易运费 | ts | 5.34 |
CURRNAME | 货币代码 | cu | CNY |
VOUCHER | 优惠券代码 | tcc | NEW_PHONE_2020 |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle product1 = new Bundle();
product1.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
product1.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product1.putString(HAParamType.CATEGORY, "Phone/Mate/Black");
product1.putString(HAParamType.PRODUCTFEATURE, "Black");
product1.putString(HAParamType.BRAND, "HUAWEI");
product1.putDouble(HAParamType.PRICE, 6999.00);
product1.putString(HAParamType.CURRNAME, "CNY");
product1.putLong(HAParamType.QUANTITY, 1);
Bundle product2 = new Bundle();
product2.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03QJ2J90");
product2.putString(HAParamType.PRODUCTNAME, "HUAWEI Mate 40 Pro");
product2.putString(HAParamType.CATEGORY, "Phone/Mate/Yellow");
product2.putString(HAParamType.PRODUCTFEATURE, "Yellow");
product2.putString(HAParamType.BRAND, "HUAWEI");
product2.putDouble(HAParamType.PRICE, 6999.00);
product2.putString(HAParamType.CURRNAME, "CNY");
product2.putLong(HAParamType.QUANTITY, 1);
ArrayList items = new ArrayList();
items.add(product1);
items.add(product2);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putParcelableArrayList("items", items);
ecommerceBundle.putString(HAParamType.TRANSACTIONID, "T12345");
ecommerceBundle.putString(HAParamType.STORENAME, "HUAWEI Store - Online");
ecommerceBundle.putDouble(HAParamType.REVENUE, 37.39);
ecommerceBundle.putDouble(HAParamType.TAXFEE, 2.85);
ecommerceBundle.putDouble(HAParamType.SHIPPING, 5.34);
ecommerceBundle.putString(HAParamType.CURRNAME, "CNY");
ecommerceBundle.putString(HAParamType.VOUCHER, "NEW_PHONE_2020");
hiAnalytics.onEvent(HAEventType.COMPLETEPURCHASE, ecommerceBundle); HA参数 | 名称 | GA字段 | 示例值 |
|---|---|---|---|
TRANSACTIONID | 交易ID | ti | T12345 |
REVENUE | 交易收入 | tr | 37.39 |
PRODUCTID | 产品SKU | pr<productIndex>id | HUAWEI_Mate_40_AI8I03Q423G |
QUANTITY | 产品数量 | pr<productIndex>qt | 1 |
示例代码如下:
HiAnalyticsInstance hiAnalytics = HiAnalytics.getInstance(this);
Bundle ecommerceBundle = new Bundle();
ecommerceBundle.putString(HAParamType.TRANSACTIONID, "T12345");
ecommerceBundle.putDouble(HAParamType.REVENUE, 37.39 );
Bundle refundedProduct = new Bundle();
refundedProduct.putString(HAParamType.PRODUCTID, "HUAWEI_Mate_40_AI8I03Q423G");
refundedProduct.putLong(HAParamType.QUANTITY, 1);
ArrayList items = new ArrayList();
items.add(refundedProduct);
ecommerceBundle.putParcelableArrayList("items", items);
hiAnalytics.onEvent(HAEventType.REFUNDORDER, ecommerceBundle);