如何将AWS Pinpoint旅程用户迁移至新旅程？技术问询

关于CLOSED状态设置失败的原因排查 #

• 确认AWS SDK for PHP的参数使用是否正确：最新版SDK中，CLOSED状态需使用Aws\Pinpoint\Enum\JourneyState::CLOSED枚举常量，而非直接传入字符串'CLOSED'，直接传字符串会触发API不支持的报错。
• 检查旧旅程的当前配置：CLOSED状态仅能设置给已启动且运行中的旅程，且需满足任一前置条件：

  • 旅程已过预定结束时间
  • 旅程已过预定开始时间，且入口活动设置为"永不添加新细分受众成员"
    若旧旅程不满足上述条件，调用updateJourneyState设置CLOSED会被API拒绝。

为什么无法直接迁移用户到新旅程 #

AWS Pinpoint Journeys的设计逻辑中，每个用户的旅程上下文（当前所处节点、等待时长、已完成步骤记录等）与原旅程绑定，没有原生支持将正在进行中的用户直接转移到新旅程的功能。直接停止旧旅程会终止所有未完成的活动执行，导致用户卡在当前节点。

可行的补救方案 #

1. 修复旧旅程状态，让现有用户完成流程
   先解决CLOSED状态设置问题，将旧旅程设为CLOSED而非直接停止：

   • 替换状态参数为SDK枚举常量
   • 若旅程不满足CLOSED前置条件，先修改旧旅程的入口活动为"永不添加新细分受众成员"，再尝试设置CLOSED状态。设置成功后，旧旅程会拒绝新用户加入，但已在旅程中的用户会继续完成剩余步骤。

2. 新旅程兼容旧用户的未完成进度
   导出旧旅程中当前活跃的用户列表，创建自定义细分受众群：

   • 在新旅程中添加分支逻辑活动，根据用户属性中记录的已完成步骤数，让用户直接跳转到对应的步骤（比如已完成3天步骤的用户直接进入第4天活动节点）
   • 将该自定义细分受众群导入新旅程，让用户从当前进度继续完成入门流程，无需重新开始。

3. 双旅程并行过渡
   保持旧旅程CLOSED状态运行至所有用户完成流程，同时新旅程接收所有新用户，待旧旅程无活跃用户后再彻底删除旧旅程。

内容的提问来源于stack exchange，提问作者David Woodworth