数据必须满足以下要求：

• 日期 （仅）: yyyy-mm-dd（例如，2023-04-18）
• 日期与时间：
  • 格式： yyyy-MMM-dd hh:mm:ss （例如，2023-APR-18 15:30:35）
  • 时区：UTC
• 数值：小数点后最多 2 位
• 字符串长度：最多 256 个字符
• 字符限制：
  • 字段名称（列标题）：不可使用空格或特殊字符
  • 所有其他数据：无限制（所有字符均有效）

除了用于处理的数据之外，BigQuery 或 Snowflake 中的数据源表还必须包含另外 2 列：一列日期，一列版本：

• 日期：
  • 列标题：dt
  • 列类型：date
  • 数据格式：yyyy-mm-dd（例如，2023-04-18）
  • 其他说明：BigQuery 表必须按此列分区
• 版本：
  • 列标题：v
  • 列类型：字符串
  • 数据格式：数字（例如，1、2、3、10）
  • 重要提示！每次 DCR 检测到此列中出现新值时，都会触发生成新版本的报告。为了确保报告的完整性，请务必在该列的值发生变化时向表格中填充完整的一组数据。

存储在 Amazon S3 或 GCS 中的数据源文件必须符合以下文件名称和格式要求：

• 文件名称必须符合 DCR 命名要求
• CSV 或 GZIP 格式
  • GZIP 压缩文件中的文件必须为 CSV 格式。
• 每个数据文件夹中的数据源文件数量：
  • CSV：最多 1 个
  • GZIP：最多 1 个不分卷的压缩文件。如需支持多部分 GZIP 文件，必须按照以下方式命名：filename_part01.csv.gz、filename_part02.csv.gz 等。

1. 在 AppsFlyer 中，从侧边菜单选择 协作 > 数据净室。
    

   

2. 点击+ 新数据源 （在主界面或在数据源标签页中）。
    

   

3. 继续完成 新数据源 的操作步骤：

输入数据源名称。该名称可以是任意唯一名称，帮助您识别该数据源。您还可以选择添加关于该数据源的说明，帮助您轻松识别其中包含的内容（例如「2025 年的所有购买数据」）。

要求和指南

• 请确保该数据源名称在您账户中的所有数据源里是唯一的。否则，您将无法保存该数据源。
• 云服务对接的名称无需与文件名称一致。
• 数据源名称要求：
  • 长度：2-80 个字符
  • 有效字符：
    • 字母（A-Z、a-z）
    • 数字（0-9），不能作为名称的首字符；
    • 下划线 "_"
  • 无效字符：
    • 空格
    • 所有其他符号和特殊字符

请按以下方式指定数据源位置：

1. 选择即将创建（或已创建）数据源的连接。
   • 如果您的账户中没有定义任何连接，系统将弹出新建连接的对话框，提示您创建一个连接。请按照 说明进行创建。
   • 如果您已有连接，但希望使用新的连接，请点击 + 新建连接 并按照  说明进行创建。
2. 根据您的数据源所在的位置，继续按下方说明进行操作。

注意：当数据量较大时，为获得最佳性能，您的部分数据可能会被单独存储。当数据源更新时，此数据也会更新；当删除数据源时，此数据也会被删除。

BigQuery 数据源位置

设置 BigQuery 的数据源位置：

1. 选择源数据表所在的数据集。
2. 选择源数据所在的数据表。

您进行这些选择时，所用的列表分别包含您在创建连接时指定的 BigQuery 项目中的可用数据集和表。

Snowflake 数据源位置

设置 Snowflake 的数据源位置：

1. 选择包含源数据的共享（share）。
2. 选择源表所在的架构（schema）。
3. 选择源数据所在的数据表。

您进行这些选择时，所用的列表分别包含您在创建连接时指定的 Snowflake 账户中的共享（share）、架构（schema）和表。

云存储桶的数据源位置

Amazon S3 或 GCS 的数据源位置由两部分组成：连接所指定的云存储桶，以及其下的文件夹路径——每次数据源更新时，DCR 都会从该路径读取源文件。 

指定连接后，AppsFlyer 可在创建数据源的过程中，自动生成所需的底层文件夹路径。

• 允许 AppsFlyer 生成文件夹，这是最简单的操作。不过，您也可以选择根据此处的说明改为手动创建。

如果由 AppsFlyer 生成这些文件夹，您唯一还需要额外提供的信息，是您希望为数据源文件夹指定的名称。（这是顶层文件夹。您还可以指定是否要将数据源文件夹创建在某个父文件夹之下– 该父文件夹通常命名为 input。

设置云端存储桶中的数据源位置时，请输入数据源文件夹的名称。

• 默认情况下，显示的数据源文件夹名称：
  • 是基于您指定的数据源名称。您可以根据需求更改文件夹名称，但必须符合DCR 命名要求。
  • 表示它将在名为 input. 的父文件夹中生成。该文件夹是您上传到 DCR 的所有数据源的父文件夹。
    • input 文件夹不是必需的，您可以将其移除或改为其他名称，但必须符合DCR 命名要求。
    • 虽然该文件夹不是必需的，但设置 input 文件夹（或其他名称的等效文件夹）仍属于最佳实践。尤其是在您使用同一个云端存储桶同时上传数据文件（input）和接收报告（output）时，更建议这样做。

本地文件的数据源位置 

您也可以使用本地文件上传源数据。不过，强烈建议您将云服务设置为数据源位置（这对较大的数据集和自动更新尤为重要）。本地文件主要用于测试以及熟悉平台功能。 

使用本地文件上传源数据： 

1. 数据源文件夹设置 

在 Data Collaboration Platform（DCP）中设置数据源时，您必须选择希望如何处理该数据源的更新。 DCP 支持两种同步方法：Snapshot 和 Append。每种方法都适用于不同的使用场景和数据流：

• Snapshot - 此方法会在每次更新数据源时上传完整数据集，并以新数据集完全替换旧数据集。仅当您每次上传的文件始终包含完整且最新的数据集时，才选择此方法。
• Append - 此方法仅上传新增或已更改的数据，而不是完整数据集。旧数据集不会被删除或更新。此方法非常适合每日或每周报告等定期上传的场景。其优势包括上传量更小（可能降低云存储成本）、数据上传更快、更便于记录管理等。

Snapshot 上传要求

如果您要在每次更新数据源时上传一个完整且独立的文件，并完全替换之前的数据集，请使用此方法。

支持的云服务

• Amazon S3
• Google Cloud Storage（GCS）
• BigQuery
• Snowflake

Snapshot 更新方法请遵循以下指南：

1. 数据源文件夹路径

   在 DCP 中注册云存储数据源时，系统会为该数据源定义一个根路径（例如 input/my_source_folder/）。每次刷新数据集时，您都会将完整快照——包含所有当前行的文件——上传到此文件夹。这可确保 DCP 始终处理最新且最完整的数据。

2. 上传完整快照文件

/v=1/data/

/v=1/

文件夹结构：

s3://af-dcr-xyz/abcd9876/input/source_name1/dt=2025-mm-dd/v=1/data/
└ 存储桶 ┘ └ 租户 ┘ └采集区┘ └数据源┘└快照日期┘└版本┘└文件┘

两天的快照结构示例：

source_name1/
  dt=2025-08-10/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS
  dt=2025-08-11/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS

上传 2 天的数据源文件完整快照后（并以程序化方式创建日期/版本/data 文件夹及 _SUCCESS 文件），您的存储桶/文件夹结构可能如下所示：
 

Append 上传要求

当仅需要上传变化或新增数据时，可使用该方法。

为什么使用 Append？

• 效率：上传量更小
• 数据完整性：保留完整的变更历史，便于进行时间序列分析
• 隐私合规 – 简化记录删除 & 同意管理

支持的云服务：AWS S3 和 Google Cloud Storage (GCS)
注意：BigQuery 和 Snowflake 不支持 Append 方法，必须使用 Snapshot 方法。

请遵循以下 Append 更新方法指南：

1. 点击生成文件夹链接。

2. 上传追加（增量）文件 

文件夹结构：

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/\n└ bucket ┘ └ tenant ┘ └ ingestion ┘ └ source ┘ └ day partition ┘

每周增量文件夹结构示例：

source_name/
  dt=2025-08-04/
  dt=2025-08-05/
  dt=2025-08-06/
  dt=2025-08-07/
  dt=2025-08-08/
  dt=2025-08-09/
  dt=2025-08-10/

经验之谈：

关键结论：即使按周上传，也始终要按天将数据放到特定的 dt=YYYY‑MM‑DD 文件夹中。

将数据源字段映射到 DCP 字段、进行测试并保存已配置的数据：

1. 加载数据源字段
2. 配置数据源字段
3. 验证是否包含欧盟用户
4. 测试源数据
5. 保存数据源

1. 加载您的数据源字段

数据源字段会自动加载。如果需要手动加载，请根据数据源位置按照以下说明操作：

数据仓库中的数据源

如需加载位于数据仓库（BigQuery 或 Snowflake）中的数据源字段，请点击 从数据源加载字段。

云端存储桶中的数据源

如需加载位于云端存储桶（Amazon S3 或 GCS）中的数据源字段，您必须上传一个数据源文件样本。

如需将数据源字段映射到 DCP 字段： 

• 您可以上传本地的数据源文件样本。
  • 如果您选择此选项，AppsFlyer 将始终自动创建数据源文件夹路径。

                                                                - 或 -

• 您可以直接从已连接的云存储桶上传数据源文件样本。
  • 如果您选择此选项，还需要做出另外一项选择：
    • 允许 AppsFlyer 自动为数据源文件生成云文件夹；或
    • 手动为数据源文件创建云文件夹

如需上传您的样本数据源文件，请按照下方相应标签页中的说明操作：

2. 配置数据源字段

加载数据源字段后，每个数据源字段（列）都会显示一个 DCP 字段与之对应。检查每个数据源字段，并从旁边的下拉列表中将其映射到相应的 DCP 字段。注意事项：

AI 辅助字段类型检测

DCP 可以基于列名，使用 AI 为每个数据源列建议一个 DCP 字段。

如需启用 AI 辅助检测：

1. 在 映射数据源字段部分中，找到以下横幅：“想快速获得字段映射帮助？启用 DCP AI 助手。」点击 启用 DCP AI 助手。
2. 字段加载完成后，点击 自动检测字段类型。 DCP 会评估每个列名，并为其建议一个 DCP 字段。
3. 保存前，请检查每一项建议。您可以直接接受建议，也可以像编辑其他字段一样手动更改映射。

每个字段都会处于以下某一种状态：

• 已映射：AI 找到了一个可信的唯一匹配项。请检查后接受，或手动更改。
• 无法映射：AI 无法确定字段。手动映射，或保留为未映射。

局限性

• 列数限制：AI 检测每个数据源最多支持 100 列。列数更多的数据源会显示“超出限制”信息。
• #configure-the-source-fields

如需移除字段：

• 将鼠标悬停在要移除的字段右侧，然后点击悬停时显示的垃圾桶图标。

如需手动添加字段：

使用此选项，您可以在受众中加入数据源当前不存在的字段。

1. 点击 + New field。系统会添加一个空字段。
2. 输入字段名称并选择其类型。
    

字段类型包括： 

• 标识符
  • Android ID
  • AppsFlyer ID
  • CUID
  • 邮件
  • 加密 email
  • 加密 email（无点号）
  • IDFA
  • IP 地址
  • ID5 ID
  • MediaMath Id
  • 移动广告 Id
  • 电话号码
  • 哈希处理后的电话号码（不含加号）
  • 平台 ID
  • SHA256 哈希处理的 ID
  • SHA256 电话号码
  • ZIP+5 邮编
  • ZIP+4 邮编
  • LUID
  • 个人 ID
• 标识符列表
  • 加密后的 email（不含点号）
  • 加密后的电话号码（不含加号）
  • 加密后的 email
  • 加密后的电话号码
  • 电子邮件
  • 电话
  • ID5 ID
  • MediaMath Id
  • 移动广告 Id
  • IDFA
  • Android ID
  • IP 地址列表
• 布尔值
• 日期和时间
  • 日期时间
  • 日期
• DMA
  • 已启用广告个性化
  • 已启用广告用户数据
  • 适用欧盟 DMA
• 数值
  • 双精度浮点数
  • 数值列表
  • 长整型
  • 数值
• 文本
  • 文本
  • App ID
  • 文本列表

标识符与标识符列表：

标识符类型每行仅包含一个值（例如，每行一个 email 或一个 CUID）。标识符列表类型每行包含一个值数组（例如，单行可包含多个哈希处理后的 email 或设备 ID）——当某个数据源需要针对每条记录中的多个标识符进行匹配时，请使用此类型。

重新加载数据源字段

如果您的某个数据文件配置已发生变化，您可以更新数据源文件以反映这些更改。

如需从文件重新加载已更新的字段：

1. 点击重新加载字段。
2. 选择文件位置。
   • 对于本地文件：上传文件。
   • 对于来自您的云服务的文件：点击从云存储桶加载，然后按照说明操作。
3. 点击 OK。现在将显示更新后的文件。 

3. 验证是否包含欧盟用户

• 对于以下问题，选择是 或 否：您的数据源是否包含受欧盟 DMA 法规约束的欧洲用户？

详细了解欧盟《数字市场法案》相关的隐私法规。

4. 测试源数据

• 【可选】点击测试，检查数据源字段的格式或有效性是否存在错误。

5. 保存数据源

• 点击保存，保存该数据源。

确认后，新数据源会添加到数据源标签页下。

1. 前往数据净室的数据源选项卡。
2. 在数据源列表中，将鼠标悬停在您要编辑的数据源上，然后点击该行末尾的编辑图标 。
3. 在编辑数据源页面中，按如下所述编辑相关字段。
4. 点击保存。

编辑数据源名称

编辑数据源名称时，请确保遵循这些命名要求。

 编辑数据源位置

1. 在编辑数据源页面 > 数据源位置中，选择其他数据连接。
2. 选择相关的位置详细信息。
3. [可选] 测试数据源。
4. 点击保存。

编辑字段映射

1. 前往字段映射并进行必要的更改：更改字段，或更新其映射的 DCP 字段。
2. 点击保存。

除非某个数据源正在受众中使用，否则您可以删除任何数据源。如果属于这种情况，系统会通过通知说明哪些受众正在使用该数据源。如需删除该数据源，您必须先删除与其关联的受众。至于与您共享的数据源，则只能由数据源所有者删除。

1. 前往数据净室的数据源选项卡。
2. 在数据源列表中，将鼠标悬停在要删除的数据源所在行上。
3. 点击该行右侧显示的删除图标 。
4. 在对话框中，点击 Delete 以确认。

一般情况下，最简便的方法是让 AppsFlyer 在创建数据源过程中自动生成所需的文件夹结构。不过，如果您希望手动创建这些文件夹，可以按以下说明操作。

创建 DCR 密钥文件夹

为确保最高安全性，存储桶正下方的文件夹（即“DCR 密钥文件夹”）必须使用分配给您账户的 8 位字母数字 DCR 密钥 命名（例如 01bcc5fb）。请注意，这与您的 AppsFlyer 账户关联的任何其他密码或密钥不同。

DCR 密钥文件夹通常需要通过您所选云服务的界面手动创建。

获取您账户的 DCR 密钥：

• 点击右上角的 3 点（操作）菜单，然后选择 DCR key。

创建 DCR 密钥文件夹后，您的存储桶/文件夹结构大致如下：

顶层输入文件夹

虽然这不是必需项，但最佳实践是直接在 DCR 密钥文件夹下创建一个顶层输入文件夹。此文件夹专用于您上传到 DCR 的文件。

顶层输入文件夹通常需要通过您所选云服务的界面手动创建。

• 如果您使用同一个存储桶既上传数据文件（输入）又接收报告（输出），则更推荐采用这种做法。
• 您可以用任意名称为该文件夹命名，只要符合 DCR 命名要求即可。为了便于识别，通常会将其命名为 input/。

创建顶层输入文件夹后，您的存储桶/文件夹结构可能如下所示：

各数据源的第二层级文件夹

您可以定期将不同数据源的文件上传到 DCR 进行处理。必须为每个数据源分配一个单独的文件夹（「数据源文件夹」）。

例如，如果您计划每天向 DCR 上传 2 个文件进行处理： BI-data.csv 和 CRM-data.gzip，则需要为这些数据源分别分配一个文件夹。您可以将这些文件夹命名为 BI-data/ 和 CRM-data/。

数据源文件夹通常需要通过您所选云服务的界面手动创建。

创建这 2 个数据源文件夹后，您的存储桶/文件夹结构可能如下：

每次数据源更新时，都必须在各个数据源文件夹下创建按日期和版本划分的嵌套子文件夹。

作为 Google 执行《数字市场法案》（DMA）的一部分，Google 已于 2024 年 3 月 6 日更新其欧盟用户同意政策。作为 Google 的应用归因合作伙伴，AppsFlyer 已做出必要调整，以支持其政策要求，同时确保广告主能够充分发挥 Google Ads 营销渠道的价值。 

添加同意字段

在设置用于在 Google 上进行受众激活的数据源时，若您对问题“您的数据源是否涉及受欧盟 DMA 法规约束的欧洲用户？”选择是请确保下表中的附加同意字段已包含在源文件中。这样，AppsFlyer 就能在激活过程中将必要信息传输给 Google。

附加同意字段及其响应值：

对受众规模的潜在影响

发送到 Google 的实际和预估受众规模可能会因同意或拒绝的用户数量而有所不同。