示例供应商配置 vendor-integration

以下先决条件适用：

• 具有投放API访问和面向读取的API密钥的充满内容的空间。
• 清除内容类型和字段ID；可在Journey Optimizer中拥有管理员访问权限以创建集成。

以下限制和排除项适用：

• 广泛列出或分页的内容性API不适合此模式；首选针对特定条目或资产的检索调用。
• 回写同步或双向同步超出了此示例的范围。

集成字段示例（与共享空间和环境的内容交付API一致）：

路径参数

标头

身份验证

以下先决条件适用：

• 租户URL和凭据（每个API表面的持有者或令牌）。
• Journey Optimizer中的管理员访问权限以创建集成。

以下限制和排除项适用：

• 主机名和路径因Sitecore产品而异。 仅使用租户公开的端点。
• OAuth访问令牌、刷新和生命周期必须遵循Sitecore安全策略。

在Journey Optimizer中配置此示例调用时，请使用以下字段。 在Sitecore文档中确认您的产品（Content Hub、XM Cloud等）的主机名和API版本。

路径参数

标头

身份验证

以下先决条件适用：

• API令牌和组织上下文；可从配置文件或上下文解析的产品ID。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 非常大的目录：如果集成需要按实体进行检索，请避免使用批量列表端点。
• Salsify角色权限可限制属性可见性。

一些较旧的引用为Salsify重复使用了下载顺序样式路径；您的租户可能使用https://app.salsify.com/api/v1/orgs/{org_id}/products/{salsify_id}或类似路径。 在Salsify开发人员中确认。

路径参数

标头

身份验证

以下先决条件适用：

• 栈栈API密钥、投放令牌、环境名称和内容类型UID。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 此模式使用REST JSON进行字段映射；GraphQL交付遵循不同的集成路径。
• 使用适合生产的投放令牌；预览和发布的流不可互换。

集成字段示例。 请参阅Contentstack内容交付API。

路径参数

身份验证

Contentstack需要​ 两个 ​密钥作为投放请求的标头。

查询参数

以下先决条件适用：

• PIM基本URL和OAuth客户端；产品UUID或标识符策略。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• PIM响应可能会很大。 仅映射个性化所需的属性。
• 写操作不在典型的只读个性化示例的范围之内。

示例模式：带有Accept: application/json的https://{pim-host}/api/rest/v1/products-uuid/{uuid}。 查看Akeneo API。

路径参数

标头

查询参数

身份验证

以下先决条件适用：

• 实例URL和令牌或基本身份验证；用于投放的工作区和路径。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• REST投放URL取决于安装的Magnolia模块和配置。

示例模式： https://{domain}/magnoliaAuthor/.rest/delivery/...或公共投放导览样式的URL。 您的路径取决于已安装的模块。 请参阅木兰文档。

标头

身份验证

注意：投放API对不需要登录的内容使用rest-anonymous角色。 要安全地访问受保护的数据，最好使用更可靠的方法，如API令牌或OAuth 2.0。

以下先决条件适用：

• 应用程序ID和密码（按区域/群集）；明确您呼叫的忠诚度或营销活动端点。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 避免在面向客户的错误或消息内容中暴露内部促销活动或营销活动标识符。
• 应用级别的速率限制适用。 根据验证指南配置重试和缓存。

集成字段示例。 完整引用： Voucherify API。

路径参数

标头

查询参数

身份验证

以下先决条件适用：

• API密钥和特定于部署的基本URL；应用程序或营销活动范围的标识符。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 会话密集型流可能需要仔细映射到集成请求模型。
• 请遵守Talon.One速率限制和幂等指南。

路径参数

标头

查询参数

身份验证

以下先决条件适用：

• 栈叠URL和API凭据；根据需要栈叠URL和API凭据；程序或商店标识符。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 客户PII必须根据Antavo协议和您的隐私政策进行处理。
• 使用Antavo为您的环境确认API版本和稳定的端点。

示例集成字段使用​ 暂存 ​主机；生产使用您的Antavo栈栈主机名。 请参阅Antavo文档。

路径参数

标头

身份验证

以下先决条件适用：

• Salesforce实例、连接的应用程序或集成用户，以及适用于您组织的OAuth。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 必须在集成中设计Salesforce API限制和OAuth令牌刷新。
• 字段级安全和共享规则可管理API响应中显示的字段。

使用针对贵组织API版本记录的忠诚度管理​成员配置文件 GET操作；路径包括程序和成员标识符。 查看Salesforce开发人员。

路径参数

标头

查询参数

*至少需要三个中的一个。

身份验证

以下先决条件适用：

• API主机和身份验证（通常为已签名的请求；遵循毛细管文档）。
• 端点的程序标识符。

以下限制和排除项适用：

• 身份验证方案和区域主机因部署而异。 用毛细管确认你的烟囱。

示例： https://ushc.intouch.capillarytech.com/api/v3/rewards/{reward_id}（主机因地区而异）。 使用毛细管验证主机和身份验证方案。

路径参数

标头

身份验证

以下先决条件适用：

• 具有API访问权限的模板帐户，以及使用定义的令牌发布的模板。
• Journey Optimizer中的管理员访问权限以创建集成。

以下限制和排除项适用：

• 此处不介绍如何在Journey Optimizer中就地编辑模具模板的WYSIWYG。
• 模板有效负载中的大型或复杂HTML可能需要安全审查和整理。

以下先决条件适用：

• 合同中的基本URL和凭据；可能时，提供权限最低的API用户。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 端点因Marigold产品而异。 验证您的部署是否支持Marigold。
• 响应中的个人数据必须符合您的DPA和保留策略。

基础主机依赖于区域（例如https://{{customername}}.module.slgnt.eu或https://{{customername}}.module.slgnt.us）。 使用Marigold为您的部署确认路径。

路径参数

标头

身份验证

以下先决条件适用：

• 具有推荐的Target；IMS组织和支持的身份验证。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 推荐和投放API需要特定参数（例如mbox或产品标识符）。 请按照Adobe Target文档中的说明进行操作。
• 调整发送卷和用例的延迟和缓存。

路径参数

标头

查询参数

身份验证

请参阅Target身份验证配置并将JSON添加到有效负载。

请求有效负载

{
  "id": {
    "tntId": "<YOUR_TENANT_ID>"
  },
  "context": {
    "channel": "web",
    "address": {
      "url": "https://example.com/store.html"
    },
    "screen": {
      "width": 1200,
      "height": 1400
    }
  },
  "experienceCloud": {
    "analytics": {
      "logging": "server_side",
      "supplementalDataId": "<supDataId>",
      "trackingServer": "sstats.adobe.com"
    }
  },
  "execute": {
    "pageLoad": {
      "parameters": {
        "pageType": "checkout",
        "preferredCurrency": "$"
      }
    },
    "mboxes": [
      {
        "index": 1,
        "name": "orderConfirmPage"
      }
    ]
  },
  "prefetch": {
    "views": [
      {
        "parameters": {
          "ad": "view"
        }
      }
    ],
    "mboxes": {
      "index": 1,
      "name": "SummerOffer"
    }
  }
}

以下先决条件适用：

• API订阅和密钥；位置密钥或城市搜索流。
• Journey Optimizer中的管理员访问权限以创建集成。

以下限制和排除项适用：

• 确认AccuWeather订阅层的JSON响应形状；集成映射JSON响应中的字段。
• 观察AccuWeather速率限制和建议的缓存。
• 在预测调用之前，解决locationKey通常需要单独的地理位置或城市搜索请求。

集成字段示例。 AccuWeather API中介绍了详细信息和层。 您通常通过单独的位置搜索调用（例如.../locations/v1/cities/search?q={{cityName}}）解析locationKey。

路径参数

标头

查询参数

身份验证

以下先决条件适用：

• API密钥和密钥（按ShipStation文档的基本身份验证）。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 不要在消息内容中公开ShipStation API密钥；仅在集成配置中保留凭据。
• 分页列表端点可能不太适合集成；如果可能，首选单资源GET。

以下​ 获取计时器 ​示例演示了一个ShipStation自动化计时调用。 在Journey Optimizer中重现时，请使用ShipStation集成指南中的确切路径和身份验证。

标头

身份验证

请求有效负载

{
    "external_batch_id": "se-28529731",
    "batch_notes": "This is my batch",
    "shipment_ids": [
      "se-28529731"
    ],
    "rate_ids": [
      "se-28529731"
    ]
}

以下先决条件适用：

• 密钥API密钥和应用程序标识符；配置文件与RevenueCat客户ID之间的稳定映射。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 保护机密API密钥并遵循您的轮换策略。
• 订阅和授权数据是敏感的。 满足隐私和同意要求。

示例模式：将RevenueCat的​从RevenueCat文档获取产品 （或等效产品/权利GET）与项目的基本URL和版本一起使用。

路径参数

标头

查询参数

身份验证

以下先决条件适用：

• 每个组织策略的Workspace主机、令牌或OAuth；具有最小范围的服务主体。
• Journey Optimizer中的管理员访问权限。

下面的​ GET ​作业示例具有说明性；对于SQL驱动的个性化，首选您的工作区支持的语句执行API模式。

标头

查询参数

以下先决条件适用：

• 门户域和OAuth客户端（或批准的令牌方法）。
• 只读访问权限的范围；Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 分页和OAuth令牌刷新必须遵循Bynder的API规则。
• 大型分页响应：仅映射个性化所需的字段。

集成字段示例。 有关OAuth 2.0有效负载的详细信息，请参阅Bynder API文档。

路径参数

标头

查询参数

身份验证

{
    "type": "oauth2",
    "endpoint": {
        "uri": ""
    },
    "method": "get",
    "response": {
        "type": "json"
    },
    "request": {
        "header": [
            {
                "key": "client_id",
                "value": ""
            },
            {
                "key": "client_secret",
                "value": ""
            }
        ],
        "queryParams": [
            {
                "key": "grant_type",
                "value": ""
            },
            {
                "key": "scope",
                "value": ""
            }
        ],
        "payload": {
            "type": "json",
            "content": {}
        }
    },
    "credentialPaths": [
        "header.client_id",
        "header.client_secret",
        "queryParam.scope"
    ],
    "tokenPath": "message.token",
    "policy": {
        "timeoutInMilliseconds": 30000,
        "cache": {
            "enabled": true,
            "ttlInSeconds": 300
        },
        "retry": {
            "enabled": false
        }
    },
    "locationConfig": {
        "key": "x-token",
        "location": "query"
    }
}

以下先决条件适用：

• API密钥和批准的使用案例；用于查询的业务标识符。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 使用Trustpilot数据必须符合Trustpilot品牌和数据使用政策。
• 速率限制适用于审核摘要和相关端点。

将Trustpilot开发人员的类别列表操作用于您的集成模式；参数因资源而异。

标头

查询参数

身份验证

以下先决条件适用：

• 合同中的API密钥和客户端标识符。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 评级和评论的显示必须遵循Bazaarvoice内容策略。
• 速率限制和缓存规则适用于每个API密钥。

示例入口点： https://api.bazaarvoice.com/data/products.json具有版本和筛选查询参数。 查看Bazaarvoice开发人员。

标头

身份验证

查询参数

以下先决条件适用：

• API凭据和区域基本URL；对消息传递中使用的字段进行法律批准。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 同意和偏好设置数据受到严格监管。 与隐私和法律团队协调。
• API路径和负载因OneTrust产品而异。 使用订阅文档。

路径参数

标头

查询参数

以下先决条件适用：

• 具有正确权限的系统用户或应用程序令牌；Business Manager一致性。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 短期访问令牌需要适合服务器端集成的续订或长期策略。
• 遵守Meta平台条款；请勿在消息负载中记录令牌或其他密钥。

集成字段示例。 有关版本控制和访问令牌，请参阅Graph API。

路径参数

标头

查询参数

以下先决条件适用：

• 租户URL和凭据（根据您的设置，为OAuth或API密钥）。
• Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• Aprimo字段级安全性必须与您在Journey Optimizer中映射的属性保持一致。
• 大型HAL或JSON负载：将映射字段限制为所需的最小值集。

路径参数

标头

身份验证

以下先决条件适用：

• 来自Epsilon的凭据和端点；Journey Optimizer中的管理员访问权限。

以下限制和排除项适用：

• 端点和主机特定于客户。 如果没有来自Epsilon帐户团队的文档，请勿部署。

示例模式：带有start和end查询参数以及基于标头的API密钥的https://{your-instance}.epsilon3.io/api/v1/planning/events。 在生产之前使用Epsilon确认。

路径参数

标头

查询参数

*对于eventType = unscheduled是可选的，对于exclude_recurrences = true是可选的。

身份验证

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 provides sample, Adobe-tested configurations for connecting Adobe Journey Optimizer Integrations to third-party vendors across content, loyalty, recommendation, data, and consent platforms.

Intents:

• Use Integrations with any external platform that exposes a compatible API
• Follow a sample vendor configuration and its example integration fields
• Configure an integration through Configurations > Manage > Create Integration
• Reproduce vendor request details (URL, HTTP method, authentication, path/query/header parameters) as example patterns

Glossary:

• Sample integration fields: Example request values (URL, HTTP method, path/query/header parameters, authentication) provided per vendor to model a compatible API (product-specific)
• Create Integration: Action under Configurations > Manage used to start a new integration configuration in Journey Optimizer (product-specific)
• Example pattern: A vendor configuration independently tested by Adobe that is not maintained or formally supported by the vendor (product-specific)

Guardrails:

• Customers are responsible for ensuring that their use of the AJO Integrations feature and any associated third-party vendors or integrations complies with all applicable laws and regulations, such as HIPAA.
• Each vendor configuration example was independently tested by Adobe as an example pattern; it is not maintained or formally supported by the vendor, so confirm current API details with the vendor documentation.
• Enter an integration name without spaces.
• Prefer single-resource or single-product retrieval over broad list, bulk, or pagination endpoints.
• Map only the attributes required for personalization; large PIM, HAL, or JSON payloads should be restricted to the minimum field set.
• Do not embed secrets or API keys in message content; store and rotate credentials per your policies.

Terminology:

• Canonical name: Sample Vendor configurations — Acronym: n/a — variants: vendor integration patterns, sample integration fields
• Synonyms: “example pattern” = “sample configuration”
• Do not confuse: a configuration “independently tested by Adobe as an example pattern” ≠ a configuration “maintained by or formally supported by” the vendor
• Do not confuse: “GET” retrieval calls (typical for most vendor patterns) ≠ “POST” calls (used for delivery calls such as Adobe Target Recommendations)

FAQ:

• Q: Are these vendor configurations officially supported by the vendors? — No; they were independently tested by Adobe as example patterns and are not maintained or formally supported by the vendor. Confirm current API details with the vendor documentation.
• Q: Who is responsible for legal and regulatory compliance, such as HIPAA? — The customer is responsible for ensuring their use of Integrations and any third-party vendors complies with all applicable laws and regulations.
• Q: Must I use only the listed vendors? — No; you can use any external platform that exposes a compatible API.
• Q: Which HTTP method do the samples use? — Typically GET, unless noted otherwise; some delivery calls, such as Adobe Target Recommendations, use POST with a JSON body.