BV像素

Bazaarvoice移动sdk提供了对Bazaarvoice提供的大多数核心产品的访问。必威手机版本要了解更多信息，请参阅Mobile SDK文档主页．

本文档解释了如何使用Bazaarvoice Pixel捕获产品购买以及非事务性事件，如“商店定位器”或“在哪里购买”点击。

简介

Bazaarvoice API分析解决方案，更广为人知的名字是BV Pixel，旨在将来自客户移动应用程序中包含消费者生成内容(CGC)的所有视图的事件传递给Bazaarvoice。这包括查看产品统计信息以及“评论”、“问题”和“答案”的CGC显示视图。利用这些收集到的数据，Bazaarvoice报告了CGC在整个客户端移动应用程序中的影响。

安装

与它

包括Maven中央存储库，并将适当的Bazaarvoice Mobile SDK模块添加到您的依赖项中:

依赖{compile 'com.bazaarvoice.bvandroidsdk:analytics:{BV_SDK_VERSION}。+'}存储库{mavenCentral()}

取代{令牌}，包括括号，并加上适当的值。请参阅安装指南{BV_SDK_VERSION}．

扩展应用程序

创建一个可扩展的类android.app.Application，并使用其构建器初始化Mobile SDK。

中可以找到构建选项的完整列表BVSDK.java．

公共类MyApplication扩展Application{@覆盖公共无效onCreate(){super.onCreate();BVPixel。builder(context， {YOUR_CLIENT_ID}， isStaging) . bhandlerthread (optionalBackgroundHandlerThread) .okHttpClient(optionalOkHttpClient) .build();}}

取代{令牌}使用适当的值。例:{牌}就变成了价值．如果您不确定正确的值，请联系Bazaarvoice的支持或者你的实现团队。

应用程序清单文件

将以下内容添加到您的AndroidManifest.xml文件。

<！——为应用程序条目设置类的名称——>  < /应用程序>

生成事件

事件映射生成步骤

下面的代码示例演示了如何分派一个分析事件:

//步骤1 //设置BVPixel BVPixel。builder(context， "clientId"， false) .okHttpClient(optionalCustomOkHttpClient) .bgHandlerThread(optionalCustomBgHandlerThread) .build();//步骤2 //创建事件BVPageViewEvent事件= new BVPageViewEvent("productId"， BVEventValues.BVProductType. bvproducttype . BVPageViewEvent)CONVERSATIONS_REVIEWS， "category");//步骤3 //发送事件BVPixel.getInstance().track(event);

事件映射生成示例

BVTransactionEvent

一旦用户完成购买，Transaction事件就应该执行。这通常发生在付款处理后或加载付款确认页面时。下面的示例代码展示了创建和发送电子商务交易分析事件所需的初始化式。

BVTransactionItem item1 = new BVTransactionItem. builder ("productId1") .setName("productName1") .setQuantity(2) .setPrice(20.02) .build();BVTransactionItem item2 = new BVTransactionItem. builder ("productId2") .setName("productName2") .setQuantity(2) .setPrice(80.02) .build();BVTransaction transaction = new BVTransaction. builder () . setcity ("Austin") . setstate ("TX") . setcountry ("USA") . settotal (200.08) . setitems(数组。asList(item1, item2)) .build();BVTransactionEvent事件=新的BVTransactionEvent(事务);

BVConversionEvent

对于非电子商务网站，这种分析指标应该实现如下所述。这个分析事件被称为非电子商务转换，它处理不被其他事件转换的用户交互，例如下载小册子或登录到服务。

BVConversionEvent event = new BVConversionEvent("customType"， "customValue"， "customLabel");

BVPageViewEvent

当产品详细信息页面完全呈现且页面视图数据可用时，执行PageView事件。PageView通常与评论和/或问题统计相关联。

BVPageViewEvent事件= new BVPageViewEvent("productId, BVEventValues.BVProductType. "CONVERSATIONS_REVIEWS， "categoryId");

BVInViewEvent

应该使用InView事件来指示CGC在视图上可见。当用户生成的内容在移动屏幕上可见时触发此事件。这应该只在每个ViewController加载时触发一次。下面的代码向您展示了如何跟踪InView事件。

BVInViewEvent事件= new BVInViewEvent("productId"， "viewContainerId"， BVEventValues.BVProductType. bvproducttype . BVInViewEvent事件。CONVERSATIONS_REVIEWS， "brandName");

BVImpressionEvent

该事件将消费者在给定视图上生成的各种内容传递回Bazaarvoice。对于UIView上的每一个评论、问题或答案，都必须发送一个印象事件。下面的代码展示了如何实现印象事件。

bv印象派事件事件= new bv印象派事件("productId"， "contentId"， BVEventValues.BVProductType. bvproducttype . bv印象派事件。CONVERSATIONS_REVIEWS BVEventValues.BVImpressionContentType。REVIEW， "categoryId"， "brandName");

BVFeatureUsedEvent

仅仅知道用户浏览过产品页面是不够的。了解终端用户如何在移动应用程序视图上与消费者生成的内容交互也是有价值的。这些信息可以在用户进行转换或购买之前提供有关用户所看重的信息的见解。

BVFeatureUsedEvent事件= new BVFeatureUsedEvent("productId"， BVEventValues.BVProductType. bvproducttype . BVFeatureUsedEvent事件。CONVERSATIONS_REVIEWS BVEventValues.BVFeatureUsedEventType。WRITE_REVIEW， "brandName");

BVViewedCGCEvent

当用户生成的内容在一段时间内可见时触发此事件。通常情况下，这意味着UGC在手机屏幕上停留的时间超过5秒，从而让最终用户了解到他们可能已经阅读了内容。

BVViewedCgcEvent event = new BVViewedCgcEvent("productId"， BVEventValues.BVProductType. bvproducttype . BVViewedCgcEvent event。CONVERSATIONS_REVIEWS， "rootCategoryId"， "categoryId"， "brand");

多客户端分析

如果需要的话，有一个额外的API用于发送带有不同客户端id的事件，

bvPixel。trackEventForClient(事件,otherClientId);