用途:引导用户完成一次完整的数据集成配置,从创建认证凭证,到配置连接、创建作业。同时处理导入(数据流入 Lytics)与导出(数据流出到外部平台)。适用于需要新增或配置数据集成时。
环境要求:需要已认证的 API 访问,凭证解析参见 ../references/auth.md。
输入:所需集成的描述(平台、方向、数据类型);可选凭证、要导出的分群、调度偏好。
流程概览:
- 先判断是否建议使用 integration-advisor 技能,若为全新集成或涉及工作流选择、字段映射,可先做策略性引导;若请求明确(如“用工作流 X 和认证 Y 创建作业”)则直接进行。
- 识别集成类型:平台(Facebook、Google、Salesforce、Klaviyo 等)、方向(导入/导出)、数据类型(受众、事件、画像、转化)。
- 检查可用 provider:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/provider" -H "Authorization: ${LYTICS_API_TOKEN}",找到目标平台对应 provider。
- 检查已有认证:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth" -H "Authorization: ${LYTICS_API_TOKEN}"。
- 如无认证,使用 connection-manager 技能创建凭证,并告知目标平台需要哪些凭证。
- 创建或选择连接:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" -H "Authorization: ${LYTICS_API_TOKEN}"。
- 使用 job-manager 技能配置作业:匹配集成类型的工作流、平台专属配置、关联认证 ID、导出时填分群 ID。
- 确认关卡:展示认证 provider 详情(类型,不含凭证)、连接配置、作业设置(工作流、调度、分群),以及每个待创建资源的原始 API 载荷。
- 批准后按顺序执行:认证(如新建)、连接(如新建)、作业,并返回各资源的成功链接。
常见模式:受众导出(选/建分群,配置带 segment_id 的导出作业,设置调度如持续或每日);数据导入(配置数据源连接,扫描连接以发现可用数据,创建带字段映射的导入作业);转化 API(CAPI,配置广告平台认证,创建转化导出作业,将 Lytics 事件映射到平台转化事件)。
错误处理:缺凭证时引导用户在目标平台查找;认证无效时建议重建凭证;找不到工作流时列出该平台可用工作流;找不到分群时先用 audience-builder 创建。
依赖:组合 connection-manager 技能、job-manager 技能、../references/confirmation-gate.md;参考 ../references/auth.md;相关 audience-builder 技能(用于创建待导出的分群)。具体命令与接口路径以原文为准。