故障排除与支持#
从您 Visualizer SDK 集成中的失败步骤开始:加载 SDK、匹配产品或导入数据。保留请求上下文,但不要泄露凭据。
商店前台按钮未出现#
- 检查网络面板中的
https://sdk.ideal.house/sdk.js,并检查任何加载失败。 - 确认有一个加载器具有正确的 Shop ID 和 Publishable Key。
- 打开 仪表板 → 设置。确认 Allowed Origins (CORS) 包含您正在测试的确切商店前台来源,任何更改后点击 保存,并重新加载商店前台。还要检查目标的确切
data-product-code。请参阅 来源配置。 - 验证产品已就绪且所选变体具有映射。
- 对于手动创建的按钮,检查您的样式是否允许验证后的激活状态变为可见。
不要强行让未经验证的按钮可见以绕过资格检查。请遵循 平台指南 和 映射指南。
打开了错误的产品#
在更改变体、打开快速视图或导航而不重新加载后检查目标。根据 动态页面 清除过时的 SDK 属性,并确认您的平台回调实际运行。
导入被接受但产品缺失#
一个 202 Accepted 响应启动异步工作。阅读 作业状态,检查项目失败并使用 错误和重试。状态端点返回当前或最新的商店作业;它不是按任意作业 ID 的历史查找。
发送给支持的信息#
使用接入期间提供的支持渠道或账户中的联系选项。包含受影响的商店前台 URL、相关的 Shop ID、产品代码或导入作业 ID、大致时间、浏览器、预期结果和脱敏的错误响应。在共享日志或屏幕截图之前,移除 Client Secret、API 密钥、令牌和私人客户图片。