{"data":{"id":"80675","string_id":"n4o0ic","status":"1","parent_id":"49193","slug":"n4o0ic","order":"6","name":"\u5ba2\u6237\u7aef","type":"1","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","add_time":"1711102668","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":"49187","string_id":"iKbFWS","status":"1","parent_id":"80675","slug":"Android_SDK","order":"4","name":"Android","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1698724222","update_time":"1740558383","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"49187","content":"> \u24d8 \u63d0\u793a\n> Android SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\n\n> **\u26a0\ufe0f<\/span> \u8fc1\u79fb\u987b\u77e5** \n> \u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n>\n> \u65b0\u5305\u540d\uff1a`ai.datatower:core`\n>\n> **?<\/span>** \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f \n> \u8bf7\u67e5\u770b[\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b](https:\/\/docs.datatower.ai\/docs\/sdk-migrate-to-3_0_0#android)\u3002\n\n[![Maven Central](https:\/\/img.shields.io\/maven-central\/v\/ai.datatower\/core?style=for-the-badge&logo=android&logoColor=70d68c&label=Android&labelColor=dbeffd&color=007EC7)](https:\/\/central.sonatype.com\/artifact\/ai.datatower\/core)\n\n# \u4e00\u3001\u96c6\u6210\n\n- \u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 mavenCentral\n\n```kotlin\nallprojects {\n repositories {\n ...\n mavenCentral()\n }\n}\n```\n\n- \u5728\u9879\u76ee\u6a21\u5757\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\n\n```kotlin\ndependencies {\n ...\n implementation 'ai.datatower:core:{\u6700\u65b0\u7248\u672c}'\n}\n```\n\n# \u4e8c\u3001\u521d\u59cb\u5316\n\n- **\u8bf4\u660e**\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n- **\u65b9\u6cd5**\n\n```Kotlin\nfun initSDK(\n context: Context,\n appId: String,\n serverUrl: String,\n channel: String = \"\",\n isDebug: Boolean = false,\n logLevel: Int = Log.VERBOSE,\n manualEnableUpload: Boolean = false\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e | \u793a\u4f8b |\n| ------------------ | ------- | -------- | ------------------------------------------------------------------------- | ----------------------------------------------------- |\n| context | Context | \u662f | Context \u4e0a\u4e0b\u6587 | getApplication() |\n| appId | String | \u662f | \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | dt_test |\n| serverUrl | String | \u662f | \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | [https:\/\/xxx.roiquery.com](https:\/\/xxx.roiquery.com\/) |\n| channel | String | \u5426 | \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d | DTChannel.GP |\n| isDebug | Boolean | \u5426 | \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower | true\/false |\n| logLevel | Int | \u5426 | log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a Log.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548 | Log.VERBOSE\u3001Log.DEBUG\u3001Log.ERROR \u7b49 |\n| manualEnableUpload | Boolean | \u5426 | \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5 | true\/false |\n\n- **\u4f7f\u7528**\n\n```kotlin\n\/\/ \u5728 Application onCreate() \u8c03\u7528\n\n\/\/ DT SDK \u521d\u59cb\u5316\nDT.initSDK(this, \"app id\", \"serverUrl\", DTChannel.GP, ture, Log.DEBUG, false)\n```\n\n# \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n\u57fa\u7840\u529f\u80fd\u7684API\u5747\u5728DTAnalytics\u7c7b\u4e0b\n\n## 3.1 ID \u4f53\u7cfb\n\n### 3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n- **\u8bf4\u660e**\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun setAccountId(id: String)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------ | ------ | -------- | ----------------- |\n| id | String | \u662f | \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id |\n\n- **\u4f7f\u7528**\n\n```kotlin\nDTAnalytics.setAccountId(\"123456\");\n```\n\n> **\u5982\u679c\u9700\u8981\u6e05\u9664\u8d26\u53f7 ID\uff0c\u8bf7\u4f20\u5165\u7a7a\u5b57\u7b26\u4e32**\n>\n> ```kotlin\n> DataTower.setAccountId(\"\");\n> ```\n\n### 3.1.2 \u83b7\u53d6 DT ID\n\n- **\u8bf4\u660e**\n\n\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun getDataTowerId(onDataTowerIDListener: OnDataTowerIdListener)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------------------- | --------------------- | -------- | --------------------- |\n| onDataTowerIDListener | OnDataTowerIdListener | \u662f | \u7528\u6237\u63a5\u6536 dt id \u7684\u56de\u8c03 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nDTAnalytics.getDataTowerId(object: OnDataTowerIdListener {\n override fun onDataTowerIdCompleted(dataTowerId: String) {\n \/\/ ...\n }\n})\n```\n\n## 3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n- **\u8bf4\u660e**\n\n\u8c03\u7528 `track` \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun track(\n eventName: String,\n properties: Map?\n )\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | --------------------------------- | -------- | -------------- |\n| eventName | String | \u662f | \u4e8b\u4ef6\u540d\u79f0 |\n| properties | Map \u6216\u8005 JSONObject | \u5426 | \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nHashMap properties = new HashMap<>();\nproperties.put(\"test_property_3\", false);\nproperties.put(\"test_property_4\", 2.3);\n\nDTAnalytics.track(\"test_track\", properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.track(\"test_track\");\n```\n\n## 3.3 \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\n### 3.3.1 user_set\n\n- **\u8bf4\u660e**\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userSet` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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- **\u65b9\u6cd5**\n\n```kotlin\nfun userSet(properties: JSONObject?)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ---------- | -------- | -------- |\n| properties | JSONObject | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nJSONObject pro = new JSONObject();\npro.put(\"user_sex_man\", false);\npro.put(\"user_pwd\", \"1111111\");\npro.put(\"user_age\", 23);\n\nDTAnalytics.userSet(pro);\n```\n\n### 3.3.2 user_set_once\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userSetOnce(properties: JSONObject?)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ---------- | -------- | -------- |\n| properties | JSONObject | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nJSONObject pro = new JSONObject();\npro.put(\"user_first_paid_time\", \"2020-09-23\");\n\nDTAnalytics.userSetOnce(pro);\n```\n\n### 3.3.3 user_add\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userAdd(properties: JSONObject?)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ---------- | -------- | -------------------------------------------------------------------- |\n| properties | JSONObject | \u662f | \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nJSONObject properties = new JSONObject();\nproperties.put(\"TotalRevenue\",30);\nDTAnalytics.userAdd(properties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a30\n\nJSONObject newProperties = new JSONObject();\nnewProperties.put(\"TotalRevenue\",648);\nDTAnalytics.userAdd(newProperties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a678\n```\n\n### 3.3.4 user_unset\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 `userUnset` \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userUnset( vararg properties: String?)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------- | -------- | -------------- |\n| properties | vararg String | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```kotlin\n\/\/ \u91cd\u7f6e\u5355\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset(\"key1\");\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset(\"key1\", \"key2\", \"key3\");\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\u6570\u7ec4\nString[] keys = {\"key1\", \"key2\"};\nDTAnalytics.userUnset(keys);\n```\n\n### 3.3.5 user_delete\n\n- **\u8bf4\u660e** \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\u3002\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userDelete()\n```\n\n### 3.3.6 user_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userAppend(properties: JSONObject?)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------- | -------- | -------------------------------------- |\n| properties | vararg String | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\uff0cvalue \u4ec5\u652f\u6301 JSONArray |\n\n- **\u4f7f\u7528**\n\n```kotlin\nDTAnalytics.userAppend({ user_list: [\"apple\", \"ball\"] });\n```\n\n### 3.3.7 user_uniq_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u5bf9\u5217\u8868\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 `userUniqAppend` \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c `userAppend` \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\n\n- **\u65b9\u6cd5**\n\n```kotlin\nfun userUniqAppend()\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------- | -------- | -------------------------------------- |\n| properties | vararg String | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\uff0cvalue \u4ec5\u652f\u6301 JSONArray |\n\n- **\u4f7f\u7528**\n\n```kotlin\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nDTAnalytics.userAppend({ user_list: [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nDTAnalytics.userAppend({ user_list: [\"apple\", \"cube\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\nDTAnalytics.userUniqAppend({ user_list: [\"apple\", \"cube\"] });\n```\n\n# \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n## 4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n\n### 4.1.1 \u5e7f\u544a\u53d8\u73b0\n\n- **\u8bf4\u660e**\n\n1. \u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n2. \u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528 UUID \u6765\u5b9e\u73b0\n3. \u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n4. \u5e7f\u544a\u76f8\u5173\u7684API\u5747\u5728**DTAdReport**\u7c7b\u4e2d\n\n| \u4e8b\u4ef6\u540d\u79f0 | \u663e\u793a\u540d | \u4e8b\u4ef6\u63cf\u8ff0 |\n| --------------- | ------------ | ---------------------------------------------------- |\n| #ad_load_begin | \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb | \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb |\n| #ad_load_end | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f |\n| #ad_to_show | \u5e7f\u544a\u9884\u5c55\u793a | \u5c06\u8981\u5c55\u793a\u5e7f\u544a |\n| #ad_show | \u5e7f\u544a\u5c55\u793a | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u4e0a\u62a5 |\n| #ad_show_failed | \u5e7f\u544a\u5c55\u793a\u5931\u8d25 | \u5e7f\u544a\u5c55\u793a\u5931\u8d25 |\n| #ad_close | \u5e7f\u544a\u5173\u95ed | \u5e7f\u544a\u5df2\u7ecf\u5173\u95ed |\n| #ad_click | \u5e7f\u544a\u70b9\u51fb | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u70b9\u51fb\u65f6\u4e0a\u62a5 |\n| #ad_rewarded | \u5e7f\u544a\u83b7\u5f97\u5956\u52b1 | \u53ea\u9488\u5bf9\u6fc0\u52b1\u5e7f\u544a\u83b7\u5f97\u5956\u52b1 |\n| #ad_conversion | \u5e7f\u544a\u6536\u76ca | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u7528\u6237\u83b7\u5f97\u5e7f\u544a\u5956\u52b1\u540e\u4e0a\u62a5 |\n| #ad_paid | \u5e7f\u544a\u5c55\u793a\u4ef7\u503c | \u5e7f\u544a\u5e73\u53f0\u7ed9\u6bcf\u4e2a\u5e7f\u544a\u7684\u9884\u4f30\u4ef7\u503c |\n\n- **\u63a5\u53e3\u5217\u8868**\n\n```kotlin\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nfun reportLoadBegin(\n id: String,\n type: AdType,\n platform: AdPlatform,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\nfun reportLoadEnd(\n id: String,\n type: AdType,\n platform: AdPlatform,\n duration: Long,\n result: Boolean,\n seq: String,\n errorCode: Int = 0,\n errorMessage: String = \"\",\n properties: MutableMap? = mutableMapOf(),\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\nfun reportToShow(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nfun reportShow(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\nfun reportShowFailed(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n errorCode: Int,\n errorMessage: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\nfun reportClose(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\nfun reportClick(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\nfun reportRewarded(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nfun reportConversionByClick(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nfun reportConversionByRewarded(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nfun reportConversionByLeftApp(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nfun reportPaid(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n value: Double,\n currency: String,\n precision: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\nfun reportPaid(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n mediation: AdMediation,\n mediationId: String,\n value: Double,\n precision: String,\n country: String,\n properties: MutableMap? = mutableMapOf(),\n)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nfun reportLeftApp(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | ---------------- | -------- | ------------------------------------------------------------------------------------------------------ |\n| seq | String | \u662f | \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210 |\n| id | String | \u662f | Network \u5e7f\u544a\u5355\u5143 ID |\n| type | AdType | \u662f | \u8be6\u89c1 [\u7c7b\u578b Type](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u7c7b\u578b%20Type) |\n| platform | AdPlatform | \u662f | \u8be6\u89c1 [\u5e7f\u544a\u5e73\u53f0 Platform](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u5e7f\u544a\u5e73\u53f0%20Platform) |\n| entrance | String | \u5426 | \u5e7f\u544a\u5c55\u793a\u5165\u53e3 |\n| result | Boolean | \u662f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f |\n| duration | Long | \u662f | \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f |\n| location | String | \u662f | \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c |\n| errorCode | Int | \u5426 | \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801 |\n| errorMessage | String | \u5426 | \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f |\n| value | Double | \u662f | \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f |\n| currency | String | \u662f | \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD |\n| precision | String | \u662f | \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6 |\n| country | String | \u662f | \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f |\n| mediation | AdMediation | \u5426 | \u8be6\u89c1 [\u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u805a\u5408\u5e7f\u544a\u5e73\u53f0%20Mediation) |\n| mediationId | String | \u5426 | \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID |\n| properties | Map | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n- **\u4f7f\u7528\u4e8b\u4f8b**\n\n**\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0**\n\n```kotlin\n\/*\n* \u4e00\u6b21\u5c55\u793aAdmob\u63d2\u9875\u5e7f\u544a\u7684\u8fc7\u7a0b\n*\/\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nval location = \"main\"\n\n\/\/ Admob\u5e7f\u544a\u5355\u5143\nval adUnit = \"xxxxxxxx\"\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\nvar seq = DTAdReport.generateUUID()\n\n\/\/ 1.\u4e0a\u62a5\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nDTAdReport.reportLoadBegin(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, seq)\n\n\/\/ \u52a0\u8f7d\u5f00\u59cb\u65f6\u95f4\nvar loadStartTime = System.currentTimeMillis()\n\n\/\/ 2.Admob\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nInterstitialAd.load(this,adUnit, adRequest,object : InterstitialAdLoadCallback() {\n\n override fun onAdLoaded(interstitialAd: InterstitialAd) {\n \/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u6210\u529f\n val loadDuration = System.currentTimeMillis() - loadStartTime\n DTAdReport.reportLoadEnd(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, loadDuration, ture, seq)\n }\n\n override fun onAdFailedToLoad(adError: LoadAdError) {\n \/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u5931\u8d25\n val loadDuration = System.currentTimeMillis() - loadStartTime\n DTAdReport.reportLoadEnd(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, loadDuration, false, seq, adError.code, adError.msg)\n }\n});\n\nInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {\n override fun onAdClicked() {\n \/\/ 7.\u5e7f\u544a\u88ab\u70b9\u51fb\n DTAdReport.reportClick(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n DTAdReport.reportConversionByClick(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n\n override fun onAdDismissedFullScreenContent() {\n \/\/ 8.\u5e7f\u544a\u5173\u95ed\n DTAdReport.reportClose(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n\n override fun onAdFailedToShowFullScreenContent(adError: AdError?) {\n \/\/ 6.\u5e7f\u544a\u5c55\u793a\u5931\u8d25\n DTAdReport.reportShowFailed(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq, adError.code, adError.msg)\n }\n\n override fun onAdShowedFullScreenContent() {\n \/\/ 5.\u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n}\n\n\/\/ 4.\u5c55\u793a\u5e7f\u544a\nDTAdReport.reportToShow(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\nInterstitialAd?.show(this)\n```\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\n\n```kotlin\noverride fun onAdRewared(){\n DTAdReport.reportConversionByRewared(adUnit, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n```\n\n**\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09**\n\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\n```kotlin\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\noverride fun onAdShowed(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n val adPlatform = getAdPlatform(ad)\n val adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL, adPlatform, location, seq)\n}\n```\n\n\u5176\u4ed6 API \u7c7b\u4f3c\n\n### 4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u5185\u8d2d\u6536\u5165\u4e8b\u4ef6\uff08#iap_purchase_success\uff09\u63a5\u53e3\n\n\u5185\u8d2d\u76f8\u5173\u7684API\u5747\u5728**DTIPAReport**\u7c7b\u4e2d\n\n\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n\n- **\u65b9\u6cd5**\n\n```kotlin\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\nfun reportPurchaseSuccess(\n order: String,\n sku: String,\n price: Double,\n currency: String,\n properties: MutableMap? = mutableMapOf()\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ---------------- | -------- | --------------------------------------------------- |\n| order | String | \u662f | \u8d2d\u4e70\u8ba2\u5355 |\n| sku | String | \u662f | \u8d2d\u4e70\u5546\u54c1 id |\n| price | Double | \u662f | \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| currency | String | \u662f | \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| properties | Map | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n### 4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u8ba2\u9605\u6536\u5165\u4e8b\u4ef6\uff08#ias_subscribe_success\uff09\u63a5\u53e3\n\u5185\u8d2d\u76f8\u5173\u7684API\u5747\u5728**DTIASReport**\u7c7b\u4e2d\n\n\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8ba2\u9605\u4f1a\u5b58\u5728\u9000\u8ba2\u7684\u60c5\u51b5\uff0c\u90a3\u4e48\u5728\u7528\u6237\u9000\u8ba2\u7684\u65f6\u5019\uff0c\u540c\u6837\u4e5f\u9700\u8981\u8c03\u7528\u8be5\u63a5\u53e3\uff0c\u5728price\u5c5e\u6027\u4e2d\uff0c\u4f20\u5165\u201c-\u9000\u8ba2\u91d1\u989d\u201d\uff08\u4f8b\u5982\uff1a-28\uff09\uff0c\u5728\u8ba1\u7b97\u6700\u7ec8\u6536\u5165\u7684\u573a\u666f\u4e2d\uff0c\u6536\u5165\u6570\u636e\u624d\u4f1a\u4e0e\u5b9e\u9645\u4e00\u81f4\u3002\n\n- **\u65b9\u6cd5**\n\n```kotlin\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\nfun reportSubscribeSuccess(\n originalOrderId: String,\n orderId: String,\n sku: String,\n price: Double,\n currency: String,\n properties: MutableMap? = mutableMapOf()\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------------- | ---------------- | -------- | --------------------------------------------------- |\n| originalOrderId | String | \u662f | \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id |\n| orderId | String | \u662f | \u8ba2\u9605\u8ba2\u5355 |\n| sku | String | \u662f | \u8ba2\u9605\u5546\u54c1 id |\n| price | Double | \u662f | \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| currency | String | \u662f | \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| properties | Map | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n## 4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n\n### 4.2.1 \u900f\u4f20 dt_id\n\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528\u83b7\u53d6 dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\n\n```kotlin\nDTAnalytics.getDataTowerId(object: OnDataTowerIdListener {\n override fun onDataTowerIdCompleted(dataTowerId: String) {\n \/\/ ...\n }\n})\n```\n\n### 4.2.2 \u5173\u8054\u4e09\u65b9 ID\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\n\n- **\u65b9\u6cd5**\n\n```kotlin\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDTAnalytics.setFirebaseAppInstanceId(\"\");\n\/\/ AppsFlyer\nDTAnalytics.setAppsFlyerId(\"\");\n\/\/ Adjust\nDTAnalytics.setAdjustId(\"\");\n\/\/ Kochava\nDTAnalytics.setKochavaId(\"\");\n\/\/ Tenjin\nDTAnalytics.setTenjinId(\"\");\n```\n\n- **\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027**\n\n| \u8c03\u7528\u63a5\u53e3 | \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0 | \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027 | \u7528\u6237\u5c5e\u6027 |\n| -------------------------- | ------------ | ------------- | -------------------- |\n| setFirebaseAppInstanceId() | Firebase | #firebase_iid | #latest_firebase_iid |\n| setAppsFlyerId() | AppsFlyer | #appsflyer_id | #latest_appsflyer_id |\n| setAdjustId() | Adjust | #adjust_id | #latest_adjust_id |\n| setKochavaId() | Kochava | #kochava_id | #latest_kochava_id |\n| setTenjinId() | Tenjin | #tenjin_id | #latest_tenjin_id |\n\n## 4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 `trackTimerStart` \u6765\u5f00\u59cb\u8ba1\u65f6\n\n1. \u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 `trackTimerStart` \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\n2. \u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 `trackTimerEnd`\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728 \"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 `#event_duration` \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\n3. \u591a\u6b21\u8c03\u7528 `trackTimerStart` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n4. \u591a\u6b21\u8c03\u7528 `trackTimerPause` \\ `trackTimerResume` \\ `trackTimerEnd` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u6682\u505c\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\\\u7ed3\u675f\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n\n- **\u65b9\u6cd5**\n\n```kotlin\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cMap \u6216\u8005 JSONObject\uff0c\u53ef\u4e0d\u4f20\nDTAnalyticsUtils.trackTimerEnd(\"event\", properties);\n```\n\n## 4.4 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n\n### 4.4.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\n\n```kotlin\nval props = JsonObject()\n\/\/ or Map\n\/\/ val props = mutableMapOf()\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setStaticCommonProperties(props)\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearStaticCommonProperties()\n```\n\n### 4.4.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\n\n```kotlin\nval props = JsonObject()\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setDynamicCommonProperties {\n props\n}\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\nDTAnalytics.track(\"simple_event\")\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearDynamicCommonProperties()\n```\n\n## 4.5 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed\nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n\n### 4.5.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n| \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6 | \u65f6\u673a | \n| ------------------- | ------------ |\n| #app_install\uff08app\u5b89\u88c5\uff09 | App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6 |\n| #session_start\uff08app\u6253\u5f00 | App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09|\n| #session_end\uff08app\u5173\u95ed\uff09 | App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09|\n\n### 4.5.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u67d0\u4e2a\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002 \n\n```kotlin\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDT.disableAutoTrack(PresetEvent)\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDT.enableAutoTrack(PresetEvent)\n```\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n- #app_install,\n- #session_start,\n- #session_end\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/iKbFWS\/66f0e1671e8d1.png)\n\n\n### 4.5.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n| \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b | \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e | \n| ------------------- | ------------ |\n| user_set |\u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5 |\n| user_set_once|\u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5|\n\n### 4.5.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\n**\u914d\u7f6e\u65b9\u5f0f**\n1. \u5728 res\/values \u4e0b\u6dfb\u52a0\u4e00\u4e2a xml \u6587\u4ef6\uff08\u4efb\u610f\u540d\u5b57\uff09\uff0c\n2. \u5176\u4e2d\u5b9a\u4e49 string-array\uff0c\u4e14 name \u4e3a **DTDisPresetProperties**\n3. \u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n**\u7279\u6b8a\u8bf4\u660e**\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n| \u5c5e\u6027 | \u8bf4\u660e\u8bf4\u660e | \n| ----------------| ------------ |\n| #bundle_id |\u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n| #app_id|DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5|\n| #debug |\u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n| #dt_id|\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #acid |\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #session_id|\u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n| #sdk_type |\u5224\u65adSDK\u7c7b\u578b\n| #sdk_version_name |\u5224\u65adSDK\u7248\u672c\n\n\n**\u793a\u4f8b**\n```xml\n\n\n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>\n```","pure_content":"\u24d8 \u63d0\u793a\nAndroid SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n\u65b0\u5305\u540d\uff1aai.datatower:core\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\n\u4e00\u3001\u96c6\u6210\n\n\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 mavenCentral\n\nallprojects {\n repositories {\n ...\n mavenCentral()\n }\n}\n\n\n\u5728\u9879\u76ee\u6a21\u5757\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\n\ndependencies {\n ...\n implementation 'ai.datatower:core:{\u6700\u65b0\u7248\u672c}'\n}\n\n\u4e8c\u3001\u521d\u59cb\u5316\n\n\n\u8bf4\u660e\n\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n\n\u65b9\u6cd5\n\n\nfun initSDK(\n context: Context,\n appId: String,\n serverUrl: String,\n channel: String = \"\",\n isDebug: Boolean = false,\n logLevel: Int = Log.VERBOSE,\n manualEnableUpload: Boolean = false\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n \u793a\u4f8b\n\n\n\n\n context\n Context\n \u662f\n Context \u4e0a\u4e0b\u6587\n getApplication()\n\n\n appId\n String\n \u662f\n \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n dt_test\n\n\n serverUrl\n String\n \u662f\n \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n https:\/\/xxx.roiquery.com\n\n\n channel\n String\n \u5426\n \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d\n DTChannel.GP\n\n\n isDebug\n Boolean\n \u5426\n \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower\n true\/false\n\n\n logLevel\n Int\n \u5426\n log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a Log.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548\n Log.VERBOSE\u3001Log.DEBUG\u3001Log.ERROR \u7b49\n\n\n manualEnableUpload\n Boolean\n \u5426\n \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5\n true\/false\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u5728 Application onCreate() \u8c03\u7528\n\n\/\/ DT SDK \u521d\u59cb\u5316\nDT.initSDK(this, \"app id\", \"serverUrl\", DTChannel.GP, ture, Log.DEBUG, false)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n\u57fa\u7840\u529f\u80fd\u7684API\u5747\u5728DTAnalytics\u7c7b\u4e0b\n3.1 ID \u4f53\u7cfb\n3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n\n\u8bf4\u660e\n\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n\n\u65b9\u6cd5\n\n\nfun setAccountId(id: String)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n id\n String\n \u662f\n \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\n\n\n\n\n\n\u4f7f\u7528\n\n\nDTAnalytics.setAccountId(\"123456\");\n\n\n\u5982\u679c\u9700\u8981\u6e05\u9664\u8d26\u53f7 ID\uff0c\u8bf7\u4f20\u5165\u7a7a\u5b57\u7b26\u4e32\nDataTower.setAccountId(\"\");\n\n\n3.1.2 \u83b7\u53d6 DT ID\n\n\n\u8bf4\u660e\n\n\n\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n\n\u65b9\u6cd5\n\n\nfun getDataTowerId(onDataTowerIDListener: OnDataTowerIdListener)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n onDataTowerIDListener\n OnDataTowerIdListener\n \u662f\n \u7528\u6237\u63a5\u6536 dt id \u7684\u56de\u8c03\n\n\n\n\n\n\u4f7f\u7528\n\n\nDTAnalytics.getDataTowerId(object: OnDataTowerIdListener {\n override fun onDataTowerIdCompleted(dataTowerId: String) {\n \/\/ ...\n }\n})\n\n3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\n\u8bf4\u660e\n\n\n\u8c03\u7528 track \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nfun track(\n eventName: String,\n properties: Map?\n )\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n eventName\n String\n \u662f\n \u4e8b\u4ef6\u540d\u79f0\n\n\n properties\n Map \u6216\u8005 JSONObject\n \u5426\n \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nHashMap properties = new HashMap<>();\nproperties.put(\"test_property_3\", false);\nproperties.put(\"test_property_4\", 2.3);\n\nDTAnalytics.track(\"test_track\", properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.track(\"test_track\");\n\n3.3 \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\n3.3.1 user_set\n\n\n\u8bf4\u660e\n\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userSet \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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\u65b9\u6cd5\n\n\nfun userSet(properties: JSONObject?)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n JSONObject\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nJSONObject pro = new JSONObject();\npro.put(\"user_sex_man\", false);\npro.put(\"user_pwd\", \"1111111\");\npro.put(\"user_age\", 23);\n\nDTAnalytics.userSet(pro);\n\n3.3.2 user_set_once\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n\n\u65b9\u6cd5\n\n\nfun userSetOnce(properties: JSONObject?)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n JSONObject\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nJSONObject pro = new JSONObject();\npro.put(\"user_first_paid_time\", \"2020-09-23\");\n\nDTAnalytics.userSetOnce(pro);\n\n3.3.3 user_add\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n\n\u65b9\u6cd5\n\n\nfun userAdd(properties: JSONObject?)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n JSONObject\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548\n\n\n\n\n\n\u4f7f\u7528\n\n\nJSONObject properties = new JSONObject();\nproperties.put(\"TotalRevenue\",30);\nDTAnalytics.userAdd(properties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a30\n\nJSONObject newProperties = new JSONObject();\nnewProperties.put(\"TotalRevenue\",648);\nDTAnalytics.userAdd(newProperties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a678\n\n3.3.4 user_unset\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 userUnset \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nfun userUnset( vararg properties: String?)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n vararg String\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u91cd\u7f6e\u5355\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset(\"key1\");\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset(\"key1\", \"key2\", \"key3\");\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\u6570\u7ec4\nString[] keys = {\"key1\", \"key2\"};\nDTAnalytics.userUnset(keys);\n\n3.3.5 user_delete\n\n\n\u8bf4\u660e \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\u3002\n\n\u65b9\u6cd5\n\n\nfun userDelete()\n\n3.3.6 user_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\n\n\n\u65b9\u6cd5\n\n\nfun userAppend(properties: JSONObject?)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n vararg String\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\uff0cvalue \u4ec5\u652f\u6301 JSONArray\n\n\n\n\n\n\u4f7f\u7528\n\n\nDTAnalytics.userAppend({ user_list: [\"apple\", \"ball\"] });\n\n3.3.7 user_uniq_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u5bf9\u5217\u8868\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 userUniqAppend \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c userAppend \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\n\n\n\u65b9\u6cd5\n\n\nfun userUniqAppend()\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n vararg String\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\uff0cvalue \u4ec5\u652f\u6301 JSONArray\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nDTAnalytics.userAppend({ user_list: [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nDTAnalytics.userAppend({ user_list: [\"apple\", \"cube\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\nDTAnalytics.userUniqAppend({ user_list: [\"apple\", \"cube\"] });\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n4.1.1 \u5e7f\u544a\u53d8\u73b0\n\n\n\u8bf4\u660e\n\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n\u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528 UUID \u6765\u5b9e\u73b0\n\u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\u5e7f\u544a\u76f8\u5173\u7684API\u5747\u5728DTAdReport\u7c7b\u4e2d\n\n\n\n\n \u4e8b\u4ef6\u540d\u79f0\n \u663e\u793a\u540d\n \u4e8b\u4ef6\u63cf\u8ff0\n\n\n\n\n #ad_load_begin\n \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb\n \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb\n\n\n #ad_load_end\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f\n\n\n #ad_to_show\n \u5e7f\u544a\u9884\u5c55\u793a\n \u5c06\u8981\u5c55\u793a\u5e7f\u544a\n\n\n #ad_show\n \u5e7f\u544a\u5c55\u793a\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u4e0a\u62a5\n\n\n #ad_show_failed\n \u5e7f\u544a\u5c55\u793a\u5931\u8d25\n \u5e7f\u544a\u5c55\u793a\u5931\u8d25\n\n\n #ad_close\n \u5e7f\u544a\u5173\u95ed\n \u5e7f\u544a\u5df2\u7ecf\u5173\u95ed\n\n\n #ad_click\n \u5e7f\u544a\u70b9\u51fb\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u70b9\u51fb\u65f6\u4e0a\u62a5\n\n\n #ad_rewarded\n \u5e7f\u544a\u83b7\u5f97\u5956\u52b1\n \u53ea\u9488\u5bf9\u6fc0\u52b1\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\n\n\n #ad_conversion\n \u5e7f\u544a\u6536\u76ca\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u7528\u6237\u83b7\u5f97\u5e7f\u544a\u5956\u52b1\u540e\u4e0a\u62a5\n\n\n #ad_paid\n \u5e7f\u544a\u5c55\u793a\u4ef7\u503c\n \u5e7f\u544a\u5e73\u53f0\u7ed9\u6bcf\u4e2a\u5e7f\u544a\u7684\u9884\u4f30\u4ef7\u503c\n\n\n\n\n\n\u63a5\u53e3\u5217\u8868\n\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nfun reportLoadBegin(\n id: String,\n type: AdType,\n platform: AdPlatform,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\nfun reportLoadEnd(\n id: String,\n type: AdType,\n platform: AdPlatform,\n duration: Long,\n result: Boolean,\n seq: String,\n errorCode: Int = 0,\n errorMessage: String = \"\",\n properties: MutableMap? = mutableMapOf(),\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\nfun reportToShow(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nfun reportShow(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\nfun reportShowFailed(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n errorCode: Int,\n errorMessage: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\nfun reportClose(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\nfun reportClick(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\nfun reportRewarded(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nfun reportConversionByClick(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nfun reportConversionByRewarded(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nfun reportConversionByLeftApp(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nfun reportPaid(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n value: Double,\n currency: String,\n precision: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\nfun reportPaid(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n mediation: AdMediation,\n mediationId: String,\n value: Double,\n precision: String,\n country: String,\n properties: MutableMap? = mutableMapOf(),\n)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nfun reportLeftApp(\n id: String,\n type: AdType,\n platform: AdPlatform,\n location: String,\n seq: String,\n properties: MutableMap? = mutableMapOf(),\n entrance: String? = \"\",\n mediation: AdMediation = AdMediation.IDLE,\n mediationId: String = \"\",\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n String\n \u662f\n \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210\n\n\n id\n String\n \u662f\n Network \u5e7f\u544a\u5355\u5143 ID\n\n\n type\n AdType\n \u662f\n \u8be6\u89c1 \u7c7b\u578b Type\n\n\n platform\n AdPlatform\n \u662f\n \u8be6\u89c1 \u5e7f\u544a\u5e73\u53f0 Platform\n\n\n entrance\n String\n \u5426\n \u5e7f\u544a\u5c55\u793a\u5165\u53e3\n\n\n result\n Boolean\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f\n\n\n duration\n Long\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f\n\n\n location\n String\n \u662f\n \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c\n\n\n errorCode\n Int\n \u5426\n \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801\n\n\n errorMessage\n String\n \u5426\n \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f\n\n\n value\n Double\n \u662f\n \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f\n\n\n currency\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD\n\n\n precision\n String\n \u662f\n \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6\n\n\n country\n String\n \u662f\n \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f\n\n\n mediation\n AdMediation\n \u5426\n \u8be6\u89c1 \u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation\n\n\n mediationId\n String\n \u5426\n \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID\n\n\n properties\n Map\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\u4e8b\u4f8b\n\n\n\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0\n\/*\n* \u4e00\u6b21\u5c55\u793aAdmob\u63d2\u9875\u5e7f\u544a\u7684\u8fc7\u7a0b\n*\/\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nval location = \"main\"\n\n\/\/ Admob\u5e7f\u544a\u5355\u5143\nval adUnit = \"xxxxxxxx\"\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\nvar seq = DTAdReport.generateUUID()\n\n\/\/ 1.\u4e0a\u62a5\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nDTAdReport.reportLoadBegin(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, seq)\n\n\/\/ \u52a0\u8f7d\u5f00\u59cb\u65f6\u95f4\nvar loadStartTime = System.currentTimeMillis()\n\n\/\/ 2.Admob\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nInterstitialAd.load(this,adUnit, adRequest,object : InterstitialAdLoadCallback() {\n\n override fun onAdLoaded(interstitialAd: InterstitialAd) {\n \/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u6210\u529f\n val loadDuration = System.currentTimeMillis() - loadStartTime\n DTAdReport.reportLoadEnd(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, loadDuration, ture, seq)\n }\n\n override fun onAdFailedToLoad(adError: LoadAdError) {\n \/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u5931\u8d25\n val loadDuration = System.currentTimeMillis() - loadStartTime\n DTAdReport.reportLoadEnd(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, loadDuration, false, seq, adError.code, adError.msg)\n }\n});\n\nInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {\n override fun onAdClicked() {\n \/\/ 7.\u5e7f\u544a\u88ab\u70b9\u51fb\n DTAdReport.reportClick(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n DTAdReport.reportConversionByClick(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n\n override fun onAdDismissedFullScreenContent() {\n \/\/ 8.\u5e7f\u544a\u5173\u95ed\n DTAdReport.reportClose(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n\n override fun onAdFailedToShowFullScreenContent(adError: AdError?) {\n \/\/ 6.\u5e7f\u544a\u5c55\u793a\u5931\u8d25\n DTAdReport.reportShowFailed(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq, adError.code, adError.msg)\n }\n\n override fun onAdShowedFullScreenContent() {\n \/\/ 5.\u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\n }\n}\n\n\/\/ 4.\u5c55\u793a\u5e7f\u544a\nDTAdReport.reportToShow(adUnit, AdType.INTERSTITIAL, AdPlatform.ADMOB, location, seq)\nInterstitialAd?.show(this)\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\noverride fun onAdRewared(){\n DTAdReport.reportConversionByRewared(adUnit, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\n\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\noverride fun onAdShowed(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n val adPlatform = getAdPlatform(ad)\n val adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL, adPlatform, location, seq)\n}\n\n\u5176\u4ed6 API \u7c7b\u4f3c\n4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u5185\u8d2d\u6536\u5165\u4e8b\u4ef6\uff08#iap_purchase_success\uff09\u63a5\u53e3\n\u5185\u8d2d\u76f8\u5173\u7684API\u5747\u5728DTIPAReport\u7c7b\u4e2d\n\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\nfun reportPurchaseSuccess(\n order: String,\n sku: String,\n price: Double,\n currency: String,\n properties: MutableMap? = mutableMapOf()\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n order\n String\n \u662f\n \u8d2d\u4e70\u8ba2\u5355\n\n\n sku\n String\n \u662f\n \u8d2d\u4e70\u5546\u54c1 id\n\n\n price\n Double\n \u662f\n \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n currency\n String\n \u662f\n \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n properties\n Map\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u8ba2\u9605\u6536\u5165\u4e8b\u4ef6\uff08#ias_subscribe_success\uff09\u63a5\u53e3\n\u5185\u8d2d\u76f8\u5173\u7684API\u5747\u5728DTIASReport\u7c7b\u4e2d\n\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\n\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8ba2\u9605\u4f1a\u5b58\u5728\u9000\u8ba2\u7684\u60c5\u51b5\uff0c\u90a3\u4e48\u5728\u7528\u6237\u9000\u8ba2\u7684\u65f6\u5019\uff0c\u540c\u6837\u4e5f\u9700\u8981\u8c03\u7528\u8be5\u63a5\u53e3\uff0c\u5728price\u5c5e\u6027\u4e2d\uff0c\u4f20\u5165\u201c-\u9000\u8ba2\u91d1\u989d\u201d\uff08\u4f8b\u5982\uff1a-28\uff09\uff0c\u5728\u8ba1\u7b97\u6700\u7ec8\u6536\u5165\u7684\u573a\u666f\u4e2d\uff0c\u6536\u5165\u6570\u636e\u624d\u4f1a\u4e0e\u5b9e\u9645\u4e00\u81f4\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\nfun reportSubscribeSuccess(\n originalOrderId: String,\n orderId: String,\n sku: String,\n price: Double,\n currency: String,\n properties: MutableMap? = mutableMapOf()\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n originalOrderId\n String\n \u662f\n \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id\n\n\n orderId\n String\n \u662f\n \u8ba2\u9605\u8ba2\u5355\n\n\n sku\n String\n \u662f\n \u8ba2\u9605\u5546\u54c1 id\n\n\n price\n Double\n \u662f\n \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n currency\n String\n \u662f\n \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n properties\n Map\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n4.2.1 \u900f\u4f20 dt_id\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528\u83b7\u53d6 dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\nDTAnalytics.getDataTowerId(object: OnDataTowerIdListener {\n override fun onDataTowerIdCompleted(dataTowerId: String) {\n \/\/ ...\n }\n})\n\n4.2.2 \u5173\u8054\u4e09\u65b9 ID\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDTAnalytics.setFirebaseAppInstanceId(\"\");\n\/\/ AppsFlyer\nDTAnalytics.setAppsFlyerId(\"\");\n\/\/ Adjust\nDTAnalytics.setAdjustId(\"\");\n\/\/ Kochava\nDTAnalytics.setKochavaId(\"\");\n\/\/ Tenjin\nDTAnalytics.setTenjinId(\"\");\n\n\n\n\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027\n\n\n\n\n\n \u8c03\u7528\u63a5\u53e3\n \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0\n \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027\n \u7528\u6237\u5c5e\u6027\n\n\n\n\n setFirebaseAppInstanceId()\n Firebase\n #firebase_iid\n #latest_firebase_iid\n\n\n setAppsFlyerId()\n AppsFlyer\n #appsflyer_id\n #latest_appsflyer_id\n\n\n setAdjustId()\n Adjust\n #adjust_id\n #latest_adjust_id\n\n\n setKochavaId()\n Kochava\n #kochava_id\n #latest_kochava_id\n\n\n setTenjinId()\n Tenjin\n #tenjin_id\n #latest_tenjin_id\n\n\n\n4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 trackTimerStart \u6765\u5f00\u59cb\u8ba1\u65f6\n\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 trackTimerStart \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\n\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 trackTimerEnd\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728 \"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 #event_duration \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\n\u591a\u6b21\u8c03\u7528 trackTimerStart \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n\u591a\u6b21\u8c03\u7528 trackTimerPause \\ trackTimerResume \\ trackTimerEnd \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u6682\u505c\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\\\u7ed3\u675f\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cMap \u6216\u8005 JSONObject\uff0c\u53ef\u4e0d\u4f20\nDTAnalyticsUtils.trackTimerEnd(\"event\", properties);\n\n4.4 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n4.4.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\nval props = JsonObject()\n\/\/ or Map\n\/\/ val props = mutableMapOf()\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setStaticCommonProperties(props)\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearStaticCommonProperties()\n\n4.4.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\nval props = JsonObject()\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setDynamicCommonProperties {\n props\n}\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\nDTAnalytics.track(\"simple_event\")\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearDynamicCommonProperties()\n\n4.5 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed\nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n4.5.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6\n \u65f6\u673a\n\n\n\n\n #app_install\uff08app\u5b89\u88c5\uff09\n App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\n\n\n #session_start\uff08app\u6253\u5f00\n App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09\n\n\n #session_end\uff08app\u5173\u95ed\uff09\n App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09\n\n\n\n4.5.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u67d0\u4e2a\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDT.disableAutoTrack(PresetEvent)\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDT.enableAutoTrack(PresetEvent)\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n\n#app_install,\n#session_start,\n#session_end\n\n\n4.5.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b\n \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e\n\n\n\n\n user_set\n \u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5\n\n\n user_set_once\n \u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5\n\n\n\n4.5.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\u914d\u7f6e\u65b9\u5f0f\n\n\u5728 res\/values \u4e0b\u6dfb\u52a0\u4e00\u4e2a xml \u6587\u4ef6\uff08\u4efb\u610f\u540d\u5b57\uff09\uff0c\n\u5176\u4e2d\u5b9a\u4e49 string-array\uff0c\u4e14 name \u4e3a DTDisPresetProperties\n\n\u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n\u7279\u6b8a\u8bf4\u660e\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n\n\n\n \u5c5e\u6027\n \u8bf4\u660e\u8bf4\u660e\n\n\n\n\n #bundle_id\n \u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n\n\n #app_id\n DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\n\n\n #debug\n \u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n\n\n #dt_id\n \u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #acid\n \u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #session_id\n \u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n\n\n #sdk_type\n \u5224\u65adSDK\u7c7b\u578b\n\n\n #sdk_version_name\n \u5224\u65adSDK\u7248\u672c\n\n\n\n\u793a\u4f8b\n\n\n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>","is_draft":"0","editor_type":"2","file_path":"","add_time":"1698724222","update_time":"1740558382"},"pure_content":"\u24d8 \u63d0\u793a\nAndroid SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n\u65b0\u5305\u540d\uff1aai.datatower:core\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\n\u4e00\u3001\u96c6\u6210\n\n\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 mavenCentral\n\nallprojects {\n reposito"},{"id":"49188","string_id":"xioCto","status":"1","parent_id":"80675","slug":"iOS_SDK","order":"3","name":"iOS","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1698725548","update_time":"1725348653","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"49188","content":"> \u24d8 \u63d0\u793a \n> iOS SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0 \n\n\n\u6700\u65b0\u7248\u672c\uff1a \n[![Cocoapods Version](https:\/\/img.shields.io\/cocoapods\/v\/DataTowerAICore?style=for-the-badge&logo=ios&logoColor=000000&label=iOS&labelColor=f3f3f5)](https:\/\/cocoapods.org\/pods\/DataTowerAICore)\n\n\n# \u4e00\u3001\u81ea\u52a8\u96c6\u6210\n\n- Swift Package Manager\n\n```swift\nAdd the following to your Package.swift file:\ndependencies:\n.package(url: \"https:\/\/github.com\/lovinjoy\/datatower.ai-core-ios\",from:\"{\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}\")\nBuild your project:\n$ swift build\n```\n\n- Cocoapods\n\n```ruby\nCocoaPods is a dependency manager for Cocoa projects. To install ROIQueryCoreFrame with CocoaPods:\n\nMake sure CocoaPods is installed.\n\n# Using the default Ruby install will require you to use sudo when\n# installing and updating gems.\n[sudo] gem install cocoapods\nUpdate your Podfile to include the following:\n\nuse_frameworks!\n\ntarget 'YourAppTargetName' do\npod 'DataTowerAICore', '~> {\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}'\nend\nRun pod install --repo-update.\n```\n\n# \u4e8c\u3001\u521d\u59cb\u5316\n\n- **\u8bf4\u660e**\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)initSDK:(NSString *)appid\n serverUrl:(NSString *)url\n channel:(DTChannel)channel\n isDebug:(BOOL)debug\n logLevel:(DTLoggingLevel)logLevel\n enableTrack:(BOOL)enableTrack\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e | \u793a\u4f8b |\n| --------- | -------------- | -------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------ |\n| appId | NSString | \u662f | \u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u5206\u914d\u7684 app_id\uff0c\u5982\u6ca1\u6709\u521b\u5efa\u9879\u76ee\u6743\u9650\u9700\u8054\u7cfb\u516c\u53f8\u8d85\u7ea7\u7ba1\u7406\u5458\u89d2\u8272\u6216 DT \u5de5\u4f5c\u4eba\u5458 | dt_test |\n| serverUrl | NSString | \u662f | \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | [https:\/\/xxx.roiquery.com](https:\/\/xxx.roiquery.com\/) |\n| channel | DTChannel | \u662f | \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0 | DTChannelAppStore |\n| isDebug | BOOL | \u662f | \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c \u9ed8\u8ba4\u4e3a false\uff1blog \u6807\u7b7e\u4e3a DataTower | true\/false |\n| logLevel | DTLoggingLevel | \u662f | log \u7684\u7ea7\u522b\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548 | DTLoggingLevelDebug\u3001DTLoggingLevelInfo\u3001DTLoggingLevelError |\n| enableTrack | BOOL | \u662f | \u662f\u5426\u4e0a\u62a5\u5230\u670d\u52a1\u5668\uff0c\u4e00\u822c\u586bYes\uff0c\u5982\u679c\u9700\u8981\u5148\u4f20\u5165\u516c\u5171\u5c5e\u6027\uff0c\u586bNo\uff0c\u5f85\u8bbe\u7f6e\u5b8c\u76f8\u5e94\u5c5e\u6027\u540e\uff0c\u9700\u8c03\u7528setEnableTracking\u5f00\u542f\u4e0a\u4f20\uff0c\u6807\u5fd7\u672a\u5f00\u542f\u524d\uff0c\u6570\u636e\u4e0d\u4f1a\u4e0a\u62a5\u5230\u540e\u53f0 | Yes\/No |\n\n- **\u4f7f\u7528**\n\n```objc\n@import DataTowerAICore;\n\n\/\/ \u5728\u7a0b\u5e8f\u5165\u53e3\u8c03\u7528\n[DT initSDK:@\"appid\" serverUrl:@\"serverUrl\" channel:DTChannelAppStore isDebug:YES logLevel:DTLoggingLevelDebug enableTrack:YES];\n\n```\n\n# \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n## 3.1 ID \u4f53\u7cfb\n\n### 3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n- **\u8bf4\u660e**\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 `setAccountId` \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 `setAccountId` \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)setAccountId:(NSString *)accountId\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------ | -------- | -------- | ----------------- |\n| id | NSString | \u662f | \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id |\n\n- **\u4f7f\u7528**\n\n```objc\n[DTAnalytics setAccountId:@\"123456\"];\n```\n\n### 3.1.2 \u83b7\u53d6 DT ID\n\n- **\u8bf4\u660e**\n\n\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (NSString *)getDataTowerId\n```\n\n\n- **\u4f7f\u7528**\n\n```objc\nNSString *dtId = [DTAnalytics getDataTowerId]\n```\n\n## 3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n- **\u8bf4\u660e**\n\n\u8c03\u7528 `trackEventName` \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)trackEventName:(NSString *)eventName properties:(NSDictionary *)properties\n\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------------- |\n| eventName | NSString | \u662f | \u4e8b\u4ef6\u540d\u79f0 |\n| properties | NSDictionary | \u5426 | \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```objc\nNSDictionary *eventProperties = @{ @\"product_name\": @\"\u5546\u54c1\u540d\"};\n[DTAnalytics trackEventName:@\"product_buy\" properties:eventProperties];\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\n[DTAnalytics trackEventName:@\"dt_track_simple\"]\n```\n\n## 3.3 \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\n### 3.3.1 user_set\n\n- **\u8bf4\u660e**\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userSet` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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- **\u65b9\u6cd5**\n\n```objc\n+ (void)userSet:(NSDictionary *)properties\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------- |\n| properties | NSDictionary | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```objc\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userSet:@{@\"username\": @\"dt_name\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n[DTAnalytics userSet:@{@\"username\": @\"dt_name2\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name2\"\n```\n\n### 3.3.2 user_set_once\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n- **\u65b9\u6cd5**\n\n```objectivec\n+ (void)userSetOnce:(NSDictionary *)properties\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------- |\n| properties | NSDictionary | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```objc\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userSetOnce:@{@\"username\": @\"dt_name\"}];\n\/\/ \u5047\u8bbe\"username\"\u4ece\u6765\u6ca1\u88ab\u8bbe\u7f6e\u8fc7\uff0c\u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n[DTAnalytics userSet:@{@\"username\": @\"dt_name2\"}];\n\/\/ \u6b64\u65f6\"username\"\u4ecd\u4e3a\"dt_name\"\n[DTAnalytics userSetOnce:@{@\"username\": @\"dt_name3\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n```\n\n### 3.3.3 user_add\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)userAdd:(NSDictionary *)properties\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------------------------------------------------------------------- |\n| properties | NSDictionary | \u662f | \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548 |\n\n- **\u4f7f\u7528**\n\n```objc\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userAdd:@{@\"usermoney\": [NSNumber numberWithInt:6]}];\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 6\n[DTAnalytics userAdd:@{@\"usermoney\": [NSNumber numberWithInt:6]}];\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 12\n```\n\n### 3.3.4 user_unset\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 `userUnset` \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)userUnset:(NSString *)propertyName\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | -------- | -------- | ------------ |\n| propertyName | NSString | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0 |\n\n- **\u4f7f\u7528**\n\n```objc\n\/\/ \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\n[DTAnalytics userUnset:@\"key1\"];\n```\n\n### 3.3.5 user_delete\n\n- **\u8bf4\u660e** \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\u3002\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)userDelete\n```\n\n### 3.3.6 user_append\n\n- **\u8bf4\u660e** \u60a8\u53ef\u4ee5\u8c03\u7528 `userAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)userAppend:(NSDictionary *)properties\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------------- |\n| properties | NSDictionary | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```objc\nNSArray *course = @[@\"History\",@\"Now\"];\nNSDictionary *userAppendProperties = @{\n @\"course\":course,\n};\n \n[DTAnalytics userAppend:userAppendProperties];\n```\n\n### 3.3.7 user_uniq_append\n\n- **\u8bf4\u660e** \u60a8\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 `userUniqAppend` \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c `userAppend` \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)userUniqAppend:(NSDictionary *)properties\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------------- |\n| properties | NSDictionary | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```objc\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\n[DTAnalytics userAppend:@{@\"user_list\":@[@\"apple\", @\"ball\"]}];\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\n[DTAnalytics userAppend:@{@\"user_list\":@[@\"apple\", @\"cube\"]}];\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\n [DTAnalytics userUniqAppend:@{@\"user_list\":@[@\"apple\", @\"cube\"]}];\n```\n\n## 3.4 \u8bbe\u7f6e\u652f\u4ed8\u539f\u59cb\u8ba2\u5355 ID\n\n- **\u8bf4\u660e**\n\nDT \u5e73\u53f0\u5904\u7406\u6570\u636e\u65f6\uff0c\u9700\u8981\u83b7\u53d6 IOS \u652f\u4ed8\u5e73\u53f0\u539f\u59cb\u8ba2\u5355 ID\uff0c\u4ee5\u6b64\u4f5c\u4e3a\u5173\u8054 Apple \u652f\u4ed8\u7528\u6237\u7684\u6807\u8bc6\u3002\u8bf7\u5728\u4f7f\u7528\u652f\u4ed8\u76f8\u5173\u7684\u4e8b\u4ef6\u4e0a\u62a5\u65f6\uff0c\u52a1\u5fc5\u8c03\u7528\u6b64\u65b9\u6cd5\u3002\n\n- **\u65b9\u6cd5**\n\n```objc\n+ (void)setIasOriginalOrderId:(NSString *)oorderId;\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------- | -------- | -------- | --------------------- |\n| orderId | NSString | \u662f | Apple \u652f\u4ed8\u539f\u59cb\u8ba2\u5355 ID |\n\n- **\u4f7f\u7528**\n\n```objectivec\n[DTAnalytics setIasOriginalOrderId:@\"123434\"]\n```\n\n# \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n## 4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n\n### 4.1.1 \u5e7f\u544a\u53d8\u73b0\n\n- **\u8bf4\u660e**\n\n1. \u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n2. \u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u7cfb\u7edf\u7684 NSUUID \u6765\u5b9e\u73b0\u3002\n3. \u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n| \u4e8b\u4ef6\u540d\u79f0 | \u663e\u793a\u540d | \u4e8b\u4ef6\u63cf\u8ff0 |\n| --------------- | ------------ | ---------------------------------------------------- |\n| #ad_load_begin | \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb | \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb |\n| #ad_load_end | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f |\n| #ad_to_show | \u5e7f\u544a\u9884\u5c55\u793a | \u5c06\u8981\u5c55\u793a\u5e7f\u544a |\n| #ad_show | \u5e7f\u544a\u5c55\u793a | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u4e0a\u62a5 |\n| #ad_show_failed | \u5e7f\u544a\u5c55\u793a\u5931\u8d25 | \u5e7f\u544a\u5c55\u793a\u5931\u8d25 |\n| #ad_close | \u5e7f\u544a\u5173\u95ed | \u5e7f\u544a\u5df2\u7ecf\u5173\u95ed |\n| #ad_click | \u5e7f\u544a\u70b9\u51fb | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u70b9\u51fb\u65f6\u4e0a\u62a5 |\n| #ad_rewarded | \u5e7f\u544a\u83b7\u5f97\u5956\u52b1 | \u53ea\u9488\u5bf9\u6fc0\u52b1\u5e7f\u544a\u83b7\u5f97\u5956\u52b1 |\n| #ad_conversion | \u5e7f\u544a\u6536\u76ca | \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u7528\u6237\u83b7\u5f97\u5e7f\u544a\u5956\u52b1\u540e\u4e0a\u62a5 |\n| #ad_paid | \u5e7f\u544a\u5c55\u793a\u4ef7\u503c | \u5e7f\u544a\u5e73\u53f0\u7ed9\u6bcf\u4e2a\u5e7f\u544a\u7684\u9884\u4f30\u4ef7\u503c |\n\n- **\u63a5\u53e3\u5217\u8868**\n\n```objc\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\n+ (void) reportLoadBegin:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n seq:(NSString *)seq\n properties:(NSDictionary *)properties;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\n+ (void) reportLoadEnd:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n duration:(NSNumber *)duration\n result:(BOOL)result\n seq:(NSString *)seq\n errorCode:(NSInteger)errorCode\n errorMessage:(NSString *)errorMessage\n properties:(NSDictionary *)properties;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\n+ (void) reportToShow:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\n+ (void) reportShow:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\n+ (void) reportAdShowFail:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n errorCode:(NSInteger)errorCode\n errorMessage:(NSString *)errorMessage\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\n+ (void) reportClose:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\n+ (void) reportClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n mediation:(DTAdMediation)mediation\n mediationId:(NSString *)mediationId\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\n+ (void) reportClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\n+ (void) reportConversionByClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\n+ (void) reportConversionByRewarded:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\n+ (void) reportConversionByLeftApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\n+ (void) reportPaid:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n value:(NSString *)value\n currency:(NSString *)currency\n precision:(NSString *)precision\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n+ (void) reportPaid:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n mediation:(DTAdMediation)mediation\n mediationId:(NSString *)mediationId\n value:(NSString *)value\n precision:(NSString *)precision\n country:(NSString *)country\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n+ (void) reportLeftApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u8fd4\u56deapp\u4e8b\u4ef6\uff0c\u5728\u8bbf\u95ee\u5e7f\u544a\u94fe\u63a5\uff0c\u56de\u5230\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n+ (void) reportReturnApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n clickGap:(NSNumber *)clickGap\n returnGap:(NSNumber *)returnGap\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| seq | String | \u662f | \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| id | String | \u662f | Network \u5e7f\u544a\u5355\u5143 ID |\n| type | DTAdType | \u662f | \u8be6\u89c1 [\u7c7b\u578b Type](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u7c7b\u578b%20Type) |\n| platform | DTAdPlatform | \u662f | \u8be6\u89c1 [\u5e7f\u544a\u5e73\u53f0 Platform](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u5e7f\u544a\u5e73\u53f0%20Platform) |\n| entrance | String | \u5426 | \u5e7f\u544a\u5c55\u793a\u5165\u53e3 |\n| result | Boolean | \u662f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f |\n| duration | Long | \u662f | \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f |\n| location | String | \u662f | \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c |\n| errorCode | Int | \u5426 | \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801 |\n| errorMessage | String | \u5426 | \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f |\n| value | String | \u662f | \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f |\n| currency | String | \u662f | \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD |\n| precision | String | \u662f | \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6 |\n| country | String | \u662f | \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f |\n| mediation | DTAdMediation | \u662f | \u8be6\u89c1 [\u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u805a\u5408\u5e7f\u544a\u5e73\u53f0%20Mediation) |\n| mediationId | String | \u662f | \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID |\n| properties | NSDictionary | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n- **\u4f7f\u7528\u4e8b\u4f8b**\n\n**\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0**\n\n```objc\n@import DataTowerAICore;\n@import GoogleMobileAds;\n@import UIKit;\n\n@interface ViewController () \n\n@property(nonatomic, strong) GADInterstitialAd *interstitial;\n\n@end\n\n@implementation ViewController\n\n- (void)viewDidLoad {\n [super viewDidLoad];\n\n \/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\n NSString *location = @\"main\";\n\n \/\/ Admob \u5e7f\u544a\u5355\u5143\n NSString *adUnit = @\"ca-app-pub-3940256099942544\/1033173712\";\n\n \/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\n NSString *seq = [NSUUID UUID].UUIDString;\n\n\n GADRequest *request = [GADRequest request];\n [GADInterstitialAd loadWithAdUnitID:adUnit\n request:request\n completionHandler:^(GADInterstitialAd *ad, NSError *error) {\n\n }];\n\n - (IBAction)showad:(id)sender {\n if (self.interstitial) {\n [self.interstitial presentFromRootViewController:self];\n } else {\n NSLog(@\"Ad wasn't ready\");\n }\n}\n\n\/\/ \u5c55\u793a\u5931\u8d25\u7684\u56de\u8c03\n- (void)ad:(nonnull id)ad\ndidFailToPresentFullScreenContentWithError:(nonnull NSError *)error {\n\n}\n\n\/\/ \u5173\u95ed\u7684\u56de\u8c03\n- (void)adDidDismissFullScreenContent:(nonnull id)ad {\n NSLog(@\"Ad did dismiss full screen content.\");\n}\n\n \/\/ \u70b9\u51fb\u7684\u56de\u8c03\uff08\u5982\u679c\u6709\u7684\u8bdd\uff09\n - (void)adClicked{\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u8f6c\u5316\n [DTAdReport reportConversionByClick:adUnit type:DTAdTypeInterstitial\n platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n }\n}\n```\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\n\n```objc\n\/\/ \u83b7\u5f97\u6fc0\u52b1\u7684\u56de\u8c03\uff08\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff09\n - (void)adRewarded{\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u8f6c\u5316\n [DTAdReport reportConversionByRewarded:adUnit type:DTAdTypeInterstitial\n platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n }\n```\n\n**\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09**\n\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\n```objectivec\n_\/\/\/ \u5c55\u793a\u7684\u56de\u8c03\n- (void)adWillPresentFullScreenContent:(nonnull id)ad {\n NSLog(@\"Ad will present full screen content.\");\n \/\/ \u4e0a\u62a5\u5c55\u793a\n [DTAdReport reportShow:adUnit type:DTAdTypeInterstitial platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n\n__}_\n```\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n\n### 4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```objc\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\n+ (void)reportPurchased:(NSString *)order\n sku:(NSString *)sku\n price:(NSNumber *)price\n currency:(NSString *)currency\n seq:(NSString *)seq\n placement:(NSString *)placement;\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------- | -------- | -------- | --------------------------------------------------- |\n| seq | NSString | \u662f | \u8d2d\u4e70\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| placement | NSString | \u662f | \u8d2d\u4e70\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\uff0c\u53ef\u4e3a\u7a7a |\n| currency | NSString | \u662f | \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| price | NSNumber | \u662f | \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| sku | NSString | \u662f | \u8d2d\u4e70\u5546\u54c1 id |\n| order | NSString | \u662f | \u8d2d\u4e70\u8ba2\u5355 |\n\n### 4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```objc\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\n+ (void)reportSubscribeSuccess:(NSString *)seq\n entrance:(NSString *)entrance\n placement:(NSString *)placement\n sku:(NSString *)sku\n orderId:(NSString *)orderId\n originalOrderId:(NSString *)originalOrderId\n price:(NSString *)price\n currency:(NSString *)currency\n properties:(NSDictionary *)properties;\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------------- | ------------ | -------- | --------------------------------------------------- |\n| seq | NSString | \u662f | \u8ba2\u9605\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| entrance | NSString | \u662f | \u8ba2\u9605\u884c\u4e3a\u5165\u53e3 |\n| placement | NSString | \u662f | \u8ba2\u9605\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e |\n| currency | NSString | \u662f | \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| price | NSString | \u662f | \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| sku | NSString | \u662f | \u8ba2\u9605\u5546\u54c1 id |\n| orderId | NSString | \u662f | \u8ba2\u9605\u8ba2\u5355 |\n| originalOrderId | NSString | \u662f | \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id |\n| properties | NSDictionary | \u662f | \u81ea\u5b9a\u4e49\u5c5e\u6027 |\n\n## 4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n\n### 4.2.1 \u900f\u4f20 dt_id\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528\u83b7\u53d6 dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\n\n```objc\nNSString *dtId = [DTAnalytics getDataTowerId];\n```\n\n### 4.2.2 \u5173\u8054\u4e09\u65b9 ID\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\n\n- **\u65b9\u6cd5**\n\n```objc\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\n[DTAnalytics setFirebaseAppInstanceId:\"\"];\n\/\/ AppsFlyer\n[DTAnalytics setAppsFlyerId:@\"\"];\n\/\/ Adjust\n[DTAnalytics setAdjustId:@\"\"];\n\/\/ Kochava\n[DTAnalytics setKochavaId:@\"\"];\n\/\/ Tenjin\n[DTAnalytics setTenjinId:@\"\"];\n```\n\n- **\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027**\n\n| \u8c03\u7528\u63a5\u53e3 | \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0 | \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027 | \u7528\u6237\u5c5e\u6027 |\n| ------- | ---------- | ----------- | ------- |\n| setFirebaseAppInstanceId() | Firebase | #firebase_iid | #latest_firebase_iid |\n| setAppsFlyerId() | AppsFlyer | #appsflyer_id | #latest_appsflyer_id | \n| setAdjustId() | Adjust | #adjust_id | #latest_adjust_id |\n| setKochavaId() | Kochava | #kochava_id | #latest_kochava_id |\n| setTenjinId() | Tenjin | #tenjin_id | #latest_tenjin_id |\n\n## 4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 `DTAnalyticsUtils` \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 `trackTimerStart` \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 `trackTimerEnd`\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 `#duration` \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 ` trackTimerStart`\\ `trackTimerPause` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 `trackTimerEnd`\\ `trackTimerResume` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\n\n- **\u65b9\u6cd5**\n\n```swift\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerStart@\"event\"]\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerPause@\"event\"]\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerResume@\"event\"]\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerEnd@\"event\"]\n```","pure_content":"\u24d8 \u63d0\u793a\niOS SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0\n\n\u6700\u65b0\u7248\u672c\uff1a\n\n\u4e00\u3001\u81ea\u52a8\u96c6\u6210\n\nSwift Package Manager\n\nAdd the following to your Package.swift file:\ndependencies:\n.package(url: \"https:\/\/github.com\/lovinjoy\/datatower.ai-core-ios\",from:\"{\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}\")\nBuild your project:\n$ swift build\n\n\nCocoapods\n\nCocoaPods is a dependency manager for Cocoa projects. To install ROIQueryCoreFrame with CocoaPods:\n\nMake sure CocoaPods is installed.\n\n# Using the default Ruby install will require you to use sudo when\n# installing and updating gems.\n[sudo] gem install cocoapods\nUpdate your Podfile to include the following:\n\nuse_frameworks!\n\ntarget 'YourAppTargetName' do\npod 'DataTowerAICore', '~> {\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}'\nend\nRun pod install --repo-update.\n\n\u4e8c\u3001\u521d\u59cb\u5316\n\n\n\u8bf4\u660e\n\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n\n\u65b9\u6cd5\n\n\n+ (void)initSDK:(NSString *)appid\n serverUrl:(NSString *)url\n channel:(DTChannel)channel\n isDebug:(BOOL)debug\n logLevel:(DTLoggingLevel)logLevel\n enableTrack:(BOOL)enableTrack\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n \u793a\u4f8b\n\n\n\n\n appId\n NSString\n \u662f\n \u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u5206\u914d\u7684 app_id\uff0c\u5982\u6ca1\u6709\u521b\u5efa\u9879\u76ee\u6743\u9650\u9700\u8054\u7cfb\u516c\u53f8\u8d85\u7ea7\u7ba1\u7406\u5458\u89d2\u8272\u6216 DT \u5de5\u4f5c\u4eba\u5458\n dt_test\n\n\n serverUrl\n NSString\n \u662f\n \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n https:\/\/xxx.roiquery.com\n\n\n channel\n DTChannel\n \u662f\n \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\n DTChannelAppStore\n\n\n isDebug\n BOOL\n \u662f\n \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c \u9ed8\u8ba4\u4e3a false\uff1blog \u6807\u7b7e\u4e3a DataTower\n true\/false\n\n\n logLevel\n DTLoggingLevel\n \u662f\n log \u7684\u7ea7\u522b\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548\n DTLoggingLevelDebug\u3001DTLoggingLevelInfo\u3001DTLoggingLevelError\n\n\n enableTrack\n BOOL\n \u662f\n \u662f\u5426\u4e0a\u62a5\u5230\u670d\u52a1\u5668\uff0c\u4e00\u822c\u586bYes\uff0c\u5982\u679c\u9700\u8981\u5148\u4f20\u5165\u516c\u5171\u5c5e\u6027\uff0c\u586bNo\uff0c\u5f85\u8bbe\u7f6e\u5b8c\u76f8\u5e94\u5c5e\u6027\u540e\uff0c\u9700\u8c03\u7528setEnableTracking\u5f00\u542f\u4e0a\u4f20\uff0c\u6807\u5fd7\u672a\u5f00\u542f\u524d\uff0c\u6570\u636e\u4e0d\u4f1a\u4e0a\u62a5\u5230\u540e\u53f0\n Yes\/No\n\n\n\n\n\n\u4f7f\u7528\n\n\n@import DataTowerAICore;\n\n\/\/ \u5728\u7a0b\u5e8f\u5165\u53e3\u8c03\u7528\n[DT initSDK:@\"appid\" serverUrl:@\"serverUrl\" channel:DTChannelAppStore isDebug:YES logLevel:DTLoggingLevelDebug enableTrack:YES];\n\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n3.1 ID \u4f53\u7cfb\n3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n\n\u8bf4\u660e\n\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n\n\u65b9\u6cd5\n\n\n+ (void)setAccountId:(NSString *)accountId\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n id\n NSString\n \u662f\n \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\n\n\n\n\n\n\u4f7f\u7528\n\n\n[DTAnalytics setAccountId:@\"123456\"];\n\n3.1.2 \u83b7\u53d6 DT ID\n\n\n\u8bf4\u660e\n\n\n\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n\n\u65b9\u6cd5\n\n\n+ (NSString *)getDataTowerId\n\n\n\n\u4f7f\u7528\n\n\nNSString *dtId = [DTAnalytics getDataTowerId]\n\n3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\n\u8bf4\u660e\n\n\n\u8c03\u7528 trackEventName \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\n+ (void)trackEventName:(NSString *)eventName properties:(NSDictionary *)properties\n\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n eventName\n NSString\n \u662f\n \u4e8b\u4ef6\u540d\u79f0\n\n\n properties\n NSDictionary\n \u5426\n \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nNSDictionary *eventProperties = @{ @\"product_name\": @\"\u5546\u54c1\u540d\"};\n[DTAnalytics trackEventName:@\"product_buy\" properties:eventProperties];\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\n[DTAnalytics trackEventName:@\"dt_track_simple\"]\n\n3.3 \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\n3.3.1 user_set\n\n\n\u8bf4\u660e\n\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userSet \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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\u65b9\u6cd5\n\n\n+ (void)userSet:(NSDictionary *)properties\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n NSDictionary\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userSet:@{@\"username\": @\"dt_name\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n[DTAnalytics userSet:@{@\"username\": @\"dt_name2\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name2\"\n\n3.3.2 user_set_once\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n\n\u65b9\u6cd5\n\n\n+ (void)userSetOnce:(NSDictionary *)properties\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n NSDictionary\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userSetOnce:@{@\"username\": @\"dt_name\"}];\n\/\/ \u5047\u8bbe\"username\"\u4ece\u6765\u6ca1\u88ab\u8bbe\u7f6e\u8fc7\uff0c\u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n[DTAnalytics userSet:@{@\"username\": @\"dt_name2\"}];\n\/\/ \u6b64\u65f6\"username\"\u4ecd\u4e3a\"dt_name\"\n[DTAnalytics userSetOnce:@{@\"username\": @\"dt_name3\"}];\n\/\/ \u6b64\u65f6\"username\"\u4e3a\"dt_name\"\n\n3.3.3 user_add\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n\n\u65b9\u6cd5\n\n\n+ (void)userAdd:(NSDictionary *)properties\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n NSDictionary\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u8bbe\u7f6e\u7528\u6237\u5c5e\u6027\n[DTAnalytics userAdd:@{@\"usermoney\": [NSNumber numberWithInt:6]}];\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 6\n[DTAnalytics userAdd:@{@\"usermoney\": [NSNumber numberWithInt:6]}];\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 12\n\n3.3.4 user_unset\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 userUnset \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\n+ (void)userUnset:(NSString *)propertyName\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n propertyName\n NSString\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\n[DTAnalytics userUnset:@\"key1\"];\n\n3.3.5 user_delete\n\n\n\u8bf4\u660e \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\u3002\n\n\u65b9\u6cd5\n\n\n+ (void)userDelete\n\n3.3.6 user_append\n\n\n\u8bf4\u660e \u60a8\u53ef\u4ee5\u8c03\u7528 userAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\n\n\u65b9\u6cd5\n\n\n+ (void)userAppend:(NSDictionary *)properties\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n NSDictionary\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\nNSArray *course = @[@\"History\",@\"Now\"];\nNSDictionary *userAppendProperties = @{\n @\"course\":course,\n};\n \n[DTAnalytics userAppend:userAppendProperties];\n\n3.3.7 user_uniq_append\n\n\n\u8bf4\u660e \u60a8\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 userUniqAppend \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c userAppend \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\n\n\u65b9\u6cd5\n\n\n+ (void)userUniqAppend:(NSDictionary *)properties\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n NSDictionary\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\n[DTAnalytics userAppend:@{@\"user_list\":@[@\"apple\", @\"ball\"]}];\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\n[DTAnalytics userAppend:@{@\"user_list\":@[@\"apple\", @\"cube\"]}];\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\n [DTAnalytics userUniqAppend:@{@\"user_list\":@[@\"apple\", @\"cube\"]}];\n\n3.4 \u8bbe\u7f6e\u652f\u4ed8\u539f\u59cb\u8ba2\u5355 ID\n\n\n\u8bf4\u660e\n\n\nDT \u5e73\u53f0\u5904\u7406\u6570\u636e\u65f6\uff0c\u9700\u8981\u83b7\u53d6 IOS \u652f\u4ed8\u5e73\u53f0\u539f\u59cb\u8ba2\u5355 ID\uff0c\u4ee5\u6b64\u4f5c\u4e3a\u5173\u8054 Apple \u652f\u4ed8\u7528\u6237\u7684\u6807\u8bc6\u3002\u8bf7\u5728\u4f7f\u7528\u652f\u4ed8\u76f8\u5173\u7684\u4e8b\u4ef6\u4e0a\u62a5\u65f6\uff0c\u52a1\u5fc5\u8c03\u7528\u6b64\u65b9\u6cd5\u3002\n\n\n\u65b9\u6cd5\n\n\n+ (void)setIasOriginalOrderId:(NSString *)oorderId;\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n orderId\n NSString\n \u662f\n Apple \u652f\u4ed8\u539f\u59cb\u8ba2\u5355 ID\n\n\n\n\n\n\u4f7f\u7528\n\n\n[DTAnalytics setIasOriginalOrderId:@\"123434\"]\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n4.1.1 \u5e7f\u544a\u53d8\u73b0\n\n\n\u8bf4\u660e\n\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u7cfb\u7edf\u7684 NSUUID \u6765\u5b9e\u73b0\u3002\n\u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\n\n\n \u4e8b\u4ef6\u540d\u79f0\n \u663e\u793a\u540d\n \u4e8b\u4ef6\u63cf\u8ff0\n\n\n\n\n #ad_load_begin\n \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb\n \u5e7f\u544a\u52a0\u8f7d\u5f00\u59cb\n\n\n #ad_load_end\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u675f\n\n\n #ad_to_show\n \u5e7f\u544a\u9884\u5c55\u793a\n \u5c06\u8981\u5c55\u793a\u5e7f\u544a\n\n\n #ad_show\n \u5e7f\u544a\u5c55\u793a\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u4e0a\u62a5\n\n\n #ad_show_failed\n \u5e7f\u544a\u5c55\u793a\u5931\u8d25\n \u5e7f\u544a\u5c55\u793a\u5931\u8d25\n\n\n #ad_close\n \u5e7f\u544a\u5173\u95ed\n \u5e7f\u544a\u5df2\u7ecf\u5173\u95ed\n\n\n #ad_click\n \u5e7f\u544a\u70b9\u51fb\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u5e7f\u544a\u70b9\u51fb\u65f6\u4e0a\u62a5\n\n\n #ad_rewarded\n \u5e7f\u544a\u83b7\u5f97\u5956\u52b1\n \u53ea\u9488\u5bf9\u6fc0\u52b1\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\n\n\n #ad_conversion\n \u5e7f\u544a\u6536\u76ca\n \u53c2\u4e0e\u5e7f\u544a\u6536\u76ca\u8ba1\u7b97\u7684\u91cd\u8981\u4e8b\u4ef6\uff1b\u5728\u7528\u6237\u83b7\u5f97\u5e7f\u544a\u5956\u52b1\u540e\u4e0a\u62a5\n\n\n #ad_paid\n \u5e7f\u544a\u5c55\u793a\u4ef7\u503c\n \u5e7f\u544a\u5e73\u53f0\u7ed9\u6bcf\u4e2a\u5e7f\u544a\u7684\u9884\u4f30\u4ef7\u503c\n\n\n\n\n\n\u63a5\u53e3\u5217\u8868\n\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\n+ (void) reportLoadBegin:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n seq:(NSString *)seq\n properties:(NSDictionary *)properties;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\n+ (void) reportLoadEnd:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n duration:(NSNumber *)duration\n result:(BOOL)result\n seq:(NSString *)seq\n errorCode:(NSInteger)errorCode\n errorMessage:(NSString *)errorMessage\n properties:(NSDictionary *)properties;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\n+ (void) reportToShow:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\n+ (void) reportShow:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\n+ (void) reportAdShowFail:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n errorCode:(NSInteger)errorCode\n errorMessage:(NSString *)errorMessage\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\n+ (void) reportClose:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\n+ (void) reportClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n mediation:(DTAdMediation)mediation\n mediationId:(NSString *)mediationId\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\n+ (void) reportClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\n+ (void) reportConversionByClick:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\n+ (void) reportConversionByRewarded:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\n+ (void) reportConversionByLeftApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\n+ (void) reportPaid:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n value:(NSString *)value\n currency:(NSString *)currency\n precision:(NSString *)precision\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n \n+ (void) reportPaid:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n mediation:(DTAdMediation)mediation\n mediationId:(NSString *)mediationId\n value:(NSString *)value\n precision:(NSString *)precision\n country:(NSString *)country\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n+ (void) reportLeftApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\/\/ \u4e0a\u62a5\u8fd4\u56deapp\u4e8b\u4ef6\uff0c\u5728\u8bbf\u95ee\u5e7f\u544a\u94fe\u63a5\uff0c\u56de\u5230\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n+ (void) reportReturnApp:(NSString *)adid\n type:(DTAdType)type\n platform:(DTAdPlatform)platform\n location:(NSString *)location\n clickGap:(NSNumber *)clickGap\n returnGap:(NSNumber *)returnGap\n seq:(NSString *)seq\n properties:(NSDictionary *)properties\n entrance:(NSString *)entrance;\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n String\n \u662f\n \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n id\n String\n \u662f\n Network \u5e7f\u544a\u5355\u5143 ID\n\n\n type\n DTAdType\n \u662f\n \u8be6\u89c1 \u7c7b\u578b Type\n\n\n platform\n DTAdPlatform\n \u662f\n \u8be6\u89c1 \u5e7f\u544a\u5e73\u53f0 Platform\n\n\n entrance\n String\n \u5426\n \u5e7f\u544a\u5c55\u793a\u5165\u53e3\n\n\n result\n Boolean\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f\n\n\n duration\n Long\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f\n\n\n location\n String\n \u662f\n \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c\n\n\n errorCode\n Int\n \u5426\n \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801\n\n\n errorMessage\n String\n \u5426\n \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f\n\n\n value\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f\n\n\n currency\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD\n\n\n precision\n String\n \u662f\n \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6\n\n\n country\n String\n \u662f\n \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f\n\n\n mediation\n DTAdMediation\n \u662f\n \u8be6\u89c1 \u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation\n\n\n mediationId\n String\n \u662f\n \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID\n\n\n properties\n NSDictionary\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\u4e8b\u4f8b\n\n\n\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0\n@import DataTowerAICore;\n@import GoogleMobileAds;\n@import UIKit;\n\n@interface ViewController () \n\n@property(nonatomic, strong) GADInterstitialAd *interstitial;\n\n@end\n\n@implementation ViewController\n\n- (void)viewDidLoad {\n [super viewDidLoad];\n\n \/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\n NSString *location = @\"main\";\n\n \/\/ Admob \u5e7f\u544a\u5355\u5143\n NSString *adUnit = @\"ca-app-pub-3940256099942544\/1033173712\";\n\n \/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\n NSString *seq = [NSUUID UUID].UUIDString;\n\n\n GADRequest *request = [GADRequest request];\n [GADInterstitialAd loadWithAdUnitID:adUnit\n request:request\n completionHandler:^(GADInterstitialAd *ad, NSError *error) {\n\n }];\n\n - (IBAction)showad:(id)sender {\n if (self.interstitial) {\n [self.interstitial presentFromRootViewController:self];\n } else {\n NSLog(@\"Ad wasn't ready\");\n }\n}\n\n\/\/ \u5c55\u793a\u5931\u8d25\u7684\u56de\u8c03\n- (void)ad:(nonnull id)ad\ndidFailToPresentFullScreenContentWithError:(nonnull NSError *)error {\n\n}\n\n\/\/ \u5173\u95ed\u7684\u56de\u8c03\n- (void)adDidDismissFullScreenContent:(nonnull id)ad {\n NSLog(@\"Ad did dismiss full screen content.\");\n}\n\n \/\/ \u70b9\u51fb\u7684\u56de\u8c03\uff08\u5982\u679c\u6709\u7684\u8bdd\uff09\n - (void)adClicked{\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u8f6c\u5316\n [DTAdReport reportConversionByClick:adUnit type:DTAdTypeInterstitial\n platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n }\n}\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\n\/\/ \u83b7\u5f97\u6fc0\u52b1\u7684\u56de\u8c03\uff08\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff09\n - (void)adRewarded{\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u8f6c\u5316\n [DTAdReport reportConversionByRewarded:adUnit type:DTAdTypeInterstitial\n platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n }\n\n\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n_\/\/\/ \u5c55\u793a\u7684\u56de\u8c03\n- (void)adWillPresentFullScreenContent:(nonnull id)ad {\n NSLog(@\"Ad will present full screen content.\");\n \/\/ \u4e0a\u62a5\u5c55\u793a\n [DTAdReport reportShow:adUnit type:DTAdTypeInterstitial platform:DTAdPlatformAdmob location:location seq:seq properties:@{} entrance:@\"\"];\n\n__}_\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\n+ (void)reportPurchased:(NSString *)order\n sku:(NSString *)sku\n price:(NSNumber *)price\n currency:(NSString *)currency\n seq:(NSString *)seq\n placement:(NSString *)placement;\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n NSString\n \u662f\n \u8d2d\u4e70\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n placement\n NSString\n \u662f\n \u8d2d\u4e70\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\uff0c\u53ef\u4e3a\u7a7a\n\n\n currency\n NSString\n \u662f\n \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n NSNumber\n \u662f\n \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n NSString\n \u662f\n \u8d2d\u4e70\u5546\u54c1 id\n\n\n order\n NSString\n \u662f\n \u8d2d\u4e70\u8ba2\u5355\n\n\n\n4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\n+ (void)reportSubscribeSuccess:(NSString *)seq\n entrance:(NSString *)entrance\n placement:(NSString *)placement\n sku:(NSString *)sku\n orderId:(NSString *)orderId\n originalOrderId:(NSString *)originalOrderId\n price:(NSString *)price\n currency:(NSString *)currency\n properties:(NSDictionary *)properties;\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n NSString\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n entrance\n NSString\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u5165\u53e3\n\n\n placement\n NSString\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\n\n\n currency\n NSString\n \u662f\n \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n NSString\n \u662f\n \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n NSString\n \u662f\n \u8ba2\u9605\u5546\u54c1 id\n\n\n orderId\n NSString\n \u662f\n \u8ba2\u9605\u8ba2\u5355\n\n\n originalOrderId\n NSString\n \u662f\n \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id\n\n\n properties\n NSDictionary\n \u662f\n \u81ea\u5b9a\u4e49\u5c5e\u6027\n\n\n\n4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n4.2.1 \u900f\u4f20 dt_id\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528\u83b7\u53d6 dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\nNSString *dtId = [DTAnalytics getDataTowerId];\n\n4.2.2 \u5173\u8054\u4e09\u65b9 ID\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\n[DTAnalytics setFirebaseAppInstanceId:\"\"];\n\/\/ AppsFlyer\n[DTAnalytics setAppsFlyerId:@\"\"];\n\/\/ Adjust\n[DTAnalytics setAdjustId:@\"\"];\n\/\/ Kochava\n[DTAnalytics setKochavaId:@\"\"];\n\/\/ Tenjin\n[DTAnalytics setTenjinId:@\"\"];\n\n\n\n\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027\n\n\n\n\n\n \u8c03\u7528\u63a5\u53e3\n \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0\n \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027\n \u7528\u6237\u5c5e\u6027\n\n\n\n\n setFirebaseAppInstanceId()\n Firebase\n #firebase_iid\n #latest_firebase_iid\n\n\n setAppsFlyerId()\n AppsFlyer\n #appsflyer_id\n #latest_appsflyer_id\n\n\n setAdjustId()\n Adjust\n #adjust_id\n #latest_adjust_id\n\n\n setKochavaId()\n Kochava\n #kochava_id\n #latest_kochava_id\n\n\n setTenjinId()\n Tenjin\n #tenjin_id\n #latest_tenjin_id\n\n\n\n4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 DTAnalyticsUtils \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 trackTimerStart \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 trackTimerEnd\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 #duration \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 trackTimerStart\\ trackTimerPause \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 trackTimerEnd\\ trackTimerResume \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerStart@\"event\"]\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerPause@\"event\"]\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerResume@\"event\"]\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6\n[DTAnalyticsUtils trackTimerEnd@\"event\"]","is_draft":"0","editor_type":"2","file_path":"","add_time":"1698725548","update_time":"1725348653"},"pure_content":"\u24d8 \u63d0\u793a\niOS SDK \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0\n\n\u6700\u65b0\u7248\u672c\uff1a\n\n\u4e00\u3001\u81ea\u52a8\u96c6\u6210\n\nSwift Package Manager\n\nAdd the following to your Package.swift file:\ndependencies:\n.package(url: \"https:\/\/github.com\/lovinjoy\/datatower.ai-core-ios\",fr"},{"id":"49189","string_id":"voKHdh","status":"1","parent_id":"80675","slug":"Unity_SDK","order":"2","name":"Unity","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1698725993","update_time":"1727173183","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"49189","content":"> \u24d8 \u63d0\u793a \n> Unity SDK \u6700\u4f4e\u517c\u5bb9 Unity 2019.3.14 \u7248\u672c\uff0c\u652f\u6301\u5e73\u53f0\uff1aAndroid\u3001iOS\n\n> **\u26a0\ufe0f<\/span> \u8fc1\u79fb\u987b\u77e5** \n> \u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n>\n> **?<\/span>** \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f \n> \u8bf7\u67e5\u770b[\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b](https:\/\/docs.datatower.ai\/docs\/sdk-migrate-to-3_0_0#Unity)\u3002\n\n\u6700\u65b0\u7248\u672c\uff1a \n[![GitHub release (with filter)](https:\/\/img.shields.io\/github\/v\/release\/datatower-ai\/sdk-core-unity?style=for-the-badge&logo=unity&logoColor=f7f7f7&label=Unity&labelColor=000000)](https:\/\/github.com\/datatower-ai\/sdk-core-unity\/releases\/latest)\n\n\u6700\u65b0\u7248\u672c\uff08\u542b Beta \u7248\uff09\uff1a\n[![](https:\/\/img.shields.io\/github\/v\/release\/datatower-ai\/sdk-core-unity?include_prereleases&style=for-the-badge&logo=unity&logoColor=f7f7f7&label=Unity%20(w%2F%20beta)&labelColor=000000)](https:\/\/github.com\/datatower-ai\/sdk-core-unity\/releases) (Android ONLY)\n\n# \u4e00\u3001\u96c6\u6210\n\n1.[\u4e0b\u8f7d Unity SDK \u8d44\u6e90\u5305](https:\/\/github.com\/datatower-ai\/sdk-core-unity\/releases)\n\n2.\u5c06\u4e0a\u8ff0\u6587\u4ef6\u901a\u8fc7 Assets \u2192 Import Package \u2192 Custom Package \u6dfb\u52a0\u5230\u9879\u76ee\u4e2d\n\n3.\u5c06 DataTower\/ \u76ee\u5f55\u4e0b\u7684 DTSDK.prefab \u9884\u5236\u4f53\u62d6\u5230\u9700\u8981\u52a0\u8f7d\u7684\u4f4d\u7f6e\uff08\u4e00\u822c\u653e\u5728\u7b2c\u4e00\u4e2a\u573a\u666f\uff09\n\n ![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/voKHdh\/65408158645d2.png)\n\n ![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/voKHdh\/65408168e6750.png)\n\n4.\u914d\u7f6e SDK\n\n ![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/voKHdh\/654081758cff5.png)\n\n - Android \uff08iOS\uff09 App Id\uff1a\u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n - serverUrl\uff1a\u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n - Channel\uff1a\u6e20\u9053\u540d\u79f0\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u5982 gp\u3001app_store\uff0c\u9ed8\u8ba4\u4e3a\u201c\u201d\uff0c\u53ef\u4e0d\u586b\n - Is Debug\uff1a\u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0c**\u4e0a\u7ebf\u524d\u8bf7\u786e\u8ba4\u5173\u95ed**\n - Log Level\uff1alog \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a Log.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548\n - Manual Enable Upload\uff1a\u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 DTAnalytics.EnableUpload() \u5f00\u542f\u4e0a\u62a5\n\n5.\u62c9\u53d6\u4f9d\u8d56\n\n - Android\n\n ![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/voKHdh\/66c2f99e9cb2b.png)\n\n - iOS\n\n ![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/voKHdh\/66c2f9b7dbd12.png)\n\n\n# \u4e8c\u3001\u521d\u59cb\u5316\n\n- \u62d6\u5165\u573a\u666f\u81ea\u52a8\u521d\u59cb\u5316\n\n# \u4e09\u3001\u57fa\u7840\u529f\u80fd\n## ID \u4f53\u7cfb\n### 3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 `setAccountId` \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 `setAccountId` \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n```csharp\nusing DataTower.Core;\n\n\/\/ \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\nDTAnalytics.SetAccountId(\"123456\");\n```\n\n### 3.1.2 \u83b7\u53d6 DT ID\n\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\n\n```csharp\nusing DataTower.Core;\n\nDTAnalytics.GetDataTowerId(dt_id =>\n{\n \/\/ ...\n});\n```\n\n## 3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\u8c03\u7528 `Track` \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n- properties: \u4e8b\u4ef6\u5c5e\u6027[*](#%E4%BA%94%E3%80%81%E5%BC%80%E5%8F%91%E6%97%B6%20Debug)\n\n```csharp\nDictionary properties = Dictionary();\nproperties.Add(\"test_property_3\", false);\nproperties.Add(\"test_property_4\", 2.3);\n\nDTAnalytics.Track(\"test_track\", properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.Track(\"test_track\");\n```\n\n## 3.3 \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\n### 3.3.1 user_set\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userSet` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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```csharp\n\/\/ \u6b64\u65f6username\u4e3adt_name\nDTAnalytics.UserSet(new Dictionary(){{\"user_name\", \"dt_name\"}});\n\/\/ \u6b64\u65f6username\u4e3adt_name2\nDTAnalytics.UserSet(new Dictionary(){{\"user_name\", \"dt_name2\"}});\n```\n\n### 3.3.2 user_set_once\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n```csharp\n\/\/ \u6b64\u65f6username\u4e3adt_name\nDTAnalytics.UserSetOnce(new Dictionary(){{\"user_name\", \"dt_name\"}});\n\/\/ \u6b64\u65f6username\u4ecd\u4e3adt_name\nDTAnalytics.UserSetOnce(new Dictionary(){{\"user_name\", \"dt_name2\"}});\n```\n\n### 3.3.3 user_add\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n```csharp\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 6\nDTAnalytics.UserAdd(new Dictionary(){{\"usermoney\", 6}});\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 12\nDTAnalytics.UserAdd(new Dictionary(){{\"usermoney\", 6}});\n```\n\n### 3.3.4 user_unset\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 `userUnset` \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n```csharp\n\/\/ \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\nDTAnalytics.UserUnset(\"user_password\");\n```\n\n### 3.3.5 user_delete\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\u3002\n\n```csharp\nDTAnalytics.UserDelete();\n```\n\n### 3.3.6 user_append\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\n\n```csharp\nvar dictionary = new Dictionary();\nvar lst = new List();\nlst.Add(\"english\");\ndictionary.Add(\"course\", lst);\nDTAnalytics.UserAppend(dictionary);\n```\n\n### 3.3.7 user_uniq_append\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 `userUniqAppend` \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c `userAppend` \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\n\n```csharp\nvar dictionary = new Dictionary();\nvar lst = new List();\nlst.Add(\"english\");\nlst.Add(\"math\");\ndictionary.Add(\"course\", lst);\nDTAnalytics.UserUniqAppend(dictionary);\n```\n\n# \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n## 4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n\n### 4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n- **\u8bf4\u660e**\n\n1. \u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n2. \u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u7cfb\u7edf\u7684 NSUUID \u6765\u5b9e\u73b0\u3002\n3. \u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n```csharp\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nvoid ReportLoadBegin(string id, AdType type, AdPlatform platform, string seq,\n Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d \nvoid ReportLoadEnd(string id, AdType type, AdPlatform platform, long duration, bool result,\n string seq, int errorCode = 0, string errorMessage = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\") \n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5c55\u793a\u8bf7\u6c42\nvoid ReportToShow(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nvoid ReportShow(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nvoid ReportClick(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5173\u95ed \nvoid ReportClose(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u6fc0\u52b1\u5e7f\u544a\u5df2\u83b7\u5f97\u5956\u52b1\nvoid ReportRewarded(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nvoid ReportConversionByClick(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nvoid ReportConversionByLeftApp(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nvoid ReportConversionByRewarded(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nfun reportPaid(string id, AdType type, AdPlatform platform, string location, string seq,\n string value, string currency, string precision, string entrance = \"\",\n Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\nfun reportPaid(string id, AdType type, string platform, string adgroupName, string adgroupType,\n string location, string seq,\n AdMediation mediation, string mediationId, string value, string currency, string precision, string country,\n string entrance = \"\", Dictionary properties = null)\n\nfun reportPaid(string id, AdType type, AdPlatform platform, string location, string seq,\n AdMediation mediation, string mediationId, string value, string precision, string country,\n Dictionary properties = null)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nfun reportLeftApp(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | ----------- | -------- | --------------------------------------------------------- |\n| seq | String | \u662f | \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| id | String | \u662f | \u5177\u4f53\u5e7f\u544a ID |\n| type | AdType | \u662f | UNKNOWN = -1 \/\/ \u672a\u77e5 BANNER = 0 \/\/\u6a2a\u5e45 INTERSTITIAL = 1 \/\/\u63d2\u5c4f NATIVE = 2 \/\/\u539f\u751f REWARDED = 3 \/\/\u6fc0\u52b1 REWARDED_INTERSTITIAL = 4 \/\/\u63d2\u5c4f\u6fc0\u52b1 APP_OPEN = 5 \/\/\u5f00\u5c4f\u5e7f\u544a |\n| platform | AdPlatform | \u662f | UNDISCLOSED = -2 \/\/ \u672a\u6388\u6743
UNKNOWN = -1 \/\/ \u672a\u77e5
ADMOB = 0
MOPUB = 1
ADCOLONY = 2
APPLOVIN = 3
CHARTBOOST = 4
FACEBOOK = 5
INMOBI = 6
IRONSOURCE = 7
PANGLE = 8
SNAP_AUDIENCE_NETWORK = 9
TAPJOY = 10
UNITY_ADS = 11
VERIZON_MEDIA = 12
VUNGLE = 13
ADX = 14
COMBO = 15
BIGO = 16
HISAVANA = 17
APPLOVIN_EXCHANGE = 18
MINTEGRAL = 19
LIFTOFF = 20
A4G = 21
GOOGLE_AD_MANAGER = 22
FYBER = 23
MAIO = 24
CRITEO = 25
MYTARGET = 26
OGURY = 27
APPNEXT = 28
KIDOZ = 29
SMAATO = 30
START_IO = 31
VERVE = 32
LOVINJOY_ADS = 33
YANDEX = 34
REKLAMUP = 35 |\n| mediation | AdMediation | \u5426 | \u5982\u679c\u4e0d\u4f7f\u7528\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff0c\u8bf7\u4f20\u5165-1MOPUB = 0 MAX = 1 HISAVANA = 2 COMBO = 3TOPON = 4TRADPLUS = 5TOBID = 6 |\n| mediationId | String | \u5426 | \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID |\n| entrance | String | \u5426 | \u5e7f\u544a\u5c55\u793a\u5165\u53e3 |\n| result | Boolean | \u662f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f |\n| duration | Long | \u662f | \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f |\n| location | String | \u662f | \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c |\n| errorCode | Int | \u5426 | \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801 |\n| errorMessage | String | \u5426 | \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f |\n| value | String | \u662f | \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f |\n| currency | String | \u662f | \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD |\n| precision | String | \u662f | \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6 |\n| country | String | \u662f | \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f |\n| properties | Dictionary | \u5426 | \u81ea\u5b9a\u4e49\u5c5e\u6027[*](#%E4%BA%94%E3%80%81%E5%BC%80%E5%8F%91%E6%97%B6%20Debug) |\n\nAdmob \u6fc0\u52b1\u5e7f\u544a\u7684\u8fc7\u7a0b\u4f5c\u4e3a\u6f14\u793a\uff08\uff09\n\n```csharp\n\/*\n * \u4e00\u6b21\u5c55\u793a\u6fc0\u52b1\u5e7f\u544a\u7684\u8fc7\u7a0b\n *\/\n AdmobSdkCallbacks.Rewarded.OnAdDisplayedEvent += OnRewardedVideoShownEvent;\n AdmobSdkCallbacks.Rewarded.OnAdClickedEvent += OnRewardedVideoClickedEvent;\n AdmobSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnRewardedAdRevenuePaidEvent;\n AdmobSdkCallbacks.Rewarded.OnAdHiddenEvent += OnRewardedVideoClosedEvent;\n AdmobSdkCallbacks.Rewarded.OnAdDisplayFailedEvent += OnRewardedVideoFailedToPlayEvent;\n AdmobSdkCallbacks.Rewarded.OnAdReceivedRewardEvent += OnRewardedVideoReceivedRewardEvent;\n\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nstring location = \"main\"\n\n\/\/ MAX \u5e7f\u544a\u5355\u5143\nstring adUnitId = \"3940256099942544\/1033173712\"\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nstring seq = UUID()\n\n\/\/ \u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nloadInterstitialAd(adUnitId);\n\n\/\/ \u5c55\u793a\u5e7f\u544a\nshowInterstitialAd()\n\n......\n\n\/\/ \u5e7f\u544a\u56de\u8c03\n\n\/\/ \u5e7f\u544a\u5c55\u793a\u6210\u529f\nprivate void OnRewardedVideoShownEvent(string adUnitId, AdInfo adInfo){\n DTAdReport.ReportShow(adUnitId, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\nprivate void OnRewardedVideoFailedToPlayEvent(string adUnitId,ErrorInfo error, AdInfo adInfo){\n\n}\n\n\/\/ \u5e7f\u544a\u88ab\u70b9\u51fb\nprivate void OnRewardedVideoClickedEvent(string adUnitId, AdInfo adInfo){\n DTAdReport.ReportConversionByClick(adUnitId, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\nprivate void OnRewardedVideoClosedEvent(string adUnitId, AdInfo adInfo){\n\n}\n\n\/\/ \u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\nprivate void OnRewardedVideoReceivedRewardEvent(string adUnitId, Reward reward, AdInfo adInfo){\n DTAdReport.ReportConversionByRewared(adUnitId), AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n```\n\n**\u573a\u666f\u4e00\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0**\n\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\u7684\u5e7f\u544a\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 OnRewardedVideoShownEvent \u56de\u8c03\n\n```kotlin\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\nprivate void OnRewardedVideoShownEvent(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n val adPlatform = getAdPlatform(ad)\n val adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL,adPlatform,location, seq)\n }\n```\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n\n### 4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```csharp\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nstring seq = UUID()\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5 (Android)\nDTIAPReport.ReportPurchaseSuccessAndroid(order, \"sku123\", 3.32, \"rmb\", new Dictionary());\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5 (iOS)\nDTIAPReport.ReportPurchaseSuccessIos(order, \"sku123\", 3.32, \"rmb\", seq, \"user\");\n```\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------- | ------ | -------- | --------------------------------------------------- |\n| seq | string | \u662f | \u8d2d\u4e70\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| placement | string | \u662f | \u8d2d\u4e70\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\uff0c\u53ef\u4e3a\u7a7a |\n| currency | string | \u662f | \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| price | Double | \u662f | \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| sku | string | \u662f | \u8d2d\u4e70\u5546\u54c1 id |\n| order | string | \u662f | \u8d2d\u4e70\u8ba2\u5355 |\n| properties | Dictionary | \u5426 | \u81ea\u5b9a\u4e49\u5c5e\u6027[*](#%E4%BA%94%E3%80%81%E5%BC%80%E5%8F%91%E6%97%B6%20Debug) |\n\n### 4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```csharp\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nvar seq = UUID();\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5 (Android)\nDTIASReport.ReportSubscribeSuccessAndroid(originalOrderId, orderId, sku, price, currency, properties);\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5 (iOS)\nDTIASReport.ReportSubscribeSuccessIos(seq, placement, sku, orderId, originalOrderId, price, currency, entrance);\n```\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------------- | ---------- | -------- | --------------------------------------------------- |\n| seq | string | \u662f | \u8ba2\u9605\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6 |\n| entrance | string | \u662f | \u8ba2\u9605\u884c\u4e3a\u5165\u53e3 |\n| placement | string | \u662f | \u8ba2\u9605\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e |\n| currency | string | \u662f | \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| price | string | \u662f | \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| sku | string | \u662f | \u8ba2\u9605\u5546\u54c1 id |\n| orderId | string | \u662f | \u8ba2\u9605\u8ba2\u5355 |\n| originalOrderId | string | \u662f | \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id |\n| properties | Dictionary | \u5426 | \u81ea\u5b9a\u4e49\u5c5e\u6027[*](#%E4%BA%94%E3%80%81%E5%BC%80%E5%8F%91%E6%97%B6%20Debug) |\n\n## 4.2 \u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\nDT \u5e73\u53f0\u63d0\u4f9b\u4e24\u79cd\u65b9\u5f0f\u8fdb\u884c\u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\n1. \u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\uff1a\u901a\u8fc7 DT SDK \u4e0a\u62a5\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u81f3 DT \u5e73\u53f0\uff0c\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u624b\u52a8\u6388\u6743\u83b7\u53d6\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\uff0cDT \u5e73\u53f0\u901a\u8fc7\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u4e0e\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\u4e2d\u7684 ID \u8fdb\u884c\u5173\u8054\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n2. \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\uff1a\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u83b7\u53d6 DT \u56de\u8c03\u5730\u5740\uff0c\u5e76\u5c06\u5176\u586b\u5199\u81f3\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\uff0cDT \u5e73\u53f0\u901a\u8fc7\u63a5\u6536\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u4fe1\u606f\u4ee5\u53ca\u4e0a\u62a5\u5bf9\u5e94\u7684\u5f52\u56e0\u5e73\u53f0 ID\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\n### 4.2.1 \u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\n\n#### 4.2.1.1 AppsFlyer\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 AppsFlyer \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 AppsFlyer SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 `SetAppsFlyerId` \u63a5\u53e3\u8bbe\u7f6e AppsFlyer ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\n\n```csharp\n\/\/ \u9700\u8981\u901a\u8fc7 AppsFlyer SDK \u83b7\u53d6 appsFlyer_id\nDTAnalytics.SetAppsFlyerId(\"appsFlyer_id\");\n```\n\n#### 4.2.1.2 Kochava\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Kochava \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Kochava SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 `setKochavaId` \u63a5\u53e3\u8bbe\u7f6e Kochava ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\u3002\n\n```csharp\n\/\/ \u9700\u8981\u901a\u8fc7 Kochava SDK \u83b7\u53d6 kochava_id\nDTAnalytics.SetKochavaId(\"kochava_id\");\n```\n\n### 4.2.2 \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\n\n#### 4.2.2.1 Adjust\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Adjust \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Adjust SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 `setAdjustId` \u63a5\u53e3\u8bbe\u7f6e Adjust ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\n\n```csharp\n\/\/ \u9700\u8981\u901a\u8fc7 Adjust SDK \u83b7\u53d6 adjust_id\nDTAnalytics.SetAdjustId(\"adjust_id\");\n```\n\n#### 4.2.2.2 Tenjin\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Tenjin \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Tenjin SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 `setTenjinId` \u63a5\u53e3\u8bbe\u7f6e Tenjin ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\u3002\n\n```csharp\n\/\/ \u9700\u8981\u901a\u8fc7 Tenjin SDK \u83b7\u53d6 Tenjin_id\nDTAnalytics.SetTenjinId(\"tenjin_id\");\n```\n\n## 4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 `DTAnalyticsUtils` \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 `TrackTimerStart` \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 `TrackTimerEnd`\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 `#duration` \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 ` TrackTimerStart`\\ `TrackTimerPause` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 `TrackTimerEnd`\\ `TrackTimerResume` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n\n```csharp\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerPause(\"event\")\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerResume(\"event\")\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerEnd(\"event\")\n \/\/ \u53ef\u4ee5\u81ea\u5b9a\u4e49\u5c5e\u6027\nDTAnalyticsUtils.TrackTimerEnd(\"event\", new Dictionary(){{\"usermoney\", 6}} )\n```\n\n## 4.4 Firebase \u670d\u52a1\u7aef\u6253\u70b9\n\n\u5982\u679c\u9700\u8981\u5728 Firebase \u4f7f\u7528 DT \u7cfb\u7edf\u4e8c\u6b21\u52a0\u5de5\u7684\u7528\u6237\u6570\u636e\uff0c\u5219\u9700\u8981\u8c03\u7528 `SetFirebaseAppInstanceId` \u8bbe\u7f6e Firebase \u7684 app_instance_id\uff0c\u6839\u636e app_instance_id\uff0c\u7528\u6237\u53ef\u4ee5\u7ed9 firebase \u4e0a\u62a5\u81ea\u5b9a\u4e49\u7684\u7528\u6237\u6570\u636e\n\n```csharp\n\/\/ \u9700\u8981\u5148\u83b7\u53d6Firebase \u7684 app_instance_id\nDTAnalytics.SetFirebaseAppInstanceId(\"app_instance_id\");\n```\n\n## 4.5 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n\n### 4.5.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\n\n```csharp\nDictionary staticProps = new() {\n {\"key\", \"value\"}\n};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.SetStaticCommonProperties(staticProps);\n\n\/\/ \u6e05\u9664\nDTAnalytics.ClearStaticCommonProperties();\n```\n\n### 4.5.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\n\n```csharp\nDictionary dynamicProps = new() {\n {\"key\", \"value\"}\n};\n\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.SetDynamicCommonProperties(() => dynamicProps);\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\nDTAnalytics.Track(\"simple_event\")\n\n\/\/ \u6e05\u9664\nDTAnalytics.ClearDynamicCommonProperties();\n```\n\n## 4.6 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed ![](https:\/\/img.shields.io\/badge\/for-3.1.0--beta1+-orange)\nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n\n### 4.6.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n| \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6 | \u65f6\u673a | \n| ------------------- | ------------ |\n| #app_install\uff08app\u5b89\u88c5\uff09 | App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6 |\n| #session_start\uff08app\u6253\u5f00 | App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09|\n| #session_end\uff08app\u5173\u95ed\uff09 | App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09|\n\n### 4.6.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u4efb\u4f55\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002 \n\n```csharp\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDTAnalytics.DisableAutoTrack(DTPresetEvent);\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDTAnalytics.EnableAutoTrack(DTPresetEvent);\n```\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n- #app_install,\n- #session_start,\n- #session_end\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/iKbFWS\/66f0e1671e8d1.png)\n\n\n### 4.6.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n| \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b | \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e | \n| ------------------- | ------------ |\n| user_set |\u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5 |\n| user_set_once|\u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5|\n\n### 4.6.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\n**\u7279\u6b8a\u8bf4\u660e**\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n| \u5c5e\u6027 | \u8bf4\u660e\u8bf4\u660e | \n| ----------------| ------------ |\n| #bundle_id |\u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n| #app_id|DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5|\n| #debug |\u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n| #dt_id|\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #acid |\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #session_id|\u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n| #sdk_type |\u5224\u65adSDK\u7c7b\u578b\n| #sdk_version_name |\u5224\u65adSDK\u7248\u672c\n\n#### Android\n**\u914d\u7f6e\u65b9\u5f0f**\n1. \u914d\u7f6e\u6587\u4ef6\u4e8e\uff1a `Assets\/Plugins\/Android\/DataTowerSdk.androidlib\/res\/values\/dt_disable_preset_properties.xml`\n3. \u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n**\u793a\u4f8b**\n```xml\n\n\n \n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>\n```\n\n# \u4e94\u3001\u5f00\u53d1\u65f6 Debug\n\n> \u4ec5\u5728 Editor \u4e0b\u8fd0\u884c\u8d77\u6548\n\n\u8c03\u7528 API \u4f1a\u5bf9\u4f20\u53c2\u8fdb\u884c\u6821\u9a8c\uff0c\u4e0d\u901a\u8fc7\u7684\u8c03\u7528\u5c06\u4f1a\u629b\u51fa\u5f02\u5e38\uff08ArgumentException\uff09\uff0c\u5e76\u63d0\u4f9b\u76f8\u5173\u9519\u8bef\u4fe1\u606f\u4ee5\u5e2e\u52a9 Debug\u3002","pure_content":"\u24d8 \u63d0\u793a\nUnity SDK \u6700\u4f4e\u517c\u5bb9 Unity 2019.3.14 \u7248\u672c\uff0c\u652f\u6301\u5e73\u53f0\uff1aAndroid\u3001iOS\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\u6700\u65b0\u7248\u672c\uff1a\n\n\u6700\u65b0\u7248\u672c\uff08\u542b Beta \u7248\uff09\uff1a\n (Android ONLY)\n\u4e00\u3001\u96c6\u6210\n1.\u4e0b\u8f7d Unity SDK \u8d44\u6e90\u5305\n2.\u5c06\u4e0a\u8ff0\u6587\u4ef6\u901a\u8fc7 Assets \u2192 Import Package \u2192 Custom Package \u6dfb\u52a0\u5230\u9879\u76ee\u4e2d\n3.\u5c06 DataTower\/ \u76ee\u5f55\u4e0b\u7684 DTSDK.prefab \u9884\u5236\u4f53\u62d6\u5230\u9700\u8981\u52a0\u8f7d\u7684\u4f4d\u7f6e\uff08\u4e00\u822c\u653e\u5728\u7b2c\u4e00\u4e2a\u573a\u666f\uff09\n\n\n4.\u914d\u7f6e SDK\n\n\nAndroid \uff08iOS\uff09 App Id\uff1a\u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\nserverUrl\uff1a\u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\nChannel\uff1a\u6e20\u9053\u540d\u79f0\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u5982 gp\u3001app_store\uff0c\u9ed8\u8ba4\u4e3a\u201c\u201d\uff0c\u53ef\u4e0d\u586b\nIs Debug\uff1a\u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0c\u4e0a\u7ebf\u524d\u8bf7\u786e\u8ba4\u5173\u95ed\n\nLog Level\uff1alog \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a Log.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548\nManual Enable Upload\uff1a\u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 DTAnalytics.EnableUpload() \u5f00\u542f\u4e0a\u62a5\n\n5.\u62c9\u53d6\u4f9d\u8d56\n\n\nAndroid\n\n\n\niOS\n\n\n\n\u4e8c\u3001\u521d\u59cb\u5316\n\n\u62d6\u5165\u573a\u666f\u81ea\u52a8\u521d\u59cb\u5316\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\nID \u4f53\u7cfb\n3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\nusing DataTower.Core;\n\n\/\/ \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\nDTAnalytics.SetAccountId(\"123456\");\n\n3.1.2 \u83b7\u53d6 DT ID\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\nusing DataTower.Core;\n\nDTAnalytics.GetDataTowerId(dt_id =>\n{\n \/\/ ...\n});\n\n3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\u8c03\u7528 Track \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\nproperties: \u4e8b\u4ef6\u5c5e\u6027*\n\n\nDictionary properties = Dictionary();\nproperties.Add(\"test_property_3\", false);\nproperties.Add(\"test_property_4\", 2.3);\n\nDTAnalytics.Track(\"test_track\", properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.Track(\"test_track\");\n\n3.3 \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\n3.3.1 user_set\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userSet \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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\/\/ \u6b64\u65f6username\u4e3adt_name\nDTAnalytics.UserSet(new Dictionary(){{\"user_name\", \"dt_name\"}});\n\/\/ \u6b64\u65f6username\u4e3adt_name2\nDTAnalytics.UserSet(new Dictionary(){{\"user_name\", \"dt_name2\"}});\n\n3.3.2 user_set_once\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\/\/ \u6b64\u65f6username\u4e3adt_name\nDTAnalytics.UserSetOnce(new Dictionary(){{\"user_name\", \"dt_name\"}});\n\/\/ \u6b64\u65f6username\u4ecd\u4e3adt_name\nDTAnalytics.UserSetOnce(new Dictionary(){{\"user_name\", \"dt_name2\"}});\n\n3.3.3 user_add\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 6\nDTAnalytics.UserAdd(new Dictionary(){{\"usermoney\", 6}});\n\/\/ \u6b64\u65f6\"usermoney\"\u4e3a 12\nDTAnalytics.UserAdd(new Dictionary(){{\"usermoney\", 6}});\n\n3.3.4 user_unset\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 userUnset \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\/\/ \u6e05\u7a7a\u7528\u6237\u5c5e\u6027\nDTAnalytics.UserUnset(\"user_password\");\n\n3.3.5 user_delete\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\u3002\nDTAnalytics.UserDelete();\n\n3.3.6 user_append\n\u60a8\u53ef\u4ee5\u8c03\u7528 userAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\nvar dictionary = new Dictionary();\nvar lst = new List();\nlst.Add(\"english\");\ndictionary.Add(\"course\", lst);\nDTAnalytics.UserAppend(dictionary);\n\n3.3.7 user_uniq_append\n\u60a8\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 userUniqAppend \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c userAppend \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\nvar dictionary = new Dictionary();\nvar lst = new List();\nlst.Add(\"english\");\nlst.Add(\"math\");\ndictionary.Add(\"course\", lst);\nDTAnalytics.UserUniqAppend(dictionary);\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n\n\u8bf4\u660e\n\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u7cfb\u7edf\u7684 NSUUID \u6765\u5b9e\u73b0\u3002\n\u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nvoid ReportLoadBegin(string id, AdType type, AdPlatform platform, string seq,\n Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d \nvoid ReportLoadEnd(string id, AdType type, AdPlatform platform, long duration, bool result,\n string seq, int errorCode = 0, string errorMessage = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\") \n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5c55\u793a\u8bf7\u6c42\nvoid ReportToShow(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nvoid ReportShow(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nvoid ReportClick(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u5e7f\u544a\u5173\u95ed \nvoid ReportClose(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5 \u6fc0\u52b1\u5e7f\u544a\u5df2\u83b7\u5f97\u5956\u52b1\nvoid ReportRewarded(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nvoid ReportConversionByClick(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nvoid ReportConversionByLeftApp(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nvoid ReportConversionByRewarded(String id,AdType type, AdPlatform platform, String location, String seq, String entrance = \"\" properties: Dictionary = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n \n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nfun reportPaid(string id, AdType type, AdPlatform platform, string location, string seq,\n string value, string currency, string precision, string entrance = \"\",\n Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\nfun reportPaid(string id, AdType type, string platform, string adgroupName, string adgroupType,\n string location, string seq,\n AdMediation mediation, string mediationId, string value, string currency, string precision, string country,\n string entrance = \"\", Dictionary properties = null)\n\nfun reportPaid(string id, AdType type, AdPlatform platform, string location, string seq,\n AdMediation mediation, string mediationId, string value, string precision, string country,\n Dictionary properties = null)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nfun reportLeftApp(string id, AdType type, AdPlatform platform, string location, string seq,\n string entrance = \"\", Dictionary properties = null, \n AdMediation mediation = AdMediation.**IDLE**, \n string mediationId = \"\")\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n String\n \u662f\n \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n id\n String\n \u662f\n \u5177\u4f53\u5e7f\u544a ID\n\n\n type\n AdType\n \u662f\n UNKNOWN = -1 \/\/ \u672a\u77e5 BANNER = 0 \/\/\u6a2a\u5e45 INTERSTITIAL = 1 \/\/\u63d2\u5c4f NATIVE = 2 \/\/\u539f\u751f REWARDED = 3 \/\/\u6fc0\u52b1 REWARDED_INTERSTITIAL = 4 \/\/\u63d2\u5c4f\u6fc0\u52b1 APP_OPEN = 5 \/\/\u5f00\u5c4f\u5e7f\u544a\n\n\n platform\n AdPlatform\n \u662f\n UNDISCLOSED = -2 \/\/ \u672a\u6388\u6743 UNKNOWN = -1 \/\/ \u672a\u77e5 ADMOB = 0MOPUB = 1 ADCOLONY = 2 APPLOVIN = 3 CHARTBOOST = 4FACEBOOK = 5 INMOBI = 6 IRONSOURCE = 7 PANGLE = 8 SNAP_AUDIENCE_NETWORK = 9 TAPJOY = 10 UNITY_ADS = 11 VERIZON_MEDIA = 12 VUNGLE = 13 ADX = 14 COMBO = 15 BIGO = 16 HISAVANA = 17 APPLOVIN_EXCHANGE = 18 MINTEGRAL = 19LIFTOFF = 20A4G = 21GOOGLE_AD_MANAGER = 22FYBER = 23MAIO = 24CRITEO = 25MYTARGET = 26OGURY = 27APPNEXT = 28KIDOZ = 29SMAATO = 30START_IO = 31VERVE = 32LOVINJOY_ADS = 33YANDEX = 34REKLAMUP = 35\n\n\n mediation\n AdMediation\n \u5426\n \u5982\u679c\u4e0d\u4f7f\u7528\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff0c\u8bf7\u4f20\u5165-1MOPUB = 0 MAX = 1 HISAVANA = 2 COMBO = 3TOPON = 4TRADPLUS = 5TOBID = 6\n\n\n mediationId\n String\n \u5426\n \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID\n\n\n entrance\n String\n \u5426\n \u5e7f\u544a\u5c55\u793a\u5165\u53e3\n\n\n result\n Boolean\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f\n\n\n duration\n Long\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f\n\n\n location\n String\n \u662f\n \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c\n\n\n errorCode\n Int\n \u5426\n \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801\n\n\n errorMessage\n String\n \u5426\n \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f\n\n\n value\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f\n\n\n currency\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD\n\n\n precision\n String\n \u662f\n \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6\n\n\n country\n String\n \u662f\n \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f\n\n\n properties\n Dictionary\n \u5426\n \u81ea\u5b9a\u4e49\u5c5e\u6027*\n\n\n\nAdmob \u6fc0\u52b1\u5e7f\u544a\u7684\u8fc7\u7a0b\u4f5c\u4e3a\u6f14\u793a\uff08\uff09\n\/*\n * \u4e00\u6b21\u5c55\u793a\u6fc0\u52b1\u5e7f\u544a\u7684\u8fc7\u7a0b\n *\/\n AdmobSdkCallbacks.Rewarded.OnAdDisplayedEvent += OnRewardedVideoShownEvent;\n AdmobSdkCallbacks.Rewarded.OnAdClickedEvent += OnRewardedVideoClickedEvent;\n AdmobSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnRewardedAdRevenuePaidEvent;\n AdmobSdkCallbacks.Rewarded.OnAdHiddenEvent += OnRewardedVideoClosedEvent;\n AdmobSdkCallbacks.Rewarded.OnAdDisplayFailedEvent += OnRewardedVideoFailedToPlayEvent;\n AdmobSdkCallbacks.Rewarded.OnAdReceivedRewardEvent += OnRewardedVideoReceivedRewardEvent;\n\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nstring location = \"main\"\n\n\/\/ MAX \u5e7f\u544a\u5355\u5143\nstring adUnitId = \"3940256099942544\/1033173712\"\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nstring seq = UUID()\n\n\/\/ \u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nloadInterstitialAd(adUnitId);\n\n\/\/ \u5c55\u793a\u5e7f\u544a\nshowInterstitialAd()\n\n......\n\n\/\/ \u5e7f\u544a\u56de\u8c03\n\n\/\/ \u5e7f\u544a\u5c55\u793a\u6210\u529f\nprivate void OnRewardedVideoShownEvent(string adUnitId, AdInfo adInfo){\n DTAdReport.ReportShow(adUnitId, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\nprivate void OnRewardedVideoFailedToPlayEvent(string adUnitId,ErrorInfo error, AdInfo adInfo){\n\n}\n\n\/\/ \u5e7f\u544a\u88ab\u70b9\u51fb\nprivate void OnRewardedVideoClickedEvent(string adUnitId, AdInfo adInfo){\n DTAdReport.ReportConversionByClick(adUnitId, AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\nprivate void OnRewardedVideoClosedEvent(string adUnitId, AdInfo adInfo){\n\n}\n\n\/\/ \u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\nprivate void OnRewardedVideoReceivedRewardEvent(string adUnitId, Reward reward, AdInfo adInfo){\n DTAdReport.ReportConversionByRewared(adUnitId), AdType.REWARDED, AdPlatform.ADMOB, location, seq)\n}\n\n\u573a\u666f\u4e00\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\u7684\u5e7f\u544a\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 OnRewardedVideoShownEvent \u56de\u8c03\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\nprivate void OnRewardedVideoShownEvent(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n val adPlatform = getAdPlatform(ad)\n val adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdType.INTERSTITIAL,adPlatform,location, seq)\n }\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nstring seq = UUID()\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5 (Android)\nDTIAPReport.ReportPurchaseSuccessAndroid(order, \"sku123\", 3.32, \"rmb\", new Dictionary());\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5 (iOS)\nDTIAPReport.ReportPurchaseSuccessIos(order, \"sku123\", 3.32, \"rmb\", seq, \"user\");\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n string\n \u662f\n \u8d2d\u4e70\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n placement\n string\n \u662f\n \u8d2d\u4e70\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\uff0c\u53ef\u4e3a\u7a7a\n\n\n currency\n string\n \u662f\n \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n Double\n \u662f\n \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n string\n \u662f\n \u8d2d\u4e70\u5546\u54c1 id\n\n\n order\n string\n \u662f\n \u8d2d\u4e70\u8ba2\u5355\n\n\n properties\n Dictionary\n \u5426\n \u81ea\u5b9a\u4e49\u5c5e\u6027*\n\n\n\n4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6, \u8fd9\u91cc\u81ea\u884c\u751f\u6210\u4e00\u4e2a\u968f\u673a\u5b57\u7b26\u4e32\nvar seq = UUID();\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5 (Android)\nDTIASReport.ReportSubscribeSuccessAndroid(originalOrderId, orderId, sku, price, currency, properties);\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5 (iOS)\nDTIASReport.ReportSubscribeSuccessIos(seq, placement, sku, orderId, originalOrderId, price, currency, entrance);\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n string\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\n\n\n entrance\n string\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u5165\u53e3\n\n\n placement\n string\n \u662f\n \u8ba2\u9605\u884c\u4e3a\u53d1\u751f\u6240\u5728\u7684\u4f4d\u7f6e\n\n\n currency\n string\n \u662f\n \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n string\n \u662f\n \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n string\n \u662f\n \u8ba2\u9605\u5546\u54c1 id\n\n\n orderId\n string\n \u662f\n \u8ba2\u9605\u8ba2\u5355\n\n\n originalOrderId\n string\n \u662f\n \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id\n\n\n properties\n Dictionary\n \u5426\n \u81ea\u5b9a\u4e49\u5c5e\u6027*\n\n\n\n4.2 \u4e09\u65b9\u5f52\u56e0\u96c6\u6210\nDT \u5e73\u53f0\u63d0\u4f9b\u4e24\u79cd\u65b9\u5f0f\u8fdb\u884c\u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\n\u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\uff1a\u901a\u8fc7 DT SDK \u4e0a\u62a5\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u81f3 DT \u5e73\u53f0\uff0c\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u624b\u52a8\u6388\u6743\u83b7\u53d6\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\uff0cDT \u5e73\u53f0\u901a\u8fc7\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u4e0e\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\u4e2d\u7684 ID \u8fdb\u884c\u5173\u8054\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\uff1a\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u83b7\u53d6 DT \u56de\u8c03\u5730\u5740\uff0c\u5e76\u5c06\u5176\u586b\u5199\u81f3\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\uff0cDT \u5e73\u53f0\u901a\u8fc7\u63a5\u6536\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u4fe1\u606f\u4ee5\u53ca\u4e0a\u62a5\u5bf9\u5e94\u7684\u5f52\u56e0\u5e73\u53f0 ID\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\n4.2.1 \u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\n4.2.1.1 AppsFlyer\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 AppsFlyer \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 AppsFlyer SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 SetAppsFlyerId \u63a5\u53e3\u8bbe\u7f6e AppsFlyer ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\n\/\/ \u9700\u8981\u901a\u8fc7 AppsFlyer SDK \u83b7\u53d6 appsFlyer_id\nDTAnalytics.SetAppsFlyerId(\"appsFlyer_id\");\n\n4.2.1.2 Kochava\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Kochava \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Kochava SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 setKochavaId \u63a5\u53e3\u8bbe\u7f6e Kochava ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\u3002\n\/\/ \u9700\u8981\u901a\u8fc7 Kochava SDK \u83b7\u53d6 kochava_id\nDTAnalytics.SetKochavaId(\"kochava_id\");\n\n4.2.2 \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\n4.2.2.1 Adjust\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Adjust \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Adjust SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 setAdjustId \u63a5\u53e3\u8bbe\u7f6e Adjust ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\n\/\/ \u9700\u8981\u901a\u8fc7 Adjust SDK \u83b7\u53d6 adjust_id\nDTAnalytics.SetAdjustId(\"adjust_id\");\n\n4.2.2.2 Tenjin\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Tenjin \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 Tenjin SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u8c03\u7528 setTenjinId \u63a5\u53e3\u8bbe\u7f6e Tenjin ID\uff0cDT \u7cfb\u7edf\u5c06\u7528\u4e8e\u5173\u8054\u7528\u6237\u7684\u5f52\u56e0\u4fe1\u606f\u3002\n\/\/ \u9700\u8981\u901a\u8fc7 Tenjin SDK \u83b7\u53d6 Tenjin_id\nDTAnalytics.SetTenjinId(\"tenjin_id\");\n\n4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 DTAnalyticsUtils \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 TrackTimerStart \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 TrackTimerEnd\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 #duration \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 TrackTimerStart\\ TrackTimerPause \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 TrackTimerEnd\\ TrackTimerResume \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerPause(\"event\")\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerResume(\"event\")\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.TrackTimerEnd(\"event\")\n \/\/ \u53ef\u4ee5\u81ea\u5b9a\u4e49\u5c5e\u6027\nDTAnalyticsUtils.TrackTimerEnd(\"event\", new Dictionary(){{\"usermoney\", 6}} )\n\n4.4 Firebase \u670d\u52a1\u7aef\u6253\u70b9\n\u5982\u679c\u9700\u8981\u5728 Firebase \u4f7f\u7528 DT \u7cfb\u7edf\u4e8c\u6b21\u52a0\u5de5\u7684\u7528\u6237\u6570\u636e\uff0c\u5219\u9700\u8981\u8c03\u7528 SetFirebaseAppInstanceId \u8bbe\u7f6e Firebase \u7684 app_instance_id\uff0c\u6839\u636e app_instance_id\uff0c\u7528\u6237\u53ef\u4ee5\u7ed9 firebase \u4e0a\u62a5\u81ea\u5b9a\u4e49\u7684\u7528\u6237\u6570\u636e\n\/\/ \u9700\u8981\u5148\u83b7\u53d6Firebase \u7684 app_instance_id\nDTAnalytics.SetFirebaseAppInstanceId(\"app_instance_id\");\n\n4.5 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n4.5.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\nDictionary staticProps = new() {\n {\"key\", \"value\"}\n};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.SetStaticCommonProperties(staticProps);\n\n\/\/ \u6e05\u9664\nDTAnalytics.ClearStaticCommonProperties();\n\n4.5.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\nDictionary dynamicProps = new() {\n {\"key\", \"value\"}\n};\n\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.SetDynamicCommonProperties(() => dynamicProps);\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\nDTAnalytics.Track(\"simple_event\")\n\n\/\/ \u6e05\u9664\nDTAnalytics.ClearDynamicCommonProperties();\n\n4.6 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed \nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n4.6.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6\n \u65f6\u673a\n\n\n\n\n #app_install\uff08app\u5b89\u88c5\uff09\n App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\n\n\n #session_start\uff08app\u6253\u5f00\n App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09\n\n\n #session_end\uff08app\u5173\u95ed\uff09\n App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09\n\n\n\n4.6.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u4efb\u4f55\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDTAnalytics.DisableAutoTrack(DTPresetEvent);\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDTAnalytics.EnableAutoTrack(DTPresetEvent);\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n\n#app_install,\n#session_start,\n#session_end\n\n\n4.6.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b\n \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e\n\n\n\n\n user_set\n \u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5\n\n\n user_set_once\n \u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5\n\n\n\n4.6.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\u7279\u6b8a\u8bf4\u660e\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n\n\n\n \u5c5e\u6027\n \u8bf4\u660e\u8bf4\u660e\n\n\n\n\n #bundle_id\n \u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n\n\n #app_id\n DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\n\n\n #debug\n \u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n\n\n #dt_id\n \u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #acid\n \u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #session_id\n \u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n\n\n #sdk_type\n \u5224\u65adSDK\u7c7b\u578b\n\n\n #sdk_version_name\n \u5224\u65adSDK\u7248\u672c\n\n\n\nAndroid\n\u914d\u7f6e\u65b9\u5f0f\n\n\u914d\u7f6e\u6587\u4ef6\u4e8e\uff1a Assets\/Plugins\/Android\/DataTowerSdk.androidlib\/res\/values\/dt_disable_preset_properties.xml\n\n\u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n\u793a\u4f8b\n\n\n \n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>\n\n\u4e94\u3001\u5f00\u53d1\u65f6 Debug\n\n\u4ec5\u5728 Editor \u4e0b\u8fd0\u884c\u8d77\u6548\n\n\u8c03\u7528 API \u4f1a\u5bf9\u4f20\u53c2\u8fdb\u884c\u6821\u9a8c\uff0c\u4e0d\u901a\u8fc7\u7684\u8c03\u7528\u5c06\u4f1a\u629b\u51fa\u5f02\u5e38\uff08ArgumentException\uff09\uff0c\u5e76\u63d0\u4f9b\u76f8\u5173\u9519\u8bef\u4fe1\u606f\u4ee5\u5e2e\u52a9 Debug\u3002","is_draft":"0","editor_type":"2","file_path":"","add_time":"1698725993","update_time":"1727173183"},"pure_content":"\u24d8 \u63d0\u793a\nUnity SDK \u6700\u4f4e\u517c\u5bb9 Unity 2019.3.14 \u7248\u672c\uff0c\u652f\u6301\u5e73\u53f0\uff1aAndroid\u3001iOS\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\u6700\u65b0\u7248\u672c\uff1a\n\n\u6700\u65b0\u7248\u672c\uff08\u542b Beta \u7248\uff09\uff1a\n (Android ONLY)\n\u4e00\u3001\u96c6\u6210\n1.\u4e0b\u8f7d Unity SDK \u8d44\u6e90\u5305\n2.\u5c06\u4e0a\u8ff0\u6587\u4ef6\u901a\u8fc7 Assets"},{"id":"49190","string_id":"iXqW8G","status":"1","parent_id":"80675","slug":"Flutter_SDK","order":"1","name":"Flutter","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1698726618","update_time":"1727173185","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"49190","content":"> \u24d8 \u63d0\u793a \n> Flutter \u7248\u672c >= 3.0.0 \n> Dart Sdk \u7248\u672c >= 3.0.0 <4.0.0 \n> Android \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4 \n> iOS \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0 \n\n> **\u26a0\ufe0f<\/span> \u8fc1\u79fb\u987b\u77e5** \n> \u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n>\n> **?<\/span>** \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f \n> \u8bf7\u67e5\u770b[\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b](https:\/\/docs.datatower.ai\/docs\/sdk-migrate-to-3_0_0#Flutter)\u3002\n\n\u6700\u65b0\u7248\u672c: \n[![Pub Version (including pre-releases)](https:\/\/img.shields.io\/pub\/v\/datatower_ai_core?style=for-the-badge&logo=flutter&logoColor=2375c5f2&label=Flutter)](https:\/\/pub.dev\/packages\/datatower_ai_core)\n\n\u6700\u65b0\u7248\u672c\uff08\u5305\u542b Beta \u7248\uff09\uff1a\n[![](https:\/\/img.shields.io\/pub\/v\/datatower_ai_core?include_prereleases&style=for-the-badge&logo=flutter&logoColor=2375c5f2&label=Flutter%20(w\/%20beta))](https:\/\/pub.dev\/packages\/datatower_ai_core) (Android ONLY)\n\n\n# \u4e00\u3001\u81ea\u52a8\u96c6\u6210\n\n\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b pubspec.yaml \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\uff1a\n\n```yaml\ndependencies:\n ...\n datatower_ai_core: ^{\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}\n ...\n```\n\n\u6216\uff0cFlutter \u547d\u4ee4\u884c\uff1a\n\n```bash\n$ flutter pub add datatower_ai_core\n```\n\n# \u4e8c\u3001\u521d\u59cb\u5316\n\n- **\u8bf4\u660e**\n\nDataTower.ai Core SDK \u521d\u59cb\u5316\u5165\u53e3\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void initSDK(\n String appId,\n String url, \n {\n String channel = \"\",\n bool isDebug = false,\n int logLevel = DTLogLevel.DEBUG,\n bool manualEnableUpload = false,\n }\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e | \u793a\u4f8b |\n| -------- | ------ | -------- | ------------------------------------------------------------------------- | ----------------------------------------------------- |\n| appId | String | \u662f | \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | dt_test |\n| url | String | \u662f | \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | [https:\/\/xxx.roiquery.com](https:\/\/xxx.roiquery.com\/) |\n| channel | String | \u5426 | \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d | \"gp\" |\n| isDebug | bool | \u5426 | \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c \u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower | true\/false |\n| logLevel | int | \u5426 | log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a DEBUG\uff0c\u4ec5\u5728 isDebug \u4e3a true \u65f6\u6709\u6548 | DTLogLevel.DEBUG\u3001DTLogLevel.INFO\u3001DTLogLevel.WARN\u3001DTLogLevel.ERROR |\n| manualEnableUpload | bool | \u5426 | \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5 | true\/false |\n\n- **\u4f7f\u7528**\n\n```dart\n\/\/ DT SDK \u521d\u59cb\u5316\nDT.initSDK(\"app id\", \"serverUrl\", channel: DTChannel.GP, isDebug: ture, logLevel: Log.DEBUG, manualEnableUpload: false)\n```\n\n# \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n## 3.1 ID \u4f53\u7cfb\n\n### 3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n- **\u8bf4\u660e**\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 `setAccountId` \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 `setAccountId` \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\u3002\u4f20 null \u76f8\u5f53\u4e8e\u767b\u51fa\u64cd\u4f5c\u3002\n\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic Future setAccountId(String? id)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------ | ------ | -------- | ----------------- |\n| id | String\uff1f | \u662f | \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id |\n\n- **\u4f7f\u7528**\n\n```dart\nDTAnalytics.setAccountId(\"123456\");\n```\n\n### 3.1.2 \u83b7\u53d6 DT ID\n\n- **\u8bf4\u660e**\n\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic Future getDataTowerId()\n```\n\n- **\u4f7f\u7528**\n\n```dart\nfinal dt_id = await DTAnalytics.getDataTowerId();\n\n\/\/ \u6216\nDTAnalytics.getDataTowerId().then((dt_id) {\n \/\/ ...\n});\n```\n\n## 3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n- **\u8bf4\u660e**\n\n\u8c03\u7528 `track` \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void track(\n String eventName,\n { Map? properties }\n )\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | --------------------- | -------- | -------------- |\n| eventName | String | \u662f | \u4e8b\u4ef6\u540d\u79f0 |\n| properties | Map | \u5426 | \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```dart\nHashMap properties = {};\nproperties[\"test_property_3\"] = false;\nproperties[\"test_property_4\"] = 2.3;\n\nDTAnalytics.track(\"test_track\", properties: properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.track(\"test_track\");\n```\n\n## 3.3 \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\n### 3.3.1 user_set\n\n- **\u8bf4\u660e**\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userSet` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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- **\u65b9\u6cd5**\n\n```dart\nstatic void userSet(Map properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------- | -------- | -------- |\n| properties | Map | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```kotlin\nfinal Map pro = {};\npro[\"user_sex_man\"] = false;\npro[\"user_pwd\"] = \"1111111\";\npro[\"user_age\"] = 23;\n\nDTAnalytics.userSet(pro);\n```\n\n### 3.3.2 user_set_once\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userSetOnce(Map properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------- | -------- | -------- |\n| properties | Map | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```dart\nfinal Map pro = {};\npro[\"user_first_paid_time\"] = \"2020-09-23\";\n\nDTAnalytics.userSetOnce(pro);\n```\n\n### 3.3.3 user_add\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userAdd(Map properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------- | -------- | -------------------------------------------------------------------- |\n| properties | Map | \u662f | \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548 |\n\n- **\u4f7f\u7528**\n\n```dart\nMap properties = {};\nproperties[\"TotalRevenue\"] = 30;\nDTAnalytics.userAdd(properties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a30\n\nMap newProperties = {};\nnewProperties[\"TotalRevenue\"] = 648;\nDTAnalytics.userAdd(newProperties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a678\n```\n\n### 3.3.4 user_unset\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 `userUnset` \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userUnset(List properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------ | -------- | -------------- |\n| properties | List | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```dart\n\/\/ \u91cd\u7f6e\u5355\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset([\"key1\"]);\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset([\"key1\", \"key2\", \"key3\"]);\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\u6570\u7ec4\nList keys = [\"key1\", \"key2\"];\nDTAnalytics.userUnset(keys);\n```\n\n### 3.3.5 user_delete\n\n- **\u8bf4\u660e** \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\u3002\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userDelete()\n```\n\n### 3.3.6 user_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userAppend(Map properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------- | -------- | --------------------------- |\n| properties | Map | \u662f | \u7528\u6237\u5c5e\u6027\uff0cvalue \u4ec5\u652f\u6301 list |\n\n- **\u4f7f\u7528**\n\n```dart\nta.userAppend({ \"user_list\": [\"apple\", \"ball\"] });\n```\n\n### 3.3.7 user_uniq_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 `userUniqAppend` \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c `userAppend` \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\n\n- **\u65b9\u6cd5**\n\n```dart\nstatic void userUniqAppend(Map properties)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------- | -------- | --------------------------- |\n| properties | Map | \u662f | \u7528\u6237\u5c5e\u6027\uff0cvalue \u4ec5\u652f\u6301 list |\n\n- **\u4f7f\u7528**\n\n```dart\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nta.userAppend({ \"user_list\": [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nta.userAppend({ \"user_list\": [\"apple\", \"cube\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\nta.userUniqAppend({ \"user_list\": [\"apple\", \"cube\"] });\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n## 4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n\n### 4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n- **\u8bf4\u660e**\n\n1. \u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n2. \u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u6211\u4eec\u7684\u5e2e\u52a9\u51fd\u6570 DTAdReport.generateUUID\uff08\uff09\n3. \u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n| \u63a5\u53e3\u540d |\n| -------------------------- |\n| reportShow |\n| reportPaid |\n| reportClick |\n| reportRewarded |\n| reportConversionByClick |\n| reportConversionByRewarded |\n| reportConversionByLeftApp |\n\n1. \u5982\u679c\u9700\u8981\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u6f0f\u6597\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n| \u63a5\u53e3\u540d |\n| -------------- |\n| reportToShow |\n| reportShow |\n| reportClick |\n| reportRewarded |\n\n- **\u63a5\u53e3\u5217\u8868**\n\n```dart\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nstatic void reportLoadBegin(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String seq,\n {JsonMap? properties}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\nstatic void reportLoadEnd(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, int duration, bool result, String seq,\n {int errorCode = 0, String errorMessage = \"\", JsonMap? properties}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\nstatic void reportToShow(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nstatic void reportShow(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\nstatic void reportShowFailed(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n AdMediationDart mediation, \n String mediationId, \n String location,\n String seq,\n int errorCode,\n String errorMessage,\n {\n JsonMap? properties,\n String? entrance\n }\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\nstatic void reportClose(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\nstatic void reportClick(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\nstatic void reportRewarded(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nstatic void reportConversionByClick(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nstatic void reportConversionByRewarded(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nstatic void reportConversionByLeftApp(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nstatic void reportPaid(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n AdMediationDart mediation,\n String mediationId,\n String location,\n String seq,\n String value,\n String currency,\n String precision,\n {\n JsonMap? properties,\n String? entrance\n }\n)\n\nstatic void _reportPaidWithCountry_(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n String location,\n String seq,\n AdMediationDart mediation,\n String mediationId,\n String value,\n String precision,\n String country, \n {\n JsonMap? properties,\n }\n)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nstatic void reportLeftApp(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId,String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| seq | String | \u662f | \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210 |\n| id | String | \u662f | Network \u5e7f\u544a\u5355\u5143 ID |\n| type | AdTypeDart | \u662f | UNKNOWN = -1 \/\/ \u672a\u77e5
BANNER = 0 \/\/ \u6a2a\u5e45
INTERSTITIAL = 1 \/\/ \u63d2\u5c4f
NATIVE = 2 \/\/ \u539f\u751f
REWARDED = 3 \/\/ \u6fc0\u52b1
REWARDED_INTERSTITIAL = 4 \/\/ \u63d2\u5c4f\u6fc0\u52b1
APP_OPEN = 5 \/\/ \u5f00\u5c4f\u5e7f\u544a
MREC=6 \/\/ \u4e2d\u7b49\u77e9\u5f62\u5e7f\u544a |\n| platform | AdPlatformDart | \u662f | UNDISCLOSED = -2 \/\/ \u672a\u6388\u6743
UNKNOWN = -1 \/\/ \u672a\u77e5
ADMOB = 0
MOPUB = 1
ADCOLONY = 2
APPLOVIN = 3
CHARTBOOST = 4
FACEBOOK = 5
INMOBI = 6
IRONSOURCE = 7
PANGLE = 8
SNAP_AUDIENCE_NETWORK = 9
TAPJOY = 10
UNITY_ADS = 11
VERIZON_MEDIA = 12
VUNGLE = 13
ADX = 14
COMBO = 15
BIGO = 16
HISAVANA = 17
APPLOVIN_EXCHANGE = 18
MINTEGRAL = 19
LIFTOFF = 20
A4G = 21
GOOGLE_AD_MANAGER = 22
FYBER = 23
MAIO = 24
CRITEO = 25
MYTARGET = 26
OGURY = 27
APPNEXT = 28
KIDOZ = 29
SMAATO = 30
START_IO = 31
VERVE = 32
LOVINJOY_ADS = 33
YANDEX = 34
REKLAMUP = 35 |\n| entrance | String | \u5426 | \u5e7f\u544a\u5c55\u793a\u5165\u53e3 |\n| result | bool | \u662f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f |\n| duration | int | \u662f | \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f |\n| location | String | \u662f | \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c |\n| errorCode | int | \u5426 | \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801 |\n| errorMessage | String | \u5426 | \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f |\n| value | double | \u662f | \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f |\n| currency | String | \u662f | \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD |\n| precision | String | \u662f | \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6 |\n| country | String | \u662f | \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f |\n| mediation | AdMediationDart | \u662f | \u5982\u679c\u4e0d\u4f7f\u7528\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff0c\u8bf7\u4f20\u5165-1
MOPUB = 0
MAX = 1
HISAVANA = 2
COMBO = 3
TOPON = 4
TRADPLUS = 5
TOBID = 6 |\n| mediationId | String | \u662f | \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID |\n| properties | Map | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n- **\u4f7f\u7528\u4e8b\u4f8b**\n\n**\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0**\n\n\u53ef\u53c2\u8003\uff1a[Android](https:\/\/lovinjoy.feishu.cn\/wiki\/GpyOw4Jz6iv4qAk914kcvwBlngg#part-B8M3dj54EocUcmxwsqycSOlLn7f)\n\n**\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09**\n\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\n```dart\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\n@override \nvoid onAdShowed(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n final adPlatform = getAdPlatform(ad)\n final adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdTypeDart.INTERSTITIAL, adPlatform,location, seq)\n}\n```\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n\n## 4.2 \u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\nDT \u5e73\u53f0\u63d0\u4f9b\u4e24\u79cd\u65b9\u5f0f\u8fdb\u884c\u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\n1. \u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\uff1a\u901a\u8fc7 DT SDK \u4e0a\u62a5\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u81f3 DT \u5e73\u53f0\uff0c\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u624b\u52a8\u6388\u6743\u83b7\u53d6\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\uff0cDT \u5e73\u53f0\u901a\u8fc7\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u4e0e\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\u4e2d\u7684 ID \u8fdb\u884c\u5173\u8054\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n2. \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\uff1a\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u83b7\u53d6 DT \u56de\u8c03\u5730\u5740\uff0c\u5e76\u5c06\u5176\u586b\u5199\u81f3\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\uff0cDT \u5e73\u53f0\u901a\u8fc7\u63a5\u6536\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u4fe1\u606f\u4ee5\u53ca\u4e0a\u62a5\u5bf9\u5e94\u7684\u5f52\u56e0\u5e73\u53f0 ID\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\n### 4.2.1 \u5173\u8054\u4e09\u65b9 ID\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\u3002\u4f20\u5165 null \u53ef\u8fdb\u884c\u6e05\u7a7a\u3002\n\n- **\u65b9\u6cd5**\n\n```kotlin\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDTAnalytics.setFirebaseAppInstanceId(\"\");\n\/\/ AppsFlyer\nDTAnalytics.setAppsFlyerId(\"\");\n\/\/ Adjust\nDTAnalytics.setAdjustId(\"\");\n\/\/ Kochava\nDTAnalytics.setKochavaId(\"\");\n\/\/ Tenjin\nDTAnalytics.setTenjinId(\"\");\n```\n\n- **\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027**\n\n| \u8c03\u7528\u63a5\u53e3 | \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0 | \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027 | \u7528\u6237\u5c5e\u6027 |\n| -------------------------- | ------------ | ------------- | -------------------- |\n| setFirebaseAppInstanceId() | Firebase | #firebase_iid | #latest_firebase_iid |\n| setAppsFlyerId() | AppsFlyer | #appsflyer_id | #latest_appsflyer_id |\n| setAdjustId() | Adjust | #adjust_id | #latest_adjust_id |\n| setKochavaId() | Kochava | #kochava_id | #latest_kochava_id |\n| setTenjinId() | Tenjin | #tenjin_id | #latest_tenjin_id |\n\n### 4.2.2 \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\n\n#### **4.2.2.1 Adjust **\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Adjust \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 DT SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u83b7\u53d6 DataTower Id \u5e76\u8c03\u7528 `Adjust.addSessionCallbackParameter` \u5c06 DataTower Id \u8fdb\u884c\u4e0a\u62a5\u5373\u53ef\n\n- **\u793a\u4f8b**\n\n```dart\n\/\/ \u5047\u8bbe\u6709\u4e2a\u521d\u59cb\u5316 Adjust SDK \u7684\u65b9\u6cd5 foo\nFuture foo(String appToken, AdjustEnvironment environment) {\n return DTAnalytics.getDataTowerId().then((dataTowerId) {\n \/\/ ...\n \n \/\/ \u8bf7\u6ce8\u610f\uff1a\u4e0b\u9762\u4e00\u884c\u4ee3\u7801\u5fc5\u987b\u8981\u5728 Adjust.start() \u4e4b\u524d\u8c03\u7528.\n Adjust.addSessionCallbackParameter('dt_id', 'dataTowerId');\n \n \/\/ \u521d\u59cb\u5316 Adjust SDK\n AdjustConfig config = AdjustConfig(appToken, environment);\n Adjust.start(config);\n });\n}\n```\n\n## 4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 `DTAnalyticsUtils` \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 `trackTimerStart` \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 `trackTimerEnd`\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 `#duration` \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 ` trackTimerStart`\\ `trackTimerPause` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 `trackTimerEnd`\\ `trackTimerResume` \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\n\n- **\u65b9\u6cd5**\n\n```dart\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cMap \u6216\u8005 JSONObject\uff0c\u53ef\u4e0d\u4f20\nDTAnalyticsUtils.trackTimerEnd(\"event\", properties);\n```\n\n## 4.4 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n\n### 4.4.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\n\n```dart\nfinal props = {};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setStaticCommonProperties(props);\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearStaticCommonProperties();\n```\n\n### 4.4.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\n\n```dart\nMap props = {};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setDynamicCommonProperties(() => props);\n\nprop[\"key_sample\"] = 20;\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\uff0c\uff08\u6b64\u65f6\u5305\u542b \"key_sample\": 20\uff09\nDTAnalytics.track(\"simple_event\");\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearDynamicCommonProperties();\n```\n\n## 4.5 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed ![](https:\/\/img.shields.io\/badge\/for-3.1.0--beta1+-orange)\nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n\n### 4.5.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n| \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6 | \u65f6\u673a | \n| ------------------- | ------------ |\n| #app_install\uff08app\u5b89\u88c5\uff09 | App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6 |\n| #session_start\uff08app\u6253\u5f00 | App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09|\n| #session_end\uff08app\u5173\u95ed\uff09 | App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09|\n\n### 4.5.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u4efb\u4f55\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002 \n\n```dart\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDT.disableAutoTrack(DTPresetEvent);\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDT.enableAutoTrack(DTPresetEvent);\n```\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n- #app_install,\n- #session_start,\n- #session_end\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/iKbFWS\/66f0e1671e8d1.png)\n\n\n### 4.5.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n| \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b | \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e | \n| ------------------- | ------------ |\n| user_set |\u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5 |\n| user_set_once|\u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5|\n\n### 4.5.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\n**\u7279\u6b8a\u8bf4\u660e**\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n| \u5c5e\u6027 | \u8bf4\u660e\u8bf4\u660e | \n| ----------------| ------------ |\n| #bundle_id |\u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n| #app_id|DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5|\n| #debug |\u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n| #dt_id|\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #acid |\u7528\u4e8e\u7528\u6237\u8bc6\u522b|\n| #session_id|\u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n| #sdk_type |\u5224\u65adSDK\u7c7b\u578b\n| #sdk_version_name |\u5224\u65adSDK\u7248\u672c\n\n**\u914d\u7f6e\u65b9\u5f0f**\n1. \u5728 res\/values \u4e0b\u6dfb\u52a0\u4e00\u4e2a xml \u6587\u4ef6\uff08\u4efb\u610f\u540d\u5b57\uff09\uff0c\n2. \u5176\u4e2d\u5b9a\u4e49 string-array\uff0c\u4e14 name \u4e3a **DTDisPresetProperties**\n3. \u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n**\u793a\u4f8b**\n```xml\n\n\n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>\n```","pure_content":"\u24d8 \u63d0\u793a\nFlutter \u7248\u672c >= 3.0.0\nDart Sdk \u7248\u672c >= 3.0.0 <4.0.0\nAndroid \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\niOS \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\u6700\u65b0\u7248\u672c:\n\n\u6700\u65b0\u7248\u672c\uff08\u5305\u542b Beta \u7248\uff09\uff1a\n (Android ONLY)\n\u4e00\u3001\u81ea\u52a8\u96c6\u6210\n\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b pubspec.yaml \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\uff1a\ndependencies:\n ...\n datatower_ai_core: ^{\u4e0a\u9762\u7684\u6700\u65b0\u7248\u672c}\n ...\n\n\u6216\uff0cFlutter \u547d\u4ee4\u884c\uff1a\n$ flutter pub add datatower_ai_core\n\n\u4e8c\u3001\u521d\u59cb\u5316\n\n\n\u8bf4\u660e\n\n\nDataTower.ai Core SDK \u521d\u59cb\u5316\u5165\u53e3\n\n\n\u65b9\u6cd5\n\n\nstatic void initSDK(\n String appId,\n String url, \n {\n String channel = \"\",\n bool isDebug = false,\n int logLevel = DTLogLevel.DEBUG,\n bool manualEnableUpload = false,\n }\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n \u793a\u4f8b\n\n\n\n\n appId\n String\n \u662f\n \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n dt_test\n\n\n url\n String\n \u662f\n \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n https:\/\/xxx.roiquery.com\n\n\n channel\n String\n \u5426\n \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d\n \"gp\"\n\n\n isDebug\n bool\n \u5426\n \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c \u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower\n true\/false\n\n\n logLevel\n int\n \u5426\n log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a DEBUG\uff0c\u4ec5\u5728 isDebug \u4e3a true \u65f6\u6709\u6548\n DTLogLevel.DEBUG\u3001DTLogLevel.INFO\u3001DTLogLevel.WARN\u3001DTLogLevel.ERROR\n\n\n manualEnableUpload\n bool\n \u5426\n \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5\n true\/false\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ DT SDK \u521d\u59cb\u5316\nDT.initSDK(\"app id\", \"serverUrl\", channel: DTChannel.GP, isDebug: ture, logLevel: Log.DEBUG, manualEnableUpload: false)\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n3.1 ID \u4f53\u7cfb\n3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n\n\u8bf4\u660e\n\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\u3002\u4f20 null \u76f8\u5f53\u4e8e\u767b\u51fa\u64cd\u4f5c\u3002\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n\n\u65b9\u6cd5\n\n\nstatic Future setAccountId(String? id)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n id\n String\uff1f\n \u662f\n \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\n\n\n\n\n\n\u4f7f\u7528\n\n\nDTAnalytics.setAccountId(\"123456\");\n\n3.1.2 \u83b7\u53d6 DT ID\n\n\n\u8bf4\u660e\n\n\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\n\n\n\u65b9\u6cd5\n\n\nstatic Future getDataTowerId()\n\n\n\n\u4f7f\u7528\n\n\nfinal dt_id = await DTAnalytics.getDataTowerId();\n\n\/\/ \u6216\nDTAnalytics.getDataTowerId().then((dt_id) {\n \/\/ ...\n});\n\n3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\n\u8bf4\u660e\n\n\n\u8c03\u7528 track \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nstatic void track(\n String eventName,\n { Map? properties }\n )\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n eventName\n String\n \u662f\n \u4e8b\u4ef6\u540d\u79f0\n\n\n properties\n Map\n \u5426\n \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nHashMap properties = {};\nproperties[\"test_property_3\"] = false;\nproperties[\"test_property_4\"] = 2.3;\n\nDTAnalytics.track(\"test_track\", properties: properties);\n\/\/ or \u4e0d\u4f20\u5c5e\u6027\nDTAnalytics.track(\"test_track\");\n\n3.3 \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\n3.3.1 user_set\n\n\n\u8bf4\u660e\n\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userSet \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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\u65b9\u6cd5\n\n\nstatic void userSet(Map properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Map\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nfinal Map pro = {};\npro[\"user_sex_man\"] = false;\npro[\"user_pwd\"] = \"1111111\";\npro[\"user_age\"] = 23;\n\nDTAnalytics.userSet(pro);\n\n3.3.2 user_set_once\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n\n\u65b9\u6cd5\n\n\nstatic void userSetOnce(Map properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Map\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nfinal Map pro = {};\npro[\"user_first_paid_time\"] = \"2020-09-23\";\n\nDTAnalytics.userSetOnce(pro);\n\n3.3.3 user_add\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n\n\u65b9\u6cd5\n\n\nstatic void userAdd(Map properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Map\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548\n\n\n\n\n\n\u4f7f\u7528\n\n\nMap properties = {};\nproperties[\"TotalRevenue\"] = 30;\nDTAnalytics.userAdd(properties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a30\n\nMap newProperties = {};\nnewProperties[\"TotalRevenue\"] = 648;\nDTAnalytics.userAdd(newProperties);\n\/\/ \u6b64\u65f6\"TotalRevenue\"\u4e3a678\n\n3.3.4 user_unset\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 userUnset \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nstatic void userUnset(List properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n List\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u91cd\u7f6e\u5355\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset([\"key1\"]);\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\nDTAnalytics.userUnset([\"key1\", \"key2\", \"key3\"]);\n\n\/\/ \u91cd\u7f6e\u591a\u4e2a\u7528\u6237\u5c5e\u6027\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\u6570\u7ec4\nList keys = [\"key1\", \"key2\"];\nDTAnalytics.userUnset(keys);\n\n3.3.5 user_delete\n\n\n\u8bf4\u660e \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\u3002\n\n\u65b9\u6cd5\n\n\nstatic void userDelete()\n\n3.3.6 user_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\u3002\n\n\n\u65b9\u6cd5\n\n\nstatic void userAppend(Map properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Map\n \u662f\n \u7528\u6237\u5c5e\u6027\uff0cvalue \u4ec5\u652f\u6301 list\n\n\n\n\n\n\u4f7f\u7528\n\n\nta.userAppend({ \"user_list\": [\"apple\", \"ball\"] });\n\n3.3.7 user_uniq_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 userUniqAppend \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c userAppend \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\u3002\n\n\n\u65b9\u6cd5\n\n\nstatic void userUniqAppend(Map properties)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Map\n \u662f\n \u7528\u6237\u5c5e\u6027\uff0cvalue \u4ec5\u652f\u6301 list\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nta.userAppend({ \"user_list\": [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nta.userAppend({ \"user_list\": [\"apple\", \"cube\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\",\"cube\"]\nta.userUniqAppend({ \"user_list\": [\"apple\", \"cube\"] });\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n\n\u8bf4\u660e\n\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002seq \u7684\u751f\u6210\uff0c\u53ef\u4ee5\u4f7f\u7528\u6211\u4eec\u7684\u5e2e\u52a9\u51fd\u6570 DTAdReport.generateUUID\uff08\uff09\n\u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\n\n\n \u63a5\u53e3\u540d\n\n\n\n\n reportShow\n\n\n reportPaid\n\n\n reportClick\n\n\n reportRewarded\n\n\n reportConversionByClick\n\n\n reportConversionByRewarded\n\n\n reportConversionByLeftApp\n\n\n\n\n\u5982\u679c\u9700\u8981\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u6f0f\u6597\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\n\n\n \u63a5\u53e3\u540d\n\n\n\n\n reportToShow\n\n\n reportShow\n\n\n reportClick\n\n\n reportRewarded\n\n\n\n\n\n\u63a5\u53e3\u5217\u8868\n\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nstatic void reportLoadBegin(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String seq,\n {JsonMap? properties}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\nstatic void reportLoadEnd(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, int duration, bool result, String seq,\n {int errorCode = 0, String errorMessage = \"\", JsonMap? properties}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\nstatic void reportToShow(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\nstatic void reportShow(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\nstatic void reportShowFailed(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n AdMediationDart mediation, \n String mediationId, \n String location,\n String seq,\n int errorCode,\n String errorMessage,\n {\n JsonMap? properties,\n String? entrance\n }\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\nstatic void reportClose(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\nstatic void reportClick(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\nstatic void reportRewarded(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\nstatic void reportConversionByClick(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\nstatic void reportConversionByRewarded(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\nstatic void reportConversionByLeftApp(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId, String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\nstatic void reportPaid(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n AdMediationDart mediation,\n String mediationId,\n String location,\n String seq,\n String value,\n String currency,\n String precision,\n {\n JsonMap? properties,\n String? entrance\n }\n)\n\nstatic void _reportPaidWithCountry_(\n String id,\n AdTypeDart type,\n AdPlatformDart platform,\n String location,\n String seq,\n AdMediationDart mediation,\n String mediationId,\n String value,\n String precision,\n String country, \n {\n JsonMap? properties,\n }\n)\n\n\/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\nstatic void reportLeftApp(\n String id, AdTypeDart type, AdPlatformDart platform, AdMediationDart mediation, String mediationId,String location, String seq,\n {JsonMap? properties, String? entrance}\n)\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n String\n \u662f\n \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210\n\n\n id\n String\n \u662f\n Network \u5e7f\u544a\u5355\u5143 ID\n\n\n type\n AdTypeDart\n \u662f\n UNKNOWN = -1 \/\/ \u672a\u77e5 BANNER = 0 \/\/ \u6a2a\u5e45 INTERSTITIAL = 1 \/\/ \u63d2\u5c4f NATIVE = 2 \/\/ \u539f\u751f REWARDED = 3 \/\/ \u6fc0\u52b1 REWARDED_INTERSTITIAL = 4 \/\/ \u63d2\u5c4f\u6fc0\u52b1 APP_OPEN = 5 \/\/ \u5f00\u5c4f\u5e7f\u544a MREC=6 \/\/ \u4e2d\u7b49\u77e9\u5f62\u5e7f\u544a\n\n\n platform\n AdPlatformDart\n \u662f\n UNDISCLOSED = -2 \/\/ \u672a\u6388\u6743 UNKNOWN = -1 \/\/ \u672a\u77e5 ADMOB = 0MOPUB = 1 ADCOLONY = 2 APPLOVIN = 3 CHARTBOOST = 4FACEBOOK = 5 INMOBI = 6 IRONSOURCE = 7 PANGLE = 8 SNAP_AUDIENCE_NETWORK = 9 TAPJOY = 10 UNITY_ADS = 11 VERIZON_MEDIA = 12 VUNGLE = 13 ADX = 14 COMBO = 15 BIGO = 16 HISAVANA = 17 APPLOVIN_EXCHANGE = 18 MINTEGRAL = 19LIFTOFF = 20A4G = 21GOOGLE_AD_MANAGER = 22FYBER = 23MAIO = 24CRITEO = 25MYTARGET = 26OGURY = 27APPNEXT = 28KIDOZ = 29SMAATO = 30START_IO = 31VERVE = 32LOVINJOY_ADS = 33YANDEX = 34REKLAMUP = 35\n\n\n entrance\n String\n \u5426\n \u5e7f\u544a\u5c55\u793a\u5165\u53e3\n\n\n result\n bool\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f\n\n\n duration\n int\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f\n\n\n location\n String\n \u662f\n \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c\n\n\n errorCode\n int\n \u5426\n \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801\n\n\n errorMessage\n String\n \u5426\n \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f\n\n\n value\n double\n \u662f\n \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f\n\n\n currency\n String\n \u662f\n \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD\n\n\n precision\n String\n \u662f\n \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6\n\n\n country\n String\n \u662f\n \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f\n\n\n mediation\n AdMediationDart\n \u662f\n \u5982\u679c\u4e0d\u4f7f\u7528\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff0c\u8bf7\u4f20\u5165-1MOPUB = 0 MAX = 1 HISAVANA = 2 COMBO = 3TOPON = 4TRADPLUS = 5TOBID = 6\n\n\n mediationId\n String\n \u662f\n \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID\n\n\n properties\n Map\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\u4e8b\u4f8b\n\n\n\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0\n\u53ef\u53c2\u8003\uff1aAndroid\n\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\n@override \nvoid onAdShowed(ad: AdInfo){\n \/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\n final adPlatform = getAdPlatform(ad)\n final adUnit = getAdUnit(ad)\n \/\/ 4. \u5e7f\u544a\u5c55\u793a\u6210\u529f\n DTAdReport.reportShow(adUnit, AdTypeDart.INTERSTITIAL, adPlatform,location, seq)\n}\n\n\u5176\u4ed6\u56de\u8c03\u7c7b\u4f3c\n4.2 \u4e09\u65b9\u5f52\u56e0\u96c6\u6210\nDT \u5e73\u53f0\u63d0\u4f9b\u4e24\u79cd\u65b9\u5f0f\u8fdb\u884c\u4e09\u65b9\u5f52\u56e0\u96c6\u6210\n\n\u4e09\u65b9\u5f52\u56e0\u62a5\u8868\u62c9\u53d6\u5173\u8054\uff1a\u901a\u8fc7 DT SDK \u4e0a\u62a5\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u81f3 DT \u5e73\u53f0\uff0c\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u624b\u52a8\u6388\u6743\u83b7\u53d6\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\uff0cDT \u5e73\u53f0\u901a\u8fc7\u5ba2\u6237\u7aef\u4e0a\u62a5\u7684\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0 ID \u4e0e\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u62a5\u8868\u6570\u636e\u4e2d\u7684 ID \u8fdb\u884c\u5173\u8054\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\uff1a\u7528\u6237\u5728 DT \u5e73\u53f0\u3010\u6570\u636e\u7ba1\u7406-\u5f52\u56e0\u6570\u636e\u3011\u83b7\u53d6 DT \u56de\u8c03\u5730\u5740\uff0c\u5e76\u5c06\u5176\u586b\u5199\u81f3\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\uff0cDT \u5e73\u53f0\u901a\u8fc7\u63a5\u6536\u4e09\u65b9\u5f52\u56e0\u5e73\u53f0\u7684\u5f52\u56e0\u4fe1\u606f\u4ee5\u53ca\u4e0a\u62a5\u5bf9\u5e94\u7684\u5f52\u56e0\u5e73\u53f0 ID\uff0c\u5b8c\u6210\u7528\u6237\u7684\u5e7f\u544a\u5f52\u56e0\n\n4.2.1 \u5173\u8054\u4e09\u65b9 ID\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9\u8bbe\u5907 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\u3002\u4f20\u5165 null \u53ef\u8fdb\u884c\u6e05\u7a7a\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDTAnalytics.setFirebaseAppInstanceId(\"\");\n\/\/ AppsFlyer\nDTAnalytics.setAppsFlyerId(\"\");\n\/\/ Adjust\nDTAnalytics.setAdjustId(\"\");\n\/\/ Kochava\nDTAnalytics.setKochavaId(\"\");\n\/\/ Tenjin\nDTAnalytics.setTenjinId(\"\");\n\n\n\n\u8c03\u7528\u63a5\u53e3\u4f1a\u4e0a\u62a5\u7684\u5c5e\u6027\n\n\n\n\n\n \u8c03\u7528\u63a5\u53e3\n \u5bf9\u5e94\u4e09\u65b9\u5e73\u53f0\n \u516c\u5171\u4e8b\u4ef6\u5c5e\u6027\n \u7528\u6237\u5c5e\u6027\n\n\n\n\n setFirebaseAppInstanceId()\n Firebase\n #firebase_iid\n #latest_firebase_iid\n\n\n setAppsFlyerId()\n AppsFlyer\n #appsflyer_id\n #latest_appsflyer_id\n\n\n setAdjustId()\n Adjust\n #adjust_id\n #latest_adjust_id\n\n\n setKochavaId()\n Kochava\n #kochava_id\n #latest_kochava_id\n\n\n setTenjinId()\n Tenjin\n #tenjin_id\n #latest_tenjin_id\n\n\n\n4.2.2 \u4e09\u65b9\u5f52\u56e0\u6570\u636e\u5b9e\u65f6\u63a8\u9001\n**4.2.2.1 Adjust **\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u8981\u5728 DT \u7cfb\u7edf\u4e2d\u63a5\u5165 Adjust \u5f52\u56e0\u6570\u636e\uff0c\u5219\u9700\u8981\u5728 DT SDK \u521d\u59cb\u5316\u5b8c\u6210\u540e\uff0c\u83b7\u53d6 DataTower Id \u5e76\u8c03\u7528 Adjust.addSessionCallbackParameter \u5c06 DataTower Id \u8fdb\u884c\u4e0a\u62a5\u5373\u53ef\n\n\n\u793a\u4f8b\n\n\n\/\/ \u5047\u8bbe\u6709\u4e2a\u521d\u59cb\u5316 Adjust SDK \u7684\u65b9\u6cd5 foo\nFuture foo(String appToken, AdjustEnvironment environment) {\n return DTAnalytics.getDataTowerId().then((dataTowerId) {\n \/\/ ...\n \n \/\/ \u8bf7\u6ce8\u610f\uff1a\u4e0b\u9762\u4e00\u884c\u4ee3\u7801\u5fc5\u987b\u8981\u5728 Adjust.start() \u4e4b\u524d\u8c03\u7528.\n Adjust.addSessionCallbackParameter('dt_id', 'dataTowerId');\n \n \/\/ \u521d\u59cb\u5316 Adjust SDK\n AdjustConfig config = AdjustConfig(appToken, environment);\n Adjust.start(config);\n });\n}\n\n4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 DTAnalyticsUtils \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 trackTimerStart \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 trackTimerEnd\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 #duration \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\u591a\u6b21\u8c03\u7528 trackTimerStart\\ trackTimerPause \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u5f00\u59cb\u65f6\u95f4\\\u6682\u505c\u65f6\u95f4\u4ee5\u6700\u540e\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\u591a\u6b21\u8c03\u7528 trackTimerEnd\\ trackTimerResume \u65f6\uff0c\u4e8b\u4ef6 \"event\" \u7684\u7ed3\u675f\u65f6\u95f4\\\u6062\u590d\u65f6\u95f4\u4ee5\u6700\u5148\u4e00\u6b21\u8c03\u7528\u65f6\u4e3a\u51c6\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDTAnalyticsUtils.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cMap \u6216\u8005 JSONObject\uff0c\u53ef\u4e0d\u4f20\nDTAnalyticsUtils.trackTimerEnd(\"event\", properties);\n\n4.4 \u516c\u5171\u5c5e\u6027\n\u5982\u9700\u4e3a\u6240\u6709\u4e8b\u4ef6\u6dfb\u52a0\u5c5e\u6027\uff0c\u53ef\u4ee5\u4f7f\u7528\u516c\u5171\u5c5e\u6027\u63a5\u53e3\u8fdb\u884c\u8bbe\u7f6e\u3002\n4.4.1 \u9759\u6001\u516c\u5171\u5c5e\u6027\n\u9759\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u4f7f\u7528\u6301\u4e45\u5316\u5b58\u50a8\uff0c\u5e94\u7528\u9000\u51fa\u518d\u5f00\u542f\u65f6\uff0c\u539f\u5148\u8bbe\u7f6e\u7684\u503c\u4f1a\u4fdd\u6301\u4e0d\u53d8\u3002\nfinal props = {};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setStaticCommonProperties(props);\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearStaticCommonProperties();\n\n4.4.2 \u52a8\u6001\u516c\u5171\u5c5e\u6027\n\u52a8\u6001\u516c\u5171\u5c5e\u6027\u4f1a\u5728\u8c03\u7528\u76f8\u5173\u4e8b\u4ef6\u4e0a\u62a5\u63a5\u53e3\u65f6\u52a8\u6001\u5730\u8fdb\u884c\u516c\u5171\u5c5e\u6027\u7684\u83b7\u53d6\uff0c\u5e94\u7528\u91cd\u542f\u540e\u9700\u91cd\u65b0\u8bbe\u7f6e\u3002\nMap props = {};\n\n\/\/ \u8bbe\u7f6e\nDTAnalytics.setDynamicCommonProperties(() => props);\n\nprop[\"key_sample\"] = 20;\n\n\/\/ Track \u65f6\u4f1a\u8c03\u7528\u52a8\u6001\u516c\u5171\u5c5e\u6027\u7684\u51fd\u6570\u6765\u83b7\u53d6\u516c\u5171\u5c5e\u6027\uff0c\u5e76\u8fdb\u884c\u4e0a\u62a5\uff0c\uff08\u6b64\u65f6\u5305\u542b \"key_sample\": 20\uff09\nDTAnalytics.track(\"simple_event\");\n\n\/\/ \u6e05\u9664\nDTAnalytics.clearDynamicCommonProperties();\n\n4.5 \u81ea\u52a8\u91c7\u96c6\u4e0e\u5173\u95ed \nSDK\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4f1a\u6709\u4e00\u4e9b\u81ea\u52a8\u91c7\u96c6\u7684\u884c\u4e3a\uff0c\u5305\u62ec\u9884\u7f6e\u4e8b\u4ef6\u548c\u7528\u6237\u4e8b\u4ef6\n4.5.1 \u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u81ea\u52a8\u91c7\u96c6\u4e8b\u4ef6\n \u65f6\u673a\n\n\n\n\n #app_install\uff08app\u5b89\u88c5\uff09\n App \u9996\u6b21\u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\n\n\n #session_start\uff08app\u6253\u5f00\n App \u542f\u52a8\uff0c\u8c03\u7528 DT.initSDK() \u65f6\u3001App \u4ece\u540e\u53f0\u5207\u6362\u5230\u524d\u53f0\u65f6\uff08\u5bf9\u5e94 resume\uff09\n\n\n #session_end\uff08app\u5173\u95ed\uff09\n App \u4ece\u524d\u53f0\u5207\u6362\u5230\u540e\u53f0\u65f6\uff08\u5bf9\u5e94 pause\uff09\n\n\n\n4.5.2 \u5173\u95ed\u9884\u7f6e\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\u5728\u67d0\u4e9b\u573a\u666f\u4e0b\uff0c\u60a8\u53ef\u80fd\u4e0d\u5e0c\u671b\u6709\u4efb\u4f55\u9884\u7f6e\u4e8b\u4ef6\u7684\u4e0a\u62a5\uff0cSDK \u63d0\u4f9b\u4e86\u63a5\u53e3\u6765\u5b9e\u73b0\u5bf9\u9884\u7f6e\u4e8b\u4ef6\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\u7684\u63a7\u5236\u3002\n\/\/ \u7981\u7528\u9884\u7f6e\u4e8b\u4ef6\nDT.disableAutoTrack(DTPresetEvent);\n\n\/\/ \u53d6\u6d88\u7981\u7528\nDT.enableAutoTrack(DTPresetEvent);\n\n\u9700\u4f20\u5165\u679a\u4e3e\u7c7b\u578b PresetEvent\uff0c\u652f\u6301\u7684\u9884\u7f6e\u4e8b\u4ef6\u3002\u9ed8\u8ba4\u4e3a\u4e0d\u7981\u7528\uff1a\n\n#app_install,\n#session_start,\n#session_end\n\n\n4.5.3 \u7528\u6237\u4e8b\u4ef6\u7684\u81ea\u52a8\u91c7\u96c6\n\n\n\n \u7528\u6237\u4e8b\u4ef6\u7c7b\u578b\n \u81ea\u52a8\u4e0a\u62a5\u8bf4\u660e\n\n\n\n\n user_set\n \u5728\u6bcf\u6b21\u521d\u59cb\u5316\u65f6\uff0c\u81ea\u52a8\u4e0a\u62a5\uff0c\u7528\u4e8e\u66f4\u65b0\u7528\u6237\u6700\u65b0\u7684\u5c5e\u6027\uff08#latest_xxx\uff09\uff0c\u5f53\u6700\u65b0\u503c\u672a\u53d1\u751f\u53d8\u5316\u65f6\uff0c\u4e0d\u4f1a\u4e0a\u62a5\n\n\n user_set_once\n \u7528\u4e8e\u8bb0\u5f55\u7528\u6237\u6fc0\u6d3b\u65f6\u7684\u5c5e\u6027\uff08#active_xxx\uff09\uff0c\u4ec5\u4e0a\u62a5\u4e00\u6b21\uff0c\u76f8\u5173\u5c5e\u6027\u4e0a\u62a5\u8fc7\u4e00\u6b21\u5c31\u4e0d\u518d\u4e0a\u62a5\n\n\n\n4.5.4 \u5173\u95ed\u9884\u7f6e\u5c5e\u6027\u7684\u91c7\u96c6\u4e0e\u4e0a\u62a5\n\u5f53\u60a8\u5728\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u5e0c\u671b\u4e0a\u62a5DT\u7684\u9884\u7f6e\u5c5e\u6027\u65f6\uff0c\u53ef\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u7684\u65b9\u5f0f\u5b9e\u73b0\n\u7279\u6b8a\u8bf4\u660e\n\u4ee5\u4e0b\u9884\u7f6e\u5c5e\u6027\u4e0d\u53ef\u5173\u95ed\uff1a\n\n\n\n \u5c5e\u6027\n \u8bf4\u660e\u8bf4\u660e\n\n\n\n\n #bundle_id\n \u5e94\u7528\u5305\u540d\uff0c\u5c5e\u4e8eDT\u5185\u7f6e\u5b57\u6bb5\n\n\n #app_id\n DT\u7684app_id\uff0c\u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\n\n\n #debug\n \u5224\u65ad\u8be5\u6761\u6570\u636e\u662f\u5426\u662fdebug\n\n\n #dt_id\n \u4e0a\u62a5\u6570\u636e\u7684\u5fc5\u5907\u5b57\u6bb5\uff0c\u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #acid\n \u7528\u4e8e\u7528\u6237\u8bc6\u522b\n\n\n #session_id\n \u4f1a\u8bdd\u4e8b\u4ef6\u552f\u4e00id\uff0c\u6807\u8bc6\u56de\u8bdd\n\n\n #sdk_type\n \u5224\u65adSDK\u7c7b\u578b\n\n\n #sdk_version_name\n \u5224\u65adSDK\u7248\u672c\n\n\n\n\u914d\u7f6e\u65b9\u5f0f\n\n\u5728 res\/values \u4e0b\u6dfb\u52a0\u4e00\u4e2a xml \u6587\u4ef6\uff08\u4efb\u610f\u540d\u5b57\uff09\uff0c\n\u5176\u4e2d\u5b9a\u4e49 string-array\uff0c\u4e14 name \u4e3a DTDisPresetProperties\n\n\u5b57\u7b26\u4e32\u6570\u7ec4\u5185\u586b\u5199\u9700\u8981\u7981\u7528\u7684\u9884\u7f6e\u5c5e\u6027\n\n\u793a\u4f8b\n\n\n \n #os_lang_code<\/item>\n #os_version_name<\/item>\n <\/string-array>\n<\/resources>","is_draft":"0","editor_type":"2","file_path":"","add_time":"1698726618","update_time":"1727173185"},"pure_content":"\u24d8 \u63d0\u793a\nFlutter \u7248\u672c >= 3.0.0\nDart Sdk \u7248\u672c >= 3.0.0 <4.0.0\nAndroid \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\niOS \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a iOS 11.0\n\n\n\u26a0\ufe0f \u8fc1\u79fb\u987b\u77e5\n\u76ee\u524d SDK \u7684\u5168\u90e8\u529f\u80fd\u5df2\u5b8c\u6210\u8fc1\u79fb\uff083.0.0+\uff09\n? \u5982\u4f55\u8fc1\u79fb\u5230\u65b0 SDK\uff1f\n\u8bf7\u67e5\u770b\u300a\u5feb\u901f\u8fc1\u79fb\u6307\u5357\u300b\u3002\n\n\u6700\u65b0\u7248\u672c:\n\n\u6700\u65b0\u7248\u672c\uff08\u5305\u542b Beta \u7248\uff09\uff1a\n (And"},{"id":"93052","string_id":"QpbVE0","status":"1","parent_id":"80675","slug":"CocosCreator","order":"0","name":"CocosCreator","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":"1714979871","update_time":"1745547266","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"93052","content":"> \u24d8 \u63d0\u793a \n> CocosCreator 3.x \n> Android \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4 \n\n## \u4e00\u3001\u96c6\u6210\n\n### 1.1 \u4e0b\u8f7dcocos-sdk\u538b\u7f29\u5305\n\n\u4e0b\u8f7d\u94fe\u63a5\uff1a[dt-cocos-sdk](https:\/\/storage.googleapis.com\/datatower\/dt-sdk\/datatower-cocos-sdk.tar.gz)\n\n\u5982\u679c\u60a8\u4f7f\u7528\u7684\u662fCocos 2.x\u7248\u672c\uff0c\u8bf7\u4e0b\u8f7d\uff1a[dt-cocos-sdk(2.x)](https:\/\/storage.googleapis.com\/datatower\/dt-sdk\/cocos2.x.zip)\n\n### 1.2 \u96c6\u6210 JS SDK\n\n- **TypeScript ESModule \u9879\u76ee**\n 1. \u5c06\u538b\u7f29\u5305\u4e2d\u7684 `dt.cc.mjs`\u3001`dt.cc.d.mts`(2.x\u7248\u672c\u4f7f\u7528\u538b\u7f29\u5305\u4e2d\u7684`cocos.js`\u548c`coco.d.ts`) \u653e\u5165\u9879\u76ee assets\/libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n 2. \u5728 assets\/scripts\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\n ```TypeScript\n import { DataTower } from '..\/lib\/dt.cc.mjs';\n ```\n- **JavaScript CommonJS \u9879\u76ee**\n 1. \u5c06\u538b\u7f29\u5305\u4e2d\u7684 `dt.cc.cjs`\u3001`dt.cc.d.cts` \u653e\u5165\u9879\u76ee assets\/libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n 2. \u5728 assets\/scripts\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\n ```JavaScript\n const { DataTower } = require('..\/lib\/dt.cc.cjs')\n ```\n\n### 1.3 Android \u7aef\u96c6\u6210\n\n[![Maven Central](https:\/\/img.shields.io\/maven-central\/v\/ai.datatower\/core?style=for-the-badge&logo=android&logoColor=70d68c&label=Android&labelColor=dbeffd&color=007EC7)](https:\/\/central.sonatype.com\/artifact\/ai.datatower\/core)\n\n1. \u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b `build.gradle` \u6587\u4ef6\u4e2d\u6dfb\u52a0 mavenCentral \u4ed3\u5e93\n ```kotlin\n allprojects {\n repositories {\n ...\n mavenCentral()\n }\n }\n ```\n2. \u5728\u9879\u76ee\u4e3b\u5de5\u7a0b\u76ee\u5f55\u4e0b `build.gradle` \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\n\n ```kotlin\n dependencies {\n ...\n\n implementation 'ai.datatower:core:{\u6700\u65b0\u7248\u672c}'\n }\n ```\n\n3. \u5c06 `DTCocosCreatorProxyApi.java` \u653e\u5230 `{\u9879\u76ee\u5730\u5740}\/native\/engine\/android\/app\/src\/` \u4e0b\u3002\u5982\u679c\u60a8\u4f7f\u7528\u7684\u662f2.x\u7684\u7248\u672c\uff0c\u5219\u5c06\u538b\u7f29\u5305\u4e2d\u7684 `DTCocosCreatorProxyApi.java`\uff0c\u653e\u5230`\/app\/src\/org\/cocos2dx\/javasrcipt\/`\u4e0b\uff0c\u5982\uff1a\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/680770ea26a05.png)\n\n4. **proguard \u89c4\u5219**\u4e2d\u52a0\u5165 (`{\u9879\u76ee\u5730\u5740}\/native\/engine\/android\/app\/proguard-rules.pro`)\uff1a\n ```\n -keep class ai.datatower.bridge.DTCocosCreatorProxyApi { *; }\n ```\n### 1.3 iOS \u7aef\u96c6\u6210\n\n#### 1. \u96c6\u6210\u4e8c\u8fdb\u5236\u6587\u4ef6\n\n##### 1. \u65b9\u5f0f\u4e00\uff0c\u624b\u52a8\u96c6\u6210\n\u628a\u538b\u7f29\u5305\u4e2d\u7684DataTowerAICore.framework \u5f15\u5165\u5de5\u7a0b\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/6639fef68ec3b.png)\n\n\n\u5f15\u5165\u7cfb\u7edf\u5e93 CoreTelephony\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/6639ff3fad04f.png)\n\n\n\u6dfb\u52a0-all_load\u6807\u5fd7, target -> build Settings -> Other Linker Flags\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/6639ff7ec1229.png)\n\n\n \n \u53c2\u8003 [iOS\u9759\u6001\u5e93\u4f7f\u7528category\u95ee\u9898](https:\/\/stackoverflow.com\/questions\/10416779\/unrecognized-selector-sent-to-class-when-calling-category-method-from-a-librar)\n\n##### 2. \u65b9\u5f0f\u4e8c\uff0c\u81ea\u52a8\u96c6\u6210 \uff08\u63a8\u8350\uff09\n\u76ee\u524d\u4ec5\u652f\u6301pod\u81ea\u52a8\u96c6\u6210\u65b9\u5f0f\n```pod\n1. \u5148\u5b89\u88c5pod\uff0c\u5b89\u88c5\u6210\u529f\u540e\uff0c\u8fdb\u5165\u9879\u76ee\u76ee\u5f55\uff0c\u8fd0\u884cpod init\uff0c\u4f1a\u751f\u6210podfile\n2. \u5728podfile\u91cc\u6dfb\u52a0\u76f8\u5e94\u914d\u7f6e\n pod \"DataTowerAICore\", \"~> 3.0.0\"\n3. \u6267\u884c pod install\n4. \u6253\u5f00xxx.xcworkspace\u9879\u76ee\n```\n\n#### 2. \u6dfb\u52a0\u6e90\u6587\u4ef6\n 1. \u628a\u538b\u7f29\u5305\u4e2d\u7684DTCocosCreatorProxyApi.h \u548c DTCocosCreatorProxyApi.mm \u6dfb\u52a0\u5230\u9879\u76ee\u4e2d\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/6639ffad91b58.png)\n\n 2. \u73b0\u5728\u53ef\u4ee5\u8fdb\u884c\u7f16\u8bd1\n\n#### 3. \u5e38\u89c1\u95ee\u9898\n 1. \u7f16\u8bd1\u62a5\u9519\uff0cfatal error: 'DataTowerAICore\/DTAnalytics.h' file not found\n \u624b\u52a8\u548c\u81ea\u52a8\u96c6\u6210\u90fd\u6709\u53ef\u80fd\u9047\u5230\uff0c \n \u5982\u679c\u662f\u624b\u52a8\u96c6\u6210\uff0c\u6dfb\u52a0framework\u7684\u8def\u5f84\u5230framework search paths\n \u5982\u679c\u662f\u81ea\u52a8\u96c6\u6210\uff0c\u53ef\u4ee5\u6dfb\u52a0$(inherited)\u5230framework search paths\uff0c\u518d\u6267\u884c\u4e00\u6b21 pod install\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/bdtuta\/article\/QpbVE0\/6639ffdc7259f.png)\n\n 2. \u8fd0\u884c\u62a5\u9519 unrecognized selector sent to class\n \u624b\u52a8\u96c6\u6210\u4f1a\u9047\u5230\uff0c\u6dfb\u52a0-all_load\u6807\u5fd7\uff0c\u89c1\u624b\u52a8\u96c6\u6210\u6307\u5f15\n\n## \u4e8c\u3001\u521d\u59cb\u5316\n\n- **\u8bf4\u660e**\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static initSDK(config: Config): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e | \u793a\u4f8b |\n| ------------------ | ------- | -------- | ------------------------------------------------------------------------- | ----------------------------------------------------- |\n| appId | string | \u662f | \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | dt_test |\n| serverUrl | string | \u662f | \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6 | [https:\/\/xxx.roiquery.com](https:\/\/xxx.roiquery.com\/) |\n| channel | string | \u5426 | \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d | DTChannel.GP |\n| isDebug | boolean | \u5426 | \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower | true\/false |\n| logLevel | number | \u5426 | log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a LogLevel.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548 | Log.VERBOSE\u3001Log.DEBUG\u3001Log.ERROR \u7b49 |\n| manualEnableUpload | boolean | \u5426 | \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5 | true\/false |\n\n- **\u4f7f\u7528**\n\n```typescript\n\/\/ DT SDK \u521d\u59cb\u5316\nDataTower.initSDK({\n appId: \"app_id\",\n serverUrl: \"https:\/\/example.com\",\n channel: \"\",\n isDebug: true,\n logLevel: LogLevel.VERBOSE,\n manualEnableUpload: false,\n});\n```\n\n## \u4e09\u3001\u57fa\u7840\u529f\u80fd\n\n### 3.1 ID \u4f53\u7cfb\n\n#### 3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n- **\u8bf4\u660e**\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 `setAccountId` \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 `setAccountId` \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static setAccountId(id: string): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------ | ------ | -------- | ----------------- |\n| id | string | \u662f | \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.setAccountId(\"123456\");\n```\n\n> **\u5982\u679c\u9700\u8981\u6e05\u9664\u8d26\u53f7 ID\uff0c\u8bf7\u4f20\u5165\u7a7a\u5b57\u7b26\u4e32**\n> ```typescript\n> DataTower.setAccountId(\"\");\n> ```\n\n#### 3.1.2 \u83b7\u53d6 DT ID\n\n- **\u8bf4\u660e**\n\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static getDataTowerId(callback: (id: string) => void): void;\n static getDataTowerId(): Promise;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| -------- | -------------------- | -------- | --------------------- |\n| callback | (id: string) => void | \u5426 | \u7528\u6237\u63a5\u6536 dt id \u7684\u56de\u8c03 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.getDataTowerId((id) => console.log(id));\n\/\/ or\nconst id = await DataTower.getDataTowerId();\n```\n\n### 3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n- **\u8bf4\u660e**\n\n\u8c03\u7528 `track` \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static track(\n eventName: string,\n properties: Record\n ): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------------------------------------------- | -------- | -------------- |\n| eventName | string | \u662f | \u4e8b\u4ef6\u540d\u79f0 |\n| properties | Record | \u662f | \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.track(\"test_track\", {\n test_property_1: \"test\",\n test_property_2: 1,\n});\n```\n\n### 3.3 \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\n#### 3.3.1 user_set\n\n- **\u8bf4\u660e**\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userSet` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userSet(properties: Record): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------------------------------------- | -------- | -------- |\n| properties | Record | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.userSet({\n user_sex_man: false,\n user_pwd: \"1111111\",\n user_age: 23,\n});\n```\n\n#### 3.3.2 user_set_once\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 `userSetOnce` \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userSetOnce(\n properties: Record\n ): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------------------------------------- | -------- | -------- |\n| properties | Record | \u662f | \u4e8b\u4ef6\u5c5e\u6027 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.userSetOnce({\n user_first_paid_time: \"2020-09-23\",\n});\n```\n\n#### 3.3.3 user_add\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userAdd` \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userAdd(properties: Record): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ---------------------- | -------- | -------------------------------------------------------------------- |\n| properties | Record | \u662f | \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.userAdd({ total: 30 });\n\/\/ \u6b64\u65f6\"total\"\u4e3a30\nDataTower.userAdd({ total: 648 });\n\/\/ \u6b64\u65f6\"total\"\u4e3a678\n```\n\n#### 3.3.4 user_unset\n\n- **\u8bf4\u660e**\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 `userUnset` \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 `userUnset` \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userUnset(properties: string[]): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | -------- | -------- | -------------- |\n| properties | string[] | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.userUnset([\"key1\"]);\n```\n\n#### 3.3.5 user_delete\n\n- **\u8bf4\u660e** \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\u3002\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userDelete(): void;\n}\n```\n\n#### 3.3.6 user_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userAppend` \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userAppend(\n properties: Record\n ): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ----------------------------------------------- | -------- | -------------- |\n| properties | Record | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```typescript\nDataTower.userAppend({ user_list: [\"apple\", \"cube\"] });\n```\n\n#### 3.3.7 user_uniq_append\n\n- **\u8bf4\u660e**\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 `userUniqAppend` \u5bf9\u5217\u8868\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 `userUniqAppend` \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c `userAppend` \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\n\n- **\u65b9\u6cd5**\n\n```typescript\nclass DataTower {\n static userUniqAppend(\n properties: Record\n ): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ----------------------------------------------- | -------- | -------------- |\n| properties | Record | \u662f | \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6 |\n\n- **\u4f7f\u7528**\n\n```typescript\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nDataTower.userUniqAppend({ user_list: [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nDataTower.userUniqAppend({ user_list: [\"apple\", \"cube\"] });\n```\n\n## \u56db\u3001\u8fdb\u9636\u529f\u80fd\n\n### 4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n\n#### 4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n- **\u8bf4\u660e**\n\n1. \u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n2. \u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002\n3. \u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n| \u63a5\u53e3\u540d |\n| -------------------------- |\n| reportShow |\n| reportPaid |\n| reportClick |\n| reportRewarded |\n| reportConversionByClick |\n| reportConversionByRewarded |\n| reportConversionByLeftApp |\n\n1. \u5982\u679c\u9700\u8981\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u6f0f\u6597\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n| \u63a5\u53e3\u540d |\n| -------------- |\n| reportToShow |\n| reportShow |\n| reportClick |\n| reportRewarded |\n\n- **\u63a5\u53e3\u5217\u8868**\n\n```typescript\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nclass DataTower {\n static reportLoadBegin(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n seq: string;\n properties?: Record;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\n static reportLoadEnd(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n duration: number;\n result: boolean;\n seq: string;\n errorCode: number;\n errorMessage: string;\n properties?: Record;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\n static reportToShow(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\n static reportShow(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\n static reportShowFailed(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n errorCode: number;\n errorMessage: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\n static reportClose(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\n static reportClick(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\n static reportRewarded(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\n static reportConversionByClick(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\n static reportConversionByRewarded(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\n static reportConversionByLeftApp(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\n static reportPaid(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n value: string;\n currency: string;\n precision: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n static reportPaid(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n mediation: AdMediation;\n mediationId: string;\n value: string;\n precision: string;\n country: string;\n properties?: Record;\n }): void;\n\n \/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n static reportLeftApp(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------------------------------ |\n| seq | string | \u662f | \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210 |\n| id | string | \u662f | Network \u5e7f\u544a\u5355\u5143 ID |\n| type | AdType | \u662f | \u8be6\u89c1 [\u7c7b\u578b Type](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u7c7b\u578b%20Type) |\n| platform | AdPlatform | \u662f | \u8be6\u89c1 [\u5e7f\u544a\u5e73\u53f0 Platform](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u5e7f\u544a\u5e73\u53f0%20Platform) |\n| entrance | string | \u5426 | \u5e7f\u544a\u5c55\u793a\u5165\u53e3 |\n| result | boolean | \u662f | \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f |\n| duration | number | \u662f | \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f |\n| location | string | \u662f | \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c |\n| errorCode | number | \u5426 | \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801 |\n| errorMessage | string | \u5426 | \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f |\n| value | string | \u662f | \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f |\n| currency | string | \u662f | \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD |\n| precision | string | \u662f | \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6 |\n| country | string | \u662f | \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f |\n| mediation | AdMediation | \u5426 | \u8be6\u89c1 [\u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation](https:\/\/docs.datatower.ai\/docs\/sdk_common_enum#\u805a\u5408\u5e7f\u544a\u5e73\u53f0%20Mediation) |\n| mediationId | string | \u5426 | \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID |\n| properties | Record | \u5426 | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n- **\u4f7f\u7528\u4e8b\u4f8b**\n\n**\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0**\n\n```typescript\n\/*\n* \u4e00\u6b21\u5c55\u793aAdmob\u63d2\u9875\u5e7f\u544a\u7684\u8fc7\u7a0b\n*\/\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nconst location = \"main\";\n\n\/\/ Admob\u5e7f\u544a\u5355\u5143\nconst adUnit = \"xxxxxxxx\";\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\nconst seq = \"xxx\";\n\n\/\/ 1.\u4e0a\u62a5\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nDataTower.reportLoadBegin({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n seq: seq,\n});\n\n\/\/ 2.Admob\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\n\/\/ \u52a0\u8f7d\u5f00\u59cb\u65f6\u95f4\nconst loadStartTime = new Date().getTime();\n\n\/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u6210\u529f\nDataTower.reportLoadEnd({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n duration: new Date().getTime() - loadStartTime,\n result: true,\n seq: seq,\n});\n\/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u5931\u8d25\nDataTower.reportLoadEnd({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n duration: new Date().getTime() - loadStartTime,\n result: false,\n seq: seq,\n errorCode: 1001,\n errorMessage: \"\u5e7f\u544a\u52a0\u8f7d\u5931\u8d25\",\n});\n\n\/\/ 4.\u5c55\u793a\u5e7f\u544a\nDTAdReport.reportToShow(\n adUnit,\n AdType.INTERSTITIAL,\n AdPlatform.ADMOB,\n location,\n seq\n);\n\n\/\/ 5.\u5e7f\u544a\u5c55\u793a\u6210\u529f\nDataTower.reportShow({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\/\/ 6.\u5e7f\u544a\u5c55\u793a\u5931\u8d25\nDataTower.reportShowFailed({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n errorCode: 1001,\n errorMessage: \"\u5e7f\u544a\u52a0\u8f7d\u5931\u8d25\",\n});\n\n\/\/ 7.\u5e7f\u544a\u88ab\u70b9\u51fb\nDataTower.reportClick({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\/\/ 8.\u5e7f\u544a\u5173\u95ed\nDataTower.reportClose({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n```\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\n\n```typescript\nDataTower.reportConversionByRewarded({\n id: adUnit,\n type: AdType.REWARDED,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n```\n\n**\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09**\n\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\n```typescript\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\nconst adInfo: AdInfo = ...;\n\/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\nconst adPlatform = getAdPlatform(ad);\nconst adUnit = getAdUnit(ad);\n\/\/ \u5e7f\u544a\u5c55\u793a\u6210\u529f\nDataTower.reportShow({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: adPlatform,\n location: location,\n seq: seq,\n});\n```\n\n\u5176\u4ed6 API \u7c7b\u4f3c\n\n#### 4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```typescript\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\nclass DataTower {\n static reportPurchaseSuccess(opts: {\n order: string;\n sku: string;\n price: number;\n currency: string;\n properties: Record;\n }): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| ---------- | ------------------- | -------- | --------------------------------------------------- |\n| currency | string | \u662f | \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| price | number | \u662f | \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c |\n| sku | string | \u662f | \u8d2d\u4e70\u5546\u54c1 id |\n| order | string | \u662f | \u8d2d\u4e70\u8ba2\u5355 |\n| properties | Record | \u662f | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n#### 4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n- **\u65b9\u6cd5**\n\n```typescript\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\nclass DataTower {\n static reportSubscribeSuccess(opts: {\n sku: string;\n price: number;\n currency: string;\n properties: Record;\n originalOrderId: string;\n orderId: string;\n }): void;\n}\n```\n\n- **\u53c2\u6570**\n\n| \u53c2\u6570\u540d | \u7c7b\u578b | \u662f\u5426\u5fc5\u4f20 | \u8bf4\u660e |\n| --------------- | ------------------- | -------- | --------------------------------------------------- |\n| currency | string | \u662f | \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| price | number | \u662f | \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c |\n| sku | string | \u662f | \u8ba2\u9605\u5546\u54c1 id |\n| orderId | string | \u662f | \u8ba2\u9605\u8ba2\u5355 |\n| originalOrderId | string | \u662f | \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id |\n| properties | Record | \u662f | \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027 |\n\n### 4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n\n#### 4.2.1 \u900f\u4f20 dt_id\n\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528 get dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\n\n```TypeScript\nDataTower.getDataTowerId((dt_id) => {})\n\/\/ \u6216\nconst id = await DataTower.getDataTowerId();\n```\n\n#### 4.2.2 user_set \u4e09\u65b9 ID\n\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\uff0c\u5b8c\u6210 dt_id \u548c\u4e09\u65b9 ID \u7684\u7ed1\u5b9a\n\n```TypeScript\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDataTower.setFirebaseAppInstanceId(\"\");\n\/\/ Kochava\nDataTower.setKochavaId(\"\");\n\/\/ AppsFlyer\nDataTower.setAppsFlyerId(\"\");\n\/\/ Adjust\nDataTower.setAdjustId(\"\");\n```\n\n### 4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n- **\u8bf4\u660e**\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 `trackTimerStart` \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 `trackTimerStart` \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 `trackTimerEnd`\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 `#duration` \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\n\n- **\u65b9\u6cd5**\n\n```typescript\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cRecord\nDataTower.trackTimerEnd(\"event\", { key: \"value\" });\n```","pure_content":"\u24d8 \u63d0\u793a\nCocosCreator 3.x\nAndroid \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\n\n\u4e00\u3001\u96c6\u6210\n1.1 \u4e0b\u8f7dcocos-sdk\u538b\u7f29\u5305\n\u4e0b\u8f7d\u94fe\u63a5\uff1adt-cocos-sdk\n\u5982\u679c\u60a8\u4f7f\u7528\u7684\u662fCocos 2.x\u7248\u672c\uff0c\u8bf7\u4e0b\u8f7d\uff1adt-cocos-sdk(2.x)\n1.2 \u96c6\u6210 JS SDK\n\n\nTypeScript ESModule \u9879\u76ee\n\n\u5c06\u538b\u7f29\u5305\u4e2d\u7684 dt.cc.mjs\u3001dt.cc.d.mts(2.x\u7248\u672c\u4f7f\u7528\u538b\u7f29\u5305\u4e2d\u7684cocos.js\u548ccoco.d.ts) \u653e\u5165\u9879\u76ee assets\/libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n\u5728 assets\/scripts\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\nimport { DataTower } from '..\/lib\/dt.cc.mjs';\n\n\n\n\n\nJavaScript CommonJS \u9879\u76ee\n\n\u5c06\u538b\u7f29\u5305\u4e2d\u7684 dt.cc.cjs\u3001dt.cc.d.cts \u653e\u5165\u9879\u76ee assets\/libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n\u5728 assets\/scripts\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\nconst { DataTower } = require('..\/lib\/dt.cc.cjs')\n\n\n\n\n\n1.3 Android \u7aef\u96c6\u6210\n\n\n\n\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 mavenCentral \u4ed3\u5e93\nallprojects {\n repositories {\n ...\n mavenCentral()\n }\n}\n\n\n\n\u5728\u9879\u76ee\u4e3b\u5de5\u7a0b\u76ee\u5f55\u4e0b build.gradle \u6587\u4ef6\u4e2d\u6dfb\u52a0 SDK \u4f9d\u8d56\ndependencies {\n ...\n\n implementation 'ai.datatower:core:{\u6700\u65b0\u7248\u672c}'\n}\n\n\n\n\u5c06 DTCocosCreatorProxyApi.java \u653e\u5230 {\u9879\u76ee\u5730\u5740}\/native\/engine\/android\/app\/src\/ \u4e0b\u3002\u5982\u679c\u60a8\u4f7f\u7528\u7684\u662f2.x\u7684\u7248\u672c\uff0c\u5219\u5c06\u538b\u7f29\u5305\u4e2d\u7684 DTCocosCreatorProxyApi.java\uff0c\u653e\u5230\/app\/src\/org\/cocos2dx\/javasrcipt\/\u4e0b\uff0c\u5982\uff1a\n\n\n\n\n\nproguard \u89c4\u5219\u4e2d\u52a0\u5165 ({\u9879\u76ee\u5730\u5740}\/native\/engine\/android\/app\/proguard-rules.pro)\uff1a\n-keep class ai.datatower.bridge.DTCocosCreatorProxyApi { *; }\n\n\n\n1.3 iOS \u7aef\u96c6\u6210\n1. \u96c6\u6210\u4e8c\u8fdb\u5236\u6587\u4ef6\n1. \u65b9\u5f0f\u4e00\uff0c\u624b\u52a8\u96c6\u6210\n\u628a\u538b\u7f29\u5305\u4e2d\u7684DataTowerAICore.framework \u5f15\u5165\u5de5\u7a0b\n\n\u5f15\u5165\u7cfb\u7edf\u5e93 CoreTelephony\n\n\u6dfb\u52a0-all_load\u6807\u5fd7, target -> build Settings -> Other Linker Flags\n\n\u53c2\u8003 iOS\u9759\u6001\u5e93\u4f7f\u7528category\u95ee\u9898\n2. \u65b9\u5f0f\u4e8c\uff0c\u81ea\u52a8\u96c6\u6210 \uff08\u63a8\u8350\uff09\n\u76ee\u524d\u4ec5\u652f\u6301pod\u81ea\u52a8\u96c6\u6210\u65b9\u5f0f\n1. \u5148\u5b89\u88c5pod\uff0c\u5b89\u88c5\u6210\u529f\u540e\uff0c\u8fdb\u5165\u9879\u76ee\u76ee\u5f55\uff0c\u8fd0\u884cpod init\uff0c\u4f1a\u751f\u6210podfile\n2. \u5728podfile\u91cc\u6dfb\u52a0\u76f8\u5e94\u914d\u7f6e\n pod \"DataTowerAICore\", \"~> 3.0.0\"\n3. \u6267\u884c pod install\n4. \u6253\u5f00xxx.xcworkspace\u9879\u76ee\n\n2. \u6dfb\u52a0\u6e90\u6587\u4ef6\n\n\n\u628a\u538b\u7f29\u5305\u4e2d\u7684DTCocosCreatorProxyApi.h \u548c DTCocosCreatorProxyApi.mm \u6dfb\u52a0\u5230\u9879\u76ee\u4e2d\n\n\n\n\u73b0\u5728\u53ef\u4ee5\u8fdb\u884c\u7f16\u8bd1\n\n\n3. \u5e38\u89c1\u95ee\u9898\n\n\n\u7f16\u8bd1\u62a5\u9519\uff0cfatal error: 'DataTowerAICore\/DTAnalytics.h' file not found\n\u624b\u52a8\u548c\u81ea\u52a8\u96c6\u6210\u90fd\u6709\u53ef\u80fd\u9047\u5230\uff0c\n\u5982\u679c\u662f\u624b\u52a8\u96c6\u6210\uff0c\u6dfb\u52a0framework\u7684\u8def\u5f84\u5230framework search paths\n\u5982\u679c\u662f\u81ea\u52a8\u96c6\u6210\uff0c\u53ef\u4ee5\u6dfb\u52a0$(inherited)\u5230framework search paths\uff0c\u518d\u6267\u884c\u4e00\u6b21 pod install\n\n\n\n\u8fd0\u884c\u62a5\u9519 unrecognized selector sent to class\n\u624b\u52a8\u96c6\u6210\u4f1a\u9047\u5230\uff0c\u6dfb\u52a0-all_load\u6807\u5fd7\uff0c\u89c1\u624b\u52a8\u96c6\u6210\u6307\u5f15\n\n\n\u4e8c\u3001\u521d\u59cb\u5316\n\n\n\u8bf4\u660e\n\n\nDataTower.ai Core SDK \u552f\u4e00\u521d\u59cb\u5316\u5165\u53e3\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static initSDK(config: Config): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n \u793a\u4f8b\n\n\n\n\n appId\n string\n \u662f\n \u9879\u76ee\u552f\u4e00\u6807\u8bc6\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n dt_test\n\n\n serverUrl\n string\n \u662f\n \u6570\u636e\u4e0a\u62a5\u5730\u5740\uff0c\u521b\u5efa\u9879\u76ee\u540e DT \u540e\u53f0\u81ea\u52a8\u5206\u914d\uff0c\u8bf7\u5728\u3010\u9879\u76ee\u8bbe\u7f6e-\u9879\u76ee\u8be6\u60c5\u3011\u4e2d\u83b7\u53d6\n https:\/\/xxx.roiquery.com\n\n\n channel\n string\n \u5426\n \u6e20\u9053\uff0c\u6253\u591a\u6e20\u9053\u5305\u65f6\u9700\u8981\u7528\u5230\uff0c\u53ef\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684\u5b9e\u73b0\uff0c \u9ed8\u8ba4\u4e3a\u201c\u201d\n DTChannel.GP\n\n\n isDebug\n boolean\n \u5426\n \u662f\u5426\u6253\u5f00\u8c03\u8bd5\uff0c\u8c03\u8bd5\u6a21\u5f0f\u4e0b\u5c06\u6253\u5370 log\uff0c\u9ed8\u8ba4\u4e3a false\uff0clog \u6807\u7b7e\u4e3a DataTower\n true\/false\n\n\n logLevel\n number\n \u5426\n log \u7684\u7ea7\u522b\uff0c\u9ed8\u8ba4\u4e3a LogLevel.VERBOSE\uff0c\u4ec5\u5728 isDebug = true \u6709\u6548\n Log.VERBOSE\u3001Log.DEBUG\u3001Log.ERROR \u7b49\n\n\n manualEnableUpload\n boolean\n \u5426\n \u662f\u5426\u624b\u52a8\u542f\u52a8\u4e0a\u62a5, \u5982\u8bbe\u4e3a true, \u5219\u9700\u8981\u81ea\u884c\u8c03\u7528 enableUpload \u5f00\u542f\u4e0a\u62a5\n true\/false\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ DT SDK \u521d\u59cb\u5316\nDataTower.initSDK({\n appId: \"app_id\",\n serverUrl: \"https:\/\/example.com\",\n channel: \"\",\n isDebug: true,\n logLevel: LogLevel.VERBOSE,\n manualEnableUpload: false,\n});\n\n\u4e09\u3001\u57fa\u7840\u529f\u80fd\n3.1 ID \u4f53\u7cfb\n3.1.1 \u8bbe\u7f6e\u8d26\u53f7 ID\n\n\n\u8bf4\u660e\n\n\n\u53ef\u4ee5\u5728\u7528\u6237\u6bcf\u4e00\u6b21\u767b\u5f55\u65f6\uff0c\u8c03\u7528 setAccountId \u8bbe\u7f6e\u7528\u6237\u7684\u8d26\u53f7 ID\uff0c DT \u7cfb\u7edf\u5c06\u4f1a\u4ee5\u8d26\u53f7 ID \u4f5c\u4e3a\u8eab\u4efd\u8bc6\u522b ID\uff0c\u591a\u6b21\u8c03\u7528 setAccountId \u5c06\u8986\u76d6\u5148\u524d\u7684\u8d26\u53f7 ID\n\u82e5\u60a8\u7684\u5e94\u7528\u6ca1\u6709\u8d26\u53f7\u4f53\u7cfb\u53ef\u4ee5\u4e0d\u8bbe\u7f6e\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static setAccountId(id: string): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n id\n string\n \u662f\n \u81ea\u6709\u7528\u6237\u7cfb\u7edf\u7684 id\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.setAccountId(\"123456\");\n\n\n\u5982\u679c\u9700\u8981\u6e05\u9664\u8d26\u53f7 ID\uff0c\u8bf7\u4f20\u5165\u7a7a\u5b57\u7b26\u4e32\nDataTower.setAccountId(\"\");\n\n\n3.1.2 \u83b7\u53d6 DT ID\n\n\n\u8bf4\u660e\n\n\n\u5f02\u6b65\u83b7\u53d6\u7531 SDK \u751f\u6210\u7684\u8bbe\u5907\u6807\u8bc6 DT ID\u3002\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static getDataTowerId(callback: (id: string) => void): void;\n static getDataTowerId(): Promise;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n callback\n (id: string) => void\n \u5426\n \u7528\u6237\u63a5\u6536 dt id \u7684\u56de\u8c03\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.getDataTowerId((id) => console.log(id));\n\/\/ or\nconst id = await DataTower.getDataTowerId();\n\n3.2 \u8bbe\u7f6e\u4e8b\u4ef6\u4e0a\u62a5\n\n\n\u8bf4\u660e\n\n\n\u8c03\u7528 track \u8bbe\u7f6e\u81ea\u52a8\u4e0a\u62a5\u7684\u57cb\u70b9\u4e8b\u4ef6\u548c\u4e8b\u4ef6\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static track(\n eventName: string,\n properties: Record\n ): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n eventName\n string\n \u662f\n \u4e8b\u4ef6\u540d\u79f0\n\n\n properties\n Record\n \u662f\n \u81ea\u5b9a\u4e49\u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.track(\"test_track\", {\n test_property_1: \"test\",\n test_property_2: 1,\n});\n\n3.3 \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\n3.3.1 user_set\n\n\n\u8bf4\u660e\n\n\n\u5bf9\u4e8e\u4e00\u822c\u7684\u7528\u6237\u5c5e\u6027\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userSet \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u4f7f\u7528\u8be5\u63a5\u53e3\u4e0a\u4f20\u7684\u5c5e\u6027\u5c06\u4f1a\u8986\u76d6\u539f\u6709\u7684\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\u65b9\u6cd5\n\n\nclass DataTower {\n static userSet(properties: Record): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Record\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.userSet({\n user_sex_man: false,\n user_pwd: \"1111111\",\n user_age: 23,\n});\n\n3.3.2 user_set_once\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u8981\u4e0a\u4f20\u7684\u7528\u6237\u5c5e\u6027\u53ea\u8981\u8bbe\u7f6e\u4e00\u6b21\uff0c\u5219\u53ef\u4ee5\u8c03\u7528 userSetOnce \u6765\u8fdb\u884c\u8bbe\u7f6e\uff0c\u5f53\u8be5\u5c5e\u6027\u4e4b\u524d\u5df2\u7ecf\u6709\u503c\u7684\u65f6\u5019\uff0c\u5c06\u4f1a\u5ffd\u7565\u8fd9\u6761\u4fe1\u606f\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userSetOnce(\n properties: Record\n ): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Record\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.userSetOnce({\n user_first_paid_time: \"2020-09-23\",\n});\n\n3.3.3 user_add\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u4e0a\u4f20\u6570\u503c\u578b\u7684\u5c5e\u6027\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userAdd \u6765\u5bf9\u8be5\u5c5e\u6027\u8fdb\u884c\u7d2f\u52a0\u64cd\u4f5c\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\uff0c\u7b49\u540c\u4e8e\u76f8\u51cf\u64cd\u4f5c\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userAdd(properties: Record): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Record\n \u662f\n \u4e8b\u4ef6\u5c5e\u6027 \u8bbe\u7f6e\u7684\u5c5e\u6027 key \u4e3a\u5b57\u7b26\u4e32\uff0cValue \u53ea\u5141\u8bb8\u4e3a\u6570\u503c\uff0c\u5426\u5219\u64cd\u4f5c\u4e0d\u751f\u6548\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.userAdd({ total: 30 });\n\/\/ \u6b64\u65f6\"total\"\u4e3a30\nDataTower.userAdd({ total: 648 });\n\/\/ \u6b64\u65f6\"total\"\u4e3a678\n\n3.3.4 user_unset\n\n\n\u8bf4\u660e\n\n\n\u5f53\u60a8\u8981\u6e05\u7a7a\u7528\u6237\u7684\u7528\u6237\u5c5e\u6027\u503c\u65f6\uff0c\u60a8\u53ef\u4ee5\u8c03\u7528 userUnset \u6765\u5bf9\u6307\u5b9a\u5c5e\u6027\u8fdb\u884c\u6e05\u7a7a\u64cd\u4f5c\uff0c\u5982\u679c\u8be5\u5c5e\u6027\u8fd8\u672a\u521b\u5efa\uff0c\u5219 userUnset \u4e0d\u4f1a\u521b\u5efa\u8be5\u5c5e\u6027\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userUnset(properties: string[]): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n string[]\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.userUnset([\"key1\"]);\n\n3.3.5 user_delete\n\n\n\u8bf4\u660e \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\u3002\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userDelete(): void;\n}\n\n3.3.6 user_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userAppend \u5bf9\u5217\u8868\u7c7b\u578b\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u5143\u7d20\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userAppend(\n properties: Record\n ): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Record\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\nDataTower.userAppend({ user_list: [\"apple\", \"cube\"] });\n\n3.3.7 user_uniq_append\n\n\n\u8bf4\u660e\n\n\n\u60a8\u53ef\u4ee5\u8c03\u7528 userUniqAppend \u5bf9\u5217\u8868\u7684\u7528\u6237\u6570\u636e\u8ffd\u52a0\u552f\u4e00\u5143\u7d20\u3002\u8c03\u7528 userUniqAppend \u63a5\u53e3\u4f1a\u5bf9\u8ffd\u52a0\u7684\u7528\u6237\u5c5e\u6027\u8fdb\u884c\u53bb\u91cd\uff0c userAppend \u63a5\u53e3\u4e0d\u505a\u53bb\u91cd\uff0c\u7528\u6237\u5c5e\u6027\u53ef\u5b58\u5728\u91cd\u590d\n\n\n\u65b9\u6cd5\n\n\nclass DataTower {\n static userUniqAppend(\n properties: Record\n ): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n properties\n Record\n \u662f\n \u7528\u6237\u5c5e\u6027\u540d\u79f0\u96c6\n\n\n\n\n\n\u4f7f\u7528\n\n\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\"\uff0c\"ball\"]\nDataTower.userUniqAppend({ user_list: [\"apple\", \"ball\"] });\n\/\/ \u6b64\u65f6user_list\u7684\u5c5e\u6027\u503c\u4e3a[\"apple\",\"apple\",\"ball\",\"cube\"]\nDataTower.userUniqAppend({ user_list: [\"apple\", \"cube\"] });\n\n\u56db\u3001\u8fdb\u9636\u529f\u80fd\n4.1 \u6536\u5165\u6570\u636e\u4e0a\u62a5\n4.1.1 \u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u5168\u94fe\u8def\n\n\n\u8bf4\u660e\n\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5e7f\u544a\u53d8\u73b0\uff08IAA\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u5e7f\u544a\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5e7f\u544a\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\u5e76\u4e0d\u662f\u6240\u6709\u4e8b\u4ef6\u90fd\u8981\u6c42\u4e0a\u62a5\uff0c\u4f46\u662f\u4e0a\u62a5\u7684\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u6709\u52a9\u4e8e\u5206\u6790\u6574\u4e2a\u5e7f\u544a\u53d8\u73b0\u94fe\u8def\u3002\u5982\u679c\u9884\u7f6e\u4e8b\u4ef6\u4e2d\u6ca1\u6709\u6ee1\u8db3\u4f60\u7684\u9700\u6c42\uff0c\u4f60\u4ecd\u53ef\u4ee5\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u3002DT \u4e2d\u9488\u5bf9\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\uff08\u52a0\u8f7d\u3001\u5c55\u793a\u3001\u884c\u4e3a\u3001\u8f6c\u5316\u3001\u5173\u95ed\u7b49\uff09\uff0c\u4f7f\u7528\u4e86\u552f\u4e00\u7684 seq \u7528\u6765\u5173\u8054\u548c\u533a\u5206\u3002\u5982\u679c\u4f60\u60f3\u5173\u8054\u540c\u4e00\u4e2a\u5e7f\u544a\u53d8\u73b0\u6d41\u7a0b\u4e2d\u9884\u7f6e\u4e8b\u4ef6\u548c\u81ea\u5b9a\u4e49\u4e8b\u4ef6\uff0c\u8bf7\u4f7f\u7528 seq \u8fdb\u884c\u5173\u8054\u3002\n\u5982\u679c\u9700\u8981\u67e5\u770b\u8bbe\u5907\u5c42\u7ea7\u5e7f\u544a\u6536\u5165\u9884\u4f30\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\n\n\n \u63a5\u53e3\u540d\n\n\n\n\n reportShow\n\n\n reportPaid\n\n\n reportClick\n\n\n reportRewarded\n\n\n reportConversionByClick\n\n\n reportConversionByRewarded\n\n\n reportConversionByLeftApp\n\n\n\n\n\u5982\u679c\u9700\u8981\u67e5\u770b\u5e7f\u544a\u53d8\u73b0\u6f0f\u6597\uff0c\u8bf7\u52a1\u5fc5\u8c03\u7528\u4ee5\u4e0b\u63a5\u53e3\u4e0a\u62a5\u76f8\u5173\u4e8b\u4ef6\uff1a\n\n\n\n\n \u63a5\u53e3\u540d\n\n\n\n\n reportToShow\n\n\n reportShow\n\n\n reportClick\n\n\n reportRewarded\n\n\n\n\n\n\u63a5\u53e3\u5217\u8868\n\n\n\/\/ \u4e0a\u62a5\u5e7f\u544a\u5f00\u59cb\u52a0\u8f7d\u4e8b\u4ef6\nclass DataTower {\n static reportLoadBegin(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n seq: string;\n properties?: Record;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u7ed3\u675f\u52a0\u8f7d\u4e8b\u4ef6\n static reportLoadEnd(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n duration: number;\n result: boolean;\n seq: string;\n errorCode: number;\n errorMessage: string;\n properties?: Record;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u9884\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u60f3\u5c55\u793a\u5e7f\u544a\u4e4b\u524d\u8c03\u7528\n static reportToShow(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4e8b\u4ef6\uff0c\u5728\u5c55\u793a\u5e7f\u544a\u65f6\u8c03\u7528\n static reportShow(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u5931\u8d25\u4e8b\u4ef6,\u5728\u5c55\u793a\u5e7f\u544a\u5931\u8d25\u65f6\u8c03\u7528\n static reportShowFailed(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n errorCode: number;\n errorMessage: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5173\u95ed\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u5173\u95ed\u65f6\u8c03\u7528\n static reportClose(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u70b9\u51fb\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544a\u88ab\u70b9\u51fb\u65f6\u8c03\u7528\n static reportClick(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u83b7\u5f97\u5956\u52b1\u4e8b\u4ef6\uff0c\u5728\u6fc0\u52b1\u5e7f\u544a\u83b7\u53d6\u5956\u52b1\u540e\u8c03\u7528\n static reportRewarded(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_click\uff09\n static reportConversionByClick(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u83b7\u5f97\u5e7f\u544a\u6fc0\u52b1\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_rewarded\uff09\n static reportConversionByRewarded(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u6536\u76ca\u8f6c\u5316\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u540e\u8df3\u51faApp\u65f6\u8c03\u7528\uff08#ad_conversion_source = by_left_app\uff09\n static reportConversionByLeftApp(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n \/\/ \u4e0a\u62a5\u5e7f\u544a\u5c55\u793a\u4ef7\u503c\u4e8b\u4ef6\uff0c\u5728\u5e7f\u544aSDK\u56de\u8c03\u65f6\u8c03\u7528\n static reportPaid(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n value: string;\n currency: string;\n precision: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n\n static reportPaid(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n mediation: AdMediation;\n mediationId: string;\n value: string;\n precision: string;\n country: string;\n properties?: Record;\n }): void;\n\n \/\/ \u4e0a\u62a5\u79bb\u5f00app\u4e8b\u4ef6\uff0c\u5728\u70b9\u51fb\u5e7f\u544a\u94fe\u63a5\uff0c\u79bb\u5f00\u5f53\u524dapp(\u9875\u9762)\u65f6\u8c03\u7528\n static reportLeftApp(opts: {\n id: string;\n type: AdType;\n platform: AdPlatform;\n location: string;\n seq: string;\n properties?: Record;\n entrance?: string;\n mediation?: AdMediation;\n mediationId?: string;\n }): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n seq\n string\n \u662f\n \u5e7f\u544a\u7cfb\u5217\u4e8b\u4ef6\u7684\u6807\u8bc6\uff0c\u9700\u8981\u8c03\u7528 DTAdReport.generateUUID\uff08\uff09\u751f\u6210\n\n\n id\n string\n \u662f\n Network \u5e7f\u544a\u5355\u5143 ID\n\n\n type\n AdType\n \u662f\n \u8be6\u89c1 \u7c7b\u578b Type\n\n\n platform\n AdPlatform\n \u662f\n \u8be6\u89c1 \u5e7f\u544a\u5e73\u53f0 Platform\n\n\n entrance\n string\n \u5426\n \u5e7f\u544a\u5c55\u793a\u5165\u53e3\n\n\n result\n boolean\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u7ed3\u679c\uff0ctrue \u4e3a\u5e7f\u544a\u52a0\u8f7d\u6210\u529f\n\n\n duration\n number\n \u662f\n \u5e7f\u544a\u52a0\u8f7d\u65f6\u957f\n\n\n location\n string\n \u662f\n \u5e7f\u544a\u4f4d\u7f6e\uff0c\u901a\u5e38\u4e3a\u5728\u5e7f\u544a\u5e73\u53f0\u914d\u7f6e\u7684\u4f4d\u7f6e\u503c\n\n\n errorCode\n number\n \u5426\n \u5931\u8d25\u7801\uff0c\u503c\u4e3a\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u7801\n\n\n errorMessage\n string\n \u5426\n \u5931\u8d25\u4fe1\u606f\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u9519\u8bef\u4fe1\u606f\n\n\n value\n string\n \u662f\n \u5e7f\u544a\u4ef7\u503c\uff0c\u5e94\u7528\u63a5\u5165\u7684\u5bf9\u5e94\u7684\u5e7f\u544a\u5e73\u53f0\u7ed9\u51fa\u7684\u5e7f\u544a\u4ef7\u503c\u4fe1\u606f\n\n\n currency\n string\n \u662f\n \u5e7f\u544a\u4ef7\u503c\u5bf9\u5e94\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u8bf7\u4f20\u5165 USD\n\n\n precision\n string\n \u662f\n \u7cbe\u786e\u5ea6\uff0c\u5e7f\u544a\u4ef7\u503c\u6240\u5bf9\u5e94\u7684\u7cbe\u786e\u5ea6\n\n\n country\n string\n \u662f\n \u5e7f\u544a\u5c55\u793a\u6240\u5728\u7684\u56fd\u5bb6\/\u5730\u533a\u4fe1\u606f\n\n\n mediation\n AdMediation\n \u5426\n \u8be6\u89c1 \u805a\u5408\u5e7f\u544a\u5e73\u53f0 Mediation\n\n\n mediationId\n string\n \u5426\n \u805a\u5408\u5e73\u53f0\u5e7f\u544a\u5355\u5143 ID\n\n\n properties\n Record\n \u5426\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n\n\n\u4f7f\u7528\u4e8b\u4f8b\n\n\n\u573a\u666f\u4e00\uff1a\u72ec\u7acb\u5e7f\u544a\u5e73\u53f0\n\/*\n* \u4e00\u6b21\u5c55\u793aAdmob\u63d2\u9875\u5e7f\u544a\u7684\u8fc7\u7a0b\n*\/\n\n\/\/ \u5e7f\u544a\u4f4d\uff0c\u6bd4\u5982\u8fd9\u9875\u9762\u662f\u4e3b\u9875\nconst location = \"main\";\n\n\/\/ Admob\u5e7f\u544a\u5355\u5143\nconst adUnit = \"xxxxxxxx\";\n\n\/\/ \u6574\u4e2a\u8fc7\u7a0b\u7684\u884c\u4e3a\u7cfb\u5217\u6807\u8bc6\nconst seq = \"xxx\";\n\n\/\/ 1.\u4e0a\u62a5\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\nDataTower.reportLoadBegin({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n seq: seq,\n});\n\n\/\/ 2.Admob\u5f00\u59cb\u52a0\u8f7d\u5e7f\u544a\n\/\/ \u52a0\u8f7d\u5f00\u59cb\u65f6\u95f4\nconst loadStartTime = new Date().getTime();\n\n\/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u6210\u529f\nDataTower.reportLoadEnd({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n duration: new Date().getTime() - loadStartTime,\n result: true,\n seq: seq,\n});\n\/\/ 3.\u4e0a\u62a5\u52a0\u8f7d\u5e7f\u544a\u5931\u8d25\nDataTower.reportLoadEnd({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n duration: new Date().getTime() - loadStartTime,\n result: false,\n seq: seq,\n errorCode: 1001,\n errorMessage: \"\u5e7f\u544a\u52a0\u8f7d\u5931\u8d25\",\n});\n\n\/\/ 4.\u5c55\u793a\u5e7f\u544a\nDTAdReport.reportToShow(\n adUnit,\n AdType.INTERSTITIAL,\n AdPlatform.ADMOB,\n location,\n seq\n);\n\n\/\/ 5.\u5e7f\u544a\u5c55\u793a\u6210\u529f\nDataTower.reportShow({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\/\/ 6.\u5e7f\u544a\u5c55\u793a\u5931\u8d25\nDataTower.reportShowFailed({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n errorCode: 1001,\n errorMessage: \"\u5e7f\u544a\u52a0\u8f7d\u5931\u8d25\",\n});\n\n\/\/ 7.\u5e7f\u544a\u88ab\u70b9\u51fb\nDataTower.reportClick({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\/\/ 8.\u5e7f\u544a\u5173\u95ed\nDataTower.reportClose({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\u5bf9\u4e8e\u6fc0\u52b1\u5e7f\u544a\uff0c\u4f1a\u6709\u83b7\u5f97\u6fc0\u52b1\u56de\u8c03\nDataTower.reportConversionByRewarded({\n id: adUnit,\n type: AdType.REWARDED,\n platform: AdPlatform.ADMOB,\n location: location,\n seq: seq,\n});\n\n\u573a\u666f\u4e8c\uff1a\u805a\u5408\u5e7f\u544a\u5e73\u53f0\uff08Mediation\uff09\n\u7531\u4e8e\u805a\u5408\u5e7f\u544a\u5e73\u53f0\u5c55\u793a\u5e7f\u544a\u7684\u65f6\u5019\uff0c\u901a\u5e38\u6ca1\u6709\u8fd4\u56de\u5177\u4f53\u662f\u54ea\u4e2a\u5e7f\u544a\u5e73\u53f0\uff08Network\uff09\u7684\u5e7f\u544a\u548c\u5bf9\u5e94\u4fe1\u606f\uff0c\u6240\u4ee5\u9700\u8981\u5728\u56de\u8c03\u4e2d\u5224\u65ad\uff0c\u5982 onAdShowed \u56de\u8c03\n\/\/ \u805a\u5408\u5e7f\u544a\u5e73\u53f0\u4e00\u822c\u4f1a\u8fd4\u56de\u5e7f\u544a\u76f8\u5173\u7684\u4fe1\u606f AdInfo\nconst adInfo: AdInfo = ...;\n\/\/ \u9700\u81ea\u884c\u5b9e\u73b0 getAdPlatform() \u3001getAdUnit()\u65b9\u6cd5\nconst adPlatform = getAdPlatform(ad);\nconst adUnit = getAdUnit(ad);\n\/\/ \u5e7f\u544a\u5c55\u793a\u6210\u529f\nDataTower.reportShow({\n id: adUnit,\n type: AdType.INTERSTITIAL,\n platform: adPlatform,\n location: location,\n seq: seq,\n});\n\n\u5176\u4ed6 API \u7c7b\u4f3c\n4.1.2 \u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAP\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u5185\u8d2d\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u5185\u8d2d\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u4e0a\u62a5\u8d2d\u4e70\u6210\u529f\u4e8b\u4ef6\uff0c\u8d2d\u4e70\u6210\u529f\u7684\u65f6\u5019\u4e0a\u62a5\nclass DataTower {\n static reportPurchaseSuccess(opts: {\n order: string;\n sku: string;\n price: number;\n currency: string;\n properties: Record;\n }): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n currency\n string\n \u662f\n \u8d2d\u4e70\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n number\n \u662f\n \u8d2d\u4e70\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n string\n \u662f\n \u8d2d\u4e70\u5546\u54c1 id\n\n\n order\n string\n \u662f\n \u8d2d\u4e70\u8ba2\u5355\n\n\n properties\n Record\n \u662f\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n4.1.3 \u8ba2\u9605\u53d8\u73b0\uff08IAS\uff09\u5168\u94fe\u8def\uff08beta\uff09\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u4f60\u7684\u4ea7\u54c1\u5177\u5907\u5185\u8d2d\u53d8\u73b0\uff08IAS\uff09\u529f\u80fd\uff0cDT SDK \u5df2\u7ecf\u9884\u7f6e\u4e86\u4e00\u4e9b\u5e38\u7528\u7684\u4e8b\u4ef6\u63a5\u53e3\u3002\u5728\u4ea7\u54c1\u7684\u8ba2\u9605\u53d8\u73b0\u76f8\u5173\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u8c03\u7528\u76f8\u5e94\u7684\u63a5\u53e3\u3002\u4e00\u65e6\u8c03\u7528\u4e86\u8fd9\u4e9b\u63a5\u53e3\u6210\u529f\uff0c\u60a8\u53ef\u4ee5\u5728\u6211\u4eec\u7684\u540e\u53f0\u5b9e\u65f6\u67e5\u770b\u8ba2\u9605\u53d8\u73b0\u5168\u94fe\u8def\u7684\u8868\u73b0\u6570\u636e\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u8ba2\u9605\u6210\u529f\u4e8b\u4ef6\u4e0a\u62a5\uff0c\u8ba2\u9605\u6210\u529f\u65f6\u4e0a\u62a5\nclass DataTower {\n static reportSubscribeSuccess(opts: {\n sku: string;\n price: number;\n currency: string;\n properties: Record;\n originalOrderId: string;\n orderId: string;\n }): void;\n}\n\n\n\n\u53c2\u6570\n\n\n\n\n\n \u53c2\u6570\u540d\n \u7c7b\u578b\n \u662f\u5426\u5fc5\u4f20\n \u8bf4\u660e\n\n\n\n\n currency\n string\n \u662f\n \u8ba2\u9605\u6240\u7528\u7684\u8d27\u5e01\u5355\u4f4d\uff0c\u4e0e price \u5171\u540c\u51b3\u5b9a\u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n price\n number\n \u662f\n \u8ba2\u9605\u6240\u9700\u7684\u4ef7\u683c\n\n\n sku\n string\n \u662f\n \u8ba2\u9605\u5546\u54c1 id\n\n\n orderId\n string\n \u662f\n \u8ba2\u9605\u8ba2\u5355\n\n\n originalOrderId\n string\n \u662f\n \u8ba2\u9605\u539f\u59cb\u8ba2\u5355 id\n\n\n properties\n Record\n \u662f\n \u5e94\u7528\u81ea\u5b9a\u4e49\u7684\u989d\u5916\u5c5e\u6027\n\n\n\n4.2 \u96c6\u6210\u4e09\u65b9\u6570\u636e\n4.2.1 \u900f\u4f20 dt_id\n\u5982\u679c\u60a8\u9700\u5c06\u4e09\u65b9\u6570\u636e\u540c\u6b65\u81f3 DT \u5e73\u53f0\uff0c\u8bf7\u5728\u4e09\u65b9 SDK \u521d\u59cb\u5316\u4e4b\u524d\u8c03\u7528 get dt_id \u7684\u65b9\u6cd5\uff0c\u7136\u540e\u6309\u7167 DT \u96c6\u6210\u5404\u5e73\u53f0\u7684\u64cd\u4f5c\u6587\u6863\u4f20\u5165\u4e09\u65b9\u5e73\u53f0\u7684\u5bf9\u5e94\u53c2\u6570\nDataTower.getDataTowerId((dt_id) => {})\n\/\/ \u6216\nconst id = await DataTower.getDataTowerId();\n\n4.2.2 user_set \u4e09\u65b9 ID\n\u5982\u679c\u60a8\u9700\u5c06 DT \u6570\u636e\u4ece\u670d\u52a1\u7aef\u53d1\u9001\u81f3\u4e09\u65b9\u5e73\u53f0\uff0c\u8bf7\u521d\u59cb\u5316\u4e09\u65b9 SDK \u4e4b\u540e\u83b7\u53d6\u4e09\u65b9 ID\uff0c\u7136\u540e\u4f7f\u7528 DT SDK \u8fdb\u884c\u6570\u636e\u4e0a\u62a5\uff0c\u5b8c\u6210 dt_id \u548c\u4e09\u65b9 ID \u7684\u7ed1\u5b9a\n\/\/ \u9700\u5148\u83b7\u53d6\u5bf9\u5e94 id\n\/\/ Firebase\nDataTower.setFirebaseAppInstanceId(\"\");\n\/\/ Kochava\nDataTower.setKochavaId(\"\");\n\/\/ AppsFlyer\nDataTower.setAppsFlyerId(\"\");\n\/\/ Adjust\nDataTower.setAdjustId(\"\");\n\n4.3 \u4e8b\u4ef6\u65f6\u957f\u8ba1\u65f6\n\n\n\u8bf4\u660e\n\n\n\u5982\u679c\u60a8\u9700\u8981\u8bb0\u5f55\u67d0\u4e2a\u4e8b\u4ef6\u7684\u6301\u7eed\u65f6\u957f\uff0c\u53ef\u4ee5\u8c03\u7528 trackTimerStart \u6765\u5f00\u59cb\u8ba1\u65f6\u3002\n\u5728\u4e8b\u4ef6\u5f00\u59cb\u65f6\uff0c\u8c03\u7528 trackTimerStart \u5e76\u4e0d\u4f1a\u771f\u6b63\u53d1\u9001\u4e8b\u4ef6\uff1b\u5728\u4e8b\u4ef6\u7ed3\u675f\u65f6\u8c03\u7528 trackTimerEnd\uff0cSDK \u4f1a\u4e0a\u62a5 \"event\" \u4e8b\u4ef6\uff0c\u5e76\u81ea\u52a8\u5728\"event\" \u4e8b\u4ef6\u5c5e\u6027\u4e2d\u52a0\u5165 #duration \u8fd9\u4e00\u5c5e\u6027\u6765\u8868\u793a\u8bb0\u5f55\u7684\u4e8b\u4ef6\u6301\u7eed\u65f6\u957f\u3002\n\n\n\u65b9\u6cd5\n\n\n\/\/ \u5f00\u59cb\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerStart(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6682\u505c\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerPause(\"event\");\n\n\/\/ \u5982\u679c\u9700\u8981\u6062\u4e8b\u4ef6\u8ba1\u65f6\nDataTower.trackTimerResume(\"event\");\n\n\/\/ \u7ed3\u675f\u4e8b\u4ef6\u8ba1\u65f6, properties \u4e3a\u81ea\u5b9a\u4e49\u5c5e\u6027\uff0cRecord\nDataTower.trackTimerEnd(\"event\", { key: \"value\" });","is_draft":"0","editor_type":"2","file_path":"","add_time":"1714979871","update_time":"1745547266"},"pure_content":"\u24d8 \u63d0\u793a\nCocosCreator 3.x\nAndroid \u8981\u6c42\u6700\u4f4e\u7cfb\u7edf\u7248\u672c\u4e3a Android 4.4\n\n\u4e00\u3001\u96c6\u6210\n1.1 \u4e0b\u8f7dcocos-sdk\u538b\u7f29\u5305\n\u4e0b\u8f7d\u94fe\u63a5\uff1adt-cocos-sdk\n\u5982\u679c\u60a8\u4f7f\u7528\u7684\u662fCocos 2.x\u7248\u672c\uff0c\u8bf7\u4e0b\u8f7d\uff1adt-cocos-sdk(2.x)\n1.2 \u96c6\u6210 JS SDK\n\n\nTypeScript ESModule \u9879\u76ee\n\n\u5c06\u538b\u7f29\u5305\u4e2d\u7684 dt.cc.mjs\u3001dt.cc."},{"id":"181013","string_id":"eEZmhgcV","status":"1","parent_id":"80675","slug":"JavaScirpt","order":"0","name":"JavaScript","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1728872295","update_time":"1731998956","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"181013","content":"> \u66f4\u65b0\u65f6\u95f4\uff1a2024-10-16\n\n[![NPM Version](https:\/\/img.shields.io\/npm\/v\/%40datatower-ai%2Fsdk-core-web?style=for-the-badge&logo=npm&logoColor=231F20&labelColor=FB8113&color=E8DEFF)](https:\/\/www.npmjs.com\/package\/@datatower-ai\/sdk-core-web)\n\n## \u4e00\u3001\u96c6\u6210\n\n### 1.1 \u4ece `npm` \u4ed3\u5e93\u5f15\u5165\n\n- **\u5b89\u88c5\u4f9d\u8d56**\n\n```bash\nnpm i @datatower-ai\/sdk-core-web\n```\n\n- **\u5f15\u5165\u5e76\u4f7f\u7528**\n\n```typescript\nimport { DataTower } from '@datatower-ai\/sdk-core-web';\n\/\/ \u521d\u59cb\u5316\nDataTower.initSDK({\/* ... *\/})\n```\n\n\n### 1.2 \u4e0b\u8f7d\u5230\u672c\u5730\uff0c\u624b\u52a8\u96c6\u6210 web SDK\n\n- **\u4e0b\u8f7dweb-sdk\u538b\u7f29\u5305**\n\n \u4e0b\u8f7d\u94fe\u63a5\uff1a[datatower-web-sdk](https:\/\/storage.googleapis.com\/datatower\/dt-sdk\/datatower-web-sdk.zip)\n\n- **TypeScript ESModule \u9879\u76ee**\n 1. \u5c06\u538b\u7f29\u5305\u4e2d\u7684 `dt.web.mjs`\u3001`dt.web.d.mts` \u653e\u5165\u9879\u76ee libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n 2. \u5728 src\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\n ```TypeScript\n import { DataTower } from '..\/libs\/dt.web.mjs';\n ```\n- **JavaScript CommonJS \u9879\u76ee**\n 1. \u5c06\u538b\u7f29\u5305\u4e2d\u7684 `dt.web.cjs`\u3001`dt.web.d.cts` \u653e\u5165\u9879\u76ee libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n 2. \u5728 src\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u4e2d\u5bfc\u51fa\u4f7f\u7528\n ```JavaScript\n const { DataTower } = require('..\/libs\/dt.web.cjs')\n ```\n- **JavaScript UMD \u9879\u76ee**\n 1. \u5c06\u538b\u7f29\u5305\u4e2d\u7684 `dt.web.js` \u653e\u5165\u9879\u76ee libs \u76ee\u5f55\u4e0b\uff0c\u5982\u679c libs \u4e0d\u5b58\u5728\uff0c\u65b0\u5efa libs \u76ee\u5f55\n 2. \u5728 `index.html` \u6587\u4ef6\u4e2d\u5f15\u5165\n ```html\n

客户端