嵌入代码生成器

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

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

实施检查清单

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

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

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

面向开发者

轻量级 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 发送其高度以实现动态大小调整
添加自动调整大小片段以避免滚动条
使用预连接提示加速首次绘制