{"data":{"id":"80676","string_id":"wb9UC1","status":"1","parent_id":"49193","slug":"wb9UC1","order":"5","name":"\u670d\u52a1\u7aef","type":"1","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","add_time":"1711102676","update_time":"1716522649","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"\u63a5\u5165\u6307\u5357","parent_type":"1","parent_slug":"7ZIxw8","child":[{"id":"84814","string_id":"506rpg","status":"1","parent_id":"80676","slug":"Python_SDK","order":"4","name":"Python","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"Python V2","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u6797\u51ef\u9f99","add_time":"1712893520","update_time":"1733804649","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"84814","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n> \u4e0b\u8f7d\uff1a[\u6700\u65b0\u7248](https:\/\/github.com\/datatower-ai\/sdk-core-python\/releases\/latest)\n> \u26a0\ufe0f<\/span> \u6b64 SDK \u9700\u642d\u914d [FileScout](https:\/\/docs.datatower.ai\/docs\/FileScout-shi-yong-zhi-nan) \u4f7f\u7528\n\n> \u24d8 \u6700\u4f4e\u652f\u6301\u7684 Python \u7248\u672c\uff1a3.7\n\n[![PyPI - Version](https:\/\/img.shields.io\/pypi\/v\/dt-python-sdk?style=for-the-badge&logo=pypi&logoColor=FFD243&label=PyPI&labelColor=006DAD)](https:\/\/pypi.org\/project\/dt-python-sdk\/)\n\n## \u4e00\u3001\u96c6\u6210 SDK\n### \u2460 \u901a\u8fc7 pip \u4e0b\u8f7d\u5b89\u88c5\n- \u4e0b\u8f7d\n ```bash\n pip install dt-python-sdk\n ```\n- \u5347\u7ea7\n ```bash\n pip install --upgrade dt-python-sdk\n ```\n### \u2461 \u81ea\u884c\u4e0b\u8f7d\u5b89\u88c5\n1. \u6839\u636e\u8fd0\u884c\u5e73\u53f0\u4e0b\u8f7d[\u6700\u65b0 SDK](https:\/\/github.com\/datatower-ai\/sdk-core-python\/releases\/latest) \u7684 whl \u5305\n2. \u5b89\u88c5 whl \u5305\n ```bash\n pip install {path}\/dt-python-sdk-{xxx}.whl\n ```\n> **\u26a0\ufe0f \u6ce8\u610f**\n> \u5bf9\u4e8e Python 3.7 \u9700\u8981\u5b89\u88c5\u5982\u4e0b\u4f9d\u8d56\uff08Python 3.8 \u53ca\u4ee5\u4e0a\u65e0\u9700\u6b64\u64cd\u4f5c\uff09\uff1a\n> `pip install importlib-metadata`\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\n\n```Python\nfrom dt_python_sdk import *\n\n# Outputs to \"log\" folder in execution path with file prefix \"dt_event\"\u00a0\n# for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n# (will be larger if size of a single event is over such limit).\nconsumer = DTLogConsumer(\"log\", 200, \"dt_event\", 10*1024*1024)\n# with debug: False\ndt = DTAnalytics(consumer, False)\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n> \u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684**\u6240\u6709\u63a5\u53e3**\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n> - \u5982\u679c\u6821\u9a8c**\u901a\u8fc7**\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n> - **\u672a\u901a\u8fc7**\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n### 3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n> [\u6570\u636e\u8bf4\u660e\u6587\u6863](https:\/\/docs.datatower.ai\/docs\/data_description)\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n> [\u7528\u6237\u8bc6\u522b\u89c4\u5219](https:\/\/docs.datatower.ai\/docs\/ji-chu-zhi-shi#a5173f2b27d6dc020d5f4637cdda1f7f)\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 `track` \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\n```Python\nacId = \"account_id_111\"\ndt_id = \"dt_id_222\"\n\nproperties = dict()\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example.app\"\nproperties[\"#os\"] = \"android\"\nproperties[\"user_level\"] = 20\nproperties[\"coin\"] = 1000\nproperties[\"from\"] = \"entry\"\n\ndt.track(acId, dt_id, \"eventName\", properties)\n```\n\n\u6ce8\u610f\uff1a\n\n1. \u4ee5`#`\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167[\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027](https:\/\/docs.datatower.ai\/docs\/data_description)\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n2. \u4ee5`$`\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n### 3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n| \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0| \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| -------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set_once` \u00a0 \u00a0| \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_add` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0|\n| \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_unset` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0|\n| \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_append` \u00a0 \u00a0 \u00a0| \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_uniq_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd |\n| \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0| \u00a0`#user_delete` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n#### 3.2.1 userSet\n\n`user_set` \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n```Python\nproperties = { \"name\": \"abc\" }\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.user_set(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.user_set(acid, dt_id, properties)\n```\n\n#### 3.2.2 userSetOnce\n\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `user_set_once` \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\n\n```Python\nproperties = { \"name\": \"abc\" }\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.user_set_once(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.user_set_once(acid, dt_id, properties)\n```\n\n#### 3.2.3 userAdd\n\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `user_add` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```Python\nproperties = {\n\u00a0 \u00a0 \"total_count\": 10,\n\u00a0 \u00a0 \"level\": 3\n}\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.user_add(acid, dt_id, properties)\n\nproperties = { \"total_count\": 20 }\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.user_add(acid, dt_id, properties)\n```\n\n#### 3.2.4 userUnset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `user_unset` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\n\n```Python\ndel_set = { \"name\": 0, \"actime_time\": 0 }\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.user_unset(acid, dt_id, del_set)\n```\n\n#### 3.2.5 userAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `user_append` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n```Python\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n}\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.user_set(acid, dt_id, properties)\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\"]\n}\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.user_append(acid, dt_id, properties)\n```\n\n#### 3.2.6 userUniqAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `user_uniq_append` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\n\n```Python\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n}\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.user_set(acid, dt_id, properties)\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\", \"dot\"]\n}\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.user_uniq_append(acid, dt_id, properties)\n```\n\n#### 3.2.7 userDelete\n\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 `user_delete` \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n```Python\ndt.user_delete(acid, dt_id, {})\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728`properties`\u4e2d\u6dfb\u52a0`#ip`\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\n\n```Python\nproperties[\"#ip\"] = \"127.0.0.1\"\n```\n\n## \u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n> \u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a \u00a0\n> - DTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n\n### 5.1 DTLogConsumer\n\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n1. log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n2. \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n4. log \u6587\u4ef6\u7684\u524d\u7f00\n3. \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\n```Python\nconsumer = DTLogConsumer(\".\/log\", 200, \"dt\", 10000)\n# \u5f00\u542f debug \u6807\u5fd7\ndt = DTAnalytics(consumer, true)\n# \u5173\u95ed debug \u6807\u5fd7\n# dt = DTAnalytics(consumer, false)\n```\n\n### 5.2 \u63d0\u4ea4\u6570\u636e\n\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n\n```Python\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush()\n```\n\n### 5.3 \u5173\u95ed SDK\n\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\n\n```Python\ndt.close()\n```\n\n## \u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\n\n```Python\nimport time\nfrom dt_python_sdk import *\n\nconsumer = DTLogConsumer(\"log\", 200, \"dt_py\", 10*1024*1024)\ndt = DTAnalytics(consumer, True)\n\nDTAnalytics.enable_log() \u00a0 \u00a0# \u5f00\u542f log\n\ndt_id = \"1234567890987654321\"\nacid = None\n\ndt.user_unset(\"xx\", \"xxxx\", {\"#app_id\": \"aaa\", \"#bundle_id\": \"123\", \"bb\": 2, \"cc\": \"ss\", \"#is_foreground\": True})\ndt.user_delete(\"xx\", \"xxxx\", {\"#app_id\": \"aaa\", \"#bundle_id\": \"123\", \"bb\": 2, \"cc\": \"ss\"})\ndt.flush()\n\nDTAnalytics.disable_log() \u00a0 \u00a0# \u5173\u95ed log\n\nproperties = dict()\nproperties[\"productNames\"] = [\"Python\", \"hello\"]\nproperties[\"productType\"] = \"Python book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"xx-shop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"sex\"] = 'female'\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\ndt.track(dt_id, acid, \"eventName\", properties)\n\ndt.flush()\ndt.close()\n```","pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u4e0b\u8f7d\uff1a\u6700\u65b0\u7248\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u24d8 \u6700\u4f4e\u652f\u6301\u7684 Python \u7248\u672c\uff1a3.7\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\u2460 \u901a\u8fc7 pip \u4e0b\u8f7d\u5b89\u88c5\n\n\u4e0b\u8f7d\npip install dt-python-sdk\n\n\n\u5347\u7ea7\npip install --upgrade dt-python-sdk\n\n\n\n\u2461 \u81ea\u884c\u4e0b\u8f7d\u5b89\u88c5\n\n\u6839\u636e\u8fd0\u884c\u5e73\u53f0\u4e0b\u8f7d\u6700\u65b0 SDK \u7684 whl \u5305\n\u5b89\u88c5 whl \u5305\npip install {path}\/dt-python-sdk-{xxx}.whl\n\n\n\n\n\u26a0\ufe0f \u6ce8\u610f\n\u5bf9\u4e8e Python 3.7 \u9700\u8981\u5b89\u88c5\u5982\u4e0b\u4f9d\u8d56\uff08Python 3.8 \u53ca\u4ee5\u4e0a\u65e0\u9700\u6b64\u64cd\u4f5c\uff09\uff1a\npip install importlib-metadata\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\nfrom dt_python_sdk import *\n\n# Outputs to \"log\" folder in execution path with file prefix \"dt_event\"\u00a0\n# for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n# (will be larger if size of a single event is over such limit).\nconsumer = DTLogConsumer(\"log\", 200, \"dt_event\", 10*1024*1024)\n# with debug: False\ndt = DTAnalytics(consumer, False)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684\u6240\u6709\u63a5\u53e3\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n\n\u5982\u679c\u6821\u9a8c\u901a\u8fc7\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\u672a\u901a\u8fc7\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\n3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u6570\u636e\u8bf4\u660e\u6587\u6863\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n\u7528\u6237\u8bc6\u522b\u89c4\u5219\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 track \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\nacId = \"account_id_111\"\ndt_id = \"dt_id_222\"\n\nproperties = dict()\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example.app\"\nproperties[\"#os\"] = \"android\"\nproperties[\"user_level\"] = 20\nproperties[\"coin\"] = 1000\nproperties[\"from\"] = \"entry\"\n\ndt.track(acId, dt_id, \"eventName\", properties)\n\n\u6ce8\u610f\uff1a\n\n\u4ee5#\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\u4ee5$\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n\n\n \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n\n\n \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set_once \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_add \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_unset \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0\n #user_append \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_uniq_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd\n\n\n \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u00a0#user_delete\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n\n\n3.2.1 userSet\nuser_set \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\nproperties = { \"name\": \"abc\" }\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.user_set(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.user_set(acid, dt_id, properties)\n\n3.2.2 userSetOnce\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 user_set_once \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\nproperties = { \"name\": \"abc\" }\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.user_set_once(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.user_set_once(acid, dt_id, properties)\n\n3.2.3 userAdd\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 user_add \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\nproperties = {\n\u00a0 \u00a0 \"total_count\": 10,\n\u00a0 \u00a0 \"level\": 3\n}\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.user_add(acid, dt_id, properties)\n\nproperties = { \"total_count\": 20 }\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.user_add(acid, dt_id, properties)\n\n3.2.4 userUnset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 user_unset \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\ndel_set = { \"name\": 0, \"actime_time\": 0 }\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.user_unset(acid, dt_id, del_set)\n\n3.2.5 userAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 user_append \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n}\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.user_set(acid, dt_id, properties)\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\"]\n}\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.user_append(acid, dt_id, properties)\n\n3.2.6 userUniqAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 user_uniq_append \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n}\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.user_set(acid, dt_id, properties)\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\", \"dot\"]\n}\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.user_uniq_append(acid, dt_id, properties)\n\n3.2.7 userDelete\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 user_delete \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\ndt.user_delete(acid, dt_id, {})\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728properties\u4e2d\u6dfb\u52a0#ip\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\nproperties[\"#ip\"] = \"127.0.0.1\"\n\n\u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n\u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a \u00a0\n\nDTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n5.1 DTLogConsumer\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\nlog \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n\u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlog \u6587\u4ef6\u7684\u524d\u7f00\n\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\nconsumer = DTLogConsumer(\".\/log\", 200, \"dt\", 10000)\n# \u5f00\u542f debug \u6807\u5fd7\ndt = DTAnalytics(consumer, true)\n# \u5173\u95ed debug \u6807\u5fd7\n# dt = DTAnalytics(consumer, false)\n\n5.2 \u63d0\u4ea4\u6570\u636e\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush()\n\n5.3 \u5173\u95ed SDK\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\ndt.close()\n\n\u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\nimport time\nfrom dt_python_sdk import *\n\nconsumer = DTLogConsumer(\"log\", 200, \"dt_py\", 10*1024*1024)\ndt = DTAnalytics(consumer, True)\n\nDTAnalytics.enable_log() \u00a0 \u00a0# \u5f00\u542f log\n\ndt_id = \"1234567890987654321\"\nacid = None\n\ndt.user_unset(\"xx\", \"xxxx\", {\"#app_id\": \"aaa\", \"#bundle_id\": \"123\", \"bb\": 2, \"cc\": \"ss\", \"#is_foreground\": True})\ndt.user_delete(\"xx\", \"xxxx\", {\"#app_id\": \"aaa\", \"#bundle_id\": \"123\", \"bb\": 2, \"cc\": \"ss\"})\ndt.flush()\n\nDTAnalytics.disable_log() \u00a0 \u00a0# \u5173\u95ed log\n\nproperties = dict()\nproperties[\"productNames\"] = [\"Python\", \"hello\"]\nproperties[\"productType\"] = \"Python book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"xx-shop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"sex\"] = 'female'\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\ndt.track(dt_id, acid, \"eventName\", properties)\n\ndt.flush()\ndt.close()","is_draft":"0","editor_type":"2","file_path":"","add_time":"1712893520","update_time":"1733804649"},"pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u4e0b\u8f7d\uff1a\u6700\u65b0\u7248\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u24d8 \u6700\u4f4e\u652f\u6301\u7684 Python \u7248\u672c\uff1a3.7\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\u2460 \u901a\u8fc7 pip \u4e0b\u8f7d\u5b89\u88c5\n\n\u4e0b\u8f7d\npip install dt-python-sdk\n\n\n\u5347\u7ea7\npip install --upgrade dt-python-sdk\n\n\n\n\u2461 \u81ea\u884c\u4e0b\u8f7d\u5b89\u88c5\n\n\u6839\u636e\u8fd0\u884c\u5e73\u53f0\u4e0b\u8f7d\u6700\u65b0 SDK \u7684"},{"id":"80266","string_id":"sXc9q0","status":"1","parent_id":"80676","slug":"SDK_Lua","order":"3","name":"Lua","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"Lua","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u6797\u51ef\u9f99","add_time":"1710987125","update_time":"1733804645","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"80266","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10 \n> \u4e0b\u8f7d\u5730\u5740\uff1a[\u6700\u65b0\u7248\u672c](https:\/\/github.com\/datatower-ai\/sdk-core-lua\/releases\/latest) \n> \u6e90\u7801\uff1a[GitHub](https:\/\/github.com\/datatower-ai\/sdk-core-base) \n> \u26a0\ufe0f<\/span> \u6b64 SDK \u9700\u642d\u914d [FileScout](https:\/\/docs.datatower.ai\/docs\/FileScout-shi-yong-zhi-nan) \u4f7f\u7528\n\n[![GitHub Release](https:\/\/img.shields.io\/github\/v\/release\/datatower-ai\/sdk-core-lua?sort=semver&style=for-the-badge&logo=lua&logoColor=06007F&label=Lua&labelColor=DDDDDD&color=06007F)](https:\/\/github.com\/datatower-ai\/sdk-core-lua\/releases\/latest\/)\n\n## \u4e00\u3001\u96c6\u6210 SDK\n\n- [\u4e0b\u8f7d](https:\/\/github.com\/datatower-ai\/sdk-core-lua\/releases\/latest) \u6700\u65b0\u7248\u672c\u7684 SDK\uff1a\n \u6839\u636e\u4f7f\u7528\u73af\u5883\u4e0b\u8f7d\u5bf9\u5e94\u7684 `*.src.rock` \u6587\u4ef6\uff0c\u5e76\u53bb\u6389\u524d\u7f00\u5c06\u5176\u66f4\u540d\u4e3a `dt-lua-sdk-{version}.src.rock`\n - Lua \u89e3\u91ca\u5668\u7248\u672c (lua51, lua52, lua53, lua54, ...),\n - \u64cd\u4f5c\u7cfb\u7edf (Linux, macOS, Windows, ...),\n - CPU \u67b6\u6784 (x86_64, aarch64, ...).\n- \u901a\u8fc7 Luarocks \u5b89\u88c5 SDK\uff1a\n ```bash\n luarocks install dt-lua-sdk-{version}.src.rock\n # Example:\n luarocks install dt-lua-sdk-1.0.0-1.src.rock\n ```\n- \u4f7f\u7528\uff1a`dt = require(\"DataTowerSdk\")`\n\n> \u5982\u679c\u6ca1\u6709\u7b26\u5408\u60a8\u73af\u5883\u7684 rock \u6587\u4ef6\uff0c\u8bf7\u4e0e\u6211\u4eec\u8054\u7cfb\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\n\n```Lua\ndt = require(\"DataTowerSdk\")\n\nconsumer = dt.DTLogConsumer(\".\/log\", 200, 10000)\nsdk = dt(consumer, false)\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n> \u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684**\u6240\u6709\u63a5\u53e3**\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n> - \u5982\u679c\u6821\u9a8c**\u901a\u8fc7**\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n> - **\u672a\u901a\u8fc7**\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n### 3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n> [\u6570\u636e\u8bf4\u660e\u6587\u6863](https:\/\/docs.datatower.ai\/docs\/data_description)\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4 \n> [\u7528\u6237\u8bc6\u522b\u89c4\u5219](https:\/\/docs.datatower.ai\/docs\/dMniLk#%E4%BA%8C%E3%80%81%E6%A0%87%E8%AF%86%E7%94%A8%E6%88%B7)\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 `track` \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\n```lua\nacId = \"account_id_111\"\ndt_id = \"dt_id_222\"\n\nlocal properties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example.app\"\nproperties[\"#os\"] = \"android\"\nproperties[\"user_level\"] = 20\nproperties[\"coin\"] = 1000\nproperties[\"from\"] = \"entry\"\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n```\n\n\u6ce8\u610f\uff1a\n\n1. \u4ee5`#`\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167[\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027](https:\/\/docs.datatower.ai\/docs\/data_description)\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n2. \u4ee5`$`\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n### 3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n| \u64cd\u4f5c | \u5bf9\u5e94\u4e8b\u4ef6\u540d | \u5904\u7406\u89c4\u5219 |\n| -------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| \u8986\u76d6\u7528\u6237\u5c5e\u6027 | `#user_set` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 |\n| \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 | `#user_set_once` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c |\n| \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 | `#user_add` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c |\n| \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c | `#user_unset` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 |\n| \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 |\n| \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_uniq_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd |\n| \u5220\u9664\u7528\u6237 | `#user_delete` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230 \n\n#### 3.2.1 userSet\n\n`userSet` \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n```lua\nproperties = { \"name\" = \"abc\" }\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\nsdk:userSet(acid, dt_id, properties)\n\nproperties = { \"name\" = \"xyz\" }\n-- \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\nsdk:userSet(acid, dt_id, properties)\n```\n\n#### 3.2.2 userSetOnce\n\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\n\n```lua\nproperties = { \"name\" = \"abc\" }\n-- \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\nsdk:userSetOnce(acid, dt_id, properties)\n\nproperties = { \"name\" = \"xyz\" }\n-- \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\nsdk:userSetOnce(acid, dt_id, properties)\n```\n\n#### 3.2.3 userAdd\n\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```lua\nproperties = {\n \"total_count\" = 10,\n \"level\" = 3\n}\n-- \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\nsdk:userAdd(acid, dt_id, properties)\n\nproperties = { \"total_count\" = 20 }\n-- \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\nsdk:userAdd(acid, dt_id, properties)\n```\n\n#### 3.2.4 userUnset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\n\n```lua\ndel_set = { \"name\" = 0,\"actime_time\" = 0 }\n-- \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\nsdk::userUnset(acid, dt_id, del_set)\n```\n\n#### 3.2.5 userAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n```lua\nproperties = {\n \"pet\" = {\"cat\", \"dog\"}\n}\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\nsdk::userSet(acid, dt_id, properties)\n\nproperties = {\n \"pet\" = {\"ratbbit\"}\n}\n-- \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\nsdk::userAppend(acid, dt_id, properties)\n```\n\n#### 3.2.6 userUniqAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\n\n```lua\nproperties = {\n \"pet\" = {\"cat\", \"dog\"}\n}\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\nsdk:userSet(acid, dt_id, properties)\n\nproperties = {\n \"pet\" = {\"ratbbit\", \"dot\"}\n}\n-- \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\nsdk:userUniqAppend(acid, dt_id, properties)\n```\n\n#### 3.2.7 userDelete\n\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 `userDelete` \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n```lua\nsdk:userDelete(acid, dt_id)\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728`properties`\u4e2d\u6dfb\u52a0`#ip`\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\u3002\n\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\n\n```lua\nproperties[\"#ip\"] = \"127.0.0.1\"\n```\n\n## \u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n> \u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a \n> - DTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n\n### 5.1 DTLogConsumer\n\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n1. log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n2. \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n3. \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n4. log \u6587\u4ef6\u7684\u524d\u7f00\uff08\u53ef\u9009\uff09\n\n```lua\nconsumer = dt.DTLogConsumer(\".\/log\", 200, 10000, \"dt\")\n-- \u5f00\u542f debug \u6807\u5fd7\nsdk = dt(consumer, true)\n-- \u5173\u95ed debug \u6807\u5fd7\n-- sdk = dt(consumer, false)\n```\n\n### 5.2 \u63d0\u4ea4\u6570\u636e\n\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n\n```lua\n-- \u7acb\u5373\u4e0a\u62a5\u6570\u636e\nsdk:flush()\n```\n\n### 5.3 \u5173\u95ed SDK\n\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\n\n```lua\nsdk:close()\n```\n\n## \u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\n\n```lua\npackage.path = package.path .. \";..\/?.lua\"\nlocal dt = require(\"src.DataTowerSdk\")\n\nlocal function getLogConsumer()\n return dt.DTLogConsumer(\".\/log\", 200, 10000)\nend\n\ndt.enableLog(true)\n\nlocal consumer = getLogConsumer()\n\n--- init SDK with consumer\nlocal sdk = dt(consumer, false)\n\nlocal dt_id = \"1234567890987654321\"\nlocal acId = nil\n\n-- set dynamic super properties\nsdk:setDynamicSuperProperties(function ()\n local properties = {}\n properties[\"DynamicKey\"] = \"DynamicValue\"\n return properties\nend)\n\n-- set super properties\nlocal superProperties = {}\nsuperProperties[\"super_key_sex\"] = \"male\"\nsuperProperties[\"super_key_age\"] = 23\nsdk:setSuperProperties(superProperties)\nsuperProperties = nil\n\nlocal properties = {}\nproperties[\"productNames\"] = { \"Lua\", \"hello\" }\nproperties[\"productType\"] = \"Lua book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"aShop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"date\"] = os.date()\nproperties[\"date1\"] = os.date(\"%Y-%m-%d %H:%M:%S\")\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n\nsdk:clearSuperProperties()\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n\nproperties = {}\nproperties[\"productNames\"] = { \"Lua\", \"hello\" }\nproperties[\"productType\"] = \"Lua book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"aShop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"date\"] = os.date()\nproperties[\"date1\"] = os.date(\"%Y-%m-%d %H:%M:%S\")\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nsdk:track(acId, dt_id, \"purchasing\", properties)\n\nlocal properties = {}\nproperties[\"#city\"] = \"beijing\"\nproperties[\"#province\"] = \"beijing\"\nproperties[\"name\"] = \"nammy\"\nproperties[\"userLevel\"] = 0\nproperties[\"userPoint\"] = 0\nproperties[\"#os\"] = \"1.2.3\"\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nlocal itemList = { \"pen\", \"tissue\", \"key\", \"fork\" }\nproperties[\"items\"] = itemList\nsdk:userSet(acId, dt_id, properties)\nproperties = nil\n\nlocal properties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\nproperties[\"setOnceKey\"] = \"1st\"\nsdk:userSetOnce(acId, dt_id, properties)\n\nproperties[\"setOnceKey\"] = \"2nd\"\nsdk:userSetOnce(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"userPoint\"] = 100\nsdk:userAdd(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"append\"] = { \"append_one\" }\nsdk:userAppend(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"append\"] = {\"append_one\", \"append_two\"}\nsdk:userUniqAppend(acId, dt_id, properties)\n\nsdk:flush()\nsdk:close()\n```","pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u4e0b\u8f7d\u5730\u5740\uff1a\u6700\u65b0\u7248\u672c\n\u6e90\u7801\uff1aGitHub\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\n\n\u4e0b\u8f7d \u6700\u65b0\u7248\u672c\u7684 SDK\uff1a\n\u6839\u636e\u4f7f\u7528\u73af\u5883\u4e0b\u8f7d\u5bf9\u5e94\u7684 *.src.rock \u6587\u4ef6\uff0c\u5e76\u53bb\u6389\u524d\u7f00\u5c06\u5176\u66f4\u540d\u4e3a dt-lua-sdk-{version}.src.rock\n\nLua \u89e3\u91ca\u5668\u7248\u672c (lua51, lua52, lua53, lua54, ...),\n\u64cd\u4f5c\u7cfb\u7edf (Linux, macOS, Windows, ...),\nCPU \u67b6\u6784 (x86_64, aarch64, ...).\n\n\n\u901a\u8fc7 Luarocks \u5b89\u88c5 SDK\uff1a\nluarocks install dt-lua-sdk-{version}.src.rock\n# Example:\nluarocks install dt-lua-sdk-1.0.0-1.src.rock\n\n\n\u4f7f\u7528\uff1adt = require(\"DataTowerSdk\")\n\n\n\n\u5982\u679c\u6ca1\u6709\u7b26\u5408\u60a8\u73af\u5883\u7684 rock \u6587\u4ef6\uff0c\u8bf7\u4e0e\u6211\u4eec\u8054\u7cfb\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\ndt = require(\"DataTowerSdk\")\n\nconsumer = dt.DTLogConsumer(\".\/log\", 200, 10000)\nsdk = dt(consumer, false)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684\u6240\u6709\u63a5\u53e3\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n\n\u5982\u679c\u6821\u9a8c\u901a\u8fc7\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\u672a\u901a\u8fc7\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\n3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u6570\u636e\u8bf4\u660e\u6587\u6863\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\n\u7528\u6237\u8bc6\u522b\u89c4\u5219\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 track \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\nacId = \"account_id_111\"\ndt_id = \"dt_id_222\"\n\nlocal properties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example.app\"\nproperties[\"#os\"] = \"android\"\nproperties[\"user_level\"] = 20\nproperties[\"coin\"] = 1000\nproperties[\"from\"] = \"entry\"\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n\n\u6ce8\u610f\uff1a\n\n\u4ee5#\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\u4ee5$\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n\n\n \u64cd\u4f5c\n \u5bf9\u5e94\u4e8b\u4ef6\u540d\n \u5904\u7406\u89c4\u5219\n\n\n\n\n \u8986\u76d6\u7528\u6237\u5c5e\u6027\n #user_set\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n\n \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\n #user_set_once\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c\n\n\n \u7d2f\u52a0\u7528\u6237\u5c5e\u6027\n #user_add\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n\n \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c\n #user_unset\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027\n\n\n \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n\n \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_uniq_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd\n\n\n \u5220\u9664\u7528\u6237\n #user_delete\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n\n\n3.2.1 userSet\nuserSet \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\nproperties = { \"name\" = \"abc\" }\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\nsdk:userSet(acid, dt_id, properties)\n\nproperties = { \"name\" = \"xyz\" }\n-- \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\nsdk:userSet(acid, dt_id, properties)\n\n3.2.2 userSetOnce\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\nproperties = { \"name\" = \"abc\" }\n-- \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\nsdk:userSetOnce(acid, dt_id, properties)\n\nproperties = { \"name\" = \"xyz\" }\n-- \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\nsdk:userSetOnce(acid, dt_id, properties)\n\n3.2.3 userAdd\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\nproperties = {\n \"total_count\" = 10,\n \"level\" = 3\n}\n-- \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\nsdk:userAdd(acid, dt_id, properties)\n\nproperties = { \"total_count\" = 20 }\n-- \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\nsdk:userAdd(acid, dt_id, properties)\n\n3.2.4 userUnset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\ndel_set = { \"name\" = 0,\"actime_time\" = 0 }\n-- \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\nsdk::userUnset(acid, dt_id, del_set)\n\n3.2.5 userAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\nproperties = {\n \"pet\" = {\"cat\", \"dog\"}\n}\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\nsdk::userSet(acid, dt_id, properties)\n\nproperties = {\n \"pet\" = {\"ratbbit\"}\n}\n-- \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\nsdk::userAppend(acid, dt_id, properties)\n\n3.2.6 userUniqAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\nproperties = {\n \"pet\" = {\"cat\", \"dog\"}\n}\n-- \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\nsdk:userSet(acid, dt_id, properties)\n\nproperties = {\n \"pet\" = {\"ratbbit\", \"dot\"}\n}\n-- \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\nsdk:userUniqAppend(acid, dt_id, properties)\n\n3.2.7 userDelete\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 userDelete \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\nsdk:userDelete(acid, dt_id)\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728properties\u4e2d\u6dfb\u52a0#ip\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\u3002\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\nproperties[\"#ip\"] = \"127.0.0.1\"\n\n\u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n\u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a\n\nDTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n5.1 DTLogConsumer\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\nlog \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n\u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\nlog \u6587\u4ef6\u7684\u524d\u7f00\uff08\u53ef\u9009\uff09\n\nconsumer = dt.DTLogConsumer(\".\/log\", 200, 10000, \"dt\")\n-- \u5f00\u542f debug \u6807\u5fd7\nsdk = dt(consumer, true)\n-- \u5173\u95ed debug \u6807\u5fd7\n-- sdk = dt(consumer, false)\n\n5.2 \u63d0\u4ea4\u6570\u636e\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n-- \u7acb\u5373\u4e0a\u62a5\u6570\u636e\nsdk:flush()\n\n5.3 \u5173\u95ed SDK\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\nsdk:close()\n\n\u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\npackage.path = package.path .. \";..\/?.lua\"\nlocal dt = require(\"src.DataTowerSdk\")\n\nlocal function getLogConsumer()\n return dt.DTLogConsumer(\".\/log\", 200, 10000)\nend\n\ndt.enableLog(true)\n\nlocal consumer = getLogConsumer()\n\n--- init SDK with consumer\nlocal sdk = dt(consumer, false)\n\nlocal dt_id = \"1234567890987654321\"\nlocal acId = nil\n\n-- set dynamic super properties\nsdk:setDynamicSuperProperties(function ()\n local properties = {}\n properties[\"DynamicKey\"] = \"DynamicValue\"\n return properties\nend)\n\n-- set super properties\nlocal superProperties = {}\nsuperProperties[\"super_key_sex\"] = \"male\"\nsuperProperties[\"super_key_age\"] = 23\nsdk:setSuperProperties(superProperties)\nsuperProperties = nil\n\nlocal properties = {}\nproperties[\"productNames\"] = { \"Lua\", \"hello\" }\nproperties[\"productType\"] = \"Lua book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"aShop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"date\"] = os.date()\nproperties[\"date1\"] = os.date(\"%Y-%m-%d %H:%M:%S\")\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n\nsdk:clearSuperProperties()\n\nsdk:track(acId, dt_id, \"eventName\", properties)\n\nproperties = {}\nproperties[\"productNames\"] = { \"Lua\", \"hello\" }\nproperties[\"productType\"] = \"Lua book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"aShop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"date\"] = os.date()\nproperties[\"date1\"] = os.date(\"%Y-%m-%d %H:%M:%S\")\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nsdk:track(acId, dt_id, \"purchasing\", properties)\n\nlocal properties = {}\nproperties[\"#city\"] = \"beijing\"\nproperties[\"#province\"] = \"beijing\"\nproperties[\"name\"] = \"nammy\"\nproperties[\"userLevel\"] = 0\nproperties[\"userPoint\"] = 0\nproperties[\"#os\"] = \"1.2.3\"\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nlocal itemList = { \"pen\", \"tissue\", \"key\", \"fork\" }\nproperties[\"items\"] = itemList\nsdk:userSet(acId, dt_id, properties)\nproperties = nil\n\nlocal properties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\nproperties[\"setOnceKey\"] = \"1st\"\nsdk:userSetOnce(acId, dt_id, properties)\n\nproperties[\"setOnceKey\"] = \"2nd\"\nsdk:userSetOnce(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"userPoint\"] = 100\nsdk:userAdd(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"append\"] = { \"append_one\" }\nsdk:userAppend(acId, dt_id, properties)\n\nproperties = {}\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\nproperties[\"append\"] = {\"append_one\", \"append_two\"}\nsdk:userUniqAppend(acId, dt_id, properties)\n\nsdk:flush()\nsdk:close()","is_draft":"0","editor_type":"2","file_path":"","add_time":"1710987126","update_time":"1733804645"},"pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u4e0b\u8f7d\u5730\u5740\uff1a\u6700\u65b0\u7248\u672c\n\u6e90\u7801\uff1aGitHub\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\n\n\u4e0b\u8f7d \u6700\u65b0\u7248\u672c\u7684 SDK\uff1a\n\u6839\u636e\u4f7f\u7528\u73af\u5883\u4e0b\u8f7d\u5bf9\u5e94\u7684 *.src.rock \u6587\u4ef6\uff0c\u5e76\u53bb\u6389\u524d\u7f00\u5c06\u5176\u66f4\u540d\u4e3a dt-lua-sdk-{version}.src.rock\n\nLua \u89e3\u91ca\u5668\u7248\u672c (lua51, lua52, lua53, lua54, ..."},{"id":"95578","string_id":"p3pF2p","status":"1","parent_id":"80676","slug":"Java","order":"2","name":"Java","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u6797\u51ef\u9f99","add_time":"1715331485","update_time":"1733804640","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"95578","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10 \n> \u26a0\ufe0f<\/span> \u6b64 SDK \u9700\u642d\u914d [FileScout](https:\/\/docs.datatower.ai\/docs\/FileScout-shi-yong-zhi-nan) \u4f7f\u7528\n\n[![](https:\/\/jitpack.io\/v\/datatower-ai\/dt-java-sdk.svg)](https:\/\/jitpack.io\/#datatower-ai\/dt-java-sdk)\n\n## \u4e00\u3001\u96c6\u6210 SDK\n\n### Gradle\n\n1. \u9879\u76ee build.gradle \u4e2d\u52a0\u5165\u6e90\uff1a\n\n```Java\nrepositories {\n mavenCentral()\n maven { url 'https:\/\/jitpack.io' }\n}\n```\n\n2. \u6a21\u5757 build.gradle \u4e2d\u52a0\u5165\u4f9d\u8d56\uff1a\n\n```Java\ndependencies {\n implementation 'com.github.datatower-ai:dt-java-sdk:{\u6700\u65b0\u7248\u672c}'\n}\n```\n\n### Maven\n\n1. \u52a0\u5165\u6e90\uff1a\n\n```Java\n\n \n jitpack.io<\/id>\n https:\/\/jitpack.io<\/url>\n <\/repository>\n<\/repositories>\n```\n\n2. \u52a0\u5165\u4f9d\u8d56\uff1a\n\n```Java\n\n com.github.datatower-ai<\/groupId>\n dt-java-sdk<\/artifactId>\n {\u6700\u65b0\u7248\u672c}<\/version>\n<\/dependency>\n```\n\n### sbt\n\n1. \u5728 build.sbt \u5c3e\u90e8\u6dfb\u52a0\uff1a\n\n```\nresolvers += \"jitpack\" at \"https:\/\/jitpack.io\"\n```\n\n2. \u6dfb\u52a0\u4f9d\u8d56\uff1a\n\n```\nlibraryDependencies += \"com.github.datatower-ai\" % \"dt-java-sdk\" % \"{\u6700\u65b0\u7248\u672c}\"\n```\n\n### leiningen\n\n1. \u5728 project.clj \u5c3e\u90e8\u6dfb\u52a0\uff1a\n\n```\n:repositories [[\"jitpack\" \"https:\/\/jitpack.io\"]]\n```\n\n2. \u6dfb\u52a0\u4f9d\u8d56\uff1a\n\n```\n:dependencies [[com.github.datatower-ai\/dt-java-sdk \"Tag\"]]\n```\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\n\n```Kotlin\nimport ai.datatower.sdk.*\n\n\/\/ Outputs to \"log\" folder in execution path with file prefix \"dt_java\"\u00a0\n\/\/ for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n\/\/ (will be larger if size of a single event is over such limit).\nval consumer = DTLogConsumer(\"log\", 200, \"dt_java\", (10 * 1024 * 1024).toLong())\n\/\/ with debug: False\nval dt: DTAnalytics = DTAnalytics.init(consumer, false)\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n> \u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684**\u6240\u6709\u63a5\u53e3**\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n>\n> - \u5982\u679c\u6821\u9a8c**\u901a\u8fc7**\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n> - **\u672a\u901a\u8fc7**\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n### 3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n> [\u6570\u636e\u8bf4\u660e\u6587\u6863](https:\/\/docs.datatower.ai\/docs\/data_description)\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n> [\u7528\u6237\u8bc6\u522b\u89c4\u5219](https:\/\/docs.datatower.ai\/docs\/ji-chu-zhi-shi#a5173f2b27d6dc020d5f4637cdda1f7f)\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 `track` \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\n```Kotlin\nval acId = \"account_id_111\"\nval dt_id = \"dt_id_222\"\n\nval properties = mapOf(\n \"#app_id\" to \"appid_1234567890\",\n \"#bundle_id\" to \"com.example.app\",\n \"#os\" to \"android\",\n \"user_level\" to 20,\n \"coin\" to 1000,\n \"from\" to \"entry\"\n)\n\ndt.track(acId, dt_id, \"eventName\", properties)\n```\n\n\u6ce8\u610f\uff1a\n\n1. \u4ee5`#`\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167[\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027](https:\/\/docs.datatower.ai\/docs\/data_description)\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n2. \u4ee5`$`\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n### 3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n| \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| -------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set_once` \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_add` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_unset` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_append` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_uniq_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd |\n| \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u00a0`#user_delete` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0 |\n\n#### 3.2.1 userSet\n\n`userSet` \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n```Kotlin\nvar properties = mapOf(\"name\" to \"abc\")\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSet(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSet(acid, dt_id, properties)\n```\n\n#### 3.2.2 userSetOnce\n\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\n\n```Kotlin\nvar properties = mapOf(\"name\" to \"abc\")\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSetOnce(acid, dt_id, properties)\n\nproperties = mapOf(\"name\" to \"xyz\")\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSetOnce(acid, dt_id, properties)\n```\n\n#### 3.2.3 userAdd\n\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```Kotlin\nval properties = mapOf(\n\u00a0 \u00a0 \"total_count\" to 10,\n\u00a0 \u00a0 \"level\" to 3\n)\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties)\n\nval properties2 = mapOf(\"total_count\": 20)\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties2)\n```\n\n#### 3.2.4 userUnset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\n\n```Kotlin\nval delSet = mapOf(\"name\" to 0, \"actime_time\" to 0)\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.userUnset(acid, dt_id, delSet)\n```\n\n#### 3.2.5 userAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n```kotlin\nvar properties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"cat\", \"dog\")\n)\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties)\n\nproperties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"ratbbit\")\n)\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.userAppend(acid, dt_id, properties)\n```\n\n#### 3.2.6 userUniqAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\n\n```Kotlin\nvar properties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"cat\", \"dog\")\n)\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties)\n\nproperties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"ratbbit\", \"dot\")\n)\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.userUniqAppend(acid, dt_id, properties)\n```\n\n#### 3.2.7 userDelete\n\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 `userDelete` \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n```koltin\ndt.userDelete(acid, dt_id, mapOf())\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728`properties`\u4e2d\u6dfb\u52a0`#ip`\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\n\n```Kotlin\nproperties[\"#ip\"] = \"127.0.0.1\"\n```\n\n\n## \u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n> \u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a\n>\n> - DTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n\n### 5.1 DTLogConsumer\n\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\n1. log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n2. \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n3. log \u6587\u4ef6\u7684\u524d\u7f00\n4. \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\n```Kotlin\nval consumer = DTLogConsumer(\".\/log\", 200, \"dt\", 1000)\n# \u5f00\u542f debug \u6807\u5fd7\nval dt = DTAnalytics(consumer, true)\n# \u5173\u95ed debug \u6807\u5fd7\n#val dt = DTAnalytics(consumer, false)\n```\n\n### 5.2 \u63d0\u4ea4\u6570\u636e\n\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n\n```Kotlin\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush()\n```\n\n### 5.3 \u5173\u95ed SDK\n\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\n\n```Kotlin\ndt.close()\n```\n\n## \u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\n\n```Koltin\npackage org.example\n\nimport ai.datatower.sdk.*\n\nfun main() {\n DTAnalytics.preload()\n DTAnalytics.toggleLogger(true)\n val consumer = DTLogConsumer(\"log\", 1000, \"dt_java\", (10 * 1024 * 1024).toLong())\n val dt: DTAnalytics = DTAnalytics.init(consumer, true)\n DTAnalytics.toggleLogger(false)\n\n val properties: java.util.HashMap = java.util.HashMap()\n properties[\"productNames\"] = listOf(\"Java\", \"hello\")\n properties[\"productType\"] = \"Java book\"\n properties[\"producePrice\"] = 80\n properties[\"shop\"] = \"xx-shop\"\n properties[\"#os\"] = \"1.1.1.1\"\n properties[\"sex\"] = \"female\"\n properties[\"#app_id\"] = \"appid_1234567890\"\n properties[\"#bundle_id\"] = \"com.example\"\n\n dt.track(\"xxx\", null, \"eventName\", properties)\n\n dt.flush()\n dt.close()\n}\n```","pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\nGradle\n\n\u9879\u76ee build.gradle \u4e2d\u52a0\u5165\u6e90\uff1a\n\nrepositories {\n mavenCentral()\n maven { url 'https:\/\/jitpack.io' }\n}\n\n\n\u6a21\u5757 build.gradle \u4e2d\u52a0\u5165\u4f9d\u8d56\uff1a\n\ndependencies {\n implementation 'com.github.datatower-ai:dt-java-sdk:{\u6700\u65b0\u7248\u672c}'\n}\n\nMaven\n\n\u52a0\u5165\u6e90\uff1a\n\n\n \n jitpack.io<\/id>\n https:\/\/jitpack.io<\/url>\n <\/repository>\n<\/repositories>\n\n\n\u52a0\u5165\u4f9d\u8d56\uff1a\n\n\n com.github.datatower-ai<\/groupId>\n dt-java-sdk<\/artifactId>\n {\u6700\u65b0\u7248\u672c}<\/version>\n<\/dependency>\n\nsbt\n\n\u5728 build.sbt \u5c3e\u90e8\u6dfb\u52a0\uff1a\n\nresolvers += \"jitpack\" at \"https:\/\/jitpack.io\"\n\n\n\u6dfb\u52a0\u4f9d\u8d56\uff1a\n\nlibraryDependencies += \"com.github.datatower-ai\" % \"dt-java-sdk\" % \"{\u6700\u65b0\u7248\u672c}\"\n\nleiningen\n\n\u5728 project.clj \u5c3e\u90e8\u6dfb\u52a0\uff1a\n\n:repositories [[\"jitpack\" \"https:\/\/jitpack.io\"]]\n\n\n\u6dfb\u52a0\u4f9d\u8d56\uff1a\n\n:dependencies [[com.github.datatower-ai\/dt-java-sdk \"Tag\"]]\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\nimport ai.datatower.sdk.*\n\n\/\/ Outputs to \"log\" folder in execution path with file prefix \"dt_java\"\u00a0\n\/\/ for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n\/\/ (will be larger if size of a single event is over such limit).\nval consumer = DTLogConsumer(\"log\", 200, \"dt_java\", (10 * 1024 * 1024).toLong())\n\/\/ with debug: False\nval dt: DTAnalytics = DTAnalytics.init(consumer, false)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684\u6240\u6709\u63a5\u53e3\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n\n\u5982\u679c\u6821\u9a8c\u901a\u8fc7\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\u672a\u901a\u8fc7\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\n3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u6570\u636e\u8bf4\u660e\u6587\u6863\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n\u7528\u6237\u8bc6\u522b\u89c4\u5219\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 track \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\nval acId = \"account_id_111\"\nval dt_id = \"dt_id_222\"\n\nval properties = mapOf(\n \"#app_id\" to \"appid_1234567890\",\n \"#bundle_id\" to \"com.example.app\",\n \"#os\" to \"android\",\n \"user_level\" to 20,\n \"coin\" to 1000,\n \"from\" to \"entry\"\n)\n\ndt.track(acId, dt_id, \"eventName\", properties)\n\n\u6ce8\u610f\uff1a\n\n\u4ee5#\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\u4ee5$\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n\n\n \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n\n\n \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set_once \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_add \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_unset \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0\n #user_append \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_uniq_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd\n\n\n \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u00a0#user_delete\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n\n\n3.2.1 userSet\nuserSet \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\nvar properties = mapOf(\"name\" to \"abc\")\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSet(acid, dt_id, properties)\n\nproperties = { \"name\": \"xyz\" }\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSet(acid, dt_id, properties)\n\n3.2.2 userSetOnce\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\nvar properties = mapOf(\"name\" to \"abc\")\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSetOnce(acid, dt_id, properties)\n\nproperties = mapOf(\"name\" to \"xyz\")\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSetOnce(acid, dt_id, properties)\n\n3.2.3 userAdd\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\nval properties = mapOf(\n\u00a0 \u00a0 \"total_count\" to 10,\n\u00a0 \u00a0 \"level\" to 3\n)\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties)\n\nval properties2 = mapOf(\"total_count\": 20)\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties2)\n\n3.2.4 userUnset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\nval delSet = mapOf(\"name\" to 0, \"actime_time\" to 0)\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.userUnset(acid, dt_id, delSet)\n\n3.2.5 userAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\nvar properties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"cat\", \"dog\")\n)\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties)\n\nproperties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"ratbbit\")\n)\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.userAppend(acid, dt_id, properties)\n\n3.2.6 userUniqAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\nvar properties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"cat\", \"dog\")\n)\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties)\n\nproperties = mapOf(\n\u00a0 \u00a0 \"pet\" to listOf(\"ratbbit\", \"dot\")\n)\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.userUniqAppend(acid, dt_id, properties)\n\n3.2.7 userDelete\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 userDelete \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\ndt.userDelete(acid, dt_id, mapOf())\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728properties\u4e2d\u6dfb\u52a0#ip\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\nproperties[\"#ip\"] = \"127.0.0.1\"\n\n\u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n\u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a\n\nDTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n5.1 DTLogConsumer\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\nlog \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n\u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlog \u6587\u4ef6\u7684\u524d\u7f00\n\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\nval consumer = DTLogConsumer(\".\/log\", 200, \"dt\", 1000)\n# \u5f00\u542f debug \u6807\u5fd7\nval dt = DTAnalytics(consumer, true)\n# \u5173\u95ed debug \u6807\u5fd7\n#val dt = DTAnalytics(consumer, false)\n\n5.2 \u63d0\u4ea4\u6570\u636e\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush()\n\n5.3 \u5173\u95ed SDK\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\ndt.close()\n\n\u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\npackage org.example\n\nimport ai.datatower.sdk.*\n\nfun main() {\n DTAnalytics.preload()\n DTAnalytics.toggleLogger(true)\n val consumer = DTLogConsumer(\"log\", 1000, \"dt_java\", (10 * 1024 * 1024).toLong())\n val dt: DTAnalytics = DTAnalytics.init(consumer, true)\n DTAnalytics.toggleLogger(false)\n\n val properties: java.util.HashMap = java.util.HashMap()\n properties[\"productNames\"] = listOf(\"Java\", \"hello\")\n properties[\"productType\"] = \"Java book\"\n properties[\"producePrice\"] = 80\n properties[\"shop\"] = \"xx-shop\"\n properties[\"#os\"] = \"1.1.1.1\"\n properties[\"sex\"] = \"female\"\n properties[\"#app_id\"] = \"appid_1234567890\"\n properties[\"#bundle_id\"] = \"com.example\"\n\n dt.track(\"xxx\", null, \"eventName\", properties)\n\n dt.flush()\n dt.close()\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1715331485","update_time":"1733804640"},"pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\nGradle\n\n\u9879\u76ee build.gradle \u4e2d\u52a0\u5165\u6e90\uff1a\n\nrepositories {\n mavenCentral()\n maven { url 'https:\/\/jitpack.io' }\n}\n\n\n\u6a21\u5757 build.gradle \u4e2d\u52a0\u5165\u4f9d\u8d56\uff1a\n\ndependencies {"},{"id":"95579","string_id":"oUNNuv","status":"1","parent_id":"80676","slug":"Node-js","order":"1","name":"Node.js","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u6797\u51ef\u9f99","add_time":"1715331502","update_time":"1733804630","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"95579","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10 \n> \u26a0\ufe0f<\/span> \u6b64 SDK \u9700\u642d\u914d [FileScout](https:\/\/docs.datatower.ai\/docs\/FileScout-shi-yong-zhi-nan) \u4f7f\u7528\n\n[![NPM Version](https:\/\/img.shields.io\/npm\/v\/%40datatower-ai%2Fsdk-core-nodejs?style=for-the-badge&logo=npm&logoColor=231F20&labelColor=FB8113&color=E8DEFF)](https:\/\/www.npmjs.com\/package\/@datatower-ai\/sdk-core-nodejs)\n\n## \u4e00\u3001\u96c6\u6210 SDK\n\n1. NPM\n\n```Bash\nnpm i @datatower-ai\/sdk-core-nodejs\n```\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\n\n```JavaScript\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\")\n\n\/\/ Outputs to \"log\" folder in execution path with file prefix \"dt_nodejs\"\u00a0\n\/\/ for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n\/\/ (will be larger if size of a single event is over such limit).\nlet consumer = dt.Consumer.DTLogConsumer(\".\/log\", 200, \"dt_nodejs\", 10*1024*1024)\ndt.init(consumer, false)\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n> \u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684**\u6240\u6709\u63a5\u53e3**\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n> - \u5982\u679c\u6821\u9a8c**\u901a\u8fc7**\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n> - **\u672a\u901a\u8fc7**\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n### 3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n> [\u6570\u636e\u8bf4\u660e\u6587\u6863](https:\/\/docs.datatower.ai\/docs\/data_description)\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n> [\u7528\u6237\u8bc6\u522b\u89c4\u5219](https:\/\/docs.datatower.ai\/docs\/ji-chu-zhi-shi#a5173f2b27d6dc020d5f4637cdda1f7f)\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 `track` \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\n```TypeScript\nvar acId = \"account_id_111\";\nvar dt_id = \"dt_id_222\";\n\nvar properties = {\n \"#app_id\": \"appid_1234567890\",\n \"#bundle_id\": \"com.example.app\",\n \"#os\": \"android\",\n \"user_level\": 20,\n \"coin\": 1000,\n \"from\": \"entry\"\n};\n\ndt.track(acId, dt_id, \"eventName\", properties);\n```\n\n\u6ce8\u610f\uff1a\n\n1. \u4ee5`#`\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167[\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027](https:\/\/docs.datatower.ai\/docs\/data_description)\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n2. \u4ee5`$`\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n### 3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n| \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0| \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| -------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set_once` \u00a0 \u00a0| \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_add` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0|\n| \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_unset` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0|\n| \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_append` \u00a0 \u00a0 \u00a0| \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_uniq_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd |\n| \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0| \u00a0`#user_delete` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n#### 3.2.1 userSet\n\n`userSet` \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n```TypeScript\nproperties = { \"name\": \"abc\" };\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSet(acid, dt_id, properties);\n\nproperties = { \"name\": \"xyz\" };\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSet(acid, dt_id, properties);\n```\n\n#### 3.2.2 userSetOnce\n\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\n\n```TypeScript\nproperties = { \"name\": \"abc\" };\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSetOnce(acid, dt_id, properties);\n\nproperties = { \"name\": \"xyz\" };\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSetOnce(acid, dt_id, properties);\n```\n\n#### 3.2.3 userAdd\n\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```TypeScript\nproperties = {\n\u00a0 \u00a0 \"total_count\": 10,\n\u00a0 \u00a0 \"level\": 3\n};\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties);\n\nproperties = { \"total_count\": 20 };\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties);\n```\n\n#### 3.2.4 userUnset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\n\n```TypeScript\ndel_set = { \"name\": 0, \"actime_time\": 0 };\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.userUnset(acid, dt_id, del_set);\n```\n\n#### 3.2.5 userAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n```TypeScript\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n};\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties);\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\"]\n};\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.userAppend(acid, dt_id, properties);\n```\n\n#### 3.2.6 userUniqAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\n\n```TypeScript\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n};\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties);\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\", \"dot\"]\n};\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.userUniqAppend(acid, dt_id, properties);\n```\n\n#### 3.2.7 userDelete\n\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 `userDelete` \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n```TypeScript\ndt.userDelete(acid, dt_id, {});\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728`properties`\u4e2d\u6dfb\u52a0`#ip`\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\n\n```TypeScript\nproperties[\"#ip\"] = \"127.0.0.1\"\n```\n\n## \u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n> \u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a \u00a0\n> - DTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n\n### 5.1 DTLogConsumer\n\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n1. log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n2. \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n4. log \u6587\u4ef6\u7684\u524d\u7f00\n3. \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\n```JavaScript\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\");\n\nlet consumer = dt.Consumer.DTLogConsumer(\"log\", 200, \"dt_nodejs\", 10*1024*1024);\n# \u5f00\u542f debug \u6807\u5fd7\ndt.init(consumer, true);\n# \u5173\u95ed debug \u6807\u5fd7\n# dt.init(consumer, false);\n```\n\n### 5.2 \u63d0\u4ea4\u6570\u636e\n\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n\n```TypeScript\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush();\n```\n\n### 5.3 \u5173\u95ed SDK\n\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\n\n```TypeScript\ndt.close();\n```\n\n## \u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\n\n```JavaScript\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\");\n\nt.toggleLogger(true);\nlet consumer = dt.Consumer.DTLogConsumer(\"log\", 1000, \"dt_nodejs\", 10*1024*1024)\ndt.init(consumer);\ndt.toggleLogger(false);\n\nlet dt_id = \"1234567890987654321\"\nlet acid = \"\"\n\nlet properties = {}\nproperties[\"productNames\"] = [\"Node\", \"hello\"]\nproperties[\"productType\"] = \"Node book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"xx-shop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"sex\"] = 'female'\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\ndt.track(dt_id, acid, \"eventName\", properties)\n\ndt.flush();\ndt.close();\n```","pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\nNPM\n\nnpm i @datatower-ai\/sdk-core-nodejs\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\")\n\n\/\/ Outputs to \"log\" folder in execution path with file prefix \"dt_nodejs\"\u00a0\n\/\/ for every 200 events, the ideal maximum size for each log file is 10MB\u00a0\n\/\/ (will be larger if size of a single event is over such limit).\nlet consumer = dt.Consumer.DTLogConsumer(\".\/log\", 200, \"dt_nodejs\", 10*1024*1024)\ndt.init(consumer, false)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684\u6240\u6709\u63a5\u53e3\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n\n\u5982\u679c\u6821\u9a8c\u901a\u8fc7\u4f1a\u8fd4\u56de true\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\u672a\u901a\u8fc7\u5219\u4f1a\u8fd4\u56de false\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\n3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u6570\u636e\u8bf4\u660e\u6587\u6863\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n\u7528\u6237\u8bc6\u522b\u89c4\u5219\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\n\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 track \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\nvar acId = \"account_id_111\";\nvar dt_id = \"dt_id_222\";\n\nvar properties = {\n \"#app_id\": \"appid_1234567890\",\n \"#bundle_id\": \"com.example.app\",\n \"#os\": \"android\",\n \"user_level\": 20,\n \"coin\": 1000,\n \"from\": \"entry\"\n};\n\ndt.track(acId, dt_id, \"eventName\", properties);\n\n\u6ce8\u610f\uff1a\n\n\u4ee5#\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\u4ee5$\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n\n\n \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n\n\n \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set_once \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_add \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_unset \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0\n #user_append \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_uniq_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd\n\n\n \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u00a0#user_delete\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n\n\n3.2.1 userSet\nuserSet \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\nproperties = { \"name\": \"abc\" };\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSet(acid, dt_id, properties);\n\nproperties = { \"name\": \"xyz\" };\n# \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSet(acid, dt_id, properties);\n\n3.2.2 userSetOnce\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\nproperties = { \"name\": \"abc\" };\n# \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.userSetOnce(acid, dt_id, properties);\n\nproperties = { \"name\": \"xyz\" };\n# \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.userSetOnce(acid, dt_id, properties);\n\n3.2.3 userAdd\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\nproperties = {\n\u00a0 \u00a0 \"total_count\": 10,\n\u00a0 \u00a0 \"level\": 3\n};\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties);\n\nproperties = { \"total_count\": 20 };\n# \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.userAdd(acid, dt_id, properties);\n\n3.2.4 userUnset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\ndel_set = { \"name\": 0, \"actime_time\": 0 };\n# \u8bbe\u7f6e\u540e\uff0c\u4f1a\u5220\u9664 name \u548c actime_time \u4e24\u4e2a\u7528\u6237\u5c5e\u6027\ndt.userUnset(acid, dt_id, del_set);\n\n3.2.5 userAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n};\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties);\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\"]\n};\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.userAppend(acid, dt_id, properties);\n\n3.2.6 userUniqAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"cat\", \"dog\"]\n};\n# \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.userSet(acid, dt_id, properties);\n\nproperties = {\n\u00a0 \u00a0 \"pet\": [\"ratbbit\", \"dot\"]\n};\n# \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.userUniqAppend(acid, dt_id, properties);\n\n3.2.7 userDelete\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 userDelete \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\ndt.userDelete(acid, dt_id, {});\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728properties\u4e2d\u6dfb\u52a0#ip\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\nproperties[\"#ip\"] = \"127.0.0.1\"\n\n\u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n\u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a \u00a0\n\nDTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n5.1 DTLogConsumer\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\nlog \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n\u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlog \u6587\u4ef6\u7684\u524d\u7f00\n\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\");\n\nlet consumer = dt.Consumer.DTLogConsumer(\"log\", 200, \"dt_nodejs\", 10*1024*1024);\n# \u5f00\u542f debug \u6807\u5fd7\ndt.init(consumer, true);\n# \u5173\u95ed debug \u6807\u5fd7\n# dt.init(consumer, false);\n\n5.2 \u63d0\u4ea4\u6570\u636e\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n# \u7acb\u5373\u4e0a\u62a5\u6570\u636e\ndt.flush();\n\n5.3 \u5173\u95ed SDK\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\ndt.close();\n\n\u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\");\n\nt.toggleLogger(true);\nlet consumer = dt.Consumer.DTLogConsumer(\"log\", 1000, \"dt_nodejs\", 10*1024*1024)\ndt.init(consumer);\ndt.toggleLogger(false);\n\nlet dt_id = \"1234567890987654321\"\nlet acid = \"\"\n\nlet properties = {}\nproperties[\"productNames\"] = [\"Node\", \"hello\"]\nproperties[\"productType\"] = \"Node book\"\nproperties[\"producePrice\"] = 80\nproperties[\"shop\"] = \"xx-shop\"\nproperties[\"#os\"] = \"1.1.1.1\"\nproperties[\"sex\"] = 'female'\nproperties[\"#app_id\"] = \"appid_1234567890\"\nproperties[\"#bundle_id\"] = \"com.example\"\n\ndt.track(dt_id, acid, \"eventName\", properties)\n\ndt.flush();\ndt.close();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1715331502","update_time":"1733804630"},"pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\nNPM\n\nnpm i @datatower-ai\/sdk-core-nodejs\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\nvar dt = require(\"@datatower-ai\/sdk-core-nodejs\")\n\n\/\/ Outputs to \"log\" folder in exec"},{"id":"126234","string_id":"xVtz4V","status":"1","parent_id":"80676","slug":"Go","order":"0","name":"Go","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u6797\u51ef\u9f99","add_time":"1721707037","update_time":"1733804635","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"126234","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10 \n> \u26a0\ufe0f<\/span> \u6b64 SDK \u9700\u642d\u914d [FileScout](https:\/\/docs.datatower.ai\/docs\/FileScout-shi-yong-zhi-nan) \u4f7f\u7528\n\n[![GitHub Tag](https:\/\/img.shields.io\/github\/v\/tag\/datatower-ai\/dt-golang-sdk?filter=!*-alpha*&style=flat-square&logo=GO&logoColor=FFFFFF&label=Go%20SDK&labelColor=007D9C&color=253443&link=https%3A%2F%2Fpkg.go.dev%2Fgithub.com%2Fdatatower-ai%2Fdt-golang-sdk)](https:\/\/pkg.go.dev\/github.com\/datatower-ai\/dt-golang-sdk)\n\n## \u4e00\u3001\u96c6\u6210 SDK\n\n### \u547d\u4ee4\u884c\n\n- \u83b7\u53d6 SDK\n\n```bash\ngo get github.com\/datatower-ai\/dt-golang-sdk\n```\n\n- \u66f4\u65b0 SDK\n\n```bash\ngo get -u github.com\/datatower-ai\/dt-golang-sdk\n```\n\n### Module\n\n1. \u5728\u4ee3\u7801\u5f00\u5934\u5f15\u5165 SDK\n\n```go\nimport \"github.com\/datatower-ai\/dt-golang-sdk\"\n```\n\n2. \u7528\u547d\u4ee4\u884c\u62c9\u53d6 SDK\n\n```bash\ngo mod tidy\n```\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\n\n```go\nimport \"github.com\/datatower-ai\/dt-golang-sdk\"\n\npath := \"log\/\"\t\t\t\/\/ log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\nmaxBatchLen := 1000\t\t\/\/ \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlogPrefix := \"my_project\"\t\/\/ log \u6587\u4ef6\u7684\u524d\u7f00\nmaxLogSize := 0\t\t\t\/\/ \u7406\u8bba\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\ndebug := false \/\/ \u662f\u5426\u4e3a debug \n\nconsumer := dtAnalytics.NewDTLogConsumer(path, maxBatchLen, logPrefix, maxLogSize)\ndt, _ := dtAnalytics.New(consumer, debug)\n\ndtAnalytics.ToggleLogger(true) \t\/\/ \u5982\u9700\u5f00\u542f Logger\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n> \u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684**\u6240\u6709\u63a5\u53e3**\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n>\n> - \u5982\u679c\u6821\u9a8c**\u901a\u8fc7**\u4f1a\u8fd4\u56de `nil`\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n> - **\u672a\u901a\u8fc7**\u5219\u4f1a\u8fd4\u56de `error`\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n### 3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n> [\u6570\u636e\u8bf4\u660e\u6587\u6863](https:\/\/docs.datatower.ai\/docs\/data_description)\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n> [\u7528\u6237\u8bc6\u522b\u89c4\u5219](https:\/\/docs.datatower.ai\/docs\/ji-chu-zhi-shi#a5173f2b27d6dc020d5f4637cdda1f7f)\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\nT\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 `Track` \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\n```go\ndtId := \"dt_id\"\nacid := \"\"\neventName := \"sample_event\"\nproperties := map[string]interface{}{\n\t\"productName\": \"Book A\"\n}\n\nerr := dt.Track(dtId, acid, eventName, properties)\n\nif err != nil {\n\t\/\/ \u5904\u7406\u5931\u8d25 ...\n}\n```\n\n\u6ce8\u610f\uff1a\n\n1. \u4ee5`#`\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167[\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027](https:\/\/docs.datatower.ai\/docs\/data_description)\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n2. \u4ee5`$`\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n### 3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n| \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| -------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_set_once` \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_add` \u00a0 \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_unset` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0 | `#user_append` \u00a0 \u00a0 \u00a0 | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 |\n| \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 | `#user_uniq_append` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd |\n| \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 | \u00a0`#user_delete` | \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0 |\n\n#### 3.2.1 userSet\n\n`UserSet` \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\n\n```go\nproperties := map[string]interface{}{ \"name\": \"abc\" }\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"name\": \"xyz\" }\n\/\/ \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.UserSet(acid, dtId, properties2)\n```\n\n#### 3.2.2 userSetOnce\n\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `UserSetOnce` \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\n\n```go\nproperties := map[string]interface{}{ \"name\": \"abc\" }\n\/\/ \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.UserSetOnce(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"name\": \"xyz\" }\n\/\/ \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.UserSetOnce(acid, dtId, properties2)\n```\n\n#### 3.2.3 userAdd\n\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `UserAdd` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```go\nproperties := map[string]interface{}{\n \"total_count\": 10,\n \"level\": 3\n}\n\/\/ \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.UserAdd(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"total_count\": 20 }\n\/\/ \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.UserAdd(acid, dtId, properties2)\n```\n\n#### 3.2.4 userUnset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `UserUnset` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\n\n```go\ndelSet := map[string]interface{}{\n \"name\": 0,\n \"actime_time\": 0\n}\ndt.UserUnset(acid, dtId, delSet)\n```\n\n#### 3.2.5 userAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `UserAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\n\n```go\nproperties := map[string]interface{}{\n \"pet\": []string{\"cat\", \"dog\"}\n}\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{\n \"pet\": []string{\"ratbbit\"}\n}\n\/\/ \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.UserAppend(acid, dtId, properties2)\n```\n\n#### 3.2.6 userUniqAppend\n\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 `UserUniqAppend` \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\n\n```go\nproperties := map[string]interface{}{\n \"pet\": []string{\"cat\", \"dog\"}\n}\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{\n \"pet\": []string{\"ratbbit\", \"dot\"}\n}\n\/\/ \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.UserUniqAppend(acid, dtId, properties2)\n```\n\n#### 3.2.7 userDelete\n\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 `UserDelete` \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\n\n```go\ndt.UserDelete(acid, dtId, make(map[string]interface{}))\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728`properties`\u4e2d\u6dfb\u52a0`#ip`\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\n\n```go\nproperties := map[string]interface{}{\n\t\"#ip\": \"127.0.0.1\"\n}\n```\n\n## \u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n> \u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a\n>\n> - DTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n\n### 5.1 DTLogConsumer\n\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\n1. log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n2. \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\n3. log \u6587\u4ef6\u7684\u524d\u7f00\n4. \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\n```go\npath := \"log\/\"\t\t\t\/\/ log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\nmaxBatchLen := 1000\t\t\/\/ \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlogPrefix := \"my_project\"\t\/\/ log \u6587\u4ef6\u7684\u524d\u7f00\nmaxLogSize := 0\t\t\t\/\/ \u7406\u8bba\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\nconsumer := dtAnalytics.NewDTLogConsumer(path, maxBatchLen, logPrefix, maxLogSize)\n\n\/\/ \u521d\u59cb\u5316\uff0cdebug\uff1atrue\ndt, _ := dtAnalytics.New(consumer, true)\n\n\/\/ \u521d\u59cb\u5316\uff0cdebug\uff1afalse\n\/\/ dt, _ := dtAnalytics.New(consumer, false)\n```\n\n### 5.2 \u63d0\u4ea4\u6570\u636e\n\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\n\n```go\ndt.Flush()\n```\n\n### 5.3 \u5173\u95ed SDK\n\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\n\n```go\ndt.Close()\n```\n\n## \u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\tdtAnalytics \"github.com\/datatower-ai\/dt-golang-sdk\"\n)\n\nfunc main() {\n\tdtAnalytics.ToggleLogger(true)\n\tconsumer := dtAnalytics.NewDTLogConsumer(\"log\", 1000, \"dt_go_demo\", 0)\n\tdt, _ := dtAnalytics.New(consumer, true)\n\tdtAnalytics.ToggleLogger(false)\n\n\tproperties := map[string]interface{}{\n\t\t\"productNames\": []string{\"Lua\", \"hello\"},\n\t\t\"productType\": \"Lua book\",\n\t\t\"producePrice\": 80,\n\t\t\"shop\": \"xx-shop\",\n\t\t\"#os\": \"1.1.1.1\",\n\t\t\"sex\": \"female\",\n\t\t\"#app_id\": \"appid_1234567890\",\n\t\t\"#bundle_id\": \"com.example\",\n\t}\n\n err := dt.Track(\"the_dt_id\", \"acid123456789\", \"simple_event\", properties)\n if err != nil {\n println(err)\n }\n\n dt.Flush()\n dt.Close()\n}\n```","pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\u547d\u4ee4\u884c\n\n\u83b7\u53d6 SDK\n\ngo get github.com\/datatower-ai\/dt-golang-sdk\n\n\n\u66f4\u65b0 SDK\n\ngo get -u github.com\/datatower-ai\/dt-golang-sdk\n\nModule\n\n\u5728\u4ee3\u7801\u5f00\u5934\u5f15\u5165 SDK\n\nimport \"github.com\/datatower-ai\/dt-golang-sdk\"\n\n\n\u7528\u547d\u4ee4\u884c\u62c9\u53d6 SDK\n\ngo mod tidy\n\n\u4e8c\u3001\u521d\u59cb\u5316\nSDK \u521d\u59cb\u5316\u793a\u4f8b\u4ee3\u7801\nimport \"github.com\/datatower-ai\/dt-golang-sdk\"\n\npath := \"log\/\"\t\t\t\/\/ log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\nmaxBatchLen := 1000\t\t\/\/ \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlogPrefix := \"my_project\"\t\/\/ log \u6587\u4ef6\u7684\u524d\u7f00\nmaxLogSize := 0\t\t\t\/\/ \u7406\u8bba\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\ndebug := false \/\/ \u662f\u5426\u4e3a debug \n\nconsumer := dtAnalytics.NewDTLogConsumer(path, maxBatchLen, logPrefix, maxLogSize)\ndt, _ := dtAnalytics.New(consumer, debug)\n\ndtAnalytics.ToggleLogger(true) \t\/\/ \u5982\u9700\u5f00\u542f Logger\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u4e8b\u4ef6\u4e0a\u62a5\u548c\u7528\u6237\u5c5e\u6027\u7684\u6240\u6709\u63a5\u53e3\u4f1a\u5bf9\u4e8b\u4ef6\u540d\/\u5c5e\u6027\u540d\/\u7c7b\u578b\u8fdb\u884c\u6821\u9a8c\n\n\u5982\u679c\u6821\u9a8c\u901a\u8fc7\u4f1a\u8fd4\u56de nil\uff0c\u5e76\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\u672a\u901a\u8fc7\u5219\u4f1a\u8fd4\u56de error\uff0c\u4e0d\u8fdb\u884c\u8bb0\u5f55\u4e0a\u62a5\n\n\n3.1 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u6570\u636e\u8bf4\u660e\u6587\u6863\uff1a\u5f53\u60a8\u5c06\u8981\u4e0a\u62a5\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u5728\u6570\u636e\u8bf4\u660e\u6587\u6863\u4e2d\u5df2\u5b58\u5728\u65f6\uff0c\u5f3a\u70c8\u5efa\u8bae\u60a8\u4f7f\u7528\u6587\u6863\u4e2d\u7684\u5bf9\u5e94\u5c5e\u6027\u540d\uff0c\u6bd4\u5982\u60a8\u8981\u4e0a\u62a5 APP \u7684\u64cd\u4f5c\u7cfb\u7edf\u5c5e\u6027\uff0c\u8bf7\u4f7f\u7528\u6587\u6863\u91cc\u9884\u7f6e\u7684\u5c5e\u6027\u540d\u201d#os\u201d\uff0c\u4e0d\u8981\u81ea\u5b9a\u4e49\u53d6\u540d\uff0c\u907f\u514d\u8ddf\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u9884\u7f6e\u5c5e\u6027\u4e0d\u4e00\u81f4\u00a0\n\u7528\u6237\u8bc6\u522b\u89c4\u5219\uff1a\u4e3a\u4e86\u8ba9\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e0e\u5e10\u53f7 ID\uff08acid\uff09\u80fd\u591f\u987a\u5229\u7ed1\u5b9a\uff0c\u5176\u4e2d\u8bbf\u5ba2 ID\uff08dt_id\uff09\u4e3a\u5fc5\u586b\nT\n\u8be5\u63a5\u53e3\u662f\u4f7f\u7528\u6700\u9891\u7e41\u7684\u63a5\u53e3\uff0c\u901a\u8fc7\u8c03\u7528 Track \u6765\u4e0a\u62a5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u5728\u4e0a\u62a5\u4e8b\u4ef6\u4e4b\u524d\uff0c\u5efa\u8bae\u60a8\u6839\u636e\u68b3\u7406\u7684\u6587\u6863\u6765\u8bbe\u7f6e\u4e8b\u4ef6\u5c5e\u6027\uff0c\u4ee5\u4e0b\u662f\u793a\u4f8b\u4ee3\u7801\uff1a\n\ndtId := \"dt_id\"\nacid := \"\"\neventName := \"sample_event\"\nproperties := map[string]interface{}{\n\t\"productName\": \"Book A\"\n}\n\nerr := dt.Track(dtId, acid, eventName, properties)\n\nif err != nil {\n\t\/\/ \u5904\u7406\u5931\u8d25 ...\n}\n\n\u6ce8\u610f\uff1a\n\n\u4ee5#\u5f00\u5934\u547d\u540d\u7684\u4e8b\u4ef6\/\u5c5e\u6027\uff0c\u5fc5\u987b\u6309\u7167\u9884\u7f6e\u4e8b\u4ef6\/\u5c5e\u6027\u89c4\u5219\u8fdb\u884c\u4e0a\u62a5\uff0c\u5426\u5219\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\u4ee5$\u5f00\u5934\u7684\u4e8b\u4ef6\/\u5c5e\u6027\u90fd\u88ab\u89c6\u4e3a\u975e\u6cd5\u5b57\u6bb5\uff0c\u5c06\u65e0\u6cd5\u4e0a\u62a5\n\n3.2 \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\nDT \u7cfb\u7edf\u652f\u6301\u7684\u7528\u6237\u5c5e\u6027\u8bbe\u7f6e\u7c7b\u578b\u603b\u89c8\u8bf4\u660e\u5982\u4e0b\n\n\n\n \u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u5e94\u4e8b\u4ef6\u540d \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u5904\u7406\u89c4\u5219 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n\n\n \u8986\u76d6\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u8986\u76d6\u7528\u6237\u7684\u539f\u6709\u5c5e\u6027\u503c\uff0c\u5982\u679c\u4e4b\u524d\u4e0d\u5b58\u5728\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u5219\u4f1a\u65b0\u5efa\u8be5\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u8986\u76d6\u64cd\u4f5c\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_set_once \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u521d\u59cb\u5316\u7528\u6237\u5c5e\u6027\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u5df2\u6709\u503c\u5b58\u5728\uff0c\u7cfb\u7edf\u5ffd\u7565\u672c\u6b21\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u7d2f\u52a0\u7528\u6237\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_add \u00a0 \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u6570\u503c\u578b\u7684\u7528\u6237\u5c5e\u6027\u505a\u7d2f\u52a0\u8ba1\u7b97\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c 0 \u540e\u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u503c \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n #user_unset \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u7684\u5c5e\u6027\u503c\uff0c\u5373\u8bbe\u7f6e\u6210 NULL\uff0c\u5982\u679c\u88ab\u6e05\u7a7a\u7684\u5c5e\u6027\u4e0d\u5b58\u5728\u4e5f\u4e0d\u4f1a\u65b0\u5efa\u8be5\u5c5e\u6027 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5217\u8868\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20 \u00a0 \u00a0 \u00a0 \u00a0\n #user_append \u00a0 \u00a0 \u00a0\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n\n\n \u8ffd\u52a0\u5e76\u53bb\u91cd\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u7684\u5143\u7d20\n #user_uniq_append\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u5c5e\u6027\u503c\u8ffd\u52a0\u5143\u7d20\uff0c\u5e76\u4f1a\u8fdb\u884c\u4e00\u6b21\u5168\u5217\u8868\u53bb\u91cd\uff08\u53bb\u91cd\u4fdd\u8bc1\u524d\u540e\u539f\u6709\u7684\u5143\u7d20\u987a\u5e8f\u4e0d\u53d8\uff09\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u518d\u53bb\u91cd\n\n\n \u5220\u9664\u7528\u6237 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\n \u00a0#user_delete\n \u5bf9\u7528\u6237\u8868\u8fdb\u884c\u64cd\u4f5c\uff0c\u5220\u9664\u5bf9\u5e94\u7528\u6237\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\u00a0\n\n\n\n3.2.1 userSet\nUserSet \u662f\u5e38\u7528\u7684\u529f\u80fd\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528\u5b83\u6765\u8fdb\u884c\u7528\u6237\u5c5e\u6027\u7684\u8bbe\u7f6e\uff0c\u8c03\u7528\u8be5\u64cd\u4f5c\u65f6\uff0c\u4f1a\u8986\u76d6\u539f\u6709\u7684\u5c5e\u6027\u503c\uff0c\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u8be5\u5c5e\u6027\uff0c\u5219\u4f1a\u521b\u5efa\u65b0\u7528\u6237\u5c5e\u6027\uff0c\u7c7b\u578b\u4e0e\u4f20\u5165\u5c5e\u6027\u7684\u7c7b\u578b\u4e00\u81f4\nproperties := map[string]interface{}{ \"name\": \"abc\" }\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"name\": \"xyz\" }\n\/\/ \u518d\u6b21\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.UserSet(acid, dtId, properties2)\n\n3.2.2 userSetOnce\n\u5982\u679c\u60a8\u5e0c\u671b\u7528\u6237\u5c5e\u6027\u53ea\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 UserSetOnce \u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u6ca1\u6709\u503c\u65f6\uff0c\u5219\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\u5e76\u8d4b\u503c\uff0c\u4f46\u8be5\u5c5e\u6027\u5df2\u7ecf\u6709\u503c\u65f6\uff0c\u5c06\u4e0d\u4f1a\u8bbe\u7f6e\u6210\u529f\nproperties := map[string]interface{}{ \"name\": \"abc\" }\n\/\/ \u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\"name\" \u7684\u503c\u4e3a \"abc\"\ndt.UserSetOnce(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"name\": \"xyz\" }\n\/\/ \u518d\u6b21\u4e00\u6b21\u6027\u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6b64\u65f6 \"name\" \u7684\u503c\u4e0d\u4f1a\u88ab\u8986\u76d6\u4e3a \"xyz\"\ndt.UserSetOnce(acid, dtId, properties2)\n\n3.2.3 userAdd\n\u5f53\u60a8\u8981\u5bf9\u6570\u503c\u7c7b\u578b\u7684\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 UserAdd \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u5219\u4f1a\u8d4b\u503c\u4e3a 0 \u518d\u8fdb\u884c\u8ba1\u7b97\uff0c\u53ef\u4f20\u5165\u8d1f\u503c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\nproperties := map[string]interface{}{\n \"total_count\": 10,\n \"level\": 3\n}\n\/\/ \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u7531\u4e8e\u8be5\u5c5e\u6027\u8fd8\u6ca1\u6709\u88ab\u8bbe\u7f6e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 10,\"level\" \u7684\u503c\u4e3a 3\ndt.UserAdd(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{ \"total_count\": 20 }\n\/\/ \u5bf9\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6 \"total_count\" \u7684\u503c\u4e3a 30, \"level\" \u7684\u503c\u4e3a 3\ndt.UserAdd(acid, dtId, properties2)\n\n3.2.4 userUnset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u5c5e\u6027\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 UserUnset \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u5c5e\u6027\u5b58\u5728\uff0c\u5219\u4f1a\u5220\u9664\u5c5e\u6027\uff0c\u5982\u679c\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u5219\u4e0d\u4f1a\u505a\u4efb\u4f55\u64cd\u4f5c\ndelSet := map[string]interface{}{\n \"name\": 0,\n \"actime_time\": 0\n}\ndt.UserUnset(acid, dtId, delSet)\n\n3.2.5 userAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 UserAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\nproperties := map[string]interface{}{\n \"pet\": []string{\"cat\", \"dog\"}\n}\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{\n \"pet\": []string{\"ratbbit\"}\n}\n\/\/ \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit\"]\ndt.UserAppend(acid, dtId, properties2)\n\n3.2.6 userUniqAppend\n\u5f53\u60a8\u8981\u8ffd\u52a0\u5217\u8868\u7c7b\u578b\u7528\u6237\u5c5e\u6027\u5143\u7d20\u5e76\u53bb\u91cd\u65f6\uff0c\u53ef\u4ee5\u8c03\u7528 UserUniqAppend \u6765\u5b9e\u73b0\uff0c\u5982\u679c\u88ab\u8ffd\u52a0\u7684\u5217\u8868\u5c5e\u6027\u4e0d\u5b58\u5728\uff0c\u7cfb\u7edf\u5c06\u81ea\u52a8\u751f\u6210\u5e76\u8fdb\u884c\u8ffd\u52a0\u548c\u53bb\u91cd\nproperties := map[string]interface{}{\n \"pet\": []string{\"cat\", \"dog\"}\n}\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\"]\ndt.UserSet(acid, dtId, properties)\n\nproperties2 := map[string]interface{}{\n \"pet\": []string{\"ratbbit\", \"dot\"}\n}\n\/\/ \u5bf9\u7528\u6237\u5217\u8868\u7c7b\u578b\u5c5e\u6027\u8ffd\u52a0\u5143\u7d20\u5e76\u53bb\u91cd\uff0c\u6570\u636e\u4e0a\u4f20\u5b8c\u6210\u540e\uff0c\u6b64\u65f6\u7528\u6237\u5c5e\u6027 \"pet\" \u7684\u503c\u4e3a [\"cat\", \"dog\", \"rabbit]\ndt.UserUniqAppend(acid, dtId, properties2)\n\n3.2.7 userDelete\n\u5982\u679c\u60a8\u8981\u5220\u9664\u67d0\u4e2a\u7528\u6237\uff0c\u53ef\u4ee5\u8c03\u7528 UserDelete \u5c06\u8fd9\u540d\u7528\u6237\u5220\u9664\uff0c\u60a8\u5c06\u65e0\u6cd5\u518d\u67e5\u8be2\u8be5\u540d\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\uff0c\u4f46\u8be5\u7528\u6237\u4ea7\u751f\u7684\u4e8b\u4ef6\u4ecd\u7136\u53ef\u4ee5\u88ab\u67e5\u8be2\u5230\ndt.UserDelete(acid, dtId, make(map[string]interface{}))\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u8bbe\u7f6e\u7528\u6237ip\u5730\u5740\n\u5728\u670d\u52a1\u7aef\u4e0a\u62a5\u6570\u636e\u65f6\uff0c\u5982\u679c\u60a8\u60f3\u8bbe\u7f6e\u7528\u6237\u7684ip\u5730\u5740,\u53ef\u4ee5\u901a\u8fc7\u5728properties\u4e2d\u6dfb\u52a0#ip\u5c5e\u6027\uff0cDT\u4f1a\u6839\u636e\u60a8\u4e0a\u62a5\u7684IP\u5730\u5740\u89e3\u6790\u7528\u6237\u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f\n\u6ce8\uff1a\u5982\u679c\u662f\u7528\u6237\u4e8b\u4ef6\uff0c\u4ec5userSetOnce\u53ef\u4e0a\u62a5#ip\u5c5e\u6027\nproperties := map[string]interface{}{\n\t\"#ip\": \"127.0.0.1\"\n}\n\n\u4e94\u3001\u6570\u636e\u4f20\u8f93\n\n\u53ef\u80fd\u4f7f\u7528\u7684\u6570\u636e\u4f20\u8f93\u65b9\u5f0f\uff1a\n\nDTLogConsumer\uff1a\u5199\u5165\u6587\u4ef6 + \u901a\u8fc7 FileScout \u4f20\u8f93\n\n\n\u5982\u679c\u751f\u4ea7\u7684\u6570\u636e\u90fd\u662f\u8c03\u8bd5\u6570\u636e\uff0c\u5efa\u8bae\u60a8\u5f00\u542f debug \u6807\u5fd7\uff0c\u5f53 debug \u6807\u5fd7\u5f00\u542f\u65f6\uff0c\u6570\u636e\u5c06\u4e0d\u4f1a\u8fdb\u5165\u751f\u4ea7\u73af\u5883\n5.1 DTLogConsumer\n\u53c2\u6570\uff08\u6309\u987a\u5e8f\uff09\uff1a\n\nlog \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\n\u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlog \u6587\u4ef6\u7684\u524d\u7f00\n\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\npath := \"log\/\"\t\t\t\/\/ log \u6587\u4ef6\u7684\u6587\u4ef6\u5939\u8def\u5f84\nmaxBatchLen := 1000\t\t\/\/ \u6700\u5927\u5355\u6b21\u5199\u5165\u6761\u6570\nlogPrefix := \"my_project\"\t\/\/ log \u6587\u4ef6\u7684\u524d\u7f00\nmaxLogSize := 0\t\t\t\/\/ \u7406\u8bba\u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f\uff08\u5355\u4f4d\uff1aByte\uff09\n\nconsumer := dtAnalytics.NewDTLogConsumer(path, maxBatchLen, logPrefix, maxLogSize)\n\n\/\/ \u521d\u59cb\u5316\uff0cdebug\uff1atrue\ndt, _ := dtAnalytics.New(consumer, true)\n\n\/\/ \u521d\u59cb\u5316\uff0cdebug\uff1afalse\n\/\/ dt, _ := dtAnalytics.New(consumer, false)\n\n5.2 \u63d0\u4ea4\u6570\u636e\n\u5982\u679c\u60a8\u671f\u671b\u6570\u636e\u7acb\u5373\u4e0a\u62a5\u5230 DT \u670d\u52a1\u5668\uff0c\u53ef\u4ee5\u901a\u8fc7 flsuh \u5b8c\u6210\ndt.Flush()\n\n5.3 \u5173\u95ed SDK\n\u8bf7\u5728\u9000\u51fa\u7a0b\u5e8f\u524d\u8c03\u7528\u672c\u63a5\u53e3\uff0c\u4ee5\u907f\u514d\u7f13\u5b58\u7684\u6570\u636e\u4e22\u5931\uff08\u91cd\u8981\uff01)\ndt.Close()\n\n\u516d\u3001\u5b8c\u6574\u793a\u4f8b\n\u4ece SDK \u521d\u59cb\u5316\u3001\u4e0a\u62a5\u5230\u5173\u95ed\uff0c\u6574\u4e2a\u4e0a\u62a5\u6d41\u7a0b\u793a\u4f8b\npackage main\n\nimport (\n\t\"fmt\"\n\tdtAnalytics \"github.com\/datatower-ai\/dt-golang-sdk\"\n)\n\nfunc main() {\n\tdtAnalytics.ToggleLogger(true)\n\tconsumer := dtAnalytics.NewDTLogConsumer(\"log\", 1000, \"dt_go_demo\", 0)\n\tdt, _ := dtAnalytics.New(consumer, true)\n\tdtAnalytics.ToggleLogger(false)\n\n\tproperties := map[string]interface{}{\n\t\t\"productNames\": []string{\"Lua\", \"hello\"},\n\t\t\"productType\": \"Lua book\",\n\t\t\"producePrice\": 80,\n\t\t\"shop\": \"xx-shop\",\n\t\t\"#os\": \"1.1.1.1\",\n\t\t\"sex\": \"female\",\n\t\t\"#app_id\": \"appid_1234567890\",\n\t\t\"#bundle_id\": \"com.example\",\n\t}\n\n err := dt.Track(\"the_dt_id\", \"acid123456789\", \"simple_event\", properties)\n if err != nil {\n println(err)\n }\n\n dt.Flush()\n dt.Close()\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1721707037","update_time":"1733804635"},"pure_content":"\u66f4\u65b0\u65f6\u95f4\uff1a2024-12-10\n\u26a0\ufe0f \u6b64 SDK \u9700\u642d\u914d FileScout \u4f7f\u7528\n\n\n\u4e00\u3001\u96c6\u6210 SDK\n\u547d\u4ee4\u884c\n\n\u83b7\u53d6 SDK\n\ngo get github.com\/datatower-ai\/dt-golang-sdk\n\n\n\u66f4\u65b0 SDK\n\ngo get -u github.com\/datatower-ai\/dt-golang-sdk\n\nModule\n\n\u5728\u4ee3\u7801\u5f00\u5934\u5f15\u5165 SDK\n\nimport \""}],"content":{"icon":"","desc":"","content_id":"80676","add_time":"1711102676","update_time":"1716522649","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}

服务端