开发人员入门 get-started-developers

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

作为​开发人员，您负责将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测试变体），而无需可视化编辑器或页面发布工作流程。

浏览 🔗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

返回角色和职责概述 ·返回开始