移动sdk:将Bazaarvoice集成到您的原生Android和iOS应用程序中。
产品推荐
Bazaarvoice移动sdk提供了对Bazaarvoice提供的大多数核心产品的访问。必威手机版本要了解更多信息,请参阅Mobile SDK文档主页。
内容
本文档解释了如何检索和显示产品推荐。
简介
使用Bazaarvoice Mobile sdk在你的应用程序中获取和显示产品推荐。
安装说明
点击这里查看如何安装和配置BVSDK。
使用Gradle安装
包括Maven中央存储库,并将适当的Bazaarvoice Mobile SDK模块添加到您的依赖项中:
依赖{实现` com.bazaarvoice.bvandroidsdk:建议:{BV_SDK_VERSION}。+“执行”com.google.android.gms:play-services-ads:9。{YOUR_PLAY_SERVICES_VERSION}' implementation 'com.android.support:recyclerview-v7:25。{YOUR_SUPPORT_LIBRARY_VERSION}'}存储库{mavenCentral()}
取代{令牌}
,包括括号,并加上适当的值。请参阅安装指南{BV_SDK_VERSION}
。
扩展应用程序
创建一个可扩展的类android.app.Application
,并使用其构建器初始化Mobile SDK。
中可以找到构建选项的完整列表BVSDK.java
。
在下面的例子中,YOUR_CLIENT_ID
表示您的客户名称,例如“bazaarvoice”。如果您不确定客户端ID或API键值,请联系Bazaarvoice的支持或者你的实现团队。
公共类MyApplication扩展Application{@覆盖公共无效onCreate(){super.onCreate();BVSDK。builder(application, bazaarenenvironment . production) . loglevel (BVLogLevel.VERBOSE) //可选:设置日志级别。. dryrunanalytics (false) //可选:只设置分析为日志,不发起网络请求。.okHttpClient(okHttpClient) //可选:使用您自己的okHttpClient实例.build();}}
应用程序清单文件
将以下内容添加到您的AndroidManifest.xml
文件。
<!——为应用程序条目设置类的名称——>< /应用程序>
设置用户信息
在用户登录工作流中对用户进行身份验证后,将已验证的用户设置为启用配置文件匹配。指用户认证令牌的指令。
用于测试的认证字符串示例
如果尚未设置授权令牌,请使用用户认证令牌的例子。
得到的建议
成功安装并配置SDK并设置用户信息后,您可以通过以下步骤获取产品推荐。
步骤1:设置请求
RecommendationsRequest。Builder Builder = new建议书请求。Builder(NUM_RECS);
请求生成器选项:
的名字 | 类型 | 默认的 | 描述 | 优先级 |
---|---|---|---|---|
被标记 |
字符串 | 零 | 喜欢这类产品。这是编目提要中提供的类别外部ID。只能设置categoryId或ProductId。你不能同时设置。 |
进行过滤 |
productId |
字符串 | 零 | 偏爱与本产品相似必威手机版本的产品。只能设置categoryId或ProductId。你不能同时设置。 |
推荐 |
PageType |
PageType | 零 | 显示推荐页面类型的元数据。公认的值是“home”,“category”,“product”,“cart”,“thankyou”和“search”。 | 推荐 |
步骤2:提供请求和回调
我们建议你使用提供的视图容器方法:
BVRecommendations recs = new BVRecommendations();
或者你可以用:
recommendationsContainerView。loadRecommendations(请求,回调)
或者,如果你想避免使用容器:
BVRecommendations recs = new BVRecommendations();推荐。getRecommended必威手机版本Products(20, new bvrecommendations . bvrecommationscallback () {@Override public void onSuccess(bvrecommendations . response response){日志。d(“演示”,response.getRecommendedPro必威手机版本ducts () .toString ());} @覆盖公共无效onFailure(Throwable Throwable){日志。d(“演示”,throwable.getMessage ());} });
显示的建议
包装单个推荐产品视图
在这个例子中,你将使用下面的布局来显示一个单独的BVProduct,在获取它之后,使用本页“获取建议”部分解释的方法:
在这个布局中为Bazaarvoice提供反馈,用提供的推荐容器视图和推荐视图包装LinearLayout,如下例所示:
< com.bazaarvoice.bvandroidsdk。推荐容器xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/推荐视图" android:layout_width="match_parent" android:layout_height="wrap_content">LinearLayout < / >
包装一组推荐产品视图的其他选项
如果你想使用其他viewgroup来代替RecyclerView, Mobile SDK提供了以下选项:
如果你想使用一个不同于ListView, GridView,或recyclerview的ViewGroup来显示推荐视图对象,比如linearlayout,用一个推荐容器视图来包装这个ViewGroup。下面的例子展示了如何使用LinearLayout ViewGroup:
< com.bazaarvoice.bvandroidsdk。推荐containerview xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/推荐prodcontainerview " android:layout_width="match_parent" android:layout_height="wrap_content">< com.bazaarvoice.bvandroidsdk。推荐视图安卓:id="@+id/推荐视图2"安卓:layout_width="match_parent"安卓:layout_height="wrap_content">