Criteo 是一个面向广告的个性化重定向平台,帮助营销人员通过定制广告重新触达网站访客。本技能通过 Membrane CLI 与 Criteo 交互,Membrane 自动处理认证和凭据刷新,用户可专注于集成逻辑而非认证管道。官方文档位于 https://developers.criteo.com/。
主要涉及对象包括:Advertisers、Campaigns、Bids、Budgets、Audiences、Products、Reports。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;随后登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后用 membrane login complete <code> 结束。连接 Criteo:membrane connection ensure "https://criteo.com" --json,用户需在浏览器完成认证;若连接处于 BUILDING 状态,使用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。
搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。
当预置动作无法覆盖需求时,可通过 Membrane 代理直接向 Criteo API 发请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
最佳实践:优先使用 Membrane 与外部应用通信;先发现再构建,运行 action list --intent 查找现有动作;让 Membrane 处理凭据,不要向用户索要 API 密钥或令牌。
限制:具体可用动作、参数与返回结构需通过 action list 查询,资料未逐一列出;认证方式依连接返回的 clientAction 而定。