サーバーおよびテンプレート仕様の構成オプション

概要

サーバーとテンプレートの仕様は、共通のエンドポイント /authoring/destination-servers を介してAdobe Experience Platform Destination SDK で設定できます。 エンドポイントで実行できる操作の完全なリストについては、 宛先 API エンドポイントの操作 をお読みください。

設定例

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "httpTemplate":{
      "httpMethod":"POST",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}

サーバーの仕様

強調表示されたサーバー設定

お客様は、HTTP エクスポートを使用して、Adobe Experience Platformから宛先にデータをアクティブ化できます。 サーバー設定には、メッセージを受信したサーバー(サイドのサーバー)に関する情報が含まれます。

このプロセスは、ユーザーデータを一連の HTTP メッセージとして宛先プラットフォームに配信します。 以下のパラメーターは、HTTP サーバー仕様テンプレートを形成します。

パラメーター タイプ 説明
name 文字列 必須 サーバーのわかりやすい名前を表し、Adobeにのみ表示されます。この名前は、パートナーや顧客には表示されません。 例 Moviestar destination server.
destinationServerType 文字列 必須 URL_BASED は現在、唯一のオプションです。
templatingStrategy 文字列 必須.
  • Adobeが下の value フィールドの URL を変換する必要がある場合は、PEBBLE_V1 を使用します。 次のようなエンドポイントがある場合は、このオプションを使用します。https://api.moviestar.com/data/{{customerData.region}}/items
  • Adobe側に変換が必要ない場合は、NONE を使用します。例えば、次のようなエンドポイントがある場合などです。https://api.moviestar.com/data/items
value 文字列 必須 Experience Platformが接続する API エンドポイントのアドレスを入力します。

テンプレート仕様

強調表示されたテンプレート設定

テンプレート仕様を使用すると、書き出したメッセージを宛先にフォーマットする方法を設定できます。 Adobeは、Jinjer と同様のテンプレート言語を使用して、XDM スキーマのフィールドを、宛先でサポートされる形式に変換します。 変換について詳しくは、以下のリンクを参照してください。

ヒント

Adobeには、メッセージ変換テンプレートの作成とテストに役立つ 開発者ツール が用意されています。

パラメーター タイプ 説明
httpMethod 文字列 必須 サーバーへの呼び出しでAdobeが使用するメソッド。オプションは GETPUTPOSTDELETEPATCH です。
templatingStrategy 文字列 必須 用途 PEBBLE_V1.
value 文字列 必須 この文字列は、Platform の顧客のデータをサービスが想定する形式に変換する、文字エスケープバージョンです。
テンプレートの作成方法について詳しくは、テンプレートの使用の 節を参照してください
文字のエスケープについて詳しくは、 RFC JSON 標準の第 7 節を参照してください。
単純な変換の例については、プロファイルのアトリビュート変換を参 照して ください。
contentType 文字列 必須 サーバーが受け入れるコンテンツタイプ。この値は application/json である可能性が高いです。

このページ