開発者向けの基本を学ぶ get-started-developers

このページについて： Adobe Journey Optimizer にアプリケーションを接続する SDK、イベントストリーミング、カスタムアクションのエンドポイント、API を実装します。これにより、ジャーニーをライブデータに基づいて実行できます。

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

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

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

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

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

前提条件 prerequisites

実装を開始する前に、以下の点を確認してください。

技術的な基盤について technical-foundation

実装に進む前に、次のコアとなる技術概念を理解しておきます。

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

Adobe Experience Platform Mobile SDK の設定

モバイル SDK は、iOS または Android アプリに直接埋め込むライブラリのコレクションです。 アプリと Adobe Experience Platform の間のコミュニケーション層として機能し、利用者の特定、行動イベントの収集、プッシュ通知、アプリ内メッセージ、パーソナライズされたコンテンツなど、Journey Optimizer からの指示を配信します。 この機能がなければ、Journey Optimizer はアプリユーザーの行動を把握できず、そうしたユーザーにリーチすることはできません。

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

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

コードベースのエクスペリエンスにより、新しいアプリのリリースを必要とせずに、オンボーディング画面や製品詳細ページ、アプリ内バナーや機能フラグなど、ネイティブモバイルアプリのあらゆるサーフェスにパーソナライズされたコンテンツを配信できます。 モバイル SDK を使用すると、ランタイムにパーソナライズされたコンテンツを取得してレンダリングできるため、チームは配置とプレゼンテーションを完全に制御できます。

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

Adobe Experience Platform Web SDK の設定

Web SDK（alloy.js）を使用すれば、複数の Adobe タグをサイトに個別に実装する代わりに、1 つの JavaScript ライブラリで対応できます。 行動データを収集し、設定したデータストリームを通じて Adobe Experience Platform にストリーミングし、パーソナライゼーションの指示を受け取ります。これらすべてを 1 回のネットワーク往復で行います。 Journey Optimizer を導入すれば、訪問者を特定し、その行動に基づいてジャーニーをトリガーし、パーソナライズされたコンテンツをページに即座に配信できるようになります。

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

マーケターがレイアウトを完全に制御するビジュアルチャネルとは異なり、コードベースのエクスペリエンスでは、パーソナライズされたコンテンツをページ上でどのように表示するかを完全にコントロールできます。 Journey Optimizer は、パーソナライゼーションデータを含む JSON ペイロードを返し、そのデータをどこに、どのように表示するかはコードで決定します。 このモデルは、ビジュアルエディターやページ公開のワークフローを必要とせずに、ヒーローバナー、レコメンデーションカルーセル、検索結果ランキング、A/B テストのバリエーションなど、あらゆる web サーフェスに対応します。

実際のコードベースのエクスペリエンスを確認するには、GitHub のサンプル実装を参照してください。

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

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

ジャーニーをトリガーするイベントの送信

ジャーニーは、イベントに基づいて実行されます。ユーザーのログイン、カートに商品の追加、購入の完了、フォームの放棄などが挙げられます。 ユーザーの役割は、こうしたイベントを適切なタイミングでアプリケーションから送信することです。 各イベントは、Experience Platform Streaming Ingestion API に送信される XDM 構造化 JSON ペイロードです。Journey Optimizer は、ミリ秒以内にイベントを受け取り、該当するジャーニーへとプロファイルをルーティングします。 イベントスキーマとペイロード構造は、データエンジニアが定義するので、コーディングを開始する前にデータエンジニアと連携して確認してください。

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

ジャーニーがカスタムアクションのステップに到達すると、Journey Optimizer は指定した URL（バックエンド、CRM、ロイヤルティプラットフォーム、REST エンドポイントなど）に対して、アウトバウンド HTTP 呼び出しを行います。 ユーザーの役割は、エンドポイントを構築して公開することです。リクエストの仕様（ペイロードの形状、認証方法、応答形式）を定義し、その背後にあるビジネスロジックを実装し、Journey Optimizer が生成する呼び出し量に対応できるようにする必要があります。 次に、管理者がエンドポイントを Journey Optimizer に登録することで、マーケターがジャーニーのステップとして利用できるようになります。

ユースケース例：カスタムアクションを使用して、ジャーニーイベントを Experience Platform に書き込みます。

Journey Optimizer API の操作 apis

すべての操作を Journey Optimizer UI を通じて行う必要はありません。 自社のバックエンドからキャンペーンをトリガーする、プライバシーリクエストを受けてメールアドレスへの配信を停止する、外部の CMS からコンテンツテンプレートを同期させる、といった必要が生じることもあります。 Journey Optimizer の REST API では、プラットフォームのコア機能にプログラムでアクセスできます。 すべての呼び出しは OAuth サーバー間認証を使用します。古い JWT メソッドは非推奨となっています。

テストとデバッグ testing

本番環境で実装を開始する前に、イベントが適切なタイミングで実行され、ジャーニーが期待どおりにトリガーされ、カスタムアクションが実際の負荷下でも正常に動作し、パーソナライズされたコンテンツが正しくレンダリングされることを確認する必要があります。 このセクションでは、低レベルの SDK のログ記録から、実際のプロファイルを使用したエンドツーエンドのジャーニーテストの実行まで、問題を早期に発見するためのツールやテクニックについて説明します。

高度な開発者向けトピック advanced-topics

コア SDK、イベント、API を導入したら、次のトピックで、さらに高度な活用が可能になります。プロファイルを肥大化させることなく、実行時にジャーニーデータを強化する、オプトアウトが各統合を通じて伝播するように同意シグナルを処理する、本番環境の規模に求められるスループットと信頼性を実現するために実装を最適化する、といった重要な機能です。

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

一般的に、ジャーニーでは、トリガーとなるイベントに含まれる情報（製品名、ロイヤリティ層、注文明細リストなど）だけでは不十分な場合があります。 これらすべてを各プロファイルに事前に読み込むのではなく、コンテキストエンリッチメントを使用すると、ジャーニーで AEP データセットから実行時に情報を検索するか、カスタムアクションの応答から情報を取得できます。 これにより、プロファイルに永続的にデータを保存することなく、メッセージや分岐条件でそのデータを参照できるようになります。

同意とガバナンスの操作

Journey Optimizer はデータガバナンスと同意ポリシーをプラットフォームレベルで適用しますが、統合でもこれらのポリシーを遵守する必要があります。 顧客がマーケティングコミュニケーションをオプトアウトした場合、またはデータ使用ラベルによりフィールドの使用方法が制限されている場合は、UI のアクションをブロックするだけでなく、カスタムアクションやデータセットの参照にもこれらのルールが適用される必要があります。

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

Journey Optimizer の本番環境では、数百万のイベントと 1 秒間に数千ものジャーニー実行が定期的に処理されます。 これらのリソースは、そのような規模に合わせて統合を調整するのに役立ちます。例えば、レート制限に達する前にレート制限を把握し、プロファイルが密かに除外されるような一般的なジャーニー設計上の問題を回避して、原因不明のまま失敗するのではなく機能が低下しても動作を継続できるエラー処理を構築したりすることが重要です。

Journey Optimizer REST API の呼び出し rest-apis

SDK やイベントストリーミングを実装するだけでなく、独自のシステムからプログラムで Journey Optimizer を実行することもできます。 API の完全なリファレンス、OpenAPI 仕様、コードサンプルは、Journey Optimizer 開発者ポータルにあります。

API トリガーキャンペーンの実行 api-triggered

Interactive Message Execution REST API を使用して、外部システムからトランザクションメッセージまたはマーケティングメッセージをトリガーします。 エンドポイントを呼び出す前に、以下を実行してください。

API リファレンス · コードサンプル · API トリガーキャンペーンの操作

外部エンドポイントのキャップとスロットル capping-throttling

ジャーニーがカスタムアクションまたはデータソースを介して外部システムを呼び出す場合、Capping API と Throttling API は、これらのシステムを過負荷から保護します。 キャップは、設定された制限を超える呼び出しを拒否します。スロットルキューは最大 6 時間待機します（本番サンドボックス、カスタムアクションのみ）。

Capping API リファレンス · Capping API の操作 · Throttling API の操作

その他の REST API more-rest-apis

Journey Optimizer では、メッセージとキャップに加えて、抑制管理、コンテンツテンプレート、キャンペーン検索、プルーフ、オーケストレーションキャンペーンの実行など、REST エンドポイントを活用できます。 これらを使用すると、UI での手動操作が必要となるような処理を自動化できます。例えば、データプル後にアドレスを一括で配信停止したり、外部のコンテンツパイプラインからテンプレートを同期したりできます。

| データセットの検証とオーケストレーションされたキャンペーン実行のトリガー| データセットの検証 · トリガー · データセットを有効にする |

その他のリソース additional-resources

役割をまたいだ共同作業 next-steps

実装作業は、次の他のチームメンバーと連携します。

実装の開始

作成を開始する準備は整っていますか？ 上記の節から最初の実装領域を選択します。

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

その他の役割ガイド other-role-guides

役割と責任の概要に戻る · 開始に戻る