在使用增长分析进行数据分析前，您需要先明确数据需求并规划数据接入方案，研发工程师根据数据接入方案完成数据接入落地。增长营销套件SDK是一款自研的埋点采集工具，用于基础数据收集与增长营销分析。本文为您介绍增长分析的数据接入能力和通用接入流程。

• SDK名称：增长营销套件SDK。

• SDK最新版本号：当前SDK版本在不断迭代发布中，您可前往Git开源页面查看各端的最新SDK版本及历史版本情况，推荐使用最新版本SDK。

  系统	SDK最新版本	包名	MD5
  Android	6.17.1	com.bytedance.bdtracker	810d4cc4c1a552a61a2ec20bbc88616b
  iOS	6.17.3	RangersAppLog	b367364fbb14e1c22baeeb54de65f026
  HarmonyOS	1.3.1	@volcengine/applog	f373d14a1a1c72fbedead2a5953227b3

• SDK发布日志：详情请参见SDK更新日志。

• SDK开发者：北京火山引擎科技有限公司。

• 主要功能：增长营销套件SDK支持采集基础数据，用于对应用的新增、激活、留存、性能等统计性指标进行分析。

• SDK隐私政策：【增长营销套件SDK】隐私政策
• 开发者使用合规规范：【增长营销套件SDK】开发者使用合规规范

在进行数据接入前，您需先大致了解Finder进行数据采集前后，采集数据的类型、数据流向。

其中：

• 行为数据：即根据分析业务目标制定的数据采集方案，在对应位置进行埋点，当用户触发关键事件时，就会将事件埋点上报给后台。
• 用户数据：采集的用于唯一标识用户的用户ID相关数据，以及业务后期分析所需的用户特征相关数据。
• 设备数据：采集的用于唯一标识设备的ID数据，以及业务后期分析所需的设备特征相关数据。

在任何一个数据采集分析项目的启动中，我们需要有完善的流程把控，保障符合预期的上线。其中研发工程师需要关注的流程为数据采集：采集方案制定与采集方案实施部分。

• 采集方案制定的指导详情请参见：如何设计埋点采集方案。
• 采集方案实施时：通常有以下通用流程与注意事项。

1. 准备工作。
   1. 确认管理员已完成创建集团、接入增长分析应用等操作，详情请参见 快速入门：管理员（SaaS-云原生版）。
   2. 登录DataFinder控制台，获取后续数据接入所需的应用ID等信息。
      • SaaS-非云原生：
        
        
      • SaaS-云原生：
        
2. 了解接入注意事项。
   • 根据数据接入方案，明确后续需要采集上报的事件及其属性，了解预置事件及属性列表是否满足业务需求，预置事件及属性详情请参见 预置属性总表。
   • 如果需要自定义事件则需要了解对应事件及其属性对应的数据格式要求，详情请参见 支持的数据格式与事件/属性分类。

     注意

     如果数据格式不符合规范，可能会导致数据接入操作正常，但后续上报的数据落库后为空或出现异常，因此您需要关注数据格式要求，例如将数值类型的属性，数据类型定义为string，可能后续数据上报候后，进行分析时会出错。

   • 根据数据接入方案，了解数据接入时支持的用户标识类型，统一统计口径，详情请参见 支持的用户唯一标识。

客户端和服务端不同端的SDK集成详情请参见对应的文档。通常需要引入SDK、初始化SDK、调用SDK、验证埋点数据这几个步骤。

DataFinder为您提供了实时埋点检测功能，您在首次进行数据接入操作时，可通过实时埋点检测来测试上报数据，验证数据上报结果。通常在建议等待10～15分钟再进行数据上报结果验证，尤其是首次上报的事件/属性结果验证。

• 首次接入埋点数据时，可参考 实时埋点检测文档 。进行接入验证。
• 您也可以直接在应用中模拟操作进行数据上报，进而验证上报结果，此时建议通过以下两个大的方向进行检验与验证：
  • 模拟上报前，根据各个应用端的接入SDK的配置要点，再次检查接入SDK的代码配置是否有误，检查要点可参见通用埋点验证操作指引文档中1.集成验证章节。
  • 接入SDK代码配置无误后，您可10～15分钟后，在DataFinder的元数据管理、用户细查、分析工具模块中验证数据上报结果，检查要点可参见通用埋点验证操作指引文档中2.系统数据验证章节。

    注意

    SaaS-非云原生环境中，对于自定义事件和属性，自该事件/属性首次被触发入库，至首次触发后的10分钟内，期间该事件/属性的上报均有可能会延缓入库，导致无法及时查询到上报的结果。此类场景下：

    • 如果有延缓入库的情况，在当天无法在元数据管理、分析工具等功能模块中查询使用对应事件/属性，第二天数据即可正常入库，可正常查询使用。
    • 建议在验证自定义事件/属性上报结果前，先在元数据管理中录入对应的自定义事件/属性，将其先完成入库，则后续事件/属性被触发上报数据时，不会有延缓入库的情况。在元数据管理中录入的操作详情请参见一般事件、用户属性、事件属性。

一些特殊场景的埋点验证，例如APP内嵌H5场景，可参见3.特殊场景验证。

数据上报策略

数据缓存策略