AWS Marketplace
针对 AWS Marketplace 提供商的用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

数据源

数据源每天收集 CSV 格式的文件,并将其传送到您提供的加密 Amazon S3 存储桶。数据源包含有关您的客户的详细信息,以及每个条目的唯一标识符。唯一标识符的名称是 address_id,它与销售报酬报告中的 Payer Address ID (付款人地址 ID) 列相同。您可以使用该字段将报告中的详细信息映射到数据源中提供的详细客户信息。

重要

要使用数据源中的信息,必须遵守AWS Marketplace 增强数据共享计划中的参与条款和条件。

要接收数据源信息,您必须:

或者,您也可以为 Amazon SNS 主题提供 ARN。通过提供该 ARN,您可以在我们将新文件传送到 S3 存储桶时收到通知。

配置您的环境

要配置您的环境,我们建议您使用该 AWS CloudFormation 模板。该模板设置接收数据源所需的 AWS 资源。具体来说,该模板有助于在您的 AWS 账户 ID 中设置加密的 S3 存储桶、AWS KMS 密钥和可选的 SNS 主题。您可以将这些服务的 ARN 添加到数据源功能的数据源配置页面中。要配置数据源功能,请从设置客户数据存储中输入资源 ARN,然后选择提交。如果选择使用现有的资源,您必须创建一个 IAM 角色以授予 AWS Marketplace 服务的访问权限。

数据字段

具有几个数据源列。address_id 列列出与销售报酬报告中的 Payer Address ID (付款人地址 ID) 列相同的信息。该字段中的数据对在交易时查找客户地址至关重要。

将每天传送数据源,其中包含为客户收集的所有信息。每次进行新交易时,都会扫描交易的客户地址;如果在数据源中不包含该地址,则会在数据源文件中添加新条目。下表说明了数据源列的名称和说明。

列名称 描述
address_id 地址的唯一键。
aws_account_id 该地址的账号。
email_domain 为该账户登记的电子邮件地址域。
company_name 为该账户登记的公司名称。
country 为该地址登记的 ISO 3166 alpha-2 国家/地区代码。
state_or_region 为该地址登记的州/省或地区。
city 为该地址登记的城市。
postal_code 为该地址登记的邮政编码。
address_line_1 为该地址登记的地址第一行。
address_line_2 为该地址登记的地址第二行。
address_line_3 为该地址登记的地址第三行。
valid_from 地址的有效起始日期。
valid_to 该列始终为空。
insert_date 地址变得可见的日期。
update_date 上次更新地址的日期。它通常与 insert_date 列中的日期相同。但在某些情况下,客户可能会更改与其账户关联的地址。
delete_date 该列始终为空。

地址信息是不可变的,因此 valid_to 和 delete_date 列始终为空。

示例数据

地址数据源是符合 4180 标准的 .csv 文件,并传送到您提供 ARN 的加密 S3 存储桶。该文件具有以下特性:

  • 其格式设置为未进行 BOM 编码的 UTF-8 文件

  • 它将逗号作为分隔符

  • 字段由双引号进行转义

  • 换行符是 \n

  • 日期采用 ISO 8601 日期和时间格式

可以将以下三个表视为一个连续表。第一行包含 .csv 文件中的标头。其余三行包含地址的示例信息。请参阅 AWS Marketplace - Seller Reporting Examples.zip 中的示例文件 PII_Addresse.csv。

address_id aws_account_id email_domain company_name country state_or_region city postal_code
fs4rwaassf332df 111122223333 example.org Example Corp. US GA Anytown 3XXXX
dskd933mks32ds 777788889999 example.net Example Corp. US WA Anytown 9XXXX
dsdghhf93993sds 123456789012 example.com Example Corp. US FL Anytown 3XXXX
address_line_1 address_line_2 address_line_3
123 Any Street unit 100
100 Main Street
123 Any Street
valid_from valid_to insert_date update_date delete_date
2018-12-12T02:32:00Z 2019-03-29T02:00:00Z 2019-03-29T02:00:00Z
2018-12-20T02:32:00Z 2019-03-29T02:00:00Z 2019-03-29T02:00:00Z
2019-01-12T02:32:00Z 2019-03-28T03:00:00Z 2019-03-28T03:00:00Z

最后五列记录数据的历史记录。数据源中的地址是不可变的,因此,您无需处理这些字段中的信息。它们作为通用历史记录架构包含在内,并随所有将来的数据源一起提供。