自定义来源的数据必须符合以下要求：

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

除了用于匹配的数据以外，BigQuery或Snowflake中的表格还必须包含2各额外的栏位，一个用于说明日期，另一个用于说明版本：

• Date:
  • 列标题
  • 数据类型：日期
  • 数据格式：yyyy-mm-dd（如2023-04-182023-04-182023-04-18）
  • 其他要求：其他注意事项：BigQuery中的表格必须按此列分区
• 版本：
  • 列标题
  • 数据类型：字符串
  • 数据格式：数字（如111、222、333、101010）
  • 重要提示！每次DCR检测到此列中出现新值时都会触发新版本报告的生成。为了确保报告的完整性，请务必在该列的值发生变化时向表格中填充完整的一组数据。

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

• 文件名称必须符合DCR的命名规则
• 必须为CSV或GZIP格式。
  • GZIP压缩文件中的文件必须为CSV格式。
• 每个数据文件夹下的数据源文件数量：
  • CSV最多1人
  • GZIPGZIP： 最多1个不分卷的压缩文件。多部分 GZIP 文件在命名如下时支持： filename_part01.csv.gz, filename_part02.csv.gz，等等。

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

   

2. 咔哒 + 新来源 （在主页或 资料来源 标签）。
    

   

3. 继续新来源攻略步骤：

输入源名称。这可以是任何独特的名称，帮助你识别来源。你也可以添加可选的来源描述，方便识别内容（例如，“2025年起的所有购买”）。

要求与指导方针

• 确保 来源名称 在你账户中的所有其他来源中独一无二。否则，你就无法保存源头。
• 对于云集成，名称不需要和文件名一致。
• 数据源名称要求：
  • 长度1000个字符以内，
  • 有效字符：
    • letters (A-Z, a-z)
    • 数字(0-9)（0-9）(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 生成文件夹，唯一需要额外信息就是你想给 源文件夹。（这是顶层文件夹，每次你想用它来运行新的报表版本时都会在里面更新源代码。）你也可以指定是否希望源文件夹在父文件夹下方创建 – 常被命名 输入。

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

• 默认情况下，数据源文件夹名称应符合以下条件：
  • 以您指定的数据源名称为基础。您可以根据需求更改文件夹名称，但必须符合DCR命名要求。
  • 通过文件夹名称可看出该文件夹位于input母文件夹下。“input”文件夹是所有DCR数据源的母文件夹。
    • input不是必须配置的文件夹，您可以将其移除或重新命名，但必须符合DCR命名要求。
    • 虽然不是必要配置，但仍建议您设置input文件夹（也可以以其他名称命名）。尤其是使用同一个云端存储桶上传（输入）和接收（输出）数据文件时，更需要设置该文件夹。

源位置作为本地文件 

你也可以用本地文件上传源数据。然而， 强烈建议将云服务设置为你的源节点 （对于更大数据集和自动更新至关重要）。本地文件主要用于测试和熟悉平台功能。 

要通过本地文件上传源数据： 

选择你的来源地点时，点击 本地文件系统 以及 下一个，这增加了从设备上传本地文件的选项。 

在数据协作平台（DCP）中设置源时，您必须选择希望如何处理该源的更新。DCP支持两种同步方式：快照 以及 附言.每种方法适合不同的用例和数据流：

• 快照 - 该方法每次源数据更新时上传完整数据集，完全替换旧数据集。只有当您上传的文件始终包含完整且最新的数据集时，才选择此方法。
• 附言 - 该方法只上传新的或更改的数据，而非完整的数据集。旧数据集不会被删除或更新。它非常适合定期上传，比如每日或每周报告。其优点包括上传更小（可能降低云存储成本）、更快的数据上传性能、更便捷的记录管理等。

快照上传要求

使用该方法上传一个完整的自包含文件，每次更新源数据时都会完全替换之前的数据集。

适配的云服务

• Amazon S3
• Google Cloud Storage
• BigQuery
• Snowflake

请遵循快照更新方法的以下指南：

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/
└ bucket ┘ └ tenant ┘ └ingestion┘ └source┘└snapshot date┘└ver┘└files┘

两天快照结构示例：

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

示例文件夹结构在上传完毕源文件的完整快照两天后（并程序化创建日期/版本/数据文件夹和_SUCCESS文件），你的桶/文件夹结构可能如下：
 

附加上传要求

使用此方法只上传自上次上传以来发生变化或新增的数据。

为什么要用Append？

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

适配的云服务AWS S3 和谷歌云存储（GCS）
注意：BigQuery 和 Snowflake 不被支持，也不能使用附加方法，必须使用快照方法。

请遵循以下附加更新方法的指南：

1.源文件夹设置

2. 上传附加（delta）文件 

文件夹解剖结构：

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

示例每周delta文件夹结构：

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字段。注意事项：

去除字段：

• 将鼠标悬停在你想移除的字段右侧，点击悬停时出现的垃圾桶图标。

手动添加字段：

这个选项允许你在受众中包含当前数据源中没有的字段。

1. 咔哒 + 新场地.新增一个空格。
2. 输入字段名称并选择其类型。
    

场地类型包括： 

• 标识符
  • Android ID
  • AppsFlyer ID
  • CUID
  • 电子邮件
  • {hashed_emails}
  • 哈希邮件（无点）
  • IDFA
  • IP地址
  • ID5 Id
  • MediaMath Id
  • 移动广告ID
  • 电话号码
  • 哈希电话（无Plus）
  • 平台ID
  • 须经过SHA256加密
  • SHA256电话号码
  • 邮编+5
  • 邮编+4
  • 路易德
  • 个人识别
• 标识符列表
  • 哈希邮件（无点）
  • 哈希电话（无加）
  • {hashed_emails}
  • 哈希电话
  • 电子邮件
  • 电话
  • ID5 Ids
  • MediaMath ID
  • 移动广告ID
  • IDFA
  • Android ID
  • IP地址
• 布林
• 日期与时间：
  • 日期时间
  • 日期
• DMA（指定市场区域）
  • Ad personalization enabled
  • Ad user data enabled
  • 适用欧盟DMA
• 数字
  • 双精度浮点数
  • 编号列表
  • 长
  • 数字
• 文本
  • 文本
  • App ID（应用ID）
  • 文本列表

标识符与识别码标识符列表：

标识符类型每行只包含一个值（例如，每行一封邮件或一个CUID）。标识符类型列表每行包含数组值（例如，一行可能包含多个哈希邮件或设备ID）——当源需要匹配多个记录标识符时，可以使用此数组。

重新加载源字段

如果你的数据文件配置发生了变化，你可以更新源文件以反映这些变化。

要从文件中重新加载已更新字段：

1. 咔哒 装填场.
2. 选择文件位置。
   • 对于本地文件：上传文件。
   • 对于来自你的云服务的文件：咔哒 从云桶加载 并按照说明操作。
3. 点击OK。更新后的文件现在已经显示出来了。 

3.验证欧盟用户的包含情况

• 精选 是的 或 不 回答问题：你的消息来源是否包括欧洲用户？哪些欧盟DMA法规适用？

了解更多关于《欧盟数字市场法案》隐私法规的信息。

4.测试源数据

• 【可选】点击，检查格式是否有误、数据源字段是否有效。

5.保存数据源

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

确认后，新源会被添加到 资料来源 Tab。

1. 进入数据净室中的数据源选项卡。
2. 在来源列表中，将鼠标悬停在你想编辑的来源上，点击编辑图标 在排尾。
3. 在 编辑来源 页面，编辑相关字段，详情如下。
4. 点击保存。

请按以下方式修改数据源名称：

编辑源名称时，务必 请遵循以下命名要求.

 请按以下方式修改数据源位置：

1. 来自 编辑来源 第>页 源头位置选择不同的数据连接。
2. 选择相关的地点详情。
3. [可选] 检测源头.
4. 点击保存。

编辑场映射

1. 进入现场映射，进行必要的修改：更改字段或更新其映射的DCP字段。
2. 点击保存。

你可以删除任何来源，除非是在受众中使用的。如果是这样，通知会指定使用该源的受众。要启用删除源，必须先删除与其关联的受众。至于与你分享的来源，只能由来源所有者删除。

1. 进入数据净室中的数据源选项卡。
2. 将鼠标悬停在数据源列表中您需要删除的那一行。
3. 点击删除图标 显示在行的右侧。
4. 在对话框中，点击 删除 确认一下。

一般情况下，最简便的方法是让AppsFlyer自动生成必要的文件夹结构，从而完成数据源创建流程。但如果您想要手动创建这些文件夹，可以按下问说明进行操作。

创建一个DCR密钥文件夹

为了提升安全性，存储桶下的直属文件夹（即“DCR密钥文件夹”）的名称必须以您账户下的8字符（字母加数字）DCR密钥来命名（如01bcc5fb01bcc5fb01bcc5fb）。请注意，这是DCR专属密钥，独立于您AppsFlyer账户下的任何其他密码或密钥。

DCR密钥文件夹一般需要通过云服务平台的界面手动创建。

要获取你账户的DCR密钥：

• 点击右上角的三点（动作）菜单，选择 DCR密钥.

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

顶层输入型文件夹

创建顶层输入型文件夹时最好将其直接置于DCR密钥文件夹下一层。该文件夹专用于向DCR上传文件。

顶层输入型文件夹一般需要您在自己选用的云服务平台中手动创建。

• 如果您使用同一个存储桶上传（输入）和接收（输出）数据文件，则更需要完成上述设置。
• 您可以用任意的名称为该文件夹命名，但必须符合DCR命名要求。为了便于识别，建议在名称中使用input/。

创建顶层输入型文件夹后，您的存储桶/文件夹架构入下：

为各数据源设置第二层文件夹

您可以定期向DCR上传不同来源的数据文件。这时，您需要为每个数据源分配一个单独的文件夹（即“数据源文件夹”）。

举个例子，如果你计划每天上传两个文件到DCR进行处理：BI-data.csv 以及 CRM-data.gzip你会为这些数据源分配一个文件夹。你可以选择把这些文件夹称为“文件夹” BI-data/ 以及 CRM-data/.

数据源文件夹一般需要您在自己选用的云服务平台中手动创建。

上述2个数据源文件夹创建完毕后，您的存储桶/文件夹结构如下：

必须在每次数据源发生更新时在各个数据源文件夹下按日期和版本创建子文件夹。

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

添加同意字段

在Google上设置一个用于受众激活的来源并确认时 是的 回答问题 你的消息来源是否涉及受欧盟DMA法规约束的欧洲用户？ 确保下表中的额外同意字段包含在源文件中。这使得AppsFlyer能够在激活过程中将必要信息传输给谷歌。

额外的同意字段及其回复值：

对观众规模的潜在影响

实际和估计的受众规模可能会根据同意或拒绝用户的数量而有所不同。