關於整合的常見問題 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.