サーバーサイド:Targetを実装

Adobe Targetのサーバーサイド配信API、SDK、およびTarget Recommendations個のAPIに関する情報。

NOTE
実装でat.jsとAppMeasurementをクライアントサイドで使用する場合は、以下で説明するTarget Delivery APIとサーバーサイド SDKを使用する必要があります。
実装でAdobe Experience Platform Web SDKを使用している場合は、Adobe Experience Platform Edge Network Server APIを使用する必要があります。

以下の処理は、Target のサーバー側実装で発生します。

  1. クライアントデバイスがサーバーを通じてエクスペリエンスのリクエストをおこないます。
  2. サーバーは、そのリクエストを Target に送信します。
  3. Target は、サーバーに応答を送り返します。
  4. サーバーは、クライアントデバイスに配信するエクスペリエンスをレンダリングするエクスペリエンスを決定します。

エクスペリエンスをブラウザーに表示する必要はありません。 エクスペリエンスは、電子メールやキオスク、音声アシスタント、その他の視覚的ではないエクスペリエンスやブラウザー以外のデバイスで表示できます。 サーバーはクライアントと Target の間に位置するので、より優れたコントロールおよびセキュリティが必要であったり、サーバーで実行したい複雑なバックエンド処理がある場合、このタイプの実装も理想的です。

NOTE
初回訪問者は、クライアントサイドでのみ初期化できます。 初回訪問者​はサーバーサイドで初期化できません。 これはECIDによるもので、これはサードパーティのdemdex cookieに依存するため、ブラウザーが関与する実装でVisitor API.jsを介して初期化する必要があります。

以下の節では、様々なサーバーサイド 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-Agent HTTP ヘッダーが必須の要素です。

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
recommendation-more-help
target-dev-help-dev