文件Journey OptimizerJourney Optimizer 指南

範例廠商組態 vendor-integration

最後更新： 2026年8月5日

建立對象：

  • Intermediate
  • User

在此頁面上：​瞭解如何將Adobe Journey Optimizer整合與任何公開相容API的外部平台搭配使用，並搭配作業護欄和說明性廠商模式來指導您的設定。

style
shade-box

客戶有責任確保其使用AJO整合功能及任何相關協力廠商或整合服務的行為符合所有適用法律及法規，例如HIPAA。

style
shade-box

快速導覽 quick-navigation

使用這些群組連結來快速跳至相關的廠商模式：

內容與CMS content-and-cms

有內容 contentful

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Contentubly維護或正式支援。 使用有爭議的檔案確認目前的API詳細資訊。

「內容」是指透過REST或GraphQL用於結構化專案和資產的Headless CMS，因此Journey Optimizer可以在傳送或開啟時提取內容。

典型的使用案例包括電子郵件中本地化的主圖區塊、替代文字和CTA，以及動態模組中的產品或促銷專案。 另一個常見模式是依ID擷取特定專案，以進行個人化傳訊。

style
shade-box
進一步瞭解內容功能的必要條件和限制。

適用下列先決條件：

  • 具有傳送API存取權及讀取導向API金鑰的充滿內容的空間。
  • 清除內容型別和欄位ID；使用Journey Optimizer中的管理員存取權來建立整合。

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

  • 廣泛列出或分頁的內容性API並不適合這種模式；偏好以特定專案或資產為目標的擷取呼叫。
  • 回寫或雙向同步處理不在本範例的範圍之內。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用內容傳送API和您的傳送Token設定​GET、貼上範例JSON、對應欄位、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用內容傳送API (CDA) URL設定端點： https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}

  5. 選取HTTP方法： GET。

  6. 新增驗證。 將​access_token 查詢​引數設定為您的內容傳送API Token，如下列​ 整合欄位範例 ​所示。 內容也接受Authorization: Bearer標題中的相同權杖；使用任何支援的整合欄位。

  7. 視需要新增路徑變數（例如，專案ID、地區設定）。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 選取個人化的必要欄位。

  10. 視需要設定逾時和快取。

  11. 測試連線並啟動。

下表列出此整合請求的範例值。

整合欄位範例

整合欄位範例（與空間和環境的內容傳送API一致）：

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://cdn.contentful.com/spaces/{{spaceID}}/environments/{{environment_id}}/entries/{{entry_id}}
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。
HTTP方法 GET

路徑引數

table 0-row-3 1-row-3 2-row-3 3-row-3
Path引數 名稱 預設值
spaceID spaceID <YOUR_SPACE_ID>
environment_id environment_id <YOUR_ENV_ID>
entry_id entry_id <YOUR_ENTRY_ID>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 access_token <YOUR_API_KEY> 查詢引數

Sitecore sitecore

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Sitecore維護或正式支援。 透過Sitecore檔案確認目前的API詳細資訊。

Sitecore Content Hub和相關雲端API支援DAM樣式的下載和中繼資料流程；以下範例模式以ID下載訂單為中心。

典型的使用案例包括電子郵件內容中的資產或下載中繼資料，以及與Sitecore中管理的DAM工作流程保持一致。

style
shade-box
進一步瞭解Sitecore的先決條件和限制。

適用下列先決條件：

  • 租使用者URL和認證（每個API表面的持有者或權杖）。
  • Journey Optimizer中的管理員存取權以建立整合。

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

  • 主機名稱和路徑因Sitecore產品而異。 僅使用您的租使用者公開的端點。
  • OAuth存取權杖、重新整理和生命週期都必須遵循Sitecore安全性原則。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 在下載順序路徑上設定​GET、設定每個Sitecore的授權標頭、從內容對應id、貼上範例JSON、對應欄位，以及調整資產延遲的逾時。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Content Hub API設定端點（範例：依ID下載訂單）。 範例URL模式：

    https://xmapps-api.sitecorecloud.io/api/v1/downloadorders/{id}

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

在Journey Optimizer中設定此範例呼叫時，請使用下列欄位。 在Sitecore檔案中確認您產品（Content Hub、XM Cloud等）的主機名稱和API版本。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://xmapps-api.sitecorecloud.io/api/v1/downloadorders/{{id}}
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
id id <id_of_download_order>

標頭

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
Authorization Authorization 常數 持有人<token> 是（開啟）
If-Modified-Since If-Modified-Since 變數 2019-08-24T14:15:22Z 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 X-Auth-Token <token> Header

Salsify salsify

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Salsify維護或正式支援。 使用Salsify檔案確認目前的API詳細資訊。

Salsify是一種PIM，具有適用於產品、管道和數位資產的API。

典型的使用案例包括電子郵件中的產品屬性或媒體URL，以及符合聯合目錄資料的訊息傳送。

style
shade-box
深入瞭解Salsify的先決條件和限制。

適用下列先決條件：

  • API權杖和組織內容；可從設定檔或內容解析的產品ID。
  • Journey Optimizer中的管理員存取權。

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

  • 非常大的目錄：如果整合需要每個實體的擷取，請避免大量列出端點。
  • 「銷售」角色許可權可限制屬性可見性。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 比起大量目錄呼叫、設定持有人驗證、貼上範例JSON、對應欄位、測試、啟動，偏好使用單一產品擷取。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Salsify Product API設定端點。 範例URL模式：

    https://api.salsify.com/v1/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

有些較舊的參考重複使用Salsify的下載順序樣式路徑；您的租使用者可能會改用https://app.salsify.com/api/v1/orgs/{org_id}/products/{salsify_id}或類似專案。 在Salsify developers中確認。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://app.salsify.com/api/v1/orgs/{{org_id}}/products/{{salsify_id}}
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
org_id org_id <org_id>
salsify_id salsify_id <salsify_id>

標頭

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
Content-Type （預設引數） Content-Type 常數 application/json 是（開啟）
Authorization Authorization 常數 Bearer <YOUR_TOKEN_HERE> 是（開啟）
If-Modified-Since If-Modified-Since 變數 2019-08-24T14:15:22Z 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 apiKey <your_api_key> Header

Contentstack contentstack

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它不是由Contentstack維護或正式支援。 使用Contentstack檔案確認目前的API詳細資訊。

Contentstack是Headless CMS；REST傳送通常用於Journey Optimizer中的JSON欄位對應。

典型的使用案例是將橫幅或促銷活動的專案與包含地區設定的引數搭配使用。

style
shade-box
深入瞭解Contentstack的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 根據Contentstack需要新增api_key和access_token標頭、包含environment查詢引數、貼上範例JSON、對應欄位、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用內容傳送API設定端點。 範例URL模式：

    https://cdn.contentstack.io/v3/content_types/{content_type_uid}/entries/{entry_uid}

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
欄位 價值
URL https://cdn.contentstack.io/v3/content_types/{{content_type_uid}}/entries/{{entry_uid}}
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。
標頭 不需要額外的標頭。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
content_type_uid 內容型別UID <your_content_type_uid>
entry_uid 進入UID <your_entry_uid>

驗證

table 0-row-3 1-row-3 2-row-3
金鑰名稱 索引鍵值 新增至
api_key <YOUR_STACK_API_KEY> Header
access_token <YOUR_DELIVERY_TOKEN> Header

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

查詢引數

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
environment 環境名稱 變數 <your_environment_name> 是（開啟）

Akeneo akeneo

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Akeneo維護或正式支援。 使用Akeneo檔案確認目前的API詳細資訊。

Akeneo PIM會公開產品、屬性和媒體的REST API。

典型的使用案例包括電子郵件模組中的受管控產品資料以及歷程中特定頻道的屬性。

style
shade-box
進一步瞭解Akeneo的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 搭配持有人權杖使用​GET、在查詢旗標中僅要求所需的屬性選項、貼上範例JSON、對應最小屬性集、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Akeneo REST API設定端點。 範例URL模式：

    https://{pim-host}/api/rest/v1/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{your-akeneo-domain}}.com/api/rest/v1/products-uuid/{{uuidProduct}}
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
uuidProduct UUID <product_uuid>

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Authorization Authorization 常數 Bearer <YOUR_TOKEN> 是（開啟）
接受 接受 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
with_attribute_options 包含屬性選項 變數 假 否（關閉）
with_quality_scores 包含品質分數 變數 假 否（關閉）
with_completenesses 包含完整性 變數 假 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization Bearer <YOUR_ACCESS_TOKEN> Header

木蘭花 magnolia

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 其並非由Magnolia維護或正式支援。 使用Magnolia檔案確認目前的API詳細資訊。

依部署而定，Magnolia提供Headless和REST傳送端點。

典型的使用案例是為行銷模組提供內容節點或片段。

style
shade-box
進一步瞭解Magnolia的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用您的模組公開的公開傳送URL模式、根據Magnolia指引進行驗證（匿名傳送與受保護內容的Token）、貼上範例JSON、對應欄位、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Magnolia REST （傳送）設定端點。 範例URL模式：

    https://{author-or-public}/.rest/delivery/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL http://{{your-domain}}/magnoliaAuthor/.rest/delivery/<myEndpoint>/travel/@nodes
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Content-Type Content-Type 常數 application/json 是（開啟）
接受 接受 常數 application/json 是（開啟）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization <bearer_token> Header

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

忠誠度和獎勵 loyalty-and-rewards

武謝里菲 voucherify

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Voucherify維護或正式支援。 使用Voucherify檔案確認目前的API詳細資訊。

Voucherify提供促銷活動和熟客REST API （行銷活動、憑單、熟客方案）。

典型的使用案例包括讀取內容中優惠方案的忠誠度或促銷狀態，以及顯示適當的層級或平衡。

style
shade-box
深入瞭解Voucherify的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 設定叢集的基底URL、新增必要的標頭(X-APP-ID、X-APP-TOKEN)、使用篩選器或ID限制清單端點、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用忠誠度/REST API設定端點。 根據Voucherify，設定您地區的​ 叢集 ​主機和路徑。 範例URL模式：

    https://{cluster}.voucherify.io/

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{cluster}}.voucherify.io/v1/loyalties/{{campaignId}}/members
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
cluster cluster <your_cluster>
campaignId campaignId <loyalty_campaign_Id>

標頭

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
X-APP-ID X-APP-ID 常數 <YOUR-APP-ID> 是（開啟）
X-Voucherify-Channel X-Voucherify-Channel 常數 Voucherify檔案 否（關閉）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5
參數 名稱 類型 值 強制
limit limit 變數 10 否（關閉）
page page 變數 1 否（關閉）
customer customer 變數 <customer_identifier> 否（關閉）
created_at created_at 變數 <iso8601_date> 否（關閉）
updated_at updated_at 變數 <iso8601_date> 否（關閉）
order order 變數 <sort_field> 否（關閉）
code code 變數 <loyalty_card_code> 否（關閉）
ids ids 變數 <array_of_ids> 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 X-APP-TOKEN <YOUR-APP-TOKEN> Header

Talon.One talon-one

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Talon.One維護或正式支援。 使用Talon.One檔案確認目前的API詳細資訊。

Talon.One是促銷和忠誠度規則引擎，使用REST API來處理工作階段、效果和設定檔。

典型的使用案例包括個人化內容中的購物車或設定檔層級的促銷活動，以及忠誠度進度或獎勵顯示。

style
shade-box
進一步瞭解Talon.One的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 在您需要的設定檔或成就路徑上使用​GET、將Authorization: ApiKey-v1 <key>設為記錄、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Talon.One整合API設定端點。 範例URL模式：

    https://{your-domain}.talon.one/v1/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例
table 0-row-2 1-row-2 2-row-2
欄位 價值
URL https://{{your-deployment}}.talon.one/v1/customer_profiles/{{integrationId}}/achievements/{{achievementId}}
HTTP方法 GET

路徑引數

table 0-row-3 1-row-3 2-row-3 3-row-3
Path引數 名稱 預設值
your-deployment your-deployment <your_deployment>
integrationId integrationId <integrationId>
achievementId achievementId <achievementId>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5
參數 名稱 類型 值 強制
progressStatus progressStatus 變數 進行中/已完成/已過期 否（關閉）
startDate startDate 變數 2024-05-29T15:04:05+07:00 否（關閉）
endDate endDate 變數 2024-05-29T15:04:05+07:00 否（關閉）
pageSize pageSize 變數 <default_page_size> 否（關閉）
skip skip 變數 <items_to_skip> 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization ApiKey-v1 <YOUR_API_KEY> Header

安塔沃 antavo

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Antavo維護或正式支援。 透過Antavo檔案確認目前的API詳細資訊。

Antavo是一種企業忠誠度平台，具有適用於成員、獎勵和事件的REST API。

典型的使用案例包括電子郵件或推播中的點數、層級或獎勵，以及忠誠度狀態所驅動的優惠。

style
shade-box
深入瞭解Antavo的先決條件和限制。

適用下列先決條件：

  • 棧疊URL和API認證；視需要程式或商店識別碼。
  • Journey Optimizer中的管理員存取權。

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

  • 客戶PII必須根據Antavo合約和您的隱私權政策處理。
  • 使用Antavo確認您環境的API版本和穩定端點。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用供應商的驗證（例如查詢中的API金鑰）設定​GET，避免公開PII違反原則、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Antavo Enterprise API設定端點。

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

範例整合欄位使用​ 暫存 ​主機；生產使用您的Antavo棧疊主機名稱。 請參閱Antavo檔案。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://api.staging.antavo.com/customers/{{customer_id}}/activities/offers
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
customer_id customer_id <customer_id>

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
接受 接受 常數 application/json 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 api_key <YOUR_API_KEY> 查詢參數

Salesforce忠誠度 salesforce-loyalty

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 Salesforce並不負責維護或正式支援此功能。 透過Salesforce檔案確認目前的API詳細資訊。

Salesforce忠誠度管理會公開Salesforce平台上的REST API，供成員、計畫和交易使用。

典型的使用案例包括顯示歷程中的層級、點數或好處，以及根據CRM和忠誠度資料調整訊息。

style
shade-box
進一步瞭解Salesforce忠誠度的必要條件和限制。

適用下列先決條件：

  • Salesforce例項、連線的應用程式或整合使用者，以及適合您組織的OAuth。
  • Journey Optimizer中的管理員存取權。

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

  • Salesforce API限制和OAuth權杖重新整理必須設計到您的整合中。
  • 欄位層級安全性和共用規則控管API回應中顯示的欄位。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用您的團隊核准的忠誠度整合端點、完成Salesforce OAuth、貼上範例JSON、對應欄位、遵守複合API限制、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Salesforce忠誠度管理REST設定端點。 範例URL模式：

    https://{instance}.salesforce.com/services/data/vXX.X/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

使用針對您組織的API版本記錄的熟客方案管理​成員設定檔 GET作業；路徑包含方案和成員識別碼。 檢視Salesforce開發人員。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{your-instance}}.my.salesforce.com/services/data/{{version}}/connect/loyalty/management/members
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
your-instance your-instance <your_instance>
version version version

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
接受 接受 常數 application/json 否（關閉）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
membershipNumber membershipNumber 變數 <membership_number> 否（關閉） *
membershipId membershipId 變數 <membership_id> 否（關閉） *
posMemId posMemId 變數 <pos_mem_id> 否（關閉） *

*至少需要三者之一。

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization <access_token> Header

毛細管 capillary

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 Capillary不負責維護或正式支援。 透過Capillary檔案確認目前的API詳細資訊。

Capillary提供零售棧疊中常見的忠誠度和參與API。

典型的使用案例包括個人化歷程中的點、層級或優惠。

style
shade-box
深入瞭解Capillary的先決條件和限制。

適用下列先決條件：

  • API主機和驗證（通常為已簽署的要求；請遵循毛細血管檔案）。
  • 端點的程式識別碼。

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

  • 驗證配置和區域主機會因部署而異。 請用「毛細管」確認您的棧疊。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 視需要設定標頭，例如CAP-API-ACCESS-TOKEN、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Capillary API設定端點。

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

範例： https://ushc.intouch.capillarytech.com/api/v3/rewards/{reward_id} （主機因地區而異）。 使用毛細管驗證主機和驗證配置。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://ushc.intouch.capillarytech.com/api/v3/rewards/{{reward_id}}
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
reward_id 獎勵ID <your_reward_id>

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Content-Type Content-Type 常數 application/json 是（開啟）
CAP-API-ACCESS-TOKEN 存取權杖 常數 <YOUR_ACCESS_TOKEN> 是（開啟）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 CAP-API-ACCESS-TOKEN <YOUR_ACCESS_TOKEN> Header

範本和傳訊 templates-and-messaging

樣板 stensul

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 Stensul不維護或正式支援該功能。 透過樣板檔案確認目前的API詳細資訊。

Stensul是用於核准範本的電子郵件建立平台；Journey Optimizer可以透過其API使用範本中繼資料和結構化區域。

典型的使用案例包括匯入核准的範本並將區域對應至設定檔屬性，以及針對可擴充的行銷活動組建重複使用受管控區塊。

style
shade-box
進一步瞭解Stensul的必要條件和限制。

適用下列先決條件：

  • 具有API存取權的範本帳戶和具有已定義權杖的已發佈範本。
  • Journey Optimizer中的管理員存取權以建立整合。

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  2. 輸入整合名稱。

  3. 使用樣板範本API URL設定端點。 範例URL模式：

    https://api.stensul.com/v1/templates/{template_id}

  4. 設定驗證（API金鑰或每個模具API檔案的OAuth）。

  5. 定義路徑變數，例如範本ID。

  6. 貼上用於欄位偵測的範例JSON回應。

  7. 將必要的範本欄位對應至Journey Optimizer個人化欄位。

  8. 測試連線並啟動。

萬用字元 marigold

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Marigold維護或正式支援。 使用Marigold檔案確認目前的API詳細資訊。

Marigold會公開忠誠度和參與API；主機會因地理位置而異（歐盟與美國的模組主機名稱）。

典型的使用案例是使用Marigold計畫的忠誠度或偏好設定資料來豐富訊息。

style
shade-box
進一步瞭解Marigold的先決條件和限制。

適用下列先決條件：

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

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

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

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 指向您地區的Marigold主機、設定驗證（下列範例使用包含金鑰和密碼的X-Api-Key）、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Marigold REST API設定端點。

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

  12. Marigold根據客戶執行個體所在的地理區域使用2個端點：

    • 歐洲： https://{{customername}}.module.slgnt.eu
    • 美國： https://{{customername}}.module.slgnt.us

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{customername}}.module.slgnt.{{locale}}/Portal/Api/organizations/{{organization}}/content/{{api_name}}
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。

路徑引數

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Path引數 名稱 預設值
customername customername <your_name>
locale locale eu / us
organization organization <your_organization>
api_name api_name <api_name>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 X-Api-Key <apiKey>:<apiSecret> Header

Adobe Target Recommendations adobe-target-recommendations

IMPORTANT
此設定是由Adobe Journey Optimizer團隊測試的說明性模式。 Adobe Target Recommendations是獨立的Adobe產品，有其自己的發行週期和API版本設定。 在生產環境中部署之前，請一律先透過Adobe Target開發人員檔案確認目前的API詳細資料。

Adobe Target包含適用於伺服器端或整合式體驗的建議與傳送API，但須視權利而定。

典型的使用案例包括將建議插入您在Journey Optimizer中撰寫的體驗，以及將索引鍵與設定檔或Experience Platform內容對齊。

➡️啟用整合後，瞭解如何在內容製作中新增整合以及在訊息範本中使用Adobe Target資料。

style
shade-box
進一步瞭解Adobe Target Recommendations的先決條件和限制。

適用下列先決條件：

  • 目標與建議；IMS組織和支援的驗證。
  • Journey Optimizer中的管理員存取權。

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

  • 推薦和傳遞API需要特定引數（例如mbox或產品識別碼）。 請依照Adobe Target檔案操作。
  • 調整傳送磁碟區及使用案例的延遲和快取。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 傳遞呼叫通常是具有JSON內文的​POST。 根據目標驗證設定OAuth、貼上範例回應、對應欄位、在預期的磁碟區下測試。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Target Recommendations/傳送API設定端點。

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例
table 0-row-2 1-row-2 2-row-2 3-row-2
欄位 價值
URL https://{{client}}.tt.omtrdc.net/rest/v1/delivery
原則 視需要設定原則層級的詳細資訊。
HTTP方法 POST

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
client client <client_name>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
使用者端 使用者端 變數 <customer_client_code> 是（開啟）
sessionId sessionId 變數 <session_identifier> 是（開啟）

驗證

參考Target驗證組態並將JSON新增至承載。

要求承載

code language-sample 
{
  "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"
    }
  }
}

資料、天氣和作業 data-weather-and-operations

AccuWeather accuweather

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 AccuWeather並不負責維護或正式支援此功能。 透過AccuWeather檔案確認目前的API詳細資訊。

AccuWeather會公開預測和位置REST API，讓訊息可包含天氣感知程式碼片段。

典型的使用案例包括電子郵件或推播中的簡短預測，以及使用與設定檔或內容繫結的預測值量身打造內容。

style
shade-box
進一步瞭解AccuWeather的先決條件和限制。

適用下列先決條件：

  • API訂閱和金鑰；位置金鑰或城市搜尋流程。
  • Journey Optimizer中的管理員存取權以建立整合。

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

  • 確認AccuWeather訂閱層級的JSON回應圖形；整合會從JSON回應對應欄位。
  • 觀察AccuWeather速率限制和建議的快取。
  • 解決locationKey通常需要在預測呼叫之前有單獨的地理位置或城市搜尋請求。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 除非您的訂閱另有需求，否則請使用​GET、附加apiKey查詢引數、對應locationKey以及設定檔/內容中的其他變數、貼上範例JSON、對應欄位，然後測試。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用每日預測API設定端點。 範例URL模式：

    https://dataservice.accuweather.com/forecasts/v1/daily/{days}day/{locationKey}

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

整合欄位範例。 詳細資訊和層級在AccuWeather API中說明。 您經常使用個別的位置搜尋呼叫（例如.../locations/v1/cities/search?q={{cityName}}）來解析locationKey。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://dataservice.accuweather.com/forecasts/v1/daily/{{days}}day/{{locationKey}}
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
days days 15
locationKey locationKey <desired_location_key>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5
參數 名稱 類型 值 強制
format format 變數 json 否（關閉）
language language 變數 en-US 否（關閉）
details details 變數 False 否（關閉）
metric metric 變數 False 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 apiKey <YOUR_API_KEY> 查詢參數

船站 shipstation

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 ShipStation不提供維護或正式支援。 透過ShipStation檔案確認目前的API詳細資訊。

ShipStation為承運商、標籤和追蹤提供運送和訂單API。

典型的使用案例包括交易式訊息中的訂單狀態、追蹤連結或傳遞ETA。

style
shade-box
深入瞭解ShipStation的先決條件和限制。

適用下列先決條件：

  • API金鑰和密碼（每個ShipStation檔案的基本驗證）。
  • Journey Optimizer中的管理員存取權。

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

  • 請勿在訊息內容中公開ShipStation API金鑰；僅將認證保留在整合設定中。
  • 分頁清單端點可能不適合整合；儘可能偏好單一資源GET。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 鎖定您需要的資源（訂單與出貨）、根據ShipStation API進行驗證、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用ShipStation REST API設定端點。 範例URL模式：

    https://ssapi.shipstation.com/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

下列​ 取得計時器 ​範例說明一個ShipStation自動化計時呼叫。 在Journey Optimizer中重製時，請使用ShipStation整合指南中的確切路徑和驗證。

table 0-row-2 1-row-2 2-row-2 3-row-2
欄位 價值
URL https://dashboard.sendtric.com/api/v1/timers/{{id}}
HTTP方法 POST
原則 視需要設定原則層級的詳細資訊。

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 apiKey <your_api_key> Header

要求承載

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

RevenueCat revenuecat

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由RevenueCat維護或正式支援。 使用RevenueCat檔案確認目前的API詳細資訊。

RevenueCat提供應用程式的訂閱狀態和權益API。

典型的使用案例是在原則允許的生命週期行銷活動中反映訂閱狀態。

style
shade-box
深入瞭解RevenueCat的先決條件和限制。

適用下列先決條件：

  • 機密API金鑰和應用程式識別碼；設定檔與RevenueCat客戶ID之間的穩定對應。
  • Journey Optimizer中的管理員存取權。

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

  • 保護秘密API金鑰，並遵循您的輪換原則。
  • 訂閱和權益資料是敏感的。 符合隱私權與同意要求。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 呼叫下面模型化的REST GET、使用機密金鑰標頭進行驗證、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用RevenueCat REST API設定端點。 範例URL模式：

    https://api.revenuecat.com/v1/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

範例模式：使用RevenueCat的​取得來自RevenueCat檔案的產品 （或同等產品/權益GET），以及專案的基本URL和版本。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://api.revenuecat.com/projects/{{project_id}}/products/{{product_id}}
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
project_id project_id <project_id>
product_id product_id <product_id>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
country country 變數 <iso_country_code> 否（關閉）
locale locale 變數 <locale_code> 否（關閉）
parentId parentId 變數 <parent_category_id> 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization Bearer <token> Header

Databricks databricks

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Databricks維護或正式支援。 使用Databricks檔案確認目前的API詳細資訊。

Databricks透過lakehouse資料提供SQL和REST API；較早的草稿結合陳述式執行指引與​ jobs/get ​範例。

典型的使用案例是使用受控資料表中的小型、非正規化屬性，以進行具有嚴格最低許可權的個人化。

style
shade-box
進一步瞭解Databricks的必要條件和限制。

適用下列先決條件：

  • 每個組織原則的Workspace主機、權杖或OAuth；具有最小範圍的服務主體。
  • Journey Optimizer中的管理員存取權。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 偏好較窄的讀取路徑；如果您使用​ POST ​陳述式執行，包括API所需的JSON內文、貼上範例成功回應以進行對應、仔細測試延遲、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Databricks SQL陳述式執行API設定端點。 範例URL模式：

    https://{workspace-host}/api/2.0/sql/statements/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

以下​ GET ​工作範例是說明性的；對於SQL驅動的個人化，偏好使用您的工作區支援的陳述式執行API模式。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
欄位 價值
URL https://<databricks-instance>/api/2.0/jobs/get
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。
Authentication OAuth

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
接受 接受 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
job_id job_id 變數 12 是

旁白 bynder

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Bynder維護或正式支援。 透過Bynder檔案確認目前的API詳細資訊。

Bynder是具有REST API的DAM；整合功能通常會將OAuth 2.0用於唯讀中繼資料或資產URL。

典型的使用案例包括將資產中繼資料或傳送URL提取至訊息中，以及讓Bynder中的創意核准與歷程保持一致。

style
shade-box
進一步瞭解Bynder的先決條件和限制。

適用下列先決條件：

  • 入口網站網域和OAuth使用者端（或核准的權杖方法）。
  • 唯讀存取的範圍；Journey Optimizer中的管理員存取權。

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

  • 分頁和OAuth權杖重新整理必須遵循Bynder的API規則。
  • 大型分頁回應：僅對應個人化所需的欄位。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 在選取的端點上設定​GET （一個常見的模式是使用者清單）、根據Bynder完成OAuth、避擴音取不必要的資料頁面、對應欄位、測試，然後啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Bynder API v4設定端點。 範例URL模式：

    https://{your-bynder-domain}/api/v4/users/

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

整合欄位範例。 如需OAuth 2.0裝載詳細資料，請參閱Bynder API檔案。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{your-bynder-domain}}/api/v4/users/
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
your-bynder-domain your-bynder-domain <your-bynder-domain>

標頭

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
Authorization Authorization 常數 持有人<token> 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
includeInActive includeInActive 變數 False 否（關閉）
limit limit 變數 100 否（關閉）
page page 變數 1 否（關閉）

驗證

table 0-row-2 1-row-2
類型 承載
OAuth 2.0 OAuth 2.0裝載（請參閱Bynder檔案）
code language-none 
{
    "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"
    }
}

Trustpilot trustpilot

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Trustpilot維護或正式支援。 透過Trustpilot檔案確認目前的API詳細資訊。

Trustpilot會提供適用於業務的API，並在您的使用案例和合約允許的情況下，稽核摘要資料。

典型的使用案例是顯示符合Trustpilot條款的行銷內容中的評論計數或評等。

style
shade-box
深入瞭解Trustpilot的先決條件和限制。

適用下列先決條件：

  • API金鑰和核准的使用案例；用於查詢的商業識別碼。
  • Journey Optimizer中的管理員存取權。

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

  • 使用Trustpilot資料必須符合Trustpilot品牌和資料使用政策。
  • 速率限制適用於稽核摘要和相關端點。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用必要的查詢驗證設定​GET、從設定檔或內容對應識別碼、貼上範例JSON、對應欄位、測試、啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Trustpilot API設定端點。 範例URL模式：

    https://api.trustpilot.com/v1/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

針對您的整合模式，使用來自Trustpilot開發人員的類別清單操作；引數會因資源而異。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://api.trustpilot.com/v1/categories
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
country country 變數 <iso_country_code> 否（關閉）
locale locale 變數 <locale_code> 否（關閉）
parentId parentId 變數 <parent_category_id> 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 apiKey <your_api_key> Header

Bazaarvoice bazaarvoice

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 Bazaarvoice不負責維護或正式支援此功能。 使用Bazaarvoice檔案確認目前的API詳細資訊。

Bazaarvoice提供評等、評論和UGC API。

典型的使用案例是當原則允許時，在電子郵件中顯示稽核摘要或評分。

style
shade-box
進一步瞭解Bazaarvoice的先決條件和限制。

適用下列先決條件：

  • 來自您合約的API密碼金鑰和使用者端識別碼。
  • Journey Optimizer中的管理員存取權。

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

  • 分級和評論的顯示必須遵循Bazaarvoice內容原則。
  • 每個API金鑰套用速率限制和快取規則。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用​ GET ​搭配passkey作為Conversations API上的查詢引數，設定Accept: application/json，貼上範例JSON，對應欄位，測試，啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Bazaarvoice交談API設定端點。 範例URL模式：

    https://api.bazaarvoice.com/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

範例進入點： https://api.bazaarvoice.com/data/products.json具有版本和篩選查詢引數。 請參閱Bazaarvoice開發人員。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://api.bazaarvoice.com/data/products.json
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
接受 接受 常數 application/json 是（開啟）

驗證

table 0-row-3 1-row-3
類型 索引鍵值 位置
密碼 <YOUR_ACCESS_TOKEN> 查詢參數

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5
參數 名稱 類型 值 強制
apiversion apiversionNumber 常數 5.4 是（開啟）
filter filter 變數 Id：47950830 否（關閉）
stats stats 變數 全部 否（關閉）

OneTrust onetrust

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 OneTrust不維護或正式支援此功能。 透過OneTrust檔案確認目前的API詳細資料。

OneTrust會公開隱私權和同意API （產品專屬的URL和結構描述）。

典型的使用案例是讀取架構和法律審查允許的情況下的條件式內容的同意或偏好設定訊號。

style
shade-box
深入瞭解OneTrust的先決條件和限制。

適用下列先決條件：

  • API認證和區域基底URL；傳訊中所使用欄位的法律核准。
  • Journey Optimizer中的管理員存取權。

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

  • 同意和偏好設定資料受到高度規範。 與隱私權與法律團隊協調。
  • API路徑和裝載會因OneTrust產品而異。 使用說明檔案說明您的訂閱。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 使用已發佈的結構描述或偏好設定中心路徑您的訂閱檔案，視需要完成OAuth、貼上範例JSON、對應欄位、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用OneTrust API設定端點。 您的租使用者、產品和路徑來自您訂閱的OneTrust檔案。 範例URL模式：

    https://{tenant}.my.onetrust.com/api/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
欄位 價值
URL https://customer.my.onetrust.com/api/consentmanager/v2/preferencecenters/{{preferencecenterid}}/schema
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
驗證 OAuth

路徑引數

table 0-row-3 1-row-3
參數 名稱 值
preferencecenterid preferencecenterid <pref-id>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
接受 接受 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
state state 常數 已發佈 是

偏好設定中心結構（已發佈）

範例（片段）： https://{tenant}.my.onetrust.com/api/consentmanager/v2/preferencecenters/{preferencecenterid}/schema?state=PUBLISHED。 確認OneTrust Developer中的確切路徑。

Meta meta

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 Meta並不負責維護或正式支援此功能。 透過Meta檔案確認目前的API詳細資訊。

Meta Graph和Marketing API會公開目錄和促銷活動物件，以進行授權的業務整合。

典型的使用案例是使用權杖和原則允許的Meta屬性來豐富內容。

style
shade-box
進一步瞭解Meta的先決條件和限制。

適用下列先決條件：

  • 具有正確許可權的系統使用者或應用程式權杖；Business Manager一致性。
  • Journey Optimizer中的管理員存取權。

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

  • 短期存取權杖需要適用於伺服器端整合的更新或長期策略。
  • 遵守Meta平台條款；請勿在訊息裝載中記錄代號或其他秘密。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 圖表呼叫通常是具有版本化路徑的​GET；處理權杖到期、貼上範例JSON、對應欄位、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Meta Graph API設定端點。 範例URL模式：

    https://graph.facebook.com/vXX.X/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

整合欄位範例。 如需版本設定和存取權杖，請參閱Graph API。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
欄位 價值
URL https://graph.facebook.com/{{API_VERSION}}/{{PRODUCT_CATALOG_ID}}/products
HTTP方法 GET
回應裝載 根據API回應，選取並設定要在編寫期間使用的回應欄位。
原則 視需要設定原則層級的詳細資訊。
Authentication OAuth

路徑引數

table 0-row-3 1-row-3 2-row-3
Path引數 名稱 預設值
API_VERSION API_VERSION v19.0
PRODUCT_CATALOG_ID PRODUCT_CATALOG_ID 12345

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
接受 接受 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5
參數 名稱 類型 值 強制
fields fields 變數 id 否
filter filter 變數 — 無

Aprimo aprimo

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Aprimo維護或正式支援。 透過Aprimo檔案確認目前的API詳細資訊。

Aprimo結合行銷作業和適用於記錄、資產和中繼資料的DAM API。

典型的使用案例包括動態內容中的已核准記錄或資產欄位，以及受規管行業中的受管DAM工作流程。

style
shade-box
進一步瞭解Aprimo的先決條件和限制。

適用下列先決條件：

  • 租使用者URL和認證（根據您的設定，為OAuth或API金鑰）。
  • Journey Optimizer中的管理員存取權。

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

  • Aprimo欄位層級安全性必須符合您在Journey Optimizer中對應的屬性。
  • 大型HAL或JSON裝載：將對應欄位限製為最小必要集。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 在所需的記錄路徑上使用​GET、傳送必要的標頭（例如API-VERSION）、貼上範例JSON （傳回的HAL或JSON）、對應最小欄位集、測試、啟用。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Aprimo DAM /記錄API設定端點。 使用您​ 租使用者 ​的API基底URL和記錄路徑（根據Aprimo）。 範例URL模式：

    https://{tenant}.dam.aprimo.com/

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例
table 0-row-2 1-row-2 2-row-2
欄位 價值
URL https://productstrategy1.dam.aprimo.com/api/core/record/{{recordID}}
HTTP方法 GET

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
recordId recordId <record_identifier>

標頭

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）
API版本 API版本 常數 1 是（開啟）
接受 接受 常數 application/hal+json OR application/json 否（關閉）
select-record select-record 變數 <selection_type> 否（關閉）
select-record-fields select-record-fields 變數 <field_list> 否（關閉）
select-field select-field 變數 <field_selection> 否（關閉）

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 Authorization 持有人<token> Header

Epsilon (Epsilon3) epsilon

IMPORTANT
此設定範例已由Adobe以範例模式獨立測試。 它並非由Epsilon維護或正式支援。 透過Epsilon檔案確認目前的API詳細資料。

Epsilon會根據企業合約公開API；基本URL和驗證來自您的帳戶團隊（以下事件API範例為說明性）。

典型的使用案例是透過支援的JSON API公開忠誠度或優惠屬性。

style
shade-box
深入瞭解Epsilon (Epsilon3)的先決條件和限制。

適用下列先決條件：

  • 來自Epsilon的認證和端點；Journey Optimizer中的管理員存取。

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

  • 端點與主機因客戶而異。 若沒有Epsilon帳戶團隊的檔案，請勿部署。

使用以下程式，在Journey Optimizer中設定這項整合。 請參閱​ 範例整合欄位 ​以取得請求詳細資訊，並在您環境的廠商檔案中確認這些值。

  1. 遵循使用整合。 請勿猜測公開URL。 使用Epsilon的規格，貼上範例JSON，對應欄位，測試，啟動。

  2. 在Journey Optimizer中，移至​組態 > 管理，然後選取​建立整合專案。

  3. 輸入不含空格的整合名稱。

  4. 使用Epsilon API設定端點（根據您的整合規格）。 基本URL和資源路徑由Epsilon帳戶小組提供。 範例URL模式：

    https://{your-instance}.epsilon3.io/api/...

  5. 選取設定表格中顯示的HTTP方法，通常為GET （除非另有說明）。

  6. 請完全依照表格和廠商檔案中的指定，設定驗證（標頭、查詢引數或OAuth）。

  7. 定義路徑、查詢和標題引數，並視需要將變數對應至設定檔或內容資料。

  8. 貼上JSON回應範例，以偵測並對應欄位。

  9. 在回應裝載對應中選取個人化所需的欄位。

  10. 根據預期的磁碟區設定逾時、重試和快取原則。

  11. 測試連線，然後啟動整合。

下表列出此整合請求的範例值。

整合欄位範例

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
欄位 價值
URL https://{{your-instance}}.epsilon3.io/api/v1/planning/events
HTTP方法 GET
原則 視需要設定原則層級的詳細資訊。
回應承載 根據API回應，選取並設定要在編寫期間使用的回應欄位。

路徑引數

table 0-row-3 1-row-3
Path引數 名稱 預設值
your-instance your-instance <your_instance>

標頭

table 0-row-5 1-row-5
參數 名稱 類型 值 強制
Content-Type （預設） Content-Type 常數 application/json 是（開啟）

查詢引數

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5
參數 名稱 類型 值 強制
start start 變數 2019-08-24T14:15:22Z 是（開啟） *
end end 變數 2019-08-24T14:15:22Z 是（開啟） *
eventType eventType 變數 已排程/未排程 否（關閉）
exclude_recurrences exclude_recurrences 變數 true / false 否（關閉）

*選擇性： eventType = unscheduled，以及exclude_recurrences = true。

驗證

table 0-row-4 1-row-4
類型 api金鑰名稱 API金鑰值 位置
API金鑰 <your_username> <EPSILON3_API_KEY> Header
recommendation-more-help
journey-optimizer-help