統合に関するよくある質問 vendor-integration-faq

このページ: Adobe Journey Optimizer の統合に関するよくある質問への回答を見つけます。ここでは、設定、認証、サポートされているチャネルと形式、権限、トラブルシューティングについて説明します。

Adobe Journey Optimizer の​統合に関するよくある質問を以下に示します。

基本を学ぶ

Journey Optimizer の統合にはどのような役割がありますか?

外部データソースを Journey Optimizer に接続すると、サードパーティシステムからキャンペーンやジャーニーにコンテンツやデータを取り込み、そのデータを使用してメッセージをパーソナライズできます。

➡️ 統合の概要の詳細情報

誰が統合を設定し、誰がコンテンツでこれらを使用しますか?

管理者は、技術設定(設定統合管理統合を作成)を作成してアクティブ化します。 マーケターは、テキストまたは HTML コンポーネントに​ パーソナライゼーションを追加 ​を使用し、統合​を開き、アクティブな統合を選択して、属性をマッピングします。

➡️ 管理者とマーケターのワークフローの詳細情報

管理者として UI のどこで統合を作成または管理しますか?

左側のメニューの「設定」セクションに移動し、統合​カードから「管理」を開き、「統合を作成」を選択します。

➡️ 統合の作成の詳細情報

統合の一般的なユースケースは何ですか?

例には、ロイヤルティシステムからの報酬ポイント、製品の価格情報、レコメンデーションエンジンからのレコメンデーション、配送ステータスなどのロジスティックスの最新情報が含まれます。

➡️ サードパーティシステムからのサンプルデータの詳細情報

➡️ ベンダー統合の例の詳細情報

設定

管理者として高レベルで統合を設定するにはどうすればよいですか?

名前と説明、API エンドポイント URL (オプションでパス変数を使用)、パステンプレート値、GET または POST、オプションのヘッダーとクエリパラメーター、認証方法、ポリシー設定(タイムアウトやオプションのキャッシュまたは再試行など)、フィールドをマッピングするサンプル JSON 応答を指定し、テスト接続を送信​と​ アクティブ化 ​を有効な場合に実行します。

➡️ 統合設定の詳細情報

サポートされている認証タイプは何ですか?

認証なしAPI キー基本認証​および OAuth 2.0(該当する場合は OAuth のペイロード設定を含む)の認証タイプを使用できます。

➡️ 認証タイプの詳細情報

応答ペイロードの手順は何のために使用されますか?

JSON 応答のサンプルをペーストすると、システムによりデータタイプが検出され、メッセージのパーソナライゼーション用に公開するフィールドを選択できます。 オーサリング中にマーケターが使用できるフィールドを制限できます。

➡️ 応答ペイロードマッピングの詳細情報

マーケターがメッセージに統合を追加するにはどうすればよいですか?

キャンペーンまたはジャーニーコンテンツで、テキストまたは HTML コンポーネントに​ パーソナライゼーションを追加 ​を使用し、統合​に移動し、統合を選択して、保存します。 パーソナライゼーションエディターのピルモードを使用すると、設定の変数(ヘッダーやクエリパラメーター、URL のパス変数など)に値をマッピングできます。

➡️ 統合によるパーソナライゼーションの詳細情報

機能とユースケース

ジャーニーとキャンペーンで統合を使用できますか?

はい。 この機能は、現在の製品制限内で、アウトバウンド​チャネル(例:メール、SMS、プッシュ)のジャーニーとキャンペーンの両方で使用できます。

➡️ ジャーニーとキャンペーンの詳細情報

再利用可能なフラグメントで統合を使用できますか?

統合機能は、フラグメントでサポートされています。

➡️ フラグメントの詳細情報

制限事項

統合をサポートするチャネルはどれですか?

アウトバウンド​チャネル(例:メール、SMS、プッシュ)がサポートされています。

➡️ サポートされているチャネルの詳細情報

サポートされている API 応答形式は何ですか?

API 呼び出し応答の場合、JSONHTML はフィールドマッピングでサポートされています。 JSON 以外の Raw バイナリ画像の出力と形式は、このワークフローでは使用できません。

➡️ JSON および応答形式の詳細情報

どの API パターンに接続できますか?

ターゲット固有のコンテンツがサポートされている​取得 API。 この統合モデルでは、リスト API(幅広いリストまたはページネーションパターン)はサポートされていません。

➡️ 取得 API とリスト API の詳細情報

権限と関連機能

統合の設定に必要な権限は何ですか?

統合の使用を開始するには、ユーザーに​ AJO 統合設定を管理 ​および AJO 統合設定を表示​権限を付与する必要があります。

➡️ 統合権限の詳細情報

統合では、Adobe Journey Optimizer コネクタを Experience Platform ソースに置き換えますか?

いいえ。 統合​は、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.
recommendation-more-help
journey-optimizer-help