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

产品支持连接

通过使用 AWS Marketplace 产品支持连接 (PSC) 功能,AWS Marketplace 客户可以在 AWS Marketplace 网站中提供联系人信息以从 AWS Marketplace 卖家获得和访问产品支持。AWS Marketplace 通过 API 与参与的卖家共享提供的数据以实现更好的支持体验。客户可以选择在购买启用了 PSC 的 AWS Marketplace 产品期间或之后添加联系人详细信息,卖家可以调用基于拉取的 API 以检索客户联系人数据以及相关的产品订阅详细信息。

您的员工可以使用 Customer Support Eligibility (客户支持资格) 工具访问有关客户订阅您的产品的近乎实时的信息,并提供快速的个性化服务。可以轻松开始使用 AWS Marketplace Management Portal:输入客户的 AWS 账户 ID 以从其账户中检索订阅和用量信息。

您还可以选择在 AWS Marketplace 产品支持连接 (PSC) 中注册您的产品。对于在 PSC 中注册的产品,AWS Marketplace 客户可以选择通过 AWS Marketplace 网站提供联系人信息 (包括姓名、组织、电子邮件地址和电话号码) 以获得和访问产品支持。如果您在 PSC 中注册,AWS Marketplace 将通过 API 与您共享提供的数据以帮助实现更无缝的支持体验。

我如何作为卖家从 AWS Marketplace 产品支持连接中获益?

通过参与 PSC,您可以更轻松地为在 AWS Marketplace 上订阅您的产品的客户提供支持。利用通过该计划提供的数据,您可以在支持部门或 CRM 系统中保留最新的客户联系人信息。如果某个 AWS Marketplace 客户通过 PSC 共享联系人信息,然后与您联系以请求支持,您可以快速访问并验证该客户的身份和产品订阅详细信息。

AWS Marketplace 产品支持连接从客户收集哪些信息?

我们收集名字和姓氏、职务、公司名称、电子邮件地址、电话号码、国家/地区以及邮政编码。提供联系人详细信息是可选的,但如果客户选择提供联系人详细信息,则组织、名字和姓氏、电子邮件以及电话号码是必填字段。参与卖家可以通过基于拉取的 API 获取所有提供的详细信息以及客户的 AWS 账号、产品 ID、产品代码和订阅开始日期。客户最多可以为每个产品订阅添加 5 个联系人的信息,他们以后还可以编辑或删除其联系人详细信息。

我会收到订阅我的产品的每个客户的联系人详细信息吗?

不必。对客户来说,输入和共享联系人信息是可选的,但我们建议客户至少为支持的产品共享一个联系人以获得更好的产品支持体验。

在购买过程的哪个阶段,客户有资格参与 PSC?

客户可以选择在订阅启用了 PSC 的产品期间或之后为 PSC 提供联系人详细信息。对于基于 AMI 的产品,选择年度或月度订阅选项的客户在订阅时对产品收取费用,选择小时订阅的客户在启动实例时收取费用。有关客户订阅产品意味着什么的更多信息,请访问 AWS Marketplace 帮助页面

我会收到有关客户的产品用量的数据吗?

不会;目前,PSC 仅收集联系人详细信息和订阅信息。在该计划中不收集用量数据。

卖家要求

我需要完成哪些工作才有资格参与 AWS Marketplace 产品支持连接?

要参与该计划,您必须遵循特定的政策:

  • 必须为您的软件发布商业支持的企业生产版本,并提供专用的支持电子邮件地址 (或等效的联系方式) 以供客户和 AWS 客户支持使用。

  • 对于在某个销售区域或指定的客户群进行的所有 AWS Marketplace 交易,您必须为销售团队提供补偿。必须将有关 AWS Marketplace 补偿的内容发送到您的全球现场销售团队,并且 AWS 必须收到该内容的副本。

  • 您的客户支持团队必须简要说明有关计划如何为 AWS Marketplace 客户提供支持的策略,并且应为 AWS Marketplace 提供您的策略的副本。必须为您的客户支持团队提供该指导,以便 AWS Marketplace 与您的客户支持团队进行合作。

  • 应在一个工作日内将通过 API 向您提供的任何客户信息添加到您的系统中。此外,客户还必须能够随时退出该计划。通过 PSC API 提供的数据将指示客户何时删除了联系人详细信息并希望从该计划中删除。

如果您对这些程序要求有任何问题,请联系 AWS Marketplace 卖家运营团队。

我需要完成哪些步骤才能参与产品支持连接?

您必须完成以下步骤才能参与该计划:

  1. 通过使用提供的静态测试数据集,与 PSC API 集成,以便在不超过一个工作日内将通过 API 提供的数据添加到您的后端 CRM 或支持系统中。有关更多详细信息,请参阅下面的“与卖家 API 集成”和“处理客户数据”。

  2. AWS Marketplace 卖家运营团队提供要在该计划中注册的产品列表。这将确保在 PSC 中将您的产品标记为注册。有关更多详细信息,请参阅下面的“注册您的产品”。

  3. 与 AWS Marketplace 团队进行合作,以确保您的产品详细信息页面包含有效的支持电子邮件地址或等效的联系方式。

  4. 为 AWS Marketplace 客户提供您计划采用的支持流程说明(约一页),并向 AWS Marketplace 卖家运营团队提交您的说明。该说明应在几个段落中简要说明您计划的支持流程,除了通报您的内部支持团队以外,还应向 AWS Marketplace 提供该说明。本文档供 AWS Marketplace 内部使用,并帮助我们跟踪在 PSC 中注册的产品的客户体验。有关应在您的说明中提供的问题列表,请查看下文。

  5. 您可以选择自定义您的欢迎电子邮件 (客户在订阅您的产品后收到该邮件) 以描述您的 PSC 支持流程,或者为您的客户提供有关产品支持的更多信息。如果您希望自定义欢迎使用电子邮件内容,请联系 AWS Marketplace 卖家运营团队。

应在我的支持流程说明中包含哪些信息?

  • 将在 PSC 中注册哪些产品列表?

  • 您是否已制订并测试一种方法以从 API 中提取数据,并将其导入到您的支持系统中?

    • 如果是,请说明如何将该数据导入到您的支持系统中?

    • 如果没有,您希望何时实施该方法? 请说明您计划的方法。

  • 请向参与 PSC 的 AWS Marketplace 客户简要说明您的支持流程。

    • AWS Marketplace PSC 客户如何与您联系以获得这些产品的支持 (电子邮件、电话、其他方式)?

    • 如果 PSC 客户与您联系以请求支持,在他们收到回复之前通常需要多长时间?

    • 对于不同的 AWS Marketplace 产品,您是否提供不同的支持级别? 如果是,请说明您的支持级别及其涵盖的内容。

    • 根据您的支持策略,您计划向客户发送哪些内容? 如果您计划发送主动沟通信息,请说明您计划发送的内容。

    • 在客户在 AWS Marketplace 网站中输入数据后,在您的支持系统中显示该数据需要多长时间?

    • 如果客户退出 PSC,您删除其联系人数据的流程是什么?

    • 您是否具有一个网页以说明为 AWS Marketplace 客户提供的支持? 如果有,请提供该网页。

注册您的产品

我如何在 PSC 中注册产品?

在查看计划要求后,请与 AWS Marketplace 卖家目录运营团队联系以提供您要在 PSC 中注册的产品列表。您可以在该计划中注册新的或现有的基于 AMI 的产品列表。请留出 1-2 周的时间以处理您的请求。您需要确认已完成与 API 集成的过程,然后才能为 PSC 启用您的产品。如上所述,您还必须在您的产品列表页面中提供有效的支持电子邮件地址,并向 AWS Marketplace 客户详细说明您计划采用的数据处理和支持流程。

处理客户数据

我如何使用通过产品支持连接提供的数据?

根据 AWS Marketplace 卖家条款和条件 (“卖家条款”),您在 PSC 计划中收到的信息构成“订阅者信息”,只能依照卖家条款 (包括其中的第 3.8 条) 使用这些信息。这些数据不能用于营销或与产品支持无关的其他用途。

我应该如何处理和存储通过 AWS Marketplace 产品支持连接提供的客户数据?

您必须依照适用的法律和您的隐私政策处理客户数据;我们建议应加密传输和静态的客户数据。根据卖家条款,提供的客户数据构成订阅者信息,只能用于提供产品支持。

技术实施指南

本节介绍 API 规范详细信息以及如何开始使用 API。PSC API“start-support-data-export”是 AWS Marketplace Commerce Analytics Service (CAS) 的一部分。要为 PSC 集成 API,您必须先注册到 CAS。如果您已注册了 CAS,则可以跳过下面的步骤 1-4。如果已注册 CAS,您需要使用首次开始使用时创建的同一个 IAM 角色。

使用 AWS 命令行界面 (CLI) 发出请求

您可以使用 AWS CLI 或任意 AWS 开发工具包 (SDK) 请求导出 PSC 数据。

如果您已使用 CAS 调用 generate-data-set 方法,则必须为 generate-data-setstart-support-data-export 使用相同的 IAM 角色。为了确保通过产品支持连接计划提供的客户联系数据是安全的,我们建议您将用于 start-support-data-export 的 S3 存储桶与用于 generate-data-set 的 S3 存储桶分隔开。验证您的 IAM 角色上的权限是否允许访问要使用的全部 S3 存储桶。

aws marketplacecommerceanalytics start-support-data-export --data-set-type "test_customer_support_contacts_data" \ --from-date “{START-DATE}” \ --role-name-arn "{YOUR-ROLE-NAME-ARN}” \ --destination-s3-bucket-name “{YOUR-S3-BUCKET}” \ --destination-s3-prefix “test-prefix” \ --sns-topic-arn “{YOUR-SNS-TOPIC-ARN}”

服务的成功响应将返回请求的 dataSetRequestId

示例响应:

{

"dataSetRequestId":

"646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"

}

API 请求参数和响应

StartSupportDataExport 方法

StartSupportDataExport 方法允许您请求客户为支持 PSC 的产品提交的联系人详细信息。导出数据的时间范围是,从请求中指定的开始日期,到请求发出时间的 15 分钟之前。成功的请求会使得数据集发布到指定的 Amazon S3 存储桶。

目前,您可以查询 API 来请求 test_customer_support_contacts_data 数据集。这会导出静态测试数据集,其中包含未与任何实际客户数据对应的数据。您应使用测试数据进行测试和集成。对于为启用 PSC 的产品返回真实客户联系数据的 customer_support_contacts_data 选项,在 2016 年后期正式发布此功能之前不可用。

请求参数

Input 描述
数据集类型

请求导出的数据集的类型。数据集的有效选项是:

test_customer_support_contacts_data

customer_support_contacts_data

test_customer_support_contacts_data 数据集提供示例数据用于测试和集成用途,并且即时可用。customer_support_contacts_data 数据集当前不可用。此选项将包含实际客户数据并在 PSC 正式发布时可用。

起始日期

要导出数据的最早日期。导出数据所含信息范围是,从指定起始日期到请求发出时间的 15 分钟之前。

“起始日期”必须表示为 ISO 8601 日期/时间字符串。

如果您希望接收完整数据集,而不是一组更新,请指定您将信息载入计划的日期之前的任意日期。要仅接收自上次请求以来的增量数据,请从前一请求生成的元数据 JSON 文件,指定 dataSetCoverageRange 的 endDateTime。有关元数据 JSON 文件的更多信息,请参阅下文。

角色名称 ARN IAM 角色的 Amazon 资源名称 (ARN),该角色附加了用于向服务提供资源访问权的权限策略。
目标 S3 存储桶名称 目标 Amazon S3 存储桶的名称(易于识别名称,而非 ARN)。您的数据集将发布到此位置。
目标 S3 前缀

(可选)已发布数据集所需的 Amazon S3 前缀,类似于标准文件系统中的目录路径。

例如,如果给定存储桶名称“mybucket”和前缀“myprefix/mydatasets”,输出文件“outputfile”将发布到“s3://mybucket/myprefix/mydatasets/outputfile”。

如果前缀目录结构不存在,则会自动创建。

如果没有提供前缀,数据集将发布到 Amazon S3 存储桶根。

SNS 主题 ARN 在发布数据集或者出现错误时,需要通知的 Amazon SNS 主题的 Amazon 资源名称 (ARN)。

响应

对 API 的调用将立即返回具有数据集请求 ID 的响应。

字段 描述
数据集请求 ID 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。

包含元数据的附加响应将发布到在原始请求中指定的 Amazon SNS (Simple Notification Service) 主题。发布的内容在下表中详述。

字段 描述
数据集 S3 位置 已传输数据集的存储桶名称和密钥。
数据集元数据 S3 位置 已传输数据集元数据文件的存储桶名称和密钥。
数据集请求 ID 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。
成功 如果操作成功,则为 True;否则为 False。
Message (可选)如果出现错误(例如,“Success”是“false”),此消息将包含有关故障的信息。

元数据文件采用 JSON 格式,包含以下字段:

字段 描述
数据集请求 ID 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。
数据集覆盖范围 定义数据覆盖范围的开始日期/时间和结束日期/时间。这些日期采用 ISO 8601 格式。
数据集请求参数 针对 GenerateDataSet 方法的原始请求参数。
数据集 S3 位置 已传输数据集的存储桶名称和密钥。
数据集元数据 S3 位置 已传输数据集元数据文件的存储桶名称和密钥。
请求接收日期时间 收到请求的日期/时间,采用 ISO 8601 格式。
请求完成日期时间 完成请求的日期/时间,采用 ISO 8601 格式。

示例 JSON 格式的元数据内容:

{

"dataSetRequestId": "c3c84ee0-5aba-11e6-8d9c-235dc080841d",

"dataSetCoverageRange": {

"startDateTime": "2016-08-18T00:00:00.000Z",

"endDateTime": "2016-08-05T03:14:50.334Z"

},

"dataSetRequestParameters": {

"fromDate": "2016-08-18T00:00:00.000Z",

"dataSetType": "test_customer_support_contacts_data",

"roleNameArn": "arn:aws:iam::123456789012:role/MarketplaceCommerceAnalyticsRole",

"destinationS3BucketName": "mybucket",

"destinationS3Prefix": "mydata",

"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:mynotification"

},

"dataSetS3Location": {

"bucketName": "mybucket",

"key": "mydata/test_customer_support_contacts_data_2015-01-18T00-00-00Z_to_2016-08-05T03-14-50Z.csv"

},

"dataSetMetaDataS3Location": {

"bucketName": "mybucket",

"key": "mydata/test_customer_support_contacts_data_2015-01-18T00-00-00Z_to_2016-08-05T03-14-50Z.meta.json"

},

"requestReceivedDateTime": "2016-08-05T03:14:50.108Z",

"requestCompletedDateTime": "2016-08-05T03:14:50.334Z"

}

输出数据格式

输出数据包含客户的联系记录、产品代码、产品 ID、订阅起始日期和客户的 AWS 账户 ID。字段摘要如下所示。每个输出文件包含一个以逗号分隔的标题,后跟包含客户数据和订阅信息的记录。每条记录都包含一个“创建”、“更新”或“删除”操作类型,用于指示该记录是自 API 请求中所示“起始日期”以来新创建、修改还是删除的。整体文件格式遵从 RFC4180 标准。

如果在 API 请求的“from-date”参数指定的时间范围内,一条记录上出现了多个操作,将只体现或导出最近的数据。例如,如果客户创建并更新了一条记录,返回的记录将根据指定的“from-date”而不同。如果“from-date”早于创建记录的日期,则只有 CREATE 记录将传入输出数据集,并且记录体现最近输入的详细信息。如果“from-date”晚于创建记录但早于更新记录的时间,则仅将 UPDATE 记录传入输出数据集。如果 from-date 晚于更新记录的时间,则不传递记录。与此类似,如果客户创建并随后删除了记录,则输出文件中只显示“DELETE”。

如果您希望接收完整数据集,而不是一组更新,请指定您将信息载入计划的日期之前的任意日期。要仅接收自上次请求以来的增量数据,请从前一请求生成的元数据 JSON 文件,指定 dataSetCoverageRange 的 endDateTime。

字段 格式 描述
产品 ID 36 个字符的十六进制字符串

AWS Marketplace 中列表的唯一标识符 (GUID)。

必填字段;始终显示在每条记录中。

产品代码 25 个字符的字母数字字符串

产品的唯一标识符,它与账单关联并在 EC2 实例元数据中提供。

必填字段;始终显示在每条记录中。

客户 GUID 36 个字符的十六进制字符串

标识客户联系数据记录的唯一 GUID。这对于输出文件中显示的每条记录唯一。

必填字段;始终显示在每条记录中。

订阅 Guid 36 个字符的十六进制字符串

与客户的产品订阅对应的唯一 GUID。客户对同一个产品可以有多个订阅。

必填字段;始终显示在每条记录中。

订阅开始日期

ISO 8601 日期/时间,使用 UTC 时区。

格式为 YYYY-MM-DDTHH: mm: ss.nnnZ,其中 YYYY 是年份,MM 是月份,DD 是一个月中的日期,HH 是小时时间 (00-23),mm 是一小时中的分钟 (00-59),ss 是一分钟内的秒 (00-59),nnn 是一秒内的毫秒 (000-9999),例如“2016-04-07T14:05:15.275Z”

客户产品订阅的起始日期。

必填字段;始终显示在每条记录中。

组织 最大长度为 255 个字符的字符串

客户提供的组织名称。

始终显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

AWS 客户 ID 12 位数字的字符串,可能包括前导零

订阅列表的客户的 AWS 客户 ID。

必填字段;始终显示在每条记录中。

名字 最大长度为 100 个字符的字符串

客户提供的联系人的名字或姓氏。

始终显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

姓氏 最大长度为 100 个字符的字符串

客户提供的联系人的姓氏。

始终显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

电话号码 最大长度为 25 个字符的字符串。可以包含国际电话号码。

客户提供的电话号码。

始终显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

电子邮件 最大长度为 254 个字符的字符串

客户提供的电子邮件地址。

始终显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

职务 最大长度为 255 个字符的字符串

客户提供的职位。

可选字段。有时显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

国家/地区代码 2 个字符的 ISO 3166 国家/地区代码

客户提供的国家/地区代码。

可选字段。有时显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

邮政编码 5 位数的字符串

客户提供的邮政编码,仅适用于美国。

可选字段。有时显示在操作类型为“更新”或“创建”的记录中。 不显示在操作类型为“删除”的记录中。

操作时间 ISO 8601 日期/时间,使用 UTC 时区。格式为 YYYY-MM-DDTHH: mm: ss.nnnZ(YYYY 是年份,MM 是月份,DD 是一个月中的日期,HH 是一天中的时间 (00-23),mm 是一小时中的分钟 (00-59),ss 是一分钟内的秒 (00-59),nnn 是一秒内的毫秒 (000-9999)),例如“2016-04-07T14:05:15.275Z”

指示客户最近创建、更新或删除记录的日期/时间。

必填字段;始终显示在每条记录中。

操作类型 字符串;可能的值为“CREATE”、“UPDATE”或“DELETE”

CREATE:表示自 API 请求中指定的 from-date 以来,新创建了记录。

UPDATE:表示自 API 请求中指定的 from-date 以来,更新了记录。

DELETE:表示自 API 请求中指定的 from-date 以来,删除了记录。

必填字段;始终显示在每条记录中。

输出文件格式的示例如下所示。

产品 ID,产品代码,客户 GUID,订阅 GUID,订阅起始日期,组织,AWS 客户 ID,名字,姓氏,电话号码,电子邮件,标题,国家/地区代码,邮政编码,操作时间,操作类型

4b898955-84fa-4cfb-8f43-98287ad69c06,4gzp2symm0v9zidfrn9f854w6,ba1d75cc-d984-4f07-bb14-ae04b952afbc,cad371fb-6f2c-4537-a054-1a7afc6312fd,2016-05-27T00:00:00.000Z,Example Inc -- Service Division,000011112222,Eugene,Thietmar,555-947-8228,eugethi@example.org,,,,2016-05-12T03:54:46.143Z,CREATE

4b898955-84fa-4cfb-8f43-98287ad69c06,4gzp2symm0v9zidfrn9f854w6,1b4a2b5f-2c5d-4779-b0c7-2878b0f45cfc,cad371fb-6f2c-4537-a054-1a7afc6312fd,2016-05-19T00:00:00.000Z,Example Inc -- Service Division,000011112222,Angela,Doe,555-294-4528,adoe@example.com,,US,02201,2016-05-19T18:21:06.834Z,CREATE

cade58ff-ff82-4770-b84b-0bd399bf1c6d,c0dcyyqczbk5uc62acmp6450t,6c83ff14-5167-43cc-bb9f-24865a78db72,c2f40319-8fc2-409a-884b-2f85adf9e29c,2015-12-01T00:00:00.000Z,Example Inc -- European Sales Division,111122223333,Ravi,Smith,555-111-1010,ravis@example.com,Head of IT,ES,,2016-04-07T14:05:15.145Z,CREATE

4b898955-84fa-4cfb-8f43-98287ad69c06,4gzp2symm0v9zidfrn9f854w6,1b4a2b5f-2c5d-4779-b0c7-2878b0f45cfc,cad371fb-6f2c-4537-a054-1a7afc6312fd,2016-05-01T00:00:00.000Z,,000011112222,,,,,,,,2016-04-22T14:36:24.054Z,DELETE

3f4300eb-bfa0-4610-8d68-d8ba71baaa50,3qtu9xydxldrj8c5jyldy1lqo,91c72621-6cf4-4d69-8ebe-073ff4f8ab9e,d118eb96-55ce-4752-909c-eedcfdcd6647,2015-11-30T00:00:00.000Z,Example Inc -- Design Division,333344445555,Nathan,Zhenyuan,555-2222-1010,nathanz@example.com,Sr.Program Manager,US,98109,2016-04-07T14:05:15.275Z,CREATE

3f4300eb-bfa0-4610-8d68-d8ba71baaa50,3qtu9xydxldrj8c5jyldy1lqo,2ae0be12-7397-4fdb-a1c7-ead17967002c,d118eb96-55ce-4752-909c-eedcfdcd6647,2016-05-01T00:00:00.000Z,Example Inc -- Design Division,333344445555,Abdul,Alves,555-676-8989,abdal@example.com,,,,2016-05-11T05:26:51.000Z,UPDATE

...

关于“删除”操作类型的注释

客户从 PSC 计划中删除其联系信息时,您会在输出 csv 文件中看到一条记录,指示操作类型“DELETE”。 客户删除其数据之后,API 不再传输联系信息,例如姓名、电话号码、电子邮件等等。每条删除记录包含唯一标识要删除的记录所需的数据。删除记录包含产品 ID、产品代码、操作时间、客户 GUID、订阅 GUID、订阅开始日期、AWS 客户 ID、操作时间和操作类型。

如果客户选择通过删除其联系信息来退出产品支持连接,您还应从您的记录中删除联系信息。由于客户联系数据不包括在 DELETE 记录中,您需要使用唯一客户 GUID 在系统中查找记录。

如果客户终止订阅,也会发送删除记录。

我已提取数据到我的 S3 存储桶。现在应该怎么办?

此时的集成步骤取决于您的内部支持系统和流程。您应确保,从 API 导出的客户联系详细信息已在一个工作日内添加到您的内部支持或 CRM 系统中,这样可在 AWS Marketplace 客户联系您的支持团队时确认其身份。许多 CRM 系统提供了 API,以自动方式在系统中创建、更新和删除记录。

更多问题?

如果您有关于参与 AWS Marketplace 产品支持连接的问题或者希望了解更多信息,请联系AWS Marketplace 卖家运营团队。