ドキュメント Journey Optimizer Journey Optimizer ガイド

開発者向けの基礎知識 get-started-developers

Last update: Fri Dec 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
はじめに

作成対象：

経験者
開発者

開発者 には、Adobe Journey Optimizer ールを実装し、アプリケーションやシステムに統合する責任があります。 Adobe Journey Optimizer システム管理者とデータエンジニアからアクセス権を付与され、環境の準備ができたら、での作業を開始できます。

Journey Optimizer エコシステムでの役割

他のチームメンバーがユーザーインターフェイスを使用してJourney Optimizerを設定する際は、以下に焦点を当てます。

モバイルアプリケーションと web アプリケーションでの SDK の実装
アプリケーションからトリガージャーニーへの イベントの送信
カスタムアクションを使用してJourney Optimizerが呼び出すことができる API エンドポイントの構築
Journey Optimizerの統合 既存のシステムおよびインフラストラクチャとの統合
実装 テストとデバッグ

データエンジニアが、データスキーマ、イベント設定およびデータソースを処理します。管理者が権限とチャネル設定をセットアップします。マーケターは、実装を使用するジャーニーとコンテンツを設計します。

このガイドでは、Journey Optimizerを使い始めるための基本的な技術実装手順を説明します。モバイルアプリを作成する場合でも、web エクスペリエンスを作成する場合でも、API 統合を作成する場合でも、以下の節に従って実装を設定してください。

前提条件 prerequisites

実装を開始する前に、次のことを確認します。

カテゴリ

要件

技術力

* JavaScript （Web SDK用）または Swift/Kotlin （Mobile SDK用）の使用経験
* RESTful API と JSON の理解
*非同期プログラミングおよびイベント駆動型アーキテクチャに関する知識
*組織のアプリケーションアーキテクチャに関する知識

アクセスとツール

* API 資格情報の Adobe Developer Console へのアクセス
* アプリケーションのコードベースへのアクセスを使用した開発環境
* API テスト用Postmanなどのテストツール
* ブラウザー開発者ツールまたはモバイルデバッグツール

他のチームメンバーから

*お客様の管理者
*XDM スキーマおよびイベント定義によって付与された環境アクセス *お客様のデータエンジニア
*要件およびユースケースからのマーケター

技術基盤について technical-foundation

実装に立ち入る前に、次の主要な技術概念を理解しておく必要があります。

Adobe Experience Platform統合: Journey Optimizerは、Adobe Experience Platformでネイティブに構築されています。基盤となるアーキテクチャを理解すると、より効果的な実装を構築するのに役立ちます。詳しくは、Journey Optimizerの仕組みを参照してください。
XDM データモデル:Journey Optimizerは、Experience Data Model （XDM）を使用してイベントとプロファイルデータを構造化します。開発者は、データエンジニアが設定したスキーマに準拠するデータの送信方法を理解する必要があります。 XDM スキーマについて説明します。
認証とセキュリティ：すべての実装に適切な認証が必要です。 SDK と API の認証を設定する方法を理解します。 API 認証の詳細情報

モバイルアプリ統合の設定 mobile-integration

Adobe Experience Platform Mobile SDKの設定

プッシュ通知、アプリ内メッセージおよびその他のモバイル機能を有効にするには、モバイルアプリケーションにAdobe Experience Platform Mobile SDKを組み込みます。

Mobile SDKをインストールして設定: Adobe Experience Platform Mobile SDKのドキュメントに従って、SDK統合を開始します。
モバイルプロパティの作成:Adobe Experience Platform Data Collection でモバイルプロパティを設定します。方法について説明しますモバイルプロパティを作成および設定する。
プッシュ通知の設定:
- iOS アプリ の場合：アプリを APN に登録します（Apple プッシュ通知サービス）。詳しくは、Appleのドキュメントを参照してください。
- Android アプリの場合:Android アプリ用に Firebase Cloud Messaging を設定します。詳しくは、Googleのドキュメントを参照してください。
モバイル統合のテスト: モバイルオンボーディングのクイックスタートワークフローを使用して、モバイル設定を迅速に設定し、テストします。

プッシュ通知を設定する詳細な手順については、このページを参照してください。

コードベースのエクスペリエンスの実装（Mobile SDK）

コードベースのエクスペリエンスを使用したネイティブモバイルアプリのパーソナライズ機能の場合：

Mobile SDKの実装については、このチュートリアルに従ってください
iOS} および 2}Android のサンプル実装を確認します

Web エクスペリエンスの実装 web-implementation

Adobe Experience Platform Web SDKの設定

Web ベースの実装の場合、Web SDKが主な統合ポイントになります。

Web SDKをインストール:『 Web SDK導入ガイドに従って、web サイトにSDKを設定します。
データストリームを設定:Journey Optimizerを有効にして、Adobe Experience Platform Data Collection でデータストリームを作成および設定します。詳しくは、データストリームのドキュメントを参照してください。
Web プッシュ通知を有効にする （オプション）:Web SDK設定で pushNotifications プロパティを設定し、sendPushSubscription コマンドを使用してプッシュ購読を登録します。

コードベースのエクスペリエンスの実装（Web SDK）

コードベースのエクスペリエンスを使用すると、あらゆるデジタルタッチポイントをパーソナライズできます。

実装方法をクライアントサイド、サーバーサイド、ハイブリッドから選択します。アプローチごとに実装サンプルを確認します。
サーフェスの定義：パーソナライズされたコンテンツを配信するアプリケーション内の場所を特定します。サーフェス設定について説明します。
コンテンツレンダリングの実装:Web SDKを使用して、パーソナライゼーションコンテンツを取得し、適用します。コードベースの実装チュートリアルを参照してください。
表示イベントとインタラクションイベントの送信：コンテンツが表示されるタイミングと、分析と最適化のためにユーザーがコンテンツとやり取りするタイミングを追跡します。

GitHub のサンプル実装を調べて、コードベースのエクスペリエンスの動作を確認します。

詳しくは、コードベースのエクスペリエンスの概要を参照してください。

イベントストリーミングの実装 event-streaming

トリガージャーニーへのイベントの送信

トリガーは、ジャーニーを開発するイベントを送信するコードを実装します。担当のデータエンジニアが、Journey Optimizerでイベントのスキーマと定義を設定します。

イベントペイロードについて：データエンジニアと協力して、イベントのスキーマと必要なペイロード構造を取得します。ペイロードは、設定した XDM スキーマに準拠する必要があります。イベントスキーマ要件について説明します。
イベントストリーミングの実装: ストリーミング取得 API を使用して、Adobe Experience Platformにイベントを送信します。イベントの送信手順を説明します。
イベントタイプを処理:
- 単一イベント：ユーザー固有のアクション（ボタンのクリック、購入完了など）のイベント送信を実装します
- ビジネスイベント：ビジネス関連のイベント（在庫の更新、価格の変更など）を送信します
イベント配信をテスト：イベントが適切に受信され、ジャーニーが期待どおりにトリガーすることを確認します。詳細情報イベントのトラブルシューティング。

API を使用してイベントを送信する場合の 実装例:

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

詳しくは、ジャーニーイベントの操作を参照してください。

カスタムアクションエンドポイントの開発 custom-actions

カスタムアクションを使用すると、ジャーニーで API を呼び出すことができます。開発者は、カスタムアクションによって呼び出される API エンドポイントを作成します。

API エンドポイントの作成：ジャーニーの実行中にJourney Optimizerが呼び出す RESTful API エンドポイントを作成します。エンドポイントは次のようになります。
- JSON ペイロードを受け入れる
- リクエストの認証（OAuth、API キーまたは JWT）
- 適切なタイムアウト制限内でリクエストを処理
- 応答を想定される形式で返します
カスタムアクション機能について：カスタムアクションは、Epsilon、Slack、Firebase、独自のサービスなどのサードパーティシステムに接続できます。詳しくは、カスタムアクションを参照してください。
アクション設定の操作: 管理者またはデータエンジニアが、Journey Optimizerでカスタムアクションを設定し、API エンドポイントの URL、認証方法、パラメーターを定義します。 API 仕様を提供します。カスタムアクション設定について説明します。
アクションにつながるデータを返す：後続のジャーニーステップで使用できるデータを返すように API を設計します。詳細情報アクション応答。
レート制限の実装：想定されるボリュームをエンドポイントが処理できることを確認します。 Journey Optimizerでは 1 秒あたり 5,000 回の呼び出しに制限が適用されますが、システムは回復力を備えている必要があります。キャッピングとスロットルについて説明します。

例のユースケース:Experience Platformへのジャーニーイベントの書き込みカスタムアクションの使用

Journey Optimizer API の操作 apis

Journey Optimizerは、プログラムによるアクセス用に包括的な REST API を提供しています。

API の機能について:Journey Optimizer API を使用すると、様々なリソースをプログラムで作成、読み取り、更新、削除できます。 Journey Optimizer API について説明します。
認証: このチュートリアルに従って、Adobe Developer Consoleを使用して API 認証を設定します。
API リファレンスについて：完全な API ドキュメントを参照して、Adobe Journey Optimizer API リファレンスで直接 API を試してください。
API トリガーキャンペーン:API トリガーキャンペーンを使用してトランザクションメッセージを作成します。大量のシナリオ（最大 5,000 TPS）の場合は、ハイスループットモードを参照してください（アドオンライセンスが必要です）。
意思決定管理 API：オファー管理と意思決定には専用の API を使用します。詳しくは、意思決定管理 API ガイドを参照してください。

テストとデバッグ testing

SDK実装のデバッグ:Adobe Experience Platform Assuranceを使用して、SDK イベントの調査、データ収集の検証、統合に関する問題のトラブルシューティングをリアルタイムで行います。 Assuranceの詳細情報。
イベント配信をテスト：アプリケーションからのイベントが、Adobe Experience Platformおよびトリガージャーニーで期待どおりに正しく受信されていることを確認します。イベント取り込みを監視し、ペイロード構造を検証します。
API 統合の検証：カスタムアクションエンドポイントをテストし、Journey Optimizer リクエストが正しく処理され、タイムアウト制限内で応答し、期待されるデータ形式を返すことを確認します。
テストプロファイルでテストモードを使用：お客様のデータエンジニアと協力してテストプロファイルへのアクセス権を取得し、ジャーニーテストモードを使用して実装を検証します。詳細情報ジャーニーのテスト。
SDK ログの監視:SDK実装でデバッグログを有効にして、開発中の問題のトラブルシューティングを行います。
- Mobile SDK：ログを有効にして、SDKのイベントと API 呼び出しを表示します
- Web SDK：ブラウザーコンソールを使用して、SDKのアクティビティを監視します
データストリーム設定の確認:Journey Optimizerにデータを送信するようにデータストリームが正しく設定されていることを確認します。イベントがデータストリームを介して正しい宛先に送られるかどうかを確認します。
分析用にジャーニーデータをクエリ：データレイクの SQL クエリを使用して、ジャーニーステップイベントの分析、問題のデバッグ、カスタムアクションのパフォーマンスの監視を行います。次のような、ジャーニー分析のクエリ例を探索します。
- プロファイルのエントリ/離脱のトラッキングと破棄理由
- カスタムアクションパフォーマンス指標（待ち時間、スループット、エラー）
- イベントの配信とエラーパターン
- ジャーニーインスタンスの状態

開発者向けの詳細トピック advanced-topics

コンテキストデータとエンリッチメントの操作

配列の反復：ハンドルバー構文を使用して、イベント、カスタムアクション応答およびデータセット検索からの動的リストをメッセージに表示します。コンテキストデータの反復について説明します。
データセット検索：データセット検索を実装して、Adobe Experience Platform データセットからのジャーニーデータを強化します。設定については、データエンジニアにお問い合わせください。データセットルックアップについて説明します。

同意とガバナンスの使用

統合にデータガバナンスと同意ポリシーを実装します。

データガバナンス：カスタムアクションにデータ使用ポリシーを適用します。詳しくは、データガバナンスを参照してください。
同意管理：実装で顧客の同意環境設定を処理します。同意の詳細情報。

最適化とベストプラクティス

キャッピングとスロットル：レート制限を理解し、適切なスロットルを実装します。外部システムの詳細情報
ジャーニーの最適化: ジャーニーの最適化のベストプラクティスに従います。
エラー処理：堅牢なエラー処理を実装します。エラーコードとトラブルシューティングガイドを確認します。

その他のリソース additional-resources

Developer Console: Adobe Developer Console にアクセスして統合を作成し、API 資格情報を管理します。
サンプルコード:GitHub のサンプル実装を調べます。
チュートリアルビデオ: Experience League の実践チュートリアルを通じて学びます。
開発者コミュニティ:Adobe コミュニティフォーラムで、他の開発者とつながり、サポートを受けることができます。

複数の役割での共同作業 next-steps

実装作業が他のチームメンバーと重なっています。

データエンジニアとの連携

データとイベントの設定に関するデータエンジニアとの共同作業：

実装する必要がある XDM スキーマとイベント構造を取得します
送信する必要があるイベントと、必要なペイロード形式を理解する
データ収集要件とデータ品質基準の調整
イベント配信とデータ取り込みのテスト

管理者の操作

アクセスと設定に関する管理者との共同作業：

設定するカスタムアクションの API 仕様を提供する
必要な権限と API 資格情報のリクエスト
チャネル設定要件（プッシュ証明書など）に基づく調整
テスト環境とサンドボックス戦略の調整

マーケターとの連携

ジャーニー要件とテストに関するマーケターとの共同作業：

イベントをトリガーにするユーザーインタラクションについて
コンテンツのパフォーマンスとユーザーエンゲージメントを追跡するための実装
実装した機能でジャーニーのテストをサポート
メッセージ配信またはパーソナライゼーションに関する問題のトラブルシューティング

実装の開始

ビルドを開始する準備はできていますか？上記の節から最初の実装領域を選択します。

モバイルアプリ？ Mobile SDK統合の基本をぶ
Web サイト？ Web SDKの設定から始める
API 統合？ ジャンプ API の操作
カスタムシステム？ チェックアウトカスタムアクション

各セクションには、実装をガイドする詳細な技術ドキュメント、コードサンプル、チュートリアルへのリンクが含まれています。

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76