设置赞助商广告跟踪

利用信标传输准确的交互信息并确定收入

为了向广告商汇报效果，必须知道赞助列表何时被查看和点击，以及该广告点击何时促成转化——无论该转化是按 Expedia Group 费率还是按其他库存来源的费率计算。住宿赞助列表 API 使用信标来实现跟踪和广告效果报告。

跟踪信标是加密信息，它使我们的系统能够正确捕获广告互动事件，将您的预订归因于相应的广告商，并处理来自您网站的广告收入。

跟踪信标详情

我们的配送 API 将生成跟踪信标，并以 URL 的形式附加到每个响应中。跟踪信标将与每个赞助列表关联的唯一信息，因此它们不能重复使用，并且需要在正确的时间触发。

**注意：**所有信标都包含一个占位符，用于表示排序顺序中的实际位置，您需要在触发信标时填充该占位符。

有些信标是我们报告所必需的，而另一些信标则有助于您自己的战略 decision-making。

点击信标

顾名思义，点击信标会在用户点击赞助商广告时触发。它们是赞助列表的重要组成部分，因为它们是您赚取收入的机制。

实施点击信标的最佳实践：

• 仅将它们设置在房源卡片中引导用户打开房源详情页面的部分。
• 右键点击应该仅触发住宿卡中 non-image 元素的点击信标。

渲染和查看信标

乍一看，渲染和查看似乎是同一个数据点，但它们的触发时间不同。渲染信标会在广告渲染到页面上时立即触发，但只有当广告像素的至少 50% 在浏览器窗口中连续 1 秒钟可见时，查看信标才会触发。

例如，考虑以下场景：

您的网站收到 10 个房源列表，并将它们包含在页面结果中。页面加载时，浏览器会渲染所有 10 张属性卡片，无论它们是否实际位于视口中。搜索结果布局使得用户实际上只能看到页面顶部的两个结果。如果所有属性都有信标，则所有 10 个渲染信标都会被触发，但只有 2 个视图信标会被触发。当用户向下滚动并显示其余属性卡片时，其余的视图信标将被触发。

结合查看信标和渲染信标，可以获得更精细的数据，并可用于指导赞助商列表排名决策。我们建议您同时实现查看信标和渲染信标，但要采用住宿赞助列表 API，只需要实现查看信标和点击信标即可。

查看信标和渲染信标均使用 URL 中的 position参数，该参数应填充赞助商列表在整体搜索结果中的数字位置。页面位置通常从 1（页面顶部的第一个属性卡）向下编号。在分页结果中，位置会按顺序跨页延续——编号不会在每个新页面上重新开始。

去重

根据拍卖 ID 和房产 ID 对跟踪信标事件进行去重。如果对某个经过筛选的搜索结果没有提交新的广告请求，则不会生成新的竞价 ID。如果同一房源在默认排序和筛选搜索中都被显示和点击，您只能获得一次点击的收入。

机器人检测

除非检测到并抑制机器人流量，否则可能会产生欺诈性广告事件，例如浏览量和点击量。因为这些活动并非有效活动，广告商不应为此付费，所以应该识别并过滤掉这些活动。

我们依靠您来防止向已知的机器人展示广告，并避免因机器人活动而触发广告跟踪事件。意外攻击可能会产生数百万美元的欺诈性广告收入，这些收入最终必须退还给广告商。

为了避免欺诈性流量，我们设置了保护逻辑，当某些条件不满足时，会自动拒绝事件。

住宿赞助列表 API 的机器人检测安全指南：

• 发起呼叫时，请将客户的真实 IP 地址发送给我们。如果来自同一 IP 地址的事件在一小时内超过预设数量，则会被拒绝。
  **注意：**这是使用客户 IP 的唯一方式，严格的数据访问策略确保客户 IP 数据不会被滥用。
• 确保正确设置 user-agent 和 origin HTTP 标头。不正确或缺失的值可能会导致我们的机器人过滤器拒绝访问，或者出现 cross-origin 资源共享 (CORS) 问题。
• 在正式上线之前，您必须向我们提供所有将要显示赞助广告的域名列表。必要时可以使用通配符。任何来自无法识别域的事件都将被自动拒绝。