高级功能（HarmonyOS）

属性插件化

属性插件化是神策鸿蒙 SDK 提供用于修改埋点事件属性的高级功能，用户可通过属性插件化功能实现对指定事件（或所有事件）的属性进行新增、修改和删除。

接口介绍

SDK 提供了 registerPropertyPlugin 方法，通过该方法传入自定义的属性插件对象给指定的事件添加、修改或删除属性。

自定义属性插件对象介绍：

{
	properties:function(data){
	  // 添加
	  // data.properties.hello = 'world'
	  
	  // 修改
	  // data.properties.$title = 'new title'
	  
	  // 删除
	  // delete data.properties.$screen_width		
	}
}

{
	isMatchedWithFilter:function(data){
		// 筛选事件名为 $SignUp 的事件
		if(data.event === '$SignUp'){
			return true;
		}

		// 筛选在页面标题为 home 的事件
		if(data.properties.$title === 'home'){
			return true;
		}
		
		// 其他事件不会执行 properties 方法
		return false;
	}
}

使用示例

• 常用方法：修改事件名为 $pageview 下的 $url 属性

  sensors.registerPropertyPlugin({
    isMatchedWithFilter:function(data){
  	return data.event === "$pageview";
    }
  
    properties:function(data){
  	data.properties['$url'] = 'http://xxx';
    }
  });

• 常用方法：删除所有事件中的 platform 属性

  sensors.registerPropertyPlugin({
    isMatchedWithFilter:function(data){
  	return data.type === 'track';
    }
  
    properties:function(data){
  	delete data.properties['platform'];
    }
  });

• 注意：需要先做事件筛选，再做属性修改。因为 profile、item 等类型的数据也是可以被修改的。

  sensors.registerPropertyPlugin({
    isMatchedWithFilter:function(data){
  	return data.type.slice(0, 4) === 'item' ||  data.type.slice(0, 7) === 'profile';
    }
    properties:function(data){
  	delete data.properties['aaa'] = 'bbb';
    }
  });

• 对所有类型数据，修改属性值。注意：这种用法一般情况下是错误的，会导致所有数据（包括 profile、item 等）都被修改，引发意想不到的情况

  sensors.registerPropertyPlugin({
      properties:function(data){
      	data.properties['aaa'] = 'bbb';
    }
  });

• 直接在 properties 里进行筛选和属性修改也是可以的

  sensors.registerPropertyPlugin({
    properties:function(data){
  	if(data.event === '$pageview'){
   		data.properties['$url'] = 'http://xxxx';
  	}
    }
  });