有关集成的常见问题解答 vendor-integration-faq

集成在Journey Optimizer中做什么？

它将外部数据源连接到Journey Optimizer，以便您可以将内容和数据从第三方系统拉入到营销活动和历程中，并使用该数据个性化消息。

➡️ 了解有关集成概述的更多信息

谁配置集成，以及谁在内容中使用集成？

管理员创建和激活技术配置（配置 > 集成 > 管理 > 创建集成）。 营销人员在文本或HTML组件中使用​添加个性化，打开​集成，选择活动集成，并映射属性。

➡️ 了解有关管理员和营销人员工作流的更多信息

我该如何作为管理员在UI中创建或管理集成？

转到左侧菜单中的​ 配置 ​部分，从​ 集成 ​卡中打开​管理，然后选择​创建集成。

➡️ 了解有关创建集成的更多信息

集成的常见用例有哪些？

示例包括忠诚度系统中的奖励积分、产品价格信息、推荐引擎中的推荐以及物流更新（如投放状态）。

➡️ 了解有关第三方系统示例数据的更多信息

➡️ 了解有关供应商集成示例的更多信息

如何以管理员身份在高级别配置集成？

请提供名称和描述、API端点URL（可以选择包含路径变量）、路径模板值、GET​或​POST、可选标头和查询参数、身份验证方法、策略设置（例如超时和可选缓存或重试）、映射到字段的示例JSON响应，然后运行​ 发送测试连接 ​和​激活（如果有效）。

➡️ 了解有关集成配置的更多信息

支持哪些身份验证类型？

这些身份验证类型可用： 无身份验证、API密钥、基本身份验证​和​OAuth 2.0（在适用的情况下，带有OAuth的有效负载配置）。

➡️ 了解有关身份验证类型的更多信息

响应有效负载步骤用于什么？

粘贴示例JSON响应，以便系统检测数据类型，并且您可以选择在消息中公开哪些字段进行个性化。 您可以限制营销人员在创作期间可用的字段。

➡️ 了解有关响应有效负载映射的更多信息

营销人员如何向消息添加集成？

在营销活动或历程内容中，对文本或HTML组件使用​添加个性化，转到​集成，选择集成，然后保存。 利用个性化编辑器中的Pills模式，您可以将值映射到配置中的变量（例如URL中的标头或查询参数或路径变量）。

➡️ 了解有关集成个性化的更多信息

我可以在历程和营销活动中使用集成吗？

可以。 在当前产品限制内，该功能可用于​ 出站 ​渠道（例如电子邮件、短信和推送）的历程和营销活动。

➡️ 了解有关历程和营销活动的更多信息

我可以在可重用片段中使用集成吗？

片段支持集成功能。

➡️ 了解有关片段的更多信息

哪些渠道支持集成？

支持​ 出站 ​渠道（例如电子邮件、短信和推送）。

➡️ 了解有关受支持渠道的更多信息

支持哪些API响应格式？

对于API调用响应，字段映射支持​ JSON ​和​HTML。 原始二进制图像输出和非JSON格式不适用于此工作流。

➡️ 了解有关JSON和响应格式的更多信息

我可以连接到哪些API模式？

支持针对特定内容的​检索 API。 此集成模型不支持​列表 API（宽列表或分页模式）。

➡️ 了解有关检索与列出API的更多信息

配置集成需要什么权限？

要开始使用集成，需要向用户授予​ 管理AJO集成配置 ​和​ 查看AJO集成配置 ​权限。

➡️ 了解有关集成权限的更多信息

集成是否会取代Experience Platform源的Adobe Journey Optimizer连接器？

不是。 集成​用于您从API驱动的消息内容中的个性化字段。 源​和其他数据摄取功能有不同的用途（例如，批量数据摄取和配置文件扩充）。 将每种功能用于其目标范围。

➡️ 了解更多有关集成的用途

➡️ 了解有关Experience Platform源的更多信息

为什么测试连接失败或保持无效？

验证端点URL、HTTP方法、路径模板、标头和查询参数、身份验证以及策略超时。 调整后使用​发送测试连接。 对于有效负载问题，请确保示例反映有效的JSON，并且所选字段与API返回的内容匹配。

➡️ 了解有关测试连接和负载验证的更多信息

为什么营销人员在选取器中看不到我的集成？

集成必须在成功测试后​激活。 当营销人员打开​ 集成 ​时，仅显示活动的集成。 如果集成仍处于草稿或非活动状态，请先完成激活。

➡️ 了解有关测试连接和激活的更多信息

哪些供应商示例可用，以及谁负责保护API？

您可以与公开兼容API端点的任何第三方平台集成。 说明性​供应商模式和配置示例可帮助您为兼容的API建模。 保护端点的责任在于第三方平台和您的团队。

➡️ 了解有关供应商集成过程的更多信息

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page answers frequently asked questions about Integrations in Adobe Journey Optimizer, covering configuration, authentication, supported channels and formats, API patterns, permissions, and troubleshooting.

Intents:

• Understand what Integrations do and who configures versus uses them
• Learn how administrators configure and marketers add an integration to message content
• Determine which channels, response formats, and API patterns are supported
• Find the permissions required to configure Integrations
• Troubleshoot a failing test connection or an integration missing from the marketer picker

Glossary:

• Integrations: Feature that connects external data sources so you can pull content and data from third-party systems into campaigns and journeys and personalize messages (product-specific)
• Add personalization: Action on a Text or HTML component that marketers use to open Integrations, choose an active integration, and map attributes (product-specific)
• Pills mode: Personalization editor mode used to map values to variables in the configuration, such as header or query parameters or path variables in the URL (product-specific)
• Retrieval APIs: APIs that target specific content, which are supported for this integration model (product-specific)
• Listing APIs: Broad list or pagination patterns, which are not supported for this integration model (product-specific)

Guardrails:

• Outbound channels are supported (for example email, SMS, and push).
• For API call responses, JSON and HTML are supported for field mapping; raw binary image output and formats that are not JSON are not available.
• Retrieval APIs that target specific content are supported; Listing APIs (broad list or pagination patterns) are not supported.
• To configure Integrations, users need the Manage AJO integration configuration and View AJO integration configuration permissions.
• Only active integrations appear when marketers open Integrations; the integration must be activated after a successful test.
• Supported authentication types: No Authentication, API key, Basic Auth, and OAuth 2.0.
• The Integrations feature is supported in Fragments.

Terminology:

• Canonical name: Integrations — Acronym: n/a — variants: external integrations, third-party integrations
• Synonyms: administrators “create and activate the technical configuration” = the setup marketers later select via “Add personalization”
• Do not confuse: “Integrations” (personalization fields in message content driven from APIs) ≠ “Sources” (Experience Platform data ingestion, such as batch ingestion and profile enrichment)
• Do not confuse: “Retrieval” APIs (supported) ≠ “Listing” APIs (not supported)

FAQ:

• Q: Which channels support Integrations? — Outbound channels (for example email, SMS, and push).
• Q: Which API response formats are supported? — JSON and HTML; raw binary image output and non-JSON formats are not available.
• Q: Which API patterns can I connect to? — Retrieval APIs that target specific content; Listing (broad list or pagination) APIs are not supported.
• Q: Can I use Integrations in reusable fragments? — Yes, the feature is supported in Fragments.
• Q: Do Integrations replace Experience Platform Sources? — No; Integrations drive personalization fields from APIs, while Sources handle data ingestion such as batch ingestion and profile enrichment.
• Q: Why do marketers not see my integration in the picker? — Integrations must be activated after a successful test; only active integrations appear.