嵌入代码生成器

在几分钟内将 Society Speaks 投票小组件添加到您的文章。开发者获得简洁的 iframe 和自定义控制。编辑获得结构化洞察，而非评论噪音。

API 参考联系

嵌入适用于 Society Speaks 原生讨论。

实施检查清单

确认您的域名已列入允许清单
生成下方的 iframe
添加自动调整大小以实现无缝用户体验

使用合作伙伴门户进行生产入驻

从合作伙伴门户创建测试密钥、验证域名并激活实时密钥。大规模部署时，使用 API 创建讨论并将返回的 讨论 ID 存储在您的内容管理系统中。查看 API 参考了解编程工作流程。

面向开发者

轻量级 iframe、可预测的参数和 postMessage 调整大小钩子。

针对编辑

结构化参与、清晰的共识信号和可审计的方法论。

针对受众

秒内投票、查看公众立场，并探索更深入的分析。

大规模流程

1) 按文章 URL 查找，2) 如缺失则创建，3) 存储讨论 ID。

什么是讨论 ID？

API 在创建或查找讨论时返回的唯一标识符。

还没有讨论？

调用 POST /api/partner/discussions 创建讨论，然后立即嵌入。

1. 查找您的讨论

文章 URL

或

讨论 ID

API 在创建或查找讨论时返回。

2. 选择主题

Default

Dark

Editorial

Georgia

Minimal

Bold

Muted

或自定义颜色：

主色

背景

字体

3. 添加您的参考标记（可选）

合作伙伴参考

用于分析。小写，无空格。

预览

输入讨论 ID 或查找文章 URL 以查看预览

嵌入代码

<!-- 输入讨论 ID 以生成嵌入代码 -->

自动调整大小片段

<script>
window.addEventListener('message', (event) => {
  if (event.data && event.data.type === 'societyspeaks:embed:resize') {
    const iframe = document.getElementById('societyspeaks-embed');
    if (iframe) iframe.style.height = event.data.height + 'px';
  }
});
</script>

性能提示

<link rel="preconnect" href="https://societyspeaks.io">
<link rel="dns-prefetch" href="https://societyspeaks.io">

提示

将 iframe 宽度设置为 100% 以实现响应式嵌入
默认高度为 600px；根据陈述数量调整
添加 ref 以跟踪来自您网站的参与情况
嵌入通过 postMessage 发送其高度以实现动态大小调整
添加自动调整大小片段以避免滚动条
使用预连接提示加速首次绘制