範例廠商組態 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的下載順序樣式路徑；您的租使用者可能會改用https://app.salsify.com/api/v1/orgs/{org_id}/products/{salsify_id}或類似專案。 在Salsify developers中確認。

路徑引數

標頭

驗證

適用下列先決條件：

• 棧疊API金鑰、傳遞Token、環境名稱和內容型別UID。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• 此模式使用REST JSON進行欄位對應；GraphQL傳送會遵循不同的整合路徑。
• 使用與生產環境相適應的傳遞權杖；預覽和發佈的流程不可互換。

整合欄位範例。 請參閱Contentstack內容傳送API。

路徑引數

驗證

Contentstack需要​ 兩個 ​金鑰做為傳遞要求的標頭。

查詢引數

適用下列先決條件：

• PIM基底URL和OAuth使用者端；產品UUID或識別碼策略。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• PIM回應可能會很大。 僅對應個人化所需的屬性。
• 寫入作業不在典型的唯讀個人化範例的範圍內。

範例模式： https://{pim-host}/api/rest/v1/products-uuid/{uuid}與Accept: application/json。 請參閱Akeneo API。

路徑引數

標頭

查詢引數

驗證

適用下列先決條件：

• 執行個體URL和權杖或基本驗證；工作區和傳遞路徑。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• REST傳遞URL取決於已安裝的Magnolia模組和設定。

範例模式： https://{domain}/magnoliaAuthor/.rest/delivery/...或公開傳遞導覽樣式URL。 您的路徑取決於已安裝的模組。 請參閱Magnolia檔案。

標頭

驗證

注意：傳送API是用於不需要登入的內容之其餘匿名角色。 為了安全存取受保護的資料，建議使用更健全的方法，例如API Token或OAuth 2.0。

適用下列先決條件：

• 應用程式ID和密碼（依地區/叢集）；清楚說明您呼叫的忠誠度或行銷活動端點。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• 避免在面對客戶的錯誤或訊息內容中公開內部促銷活動或行銷活動識別碼。
• 套用應用程式層級的速率限制。 依據驗證指引設定重試和快取。

整合欄位範例。 完整參考： Voucherify API。

路徑引數

標頭

查詢引數

驗證

適用下列先決條件：

• API金鑰和部署特定的基底URL；應用程式或促銷活動範圍的識別碼。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• 工作階段密集型流程可能需要仔細對應至整合請求模型。
• 請參閱Talon.One速率限制和冪等指引。

路徑引數

標頭

查詢引數

驗證

適用下列先決條件：

• 棧疊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中的管理員存取權以建立整合。

下列限制和排除專案適用：

• 就地編輯WYSIWYG中的Journey Optimizer樣板範本在此不說明。
• 範本裝載中的大型或複雜HTML可能需要安全性審查和淨化。

適用下列先決條件：

• 來自您合約的基本URL和認證；可能的話，請使用最低許可權的API使用者。
• Journey Optimizer中的管理員存取權。

下列限制和排除專案適用：

• 端點因Marigold產品而異。 驗證Marigold是否支援您的部署。
• 回應中的個人資料必須符合您的DPA和保留政策。

基礎主機依存於區域（例如https://{{customername}}.module.slgnt.eu或https://{{customername}}.module.slgnt.us）。 使用Marigold確認您部署的路徑。

路徑引數

標頭

驗證

適用下列先決條件：

• 目標與建議；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帳戶團隊的檔案，請勿部署。

範例模式： https://{your-instance}.epsilon3.io/api/v1/planning/events具有start和end查詢引數以及標頭型API金鑰。 生產前先向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.