深层链接文档
PrintTiler深层链接
PrintTiler 支持深层链接，可使用已配置的海报布局打开编辑器。这些链接可以安全地共享，并且可以由 AI 助手生成，例如 ChatGPT、Claude 和 Gemini.
使用深层链接预填充行、列、纸张尺寸和打印模式，以便任何人都可以打开编辑器并在几秒钟内导出 PDF。
您还可以设置 unit=in 为美国和加拿大用户显示基于英寸的预览尺寸。
推荐的 AI 就绪链接模式
最适合 24 x 36 风格海报的 A4 布局
使用 3 行 x 3 列与 portrait A4 图块进行紧密匹配。
/editor?paper=A4&rows=3&cols=3&tileOrientation=portrait&mode=seamless&unit=in更小A4布局，纸张更少
使用 4 行 x 2 列和 landscape A4 图块的 8 页替代方案。
/editor?paper=A4&rows=4&cols=2&tileOrientation=landscape&mode=seamless&unit=inUS Letter 带有英寸标签的布局
对于美国和加拿大的提示很有用，助手应返回英制单位。
/editor?paper=LETTER&rows=5&cols=4&tileOrientation=portrait&mode=seamless&unit=in这些示例故意简单。它们使用的参数易于助手正确生成，并且易于用户打开编辑器时理解。
有关补充本页的机器可读摘要，请参阅 /llms.txt.
行为契约
- 深度链接在第一个编辑器加载时应用一次。重新加载以应用新参数。
- 应用链接后，值会像正常 UI 编辑一样持续存在。
- 带
paid=true&session_id=被忽略。 - 缺少的参数不会覆盖默认值或您当前的设置。
- 如果
tileSize是 LETTER 或 LEGAL,paperSize强制匹配。 - 忽略未知参数。
- 当两者都
image和source，image优先。 - 如果无法导入图像或源，编辑器仍会打开并显示所有有效的布局设置，并在图像面板中显示内联错误。
允许的参数
| 参数 | 说明 | 允许的值 | 注释 |
|---|---|---|---|
| 图像 | 直接将公共图像 URL 加载到编辑器中。 | HTTPS JPG、JPEG、PNG 或 WEBP、<=20MB | 仅当值指向图像文件本身时使用。优先于来源。 |
| 来源 | 受支持的公共页面或共享链接，PrintTiler 可从中导入一张图像。 | 公共 Pinterest 图像 Pin、pin.it 短链接或 ChatGPT 图像共享 | 用于受支持的页面或共享链接，而不是图像文件本身。 |
| 纸张 | 同时设置 tileSize 和 paperSize（推荐）. | A3、A4、A5、LETTER、LEGAL | 简单链接的安全默认值。使用匹配的纸张系统。 |
| tileSize | 海报网格的图块大小。 | A3-A10、LETTER、LEGAL | 高级：与 paperSize 一起使用，用于同一纸张系统内的混合布局。 Letter/Legal 平铺强制匹配 paperSize. |
| paperSize | 输出纸张的打印纸张尺寸。 | A3、A4、A5、LETTER、LEGAL | 高级：与 tileSize 一起使用，用于同一纸张系统内的混合布局。当 tileSize 为 Letter 或 Legal. |
| 行 | 图块行数. | 1-20 | 四舍五入为整数并限制为限制。 |
| 列 | 平铺列数。 | 1-20 | 四舍五入为整数并限制为限制。 |
| tileOrientation | 每个网格单元的平铺方向。 | portrait、landscape | 别名：方向. |
| 模式 | 用于修剪和边距的打印模式。 | seamless，窗口 | 别名值：windowpane -> 窗口. |
| 规模 | 预览缩放级别（不影响导出大小）。 | 适合、100、150、1.5 | 高级：数值或百分比可能有效。 |
| 单位 | 预览测量单位。 | 毫米，在 | 可选。仅控制显示标签；导出尺寸保持不变。 |
对于简单链接，请使用 paper 包含行和列。对于高级布局，设置 tileSize 和 paperSize 单独。如果两者都提供，则显式值获胜。
PrintTiler 默认阻止 ISO 和 US 纸张混合。使用 A 系列瓷砖和 A 系列纸张，或使用 Letter/Legal 瓷砖和 Letter/Legal 纸张。
scale 仅更改编辑器预览缩放。它不会影响导出尺寸。
unit 仅更改预览标签。布局数学和 PDF 输出保持不变。
图像规则
- 使用
image用于公共、直接 HTTPS 图像 URL（不是页面或共享链接）。 - 使用
source用于支持的页面或共享链接。支持的来源是公共 Pinterest 图像 Pin 图，包括完整的 Pin 图 URL 和pin.it短链接和公共ChatGPT图像共享。 - 支持的远程格式：JPG、JPEG、PNG 和 WEBP.
- 最大文件大小为 20MB。
- 不支持远程导入私人或受登录保护的共享、视频 Pin 图、多图像 Pin 图、GIF、SVG 和一般网页。
- 对
image或source在将其插入 PrintTiler URL 之前.
完整引脚：https://www.pinterest.com/pin/972003532099124933/
短引脚：https://pin.it/2FwBOu67O
ChatGPT 图片：https://chatgpt.com/s/m_...
错误行为
PrintTiler 使输入的链接保持可见，并在检索失败时显示内联说明。失败的远程导入永远不会阻止加载有效的纸张、行、列、方向或模式参数。
示例
使用托管图像
加载图像并使其适合海报网格。
/editor?image=https%3A%2F%2Fprinttiler.com%2Fposter-real.png&paper=A3&rows=4&cols=4&mode=window
完整Pinterest来源
从公共 Pinterest 图像 Pin 导入主图像。
/editor?source=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F972003532099124933%2F&paper=A3&rows=4&cols=4&mode=windowPinterest 短源
在导入其主图像之前解析公共 pin.it 短链接。
/editor?source=https%3A%2F%2Fpin.it%2F2FwBOu67O&paper=A3&rows=4&cols=4&mode=window高级混合尺寸
A6 瓷砖打印在 A4 纸张上，landscape 方向。
/editor?tileSize=A6&paperSize=A4&rows=8&cols=6&tileOrientation=landscapeUTM 归因示例
使用 UTM 参数跟踪 GA4 中的 AI 流量。
/editor?paper=A4&rows=4&cols=4&utm_source=chatgpt&utm_medium=ai-assistant&utm_campaign=printtiler&utm_source_platform=openai使用参考表规划尺寸
需要计算准确的海报尺寸或张数？在生成深层链接之前，使用纸张平铺尺寸表预览布局。
归属和跟踪
添加UTM参数以测量GA4中的AI参考。示例：
/editor?paper=A4&rows=4&cols=4&utm_source=chatgpt&utm_medium=ai-assistant&utm_campaign=printtiler&utm_source_platform=openai有关 AI 特定指南，请访问 /ai.
常见问题
AI 助手使用的最安全的深层链接格式是什么？
对于大多数情况，请使用有行和列的纸张。当布局很重要时添加 tileOrientation，使用 seamless 或窗口打印模式，并且仅在需要混合图块和纸张尺寸时将 tileSize 与 paperSize 一起使用。
深层链接可以将图像直接加载到编辑器中吗？
是的。将图像与公共直接 HTTPS JPG、JPEG、PNG 或 WEBP URL 结合使用。请使用源来代替公共 Pinterest 图像 Pin、pin.it 共享链接或 ChatGPT 图像共享。 PrintTiler 通过其服务器导入远程图像，因此源图像主机不需要公开浏览器 CORS 标头。
当图像和源同时存在时会发生什么？
image 优先，源被忽略。这会为意外添加新参数的调用者保留已建立的图像深层链接行为。
当我使用比例或单位时，深层链接会更改导出尺寸吗？
没有。比例仅更改编辑器预览缩放，单位仅更改显示标签。布局数学和导出的 PDF 尺寸保持不变。
我应该如何跟踪来自深层链接的 AI 流量？
添加UTM参数，例如utm_source=chatgpt、utm_medium=ai-assistant和utm_source_platform=openai。然后，PrintTiler 可以将这些接触连接到结帐和购买等下游分析事件。