ドキュメントExperience PlatformEdge Network Server API ドキュメント

場所のヒント

Last update: Wed Apr 12 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

概要 overview

この Adobe Experience Platform Edge Network では、グローバルに分散した複数のサーバを使用して、エンドユーザーの場所に関係なく、迅速な応答時間を確保します。 また、DNS ベースのルーティングを使用して、リクエストが常にエンドユーザーに最も近い Edge ネットワークの場所にルーティングされるようにします。

エンドユーザーがセッション中に VPN に接続したり、モバイルデバイス上のネットワークタイプを切り替えたりした場合、多くの場合、Edge ネットワーク要求は別の場所にルーティングされます。 Adobe Experience PlatformとAdobe Experience Cloudのソリューションはエンドユーザープロファイル情報を Edge ネットワークに保存するので、サーバー間の中間セッションルーティングに問題が生じる可能性があります。

ロケーションのヒントが役立つ場所です。

エンドユーザーが常に現在のプロファイルデータを含む Edge Network 地域サーバーとやり取りできるように、ロケーションヒント機能では、セッションの最初のリクエストがおこなわれたのと同じサーバーに Edge Network へのすべてのリクエストを送信します。 これにより、セッション中にどのようなネットワークの変更が発生したかに関係なく、ユーザーが一貫したエクスペリエンスを得ることができます。

場所のヒントの使用方法

次の例に示すように、ロケーションヒントは、最初の Edge Network リクエストの応答と、それ以降のすべてのリクエストに含まれます。

{
   "payload":[
      {
         "scope":"EdgeNetwork",
         "hint":"or2",
         "ttlSeconds":1800
      }
   ],
   "type":"locationHint:result"
}

この EdgeNetwork 範囲には、Edge ネットワークが後続のリクエストを適宜ルーティングするために必要なすべての関連情報が含まれます。 Edge ネットワークに対する最初のリクエストと後続の各リクエストの応答には、ハンドル内にタイプの locationHint:result.

に関連付けられたヒント EdgeNetwork 範囲には、次のいずれかの値を含めることができます。

  • or2
  • va6
  • irl1
  • ind1
  • jpn3
  • sgp3
  • aus3

API 形式

後続のリクエストが正しくルーティングされるようにするには、ベースパス間の後続の API 呼び出しの URL パス ( 通常は ee、および v2 API バージョン。

POST 'https://edge.adobedc.net/ee/{LOCATION_HINT}/v2/interact?dataStreamId={DataStream_ID}'

Edge Network が返すロケーションヒントがセッション中も保持されるように、ロケーションヒントの値を、Cookie の有効期間と共に ( ttlSeconds フィールド（通常は 1800 秒）に入力します。

ほとんどの Cookie と同様に、Edge ネットワークからの応答があるたびに、この Cookie の有効期間を延長する必要があります。 Web SDK との互換性を最大限に高めるには、cookie 名を使用します。 kndctr_{IMSORG}_AdobeOrg_cluster. 通常、組織 ID はで終わります @AdobeOrg. この @ cookie の形式が正しいことを確認するには、の値をアンダースコアに変換する必要があります。

recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b