将 Omnisend 与 ZAP~POST 连接，以向支持国家的新联系人发送实体明信片。集成每 30 分钟检查一次 Omnisend，并将符合条件的联系人和地址信息提交到与联系人国家匹配的 ZAP~POST 活动。
这是从 Omnisend 到 ZAP~POST 的单向集成。投递、退回和其他 ZAP~POST 状态不会同步回 Omnisend。
开始之前
确保您拥有：
一个活动的 ZAP~POST 账户。
一个 ZAP~POST API 密钥和 API 密码。
至少一个已发布前后艺术作品的 ZAP~POST 活动。
您要邮寄的联系人的地址、城市和国家数据。
一个名称清晰标识其服务国家的 ZAP~POST 活动。
访问 Omnisend 应用市场中的 ZAP~POST 集成。
例如，您可以命名活动：
欢迎明信片 - 美国欢迎明信片 - 英国欢迎明信片 - 德国
重要： 未发布的活动在您提交联系人时可能返回一个404 未找到响应。在与集成一起使用之前，发布活动的正面和背面艺术作品。
创建 ZAP~POST API 凭证
步骤1。 登录 ZAP~POST ZAPP。
步骤 2。 转到设置 → API 消费者。选择添加新消费者。
步骤 3。 选择生成新密钥。
步骤 4。 复制生成的API密钥（API Key） 和 API 密码。
您需要这两个凭证才能将 ZAP~POST 连接到 Omnisend。
将 ZAP~POST 连接到 Omnisend
步骤 1。 在 Omnisend 应用市场中打开 ZAP~POST 集成。
步骤 2。 输入您的 ZAP~POSTAPI 密钥，然后输入您的 ZAP~POSTAPI 密码。
步骤 3。 保存连接。
集成使用这些凭据将单个联系人记录提交到 ZAP~POST。
创建明信片自动化工作流
该集成使用一个名为 欢迎明信片 的自动化工作流。
创建或打开 欢迎明信片 自动化工作流。
选择 Omnisend 的 新联系人 触发器。
添加一个要求联系人必须具备的过滤器：
一个地址
一个城市
一个国家
添加 ZAP~POST 提交单个记录 操作。
选择所有该自动化工作流可以使用的 ZAP~POST 活动。
保存自动化工作流。
该集成检查所选活动名称，并将每个联系人路由到与其国家匹配的活动。
设置活动路由
该 活动 字段支持多选。选择该自动化工作流应能够使用的每个 ZAP~POST 活动。
该集成不会将每个联系人发送到每个选定的活动。它将联系人的国家与每个选定活动的名称进行比较。
例如：
来自美国的联系人被路由到包含
United States或US的活动。来自英国或北爱尔兰的联系人被路由到包含
United Kingdom或UK的活动。来自其他国家的联系人在选定的活动名称中包含该国家或其公认缩写时被路由到活动。
ZAP~POST 不提供单独的国家字段用于此路由。活动名称是集成可用的国家信号。
使用清晰的活动名称，例如：
欢迎明信片 - 德国欢迎明信片 - DE欢迎明信片 - 法国
来自英国或北爱尔兰的联系人不会路由到美国活动，即使两个活动都被选中。这些国家使用不同的实体邮件格式，并需要单独的活动设置。
已归档的活动可能在活动选择器中仍然可见。它们被标记为 ZAP~POST 提供的状态，并被排除在接收邮件之外。
支持的国家
当联系人的国家与所选的 ZAP~POST 活动名称匹配时，集成会路由该联系人。
以下国家已确认端到端支持：
英国
北爱尔兰
美国
路由逻辑还可以匹配其他国家，当存在命名正确的营销活动时。在您依赖它进行生产邮件之前，必须通过端到端测试确认对其他国家的支持。
ZAP~POST 可能支持向德国、荷兰、法国和意大利等国家的投递。然而，通过此集成的可用性取决于是否配置和测试了匹配的活动。
注意：爱尔兰共和国 不受此集成支持。ZAP~POST 对爱尔兰每次活动发送要求至少 2000 条记录，这不符合此集成的单个联系人的发送模型。
发送到 ZAP~POST 的数据
提交单个记录 操作将联系数据发送到 ZAP~POST。
字段 | 要求 |
客户 ID | 必填且唯一。限制为 100 个字符。映射自 Omnisend 联系人 ID。 |
国家 | 必填。支持字母、空格、连字符、括号、句点、和号和撇号。 |
电子邮件 | 可选。限制为 255 个字符。 |
名字 | 可选。 |
姓氏 | 可选。 |
公司名称 | 可选。 |
称谓 | 可选。 |
姓名字段 | 可投递的名称需要有效的姓名字段组合。组合限制为 120 个字符。 |
地址行 1 | 可单独选择。 |
地址行 2 | 可单独选择。 |
地址行 3 | 可单独选择。 |
城市 | 可单独选择。 |
邮政编码 | 可单独选择。 |
地址字段 | 可投递的地址需要有效的地址、城市和邮政编码组合。组合限制为 150 个字符。 |
货币 | 可选。仅使用字母，并支持最多三个字符，例如 |
语言 | 可选。仅使用字母，并支持最多 10 个字符。 |
自定义数据 | 可选的 JSON，用于特定于活动的字段。 |
ZAP~POST 需要足够的姓名和地址信息以投递明信片。信息不足的联系人可能会验证失败或无法投递。
添加自定义数据
使用 自定义数据 发送不属于标准联系人字段的特定于活动的值。
示例包括：
优惠优惠代码值开始日期
这些字段必须已经在 ZAP~POST 中为活动配置。使用小写字段名作为 JSON 键。
使用仅有效记录设置
该操作包括一个 仅有效记录 切换。
当设置开启时，如果任何字段未通过验证，ZAP~POST 将拒绝整个提交。
当设置关闭时（这是默认设置），有效字段将被提交，验证失败将在响应中返回。
根据您是否希望一个无效字段阻止整个提交来选择设置。
了解发送计划
集成每 30 分钟 检查 Omnisend 是否有新联系人。
ZAPPOST 可能会将单个提交内部合并为一个每日批次。这会影响记录在 ZAPPOST 的处理或报告页面上的显示。这不会改变邮件行为。
提交的记录的邮件状态在提交后的第二天之前可能无法查询。
故障排除
我看到“发生错误，请联系支持”
对于一个新的或重新连接的 ZAP~POST 账户，此消息可能表示试用期已过期。
在排查 Omnisend 连接之前，请检查您的 ZAP~POST 试用或账单状态。
我收到 404 未找到 响应
确认所选的 ZAP~POST 活动已发布前后艺术作品。
未发布的活动可能返回 404 未找到 响应。Omnisend 无法在提交之前检测未发布的艺术作品。
一个联系人没有收到明信片
检查以下内容：
该联系人有地址、城市和国家。
该联系人的国家与所选活动名称匹配。
匹配的活动未被归档。
该活动已发布前后艺术作品。
您的 ZAP~POST 试用或账单状态是活动的。
API 密钥和 API 密码是正确的。
该联系人包含足够的姓名和地址信息以供投递。
常见问题
我什么时候可以查看邮件状态？
ZAP~POST不会在同一天提供提交记录的状态供查询。在第二天检查状态。
集成是否将 ZAP~POST 投递状态同步到 Omnisend？
否 集成将联系人数据从 Omnisend 发送到 ZAPPOST。它不会将投递、退回或其他 ZAPPOST 事件同步回 Omnisend。
ZAP~POST 发送明信片的速度有多快？
Omnisend 每 30 分钟检查一次新联系人。ZAP~POST 可能会将单个提交内部批处理以进行每日处理。批处理过程影响报告，而不是集成的发送行为。
我可以使用一个活动针对多个国家吗？
当国家需要不同的实体邮件格式时，请使用单独的活动。
英国和北爱尔兰可以使用一个共享活动。美国需要一个单独的活动。
如果一个国家没有收到邮件，我该怎么办？
确保所选的 ZAP~POST 活动在其名称中包含联系人的国家或公认的缩写。还要确认该活动是活动的，并且已发布艺术作品。
如果问题仍然存在，请联系 Omnisend 支持，提供联系人 ID 和 ZAP~POST 活动名称。
还有更多问题吗？ 我们的支持专家通过应用内聊天或电子邮件随时为您服务，邮箱为[email protected]