开发人员入门 get-started-developers

在此页面上：​实施 SDK、事件流、自定义操作端点及 API，将您的应用程序连接到 Adobe Journey Optimizer，从而使您的历程能够基于实时数据运行。

作为​开发人员，您负责将Adobe Journey Optimizer实施并集成到您的应用和系统中。 系统管理员和数据工程师为您授予访问权限并准备好环境后，您就可以开始使用 Adobe Journey Optimizer。

您在 Journey Optimizer 生态系统中的角色

当其他团队成员通过用户界面配置 Journey Optimizer 时，您将专注于以下方面：

您的数据工程师将处理数据架构、事件配置和数据源。 您的管理员将设置权限和渠道配置。 营销人员将设计使用您所实现的历程与内容。

本指南涵盖必要的技术实施步骤，助您开始使用 Journey Optimizer。 无论您是构建移动应用程序、web 体验还是 API 集成，请按照以下部分设置您的实施内容。

先决条件 prerequisites

在开始实施之前，请确保您具备以下条件：

理解技术基础 technical-foundation

在深入实施之前，请先熟悉以下核心技术概念：

设置移动应用集成 mobile-integration

配置 Adobe Experience Platform Mobile SDK

Mobile SDK 是您直接在 iOS 或 Android 应用程序中嵌入的库集合。它充当应用程序与 Adobe Experience Platform 之间的通信层：它可识别用户、收集行为事件，并传递来自 Journey Optimizer 的指令 – 包括推送通知、应用内消息和个性化内容。如果没有它，Journey Optimizer 将无法了解您的应用程序用户的行为，也无法联系到他们。

此页面提供了配置推送通知的详细步骤。

实施基于代码的体验 (Mobile SDK)

通过基于代码的体验，您可以向原生移动应用程序中的任何位置交付个性化内容，从引导屏幕和产品详细信息页面，到应用程序内横幅和功能标记，而无需发布新的应用程序版本。使用 Mobile SDK 在运行时获取和呈现个性化内容，让您的团队可以完全控制投放位置和呈现方式：

实施 web 体验 web-implementation

设置 Adobe Experience Platform Web SDK

Web SDK (alloy.js) 是单个 JavaScript 库，可替代您的网站原本可能需要的一堆零散的 Adobe 标记。它会收集行为数据，通过您配置的数据流将其传输到 Adobe Experience Platform，并接收返回的个性化指令，这一切都在一次网络往返中完成。设置完毕后，Journey Optimizer 即可识别访客、根据其操作触发历程，并立即向您的页面交付定制内容。

实施基于代码的体验 (Web SDK)

与营销人员完全控制布局的可视化渠道不同，基于代码的体验可让您完全掌控页面上个性化内容的呈现方式。Journey Optimizer 会返回包含个性化数据的 JSON 有效负载；您的代码决定要在何处以及如何显示该有效负载。此模型适用于任何Web表面（主页横幅、推荐轮播、搜索结果排名、A/B测试变体），而无需可视化编辑器或页面发布工作流程。

浏览 ](https://github.com/adobe/alloy-samples/tree/main/ajo){target=“_blank”}GitHub 上的实施示例[，了解实际应用中的基于代码的体验。

进一步了解基于代码的体验快速入门。

实施事件流 event-streaming

发送事件以触发历程

历程在事件上运行 — 用户登录，将项目添加到购物车，完成购买，放弃表单。 你的工作是适时地从你的应用程序中发出这些事件。 每个事件都是发送到 Experience Platform 流式引入 API 的 XDM 结构化 JSON 有效负载；Journey Optimizer 在毫秒内选取它，并将配置文件路由到任何匹配的历程。事件架构和有效负载结构由您的数据工程师定义 — 在开始编码之前与他们协调。

通过 API 发送事件的​实施示例：

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

进一步了解处理历程事件。

开发自定义操作端点 custom-actions

当历程达到自定义操作步骤时，Journey Optimizer 会对您提供的 URL（您的后端、CRM、忠诚度平台、任何 REST 端点）进行出站 HTTP 调用。您的工作是构建并公开该端点：定义请求合约（负载结构、身份验证方法、响应格式），实施其背后的业务逻辑，并确保它可以处理 Journey Optimizer 将生成的调用量。然后，您的管理员会在 Journey Optimizer 中注册该端点，以便营销人员可以将其用作其历程中的步骤。

示例用例：使用自定义操作将历程事件写入 Experience Platform。

使用 Journey Optimizer API apis

并非所有事情都需要通过 Journey Optimizer UI 发生。有时，您需要从自己的后端触发营销活动、在隐私请求后禁止显示电子邮件地址，或从外部 CMS 同步内容模板。 Journey Optimizer 的 REST API 允许您以编程方式访问平台的核心功能。所有调用都使用 OAuth 服务器到服务器身份验证 — 旧版 JWT 方法已弃用。

测试与调试 testing

在实施上线之前，您需要确信事件会在正确的时间触发，历程会按预期触发，自定义操作会在实际负载下运行，并且个性化内容会正确呈现。 本节介绍用于及早发现问题的工具和技术，从低级别的SDK日志记录到使用真实用户档案进行的端到端历程测试运行。

高级开发人员主题 advanced-topics

在您的核心 SDK、事件和 API 准备就绪后，这些主题将帮助您更进一步：在运行时扩充历程数据而不会导致轮廓臃肿，处理同意信号以使选择退出的操作传播到每个集成点，调整您的实施以达到生产规模所需的吞吐量和可靠性。

处理上下文数据和扩充

历程通常需要的数据多于触发事件中提供的数据 — 产品名称、忠诚度等级和订单行项目列表。 上下文扩充允许您的历程在运行时从 AEP 数据集中查找此类数据，或从自定义操作响应中将其承接过来，而不是将所有这些数据预先加载到每个轮廓中。然后，您的消息和分支条件可以引用该数据，而无需将其永久存储在轮廓中。

处理同意与治理

Journey Optimizer 在平台级别实施数据治理和同意策略，但您的集成也需要尊重它们。当客户选择退出营销通信，或当数据使用标签限制字段的使用方式时，这些规则需要在自定义操作和数据集查找中传播 — 而不仅仅是在 UI 中阻止操作。

优化与最佳实践

生产Journey Optimizer实施每秒会定期处理数百万个事件和数千次旅程执行。 这些资源可帮助您针对该规模调整集成 — 在点击速率限制之前了解这些限制，避免静默丢弃用户档案的常见历程设计隐患，以及构建可正常降低而不是不透明地失败的错误处理。

调用 Journey Optimizer REST API rest-apis

除了实施 SDK 和事件流之外，您还可以以编程方式从您自己的系统中驱动 Journey Optimizer。完整的 API 引用、OpenAPI 规格和代码示例可在 Journey Optimizer 开发人员门户上找到。

API 触发的营销活动 api-triggered

使用交互式消息执行REST API触发来自外部系统的事务性或营销消息。 在调用端点之前：

API引用 · 代码示例 · 使用API触发的营销活动

外部端点的上限和限制 capping-throttling

当历程通过自定义操作或数据源调用外部系统时，上限和限制 API 会保护这些系统免受过载。设置上限可拒绝超出配置限制的调用；限制可调用排队长达 6 小时（仅生产沙盒、自定义操作）。

上限API引用 · 使用上限API · 使用限制API

更多 REST API more-rest-apis

除了消息传递和上限之外，Journey Optimizer 还公开 REST 端点，以用于禁止管理、内容模板、营销活动检索、校对，以及编排营销活动的执行。当您需要自动执行操作而这些操作原本需要在 UI 中手动完成时，请使用这些选项 — 例如，在数据提取后批量隐藏地址，或从外部内容管道同步模板

|验证数据集并触发编排的活动执行 | 数据集验证 · 触发器 · 启用数据集 |

其他资源 additional-resources

跨角色协作 next-steps

您的实施工作与其他团队成员相互关联：

开始实施

准备好开始构建了吗？ 从以上部分中选择您的首个实施领域：

每个部分都包含指向详细技术文档、代码示例和教程的链接，以指导您的实施工作。

其他角色指南 other-role-guides

返回角色和职责概述 · 返回快速入门