---
schema_version: "1"
id: 7e45836f161bef1f824cd97d5397471ab5b8e391a31874e31e66e8cc3796e9d5
title: 将指标嵌入网页（已停用）
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/pro/desktop/embed_metrics.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/zh-cn/embed_metrics.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 58ed2258a1f2bbc2f0381385dbda45f5b1957d8562edd37c101b2dcbaef94c09
description: Embed legacy metrics into webpages. This retired feature was replaced by Tableau Pulse.
---
[跳转到主要内容](#main-content)

# 将指标嵌入网页（已停用）

**旧版指标功能的停用**

Tableau 的旧版指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。借助 Tableau Pulse，我们开发了一种改进的体验来跟踪指标和询问数据问题。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)以了解新体验，并参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)了解已停用的功能 。

您可以嵌入指标以在与您的查看者最相关的上下文中将它们与其他 Web 内容一起显示。当您加载嵌入的指标时，您将获得最新的可用数据，因为您直接连接到 Tableau Server 或 Tableau Cloud 上的数据。

若要将指标嵌入网页，请复制 Tableau Server 或 Tableau Cloud 上提供的 HTML 嵌入代码或使用下面显示的 JavaScript 示例。您可以在单个页面上嵌入多个指标，只要这些指标来自同一个 Tableau 站点。

嵌入式指标与 Tableau Cloud 和 Tableau Server 支持的相同 Web 浏览器一起使用。有关受支持浏览器的列表，请参见[技术规范](https://www.tableau.com/zh-cn/products/techspecs)。尽管 Safari 支持嵌入，但查看者必须关闭“防止跨站点跟踪”才能看到嵌入的内容。

嵌入式指标的嵌入代码和参数与用于嵌入式视图的代码和参数不同。有关嵌入式视图的信息，请参见[将视图嵌入网页](https://help.tableau.com/v0.0/pro/desktop/zh-cn/embed.htm)。

**注意：**您的 Tableau 管理员可以限制允许嵌入的站点或完全禁用嵌入。如果您的嵌入指标未加载，请与您的管理员联系，以确保您嵌入它的站点在嵌入允许列表中。有关详细信息，请参见[用于嵌入的 Tableau 设置](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_site.html)。

## 复制嵌入代码

嵌入指标的最快方法是复制 Tableau 提供的嵌入代码。

1. 在 Tableau Cloud 或 Tableau Server 上，导航到要嵌入的指标的详细信息页面。
2. 单击“共享指标”按钮。
3. 单击“复制嵌入代码”。  
    ![共享对话框上“复制嵌入代码”按钮](/tableau/next/zh-cn/pro/desktop/zh-cn/Img/share_embed_code_metrics.png)
4. 将嵌入代码粘贴到要嵌入指标的网页中。

## 编写自己的嵌入代码

当您从 Tableau Server 或 Tableau Cloud 复制嵌入代码时，您复制的是 HTML 嵌入代码（不含任何可选参数）。如果您想更好地控制嵌入的指标，您可以自定义 HTML 或使用 JavaScript 示例编写您自己的脚本。

### HTML 示例

```
<tableau-metric
	src='https://mycompany/#/metrics/1'
	link-target='https://example.com'>
</tableau-metric>
<script type='module' src='https://mycompany/javascripts/api/tableau.metric.1.latest.min.js'></script>
```

### JavaScript 示例

```
<div id='metricDiv'/>
<script type='module'>
	import { TableauMetric } from 'https://mycompany/javascripts/api/tableau.metric.1.latest.min.js';
				
	let metric = new TableauMetric();

	metric.src = 'https://mycompany/#/metrics/1';
	metric.linkTarget = 'https://example.com';document.getElementById('metricDiv').appendChild(metric);
</script>
```

## 嵌入代码的参数

嵌入代码的参数可用于自定义 HTML 和 JavaScript 嵌入选项。

<table class="table--plain"><thead><tr><th>参数</th><th>值</th><th>描述</th><th>示例</th></tr></thead><tbody><tr><td>来源<br>（必需）</td><td>字符串</td><td>Tableau Server 或 Tableau Cloud 上指标的 URL。</td><td><code>https://mycompany/#/metrics/1</code></td></tr><tr><td><p>link-target (HTML)</p><p>linkTarget (JavaScript)<br></p><p>（可选）</p></td><td>字符串</td><td>查看者单击该指标时将被定向到的 URL。如果未指定目标，则嵌入的指标将链接到源 URL。</td><td><code>http://example.com</code></td></tr></tbody></table>

## 嵌入式指标的身份验证

嵌入式指标遵守 Tableau Server 和 Tableau Cloud 上使用的相同许可和权限限制。若要查看嵌入式指标，查看者必须登录嵌入该指标的 Tableau 站点上的帐户。与嵌入式视图不同，嵌入式指标不允许使用来宾帐户向未登录的查看者显示指标。

未在另一个选项卡中登录 Tableau Server 或 Tableau Cloud 的查看者将被提示从嵌入式指标本身登录。若要从嵌入式指标成功登录，必须将查看者的浏览器配置为允许第三方 Cookie。

嵌入式指标支持 Tableau Server 和 Tableau Cloud 的所有身份验证方法，受信任的身份验证除外。对于从 Tableau Server 嵌入的指标，服务器必须使用 HTTPS 来保护通信。

若要为嵌入式指标启用单点登录体验，您的 Tableau 管理员必须在 Tableau Server 与外部授权服务器（仅限 Tableau Server）或与 Tableau 已连接应用和网页之间配置信任关系。有关详细信息，请参见 Tableau Server 帮助中的[注册 EAS 以启用嵌入内容的 SSO](https://help.tableau.com/current/server-linux/zh-cn/connected_apps_eas.htm)或 Tableau Cloud 帮助中的[配置 Tableau 已连接应用以启用嵌入内容的 SSO](https://help.tableau.com/current/online/zh-cn/connected_apps.htm)。

## 如何构建指标 URL

若要嵌入指标，请指定指标 URL 和用于呈现指标的 JavaScript 的 URL。指标 URL 在 Tableau Cloud、具有单个站点的 Tableau Server 环境和多站点 Tableau Server 环境中遵循略有不同的模式。如果您不确定如何设置 URL 格式，请复制嵌入代码，因为它同时包含指标 URL 和 JavaScript URL。

指标必须托管在 Tableau Server 或 Tableau Cloud 上。您不能通过本地文件嵌入指标。

### 指标 URL 结构

- Tableau Cloud 站点：`https://<pod>.online.tableau.com/#/site/<sitename>/metrics/<metric>`
- Tableau Server 单个站点（或默认站点）：`https://<servername>/#/metrics/<metric>`
- Tableau Server 多站点：`https://<servername>/#/site/<sitename>/metrics/<metric>`

### JavaScript URL 结构

指标 URL 会因您嵌入的站点而异，但呈现指标的 JavaScript 的 URL 不会更改，因为它不包含该站点。

- Tableau Cloud 站点：`https://<pod>.online.tableau.com/javascripts/api/tableau.metric.1.latest.min.js`
- Tableau Server：`https://<servername>/javascripts/api/tableau.metric.1.latest.min.js`