DataFinder支持对接采集三方平台的数据，将采集到的数据落库至DataFinder后即可在DataFinder上进行数据分析。本文为您介绍如何采集singular的数据。

在接入singular数据前，您需要在应用APP中集成singular SDK（用于生成广告归因数据）、DataFinder SDK（用于上报用户埋点数据），然后参考本文在DataFinder中配置singular数据接入的数据范围、数据接入落库的映射规则等，并生成一个数据上报API，后续singular可通过此API将数据上报落库至DataFinder。

当前仅SaaS-云原生环境支持接入singular数据。如果您不确定当前的环境是否是SaaS-云原生环境，可参考文档进行确认：SaaS-非云原生/SaaS-云原生 & 私有化环境。

1. 您需要先在应用中集成singular SDK和DataFinder SDK。DataFinder SDK的集成操作指导请参见Finder数据接入概述。

   注意

   非常建议您在应用中集成SDK时，先初始化DataFinder SDK，并在 Singular SDK 初始化时将 DataFinder SDK 的匿名 ID 设置为 Singular 的自定义用户 ID，便于在匿名用户场景下，将singular的用户标识数据和DataFinder的用户标识数据打通。

2. 配置singular数据接入前，您需先规划好需要上报落库至DataFinder的数据有哪些，包括需要上报的事件列表、事件属性列表、用户属性列表。并根据规划，将事件、事件属性、用户属性录入DataFinder的元数据管理中，录入操作请参见一般事件、事件属性、用户属性。

   注意

   • 添加录入事件列表时，事件名称（非展示名）需与singular中的事件数据字段名完全一致，后续通过事件的英文名匹配需要上报落库的事件。
   • 录入事件属性、用户属性时，需关注属性的数据类型，尽量保持属性的数据类型与singler中实际属性字段的数据类型一致，当前支持落库的数据格式请参见支持的数据格式与事件/属性分类。

您需要在DataFinder控制台配置singular数据接入的规则，例如需要上报至DataFinder的数据范围、数据落库的映射规则等，完成配置后会生成一个数据上报的API，用于后续singular上报数据。

1. 登录并进入DataFinder控制台后，单击顶部导航栏数据管理>数据集成>数据接入，在外部数据源页签中，找到三方平台singular数据源并单击后方的接入。
   

2. 在弹出来的接入配置页面中配置singular的接入配置参数。

   1. 配置基本信息。
      

      参数

      配置说明

      用户识别字段

      将singular中的用户标识ID字段配置在此处，后续DataFinder将此字段的数据映射落库为DataFinder的用户标识ID字段。 当前DataFinder的用户标识字段主要为两大类： Web_ID/Device_ID：设备标识字段，通常用于标识匿名用户。当同时有Web_id和Device_id时，优先使用Device_id。 注意 如果添加了Web_ID/Device_ID用于标识匿名用户，非常建议您在应用中集成SDK时，先初始化DataFinder SDK，并在 Singular SDK 初始化时将 DataFinder SDK 的匿名 ID 设置为 Singular 的自定义用户 ID。 UID：用户标识字段，通常用于标识实名用户。 您可以根据当前singular中的实际标识字段情况，添加对应的用户识别字段。 后续DataFinder会依据采集到的用户标识字段，生成用户唯一标识ssid，mapping逻辑详情请参见用户标识（uid、ssid、did）。

   2. 配置事件入库规则。配置singular中需要采集上报的事件、事件属性详情，并设置上报的数据是否要落库至DataFinder。
      

      参数	配置说明
      回传数据设置	配置后续singular上报数据时是否需要将事件及事件属性数据上报落库至DataFinder。 写入事件表：表明后续singular需要将事件和事件属性上报落库至DataFinder。选择后，下方需进一步配置需要上报落库的事件列表、事件属性映射规则。 仅处理用户属性：表明后续singular不需要将事件和事件属性上报落库至DataFinder。选择后，下方需进一步配置事件列表，此处的配置的事件列表仅用于后续关联需要上报的用户属性数据，事件本身不会上报落库至DataFinder。
      目标写入事件	选择需要上报落库/关联用户属性的事件列表。 注意 此处选择的事件名称，需与singular中的事件数据字段名完全一致，如果下拉列表中没有对应事件，您需前往数据管理>元数据管理>一般事件页面先创建录入对应的事件。
      事件入库规则	如果上述参数中您选择了需要将事件、事件属性上报落库至DataFinder，您还需配置singular中事件属性字段与DataFinder中事件属性字段的映射关系。 您可以单击添加事件属性，配置映射规则。 在Singular 属性名称列输入Singular中需要上报落库的事件属性字段名称。 在Finder 事件属性名称列的下拉列表中选择与之映射的事件属性名称。 注意 如果下拉列表中没有对应的DataFinder事件属性，您需前往数据管理>元数据管理>事件属性页面先创建录入对应的事件属性。 此处配置的事件属性，后续实际上报时会作为已选所有目标写入事件的事件属性，即，所有目标写入事件均会关联此处所有的事件属性。

   3. 配置用户属性入库规则。
      

      参数	配置说明
      属性关联设置	选择上报落库至DataFinder的用户属性关联至哪些事件，后续实际上报数据时，基于此处的配置结果，通过事件来匹配需要上报落库的用户属性数据。 所有事件：表明将需要上报落库的用户属性关联至上述 事件入库规则 配置步骤中已添加的所有目标写入事件， 指定事件：表明将需要上报落库的用户属性关联至部分目标写入事件，您需要在下方配置具体的来源事件。 无事件：表明无需上报落库用户属性数据。
      来源事件	（可选）上方参数选择指定事件时需配置，您可在下拉列表中选择需要将用户属性关联至哪些上报的事件中。
      用户属性入库规则	您可以单击添加用户属性，配置映射规则。 在Singular 属性名称列输入Singular中需要上报落库的用户属性字段名称。 在Finder 用户属性名称列的下拉列表中选择与之映射的用户属性名称。 注意 如果下拉列表中没有对应的DataFinder用户属性，您需前往数据管理>元数据管理>用户属性页面先创建录入对应的用户属性。 此处配置的用户属性，后续实际上报时会基于关联的写入事件的进行匹配上报，未关联至写入事件的用户属性不会上报。 入库写入支持只写一次、覆写更新、数值累加三种。 只写一次：即usersetonce，适用于记录首次用户特征信息，记录一次后续不再更新；比如首次访问时间。 覆写更新：即usersetup，每次均会使用最新的用户属性数据覆盖此前的用户属性数据。 数值累加：即usersetadd，通常用于设置需要累加的数值类型的用户属性，例如，用户充值金额相关属性，最初充值金额是20，用户之后又充值了30 ；累计后最终记录用户的充值金额为50。

3. 完成配置后，单击保存，界面会提示您设置成功，并提供数据上报的API地址，您可单击确定并复制地址，将API地址保存至本地，用于后续Singular的回传设置。
   
   您后续也可以在Singular数据接入配置页面的顶部获取对应的API地址。

获取API地址后，您后续需前往Singular后台的Internal BI Postbacks 的配置页面，将API地址配置为Singular的回传地址。