開発者向けの基本を学ぶ 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）は、サイトで必要になる可能性のある個別のJavaScript タグのパッチワークに代わる単一のAdobe ライブラリです。 単一のネットワークで、行動データを収集し、設定したデータストリームを通じてAdobe Experience Platformにストリーミングし、パーソナライゼーションの指示を受け取ります。 adobe 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は、バックエンド、CRM、ロイヤルティプラットフォーム、REST エンドポイントなど、提供したURLに対してアウトバウンド 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の操作 ・ ​ スロットル APIの操作

その他のREST API more-rest-apis

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

その他のリソース additional-resources

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

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

実装の開始

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

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

その他のロールガイド other-role-guides

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