概述

利用新的商品销售 API 更轻松地识别交易并受益于机器学习技术

利用机器学习帮助您从 Expedia Group 庞大的全球促销库存中找出最适合旅行者的优惠和折扣。通过使用 Merchandising API，您可以访问各种活动内容并处理数据，以构建成功的 year-long 策略和 traveler-facing 体验，例如促销电子邮件、应用程序小部件、网站横幅和轮播体验。

我们还在合作伙伴门户中添加了一个新应用程序，您可以使用它来制定营销策略以及计划、执行和跟踪活动。该应用程序位于名为“门户营销中心”的新部分。请联系您的客户经理以获取更多信息。

活动内容端点

提供即将举行的活动详情，包括活动 ID、预订和住宿开始和结束日期以及参与的酒店数量。
可以直接访问 Expedia-curated 活动资产，例如活动主题图片、目的地图像、建议副本等。
接收有关限时优惠 (LTO) 活动的信息，这些活动的预订窗口在未来六个月内，以及全年可用的常青活动。

您可以使用 Campaign Content 端点通过请求参数搜索即将开展的活动，包括：

可预订日期范围
入住日期范围
等于或高于最低折扣值
LTO 与常青优惠

对于预订期限超过六个月的 LTO 活动，以下字段将被排除：

预订和入住日期
最小和最大折扣百分比

其他细节

活动内容端点可以帮助您利用 Expedia-curated 资产来创建 traveler-facing 营销体验，例如促销电子邮件、应用程序小部件、网站横幅等。

您可以使用活动内容响应中的 property_count字段来确定参与属性的最大 up-to-date 数量。酒店对促销活动的参与是动态的，因此我们建议您在活动开始前约 4-6 周评估property_count，以更准确地了解有多少酒店将作为活动的一部分提供优惠。

促销端点接受的唯一区域类型是city。其他区域类型如multi_city_vicinity、point_of_interest、neighbourhood等将返回空白响应。

合作伙伴仍负责使用新的 Merchandising API 或 Shopping API 构建的网站上的营销和消息传递活动，并确保所有此类营销和消息传递符合适用的法律法规。

促销端点

提供与特定活动相关的所有可用交易和折扣。
能够借助多个请求参数搜索和过滤交易，包括能够为特定活动或跨多个活动请求交易。
使您能够始终展示最具 up-to-date 吸引力的房地产交易，以建立 high-converting 活动。

您可以使用促销端点通过请求参数轻松过滤和搜索交易，例如：

广告系列 ID 和/或媒体资源 ID
可预订日期范围
入住日期范围
等于或高于最低评分、最低星级和/或最低折扣的值
限时与常青的区别
Member-only 和 mobile-only 交易标志
超级区域或特定目的地
机器学习相关性得分排序顺序

以下详细信息将在促销 API 响应中返回：

交易 ID、相应的广告系列 ID 和属性 ID
可预订日期范围、入住日期范围、不适用日期和提前购买期限
限时与常青的区别
机器 learning-powered 针对响应中返回的交易、属性和目的地，为您的业务提供独特的相关性分数
具体目的地和连锁店 ID 信息
标记化链接到现有的快速财产内容 API，以提取 property-level 图像，并将其融入您的营销体验中

其他细节

您可以轻松搜索和过滤促销响应以获得更有针对性的优惠，从而完全控制向旅行者展示的优惠。您还可以策划这些交易来构建您自己的活动主题，而不是使用 Expedia-defined 活动和相关资产。

您可以在 Promotions 端点上使用 include请求参数来自定义收到的响应的大小。因此，如果您只需要返回几个字段，而不是接收所有响应字段，则可以在 include参数中添加那些特定的字段名称。

您可以使用活动内容响应中的 property_count字段来确定参与属性的最大 up-to-date 数量。酒店参与促销活动是动态的，因此我们建议您评估property_count大约在活动开始前 4-6 周，以便更准确地了解有多少房产将作为活动的一部分提供优惠。

与活动内容指南一样，我们建议您尽可能接近活动可预订开始日期提出促销请求，以确保您获得最多的 up-to-date 优惠。

如果您有兴趣构建 destination-based 营销活动，您可以使用相关的region_id来自快速地理 API。

机器学习建议

促销响应中提供的机器 learning-powered 相关性分数对于每个组织都是唯一的，因此您收到的分数/排名将与其他人收到的分数/排名不同。您可以使用机器学习建议来确定在商品推销活动中要推广的最佳交易、房产和目的地。Higher-scoring 优惠、酒店和目的地将有可能推动您独特的旅行者群体的转化。

目前，您将收到每个活动中前 10,000 个交易的相关性分数。在我们的测试中，我们发现在前 10,000 笔交易之后，这个分数的价值和影响变得微不足道。

根据您的使用情况，您可以使用sort_by参数来定义促销响应的排序顺序，选择根据我们的机器学习模型确定的交易、属性或目的地相关性进行排序，以便您在可见性和旅行者预订方面从商品销售中获得最大价值。

如果你通过sort_by = promotion您将收到根据我们专有的机器学习算法排名为 high-to-low（1 到 10,000）的所有交易结果。您可以使用此排序来获取我们的模型预计转换率更高的顶级推荐交易。
如果你通过sort_by = property您将收到根据我们专有的机器学习算法排名为 high-to-low 的房产的所有交易结果。
如果你通过sort_by = destination您将收到根据我们专有的机器学习算法排名为 high-to-low 的目的地的所有交易结果。

**笔记：**门户营销中心还提供机器学习建议。请联系您的客户经理以了解更多详细信息。

对购物可用性 API 所做的更改

要获取有关可用性、实时定价、可退款性、佣金信息等的最新详细信息，您应该向 Rapid 提出标准请求购物可用性 API我们对购物 API 进行了以下更改，以支持商品销售流程并使您尽可能顺利地集成商品销售 API：

使用新的deal快速购物可用性端点中可用的过滤器仅接收具有有效促销的价格。这使您可以灵活地创建以商品销售为重点的购物请求，并确保返回的所有费率都具有 deal 属性。
Rapid 的购物可用性端点上提供了一个名为 Campaign-Id 的新请求标头，您可以用它指示您正在进行的特定购物可用性 API 调用不是常规调用，而实际上是由于您的商品促销活动而进行的（换句话说，这将表示当旅行者因活动促销而进入商店体验时，提出了购物可用性 API 请求）。每次购物 API 调用我们只接受一个活动 ID。此活动 ID 将帮助我们跟踪您的活动效果并为您设计更好的机器学习模型和 API 增强功能。
如果您想查看门户营销中心上的营销活动效果，您需要在购物 API 调用中传递营销活动 ID 参数。如果您有任何疑问，请联系您的客户经理。

**注意：**您一次最多可以从购物可用性 API 请求 250 个属性的详细信息。

示例响应

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

注意： Merchandising API 响应中提供的 id 和 description 与 Shopping API 响应中返回的不同。我们强烈建议您使用 Merchandising API 返回的 id 和 description。

建议的最低折扣不含税费。您有责任确保所宣传的折扣符合必要的价格广告法。

API 详情

探索此页面上的 merchandising-related 端点定义，然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较情况。

其他资源

无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合，我们都能满足您的需求。