Java SDK 接入文档

1、 集成SDK

1.1 导入SDK包

云图Java SDK当前提供Maven导入SDK方式

本地Maven仓库添加jar包，WEB工程pom.xml添加如下内容：

<dependency>
  <groupId>com.nd.atlas.javasdk</groupId>
  <artifactId>AtlasSDK</artifactId>
  <version>1.0.0</version>
</dependency>

1.2 初始化SDK

初始化PropertiesBuilder对象，对象参数如下：

appKey 应用标识码（String，必选）

使用示例

PropertiesBuilder propertiesBuilder = new PropertiesBuilder();
propertiesBuilder.init("appkey");

2. 高级功能接入

以下功能可根据项目的情况进行接入，如无详细的接入要求可暂时不接入以下功能

2.1 自定义事件的统计

自定义事件，目前支持以下两种多态方法，分别应用于不同的场景：

   /**
    * 用户定义事件
    *
    * @param id    事件Id
    * @param label 事件属性
    */
   public static void onEvent(String id, String label)

   /**
    * 用户定义事件
    *
    * @param id   事件Id
    * @param info 事件属性集
    */
   public static void onEvent(String id, Map<String, Object> info)

如果事件除了需要统计次数，还有不同的属性，如购买事件，可能有买苹果、买梨子、买香蕉等，而且需要对每种类型的水果的购买次数分别统计，则可以使用以下方式：

DataAction.onEvent("eventBuy", "apple");
DataAction.onEvent("eventBuy", "banana");

考虑到某些情况下，对于一个事件，我们不止有一个维度的属性要统计。如购买事件，除了水果的类型，有时还可能需要统计门店，可以使用带Map的接口：

Map<String, String> info = new HashMap<String, String>();
info.put("type", "apple");
info.put("store", "0AD056SDSD00AS"); // 门店标识
DataAction.onEvent("eventBuy", info);

3. 环境要求

Java JDK 1.6版本及以上