サーバーサイド:Targetを実装
Adobe Targetのサーバーサイド配信API、SDK、およびTarget Recommendations個のAPIに関する情報。
以下の処理は、Target のサーバー側実装で発生します。
- クライアントデバイスがサーバーを通じてエクスペリエンスのリクエストをおこないます。
- サーバーは、そのリクエストを Target に送信します。
- Target は、サーバーに応答を送り返します。
- サーバーは、クライアントデバイスに配信するエクスペリエンスをレンダリングするエクスペリエンスを決定します。
エクスペリエンスをブラウザーに表示する必要はありません。 エクスペリエンスは、電子メールやキオスク、音声アシスタント、その他の視覚的ではないエクスペリエンスやブラウザー以外のデバイスで表示できます。 サーバーはクライアントと Target の間に位置するので、より優れたコントロールおよびセキュリティが必要であったり、サーバーで実行したい複雑なバックエンド処理がある場合、このタイプの実装も理想的です。
以下の節では、様々なサーバーサイド APIとSDKについて詳しく説明します。
Server Side Delivery API
リンク: サーバーサイド配信API
/rest/v1/delivery
Target Delivery APIを使用すると、次のことが可能になります。
- SPAやモバイルチャネルを含むwebはもちろん、コネクテッド TV、キオスク、実店舗のデジタルスクリーンなど、ブラウザー以外のIoT デバイスにもエクスペリエンスを提供できます。
- HTTP/S呼び出しを行うことができる、任意のサーバーサイドプラットフォームまたはアプリケーションから、エクスペリエンスを配信します。
- 訪問者がどのチャネルやデバイスを利用してビジネスに関与したとしても、訪問者に一貫性のあるパーソナライズされた体験を提供します。
- 訪問者のエクスペリエンスをサーバー上のセッション内にキャッシュして、複数のAPI呼び出しを回避できるようにすることで、パフォーマンスを向上させます。
- サーバーサイドから、Adobe Analytics、Adobe Audience Manager(AAM)、Adobe Experience Cloud ID ServiceなどのAdobe Experience Cloud製品とシームレスに連携できます。
サーバーサイド SDK
Adobe Target サーバーサイド SDKのドキュメントは、お使いの言語でサーバーにTargetを実装するのに役立ちます。
Adobe Targetのサーバーサイド SDKを使用すると、次のことが可能になります。
- 機能のフラグ付け、ロールアウト、および A/B実験 を ほぼゼロの遅延 で実行して実行します。
- SPAと モバイルチャネル を含む web 全体、および接続されたテレビ、キオスク、実店舗のデジタル画面などのブラウザー以外の モノのインターネット(IoT)デバイス を含むエクスペリエンスを配信します。
- ユーザーがどのチャネルやデバイスとエンゲージしたかに関係なく、機械学習(ML)を活用したパーソナライズされたエクスペリエンスをユーザーに提供します。
- サーバーサイドから Adobe Analytics 、 Adobe Audience Manager 、 Experience Cloud ID Service などのAdobe Experience Cloud製品とシームレスに連携できます。
デバイス上の決定を介してシンプルな機能フラグ付けユースケースを実行する方法については、はじめに ページを参照してください。
サンプルアプリ をチェックして、楽しく遊びましょう。
Target Recommendations API
リンク:Target Recommendations APIおよびAdobe Recommendations APIの概要。
Recommendations APIを使用すると、Target個のRecommendations サーバーとプログラムで対話できます。 これらのAPIは、通常Target ユーザーインターフェイスを介して実行する機能を実行するために、さまざまなアプリケーションスタックと統合できます。
SDKを使用しないPlatform Edge Network API呼び出し platform-edge-api-user-agent
Adobe Experience Platform Web SDKおよびその他のサポートされているSDK統合には、Experience Platform Edge Networkの呼び出し時にHTTP リクエストヘッダーにブラウザーのようなUser-Agent値が含まれています。 SDKなしでパブリック インタラクション APIを使用するサーバーサイド統合では、このヘッダーを明示的に指定する必要があります。
SDK以外のインタラクション API呼び出しの場合は、次の要件を確認してください。
- HTTP リクエストヘッダーに、ブラウザーに似た有効な
User-Agentを含めます。 JSON リクエスト本文の訪問者またはユーザーエージェントの値だけでは、この統合パターンのボット検出要件を満たしません。 - プレースホルダーやブラウザー以外の値(例:
MyApp/1.0)は使用しないでください。このような値はボットの分類になる可能性があります。 - パブリック Edge API呼び出しには、SDK名またはSDK バージョンは必要ありません。 このシナリオでは、有効な
User-AgentHTTP ヘッダーが必須の要素です。
Targetがリクエストをボットトラフィックとして分類すると、以下のように、Recommendationsや自動ターゲット などのアクティビティのプロファイル検索、セグメント評価、パーソナライズされたコンテンツが抑制されるので、パーソナライゼーションが失敗したり、断続的に見えたりする可能性があります。
SDKの導入について詳しくは、Adobe Experience Platform Web SDK 概要を参照してください。
Interact API リクエストの例(ヘッダーにはUser-Agentを含める必要があります):
POST https://edge.adobedc.net/ee/v2/interact?dataStreamId=YOUR_DATASTREAM_ID&requestId=YOUR_REQUEST_ID
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.5 Safari/605.1.15
Accept: */*
Content-Type: text/plain; charset=UTF-8