Show Menu
トピック×

CSVファイルのXDMスキーマへのマップ

CSVデータをAdobe Experience Platformに取り込むには、そのデータをExperience Data Model(XDM)スキーマにマッピングする必要があります。 このチュートリアルでは、Experience Platformユーザーインターフェイスを使用してCSVファイルをXDMスキーマにマップする方法について説明します。
さらに、このチュートリアルの付録では、 マッピング関数の使用に関する詳細について説明します

はじめに

このチュートリアルでは、Adobe Experience Platformの次のコンポーネントについて、十分に理解している必要があります。
また、このチュートリアルでは、CSVデータを取り込むデータセットを既に作成している必要があります。 UIでデータセットを作成する手順については、「 データ取り込みのチュートリアル 」を参照してください。

追加データ

Experience Platform UIで、左側のナビゲーションの ワークフロー をクリックし、「CSVをXDMスキーマに マップ」をクリックします 。 表示される右側のパネルで、「 起動 」をクリックします。
CSVをXDMに マップ」スキーマ ・ワークフローが表示され、 追加dataステップから開始します。
CSVファイルを用意されているスペースにドラッグ&ドロップするか、「 参照 」をクリックしてファイルを直接選択します。 ファイルがアップロードされると、 サンプルデータ (Sample data)セクションが表示され、最初の10行のデータが表示されます。 データが期待どおりにアップロードされたことを確認したら、「 次へ 」をクリックします。

宛先の選択

The Destination step appears. 提供されたリストから、CSVデータを取り込むデータセットを選択し、「 次へ 」をクリックします。

CSVフィールドのXDMスキーマフィールドへのマップ

The Mapping step appears. CSVファイルの列は「 Source Field 」の下に表示され、対応するXDMスキーマフィールドは「 ターゲットフィールド 」の下に表示されます。 未選択のターゲットフィールドは赤で枠線表示されます。
CSV列をXDMフィールドにマップするには、列の対応するターゲットフィールドの横にあるスキーマアイコンをクリックします。
# ウィンドウが表示されます。 XDMスキーマの構造に移動して、CSV列のマッピング先のフィールドを探します。 XDMフィールドをクリックして選択し、「 Select 」をクリックします。
マッピング 」画面が再表示され、選択したXDMフィールドが「 ターゲットフィールド 」の下に表示されます。
特定のCSV列をマップしない場合は、「ターゲット」フィールドの 横にある削除アイコンをクリックして、マッピングを削除できます 。 新しいマッピングを追加する場合は、リストの下部にある 追加「新しいマッピング 」をクリックします。
フィールドのマッピング時には、入力ソースフィールドに基づいて値を計算する関数を含めることもできます。 詳細については、付録の「 マッピング関数 」の節を参照してください。
上記の手順を繰り返して、CSV列のXDMフィールドへのマッピングを続行します。 完了したら、「 次へ 」をクリックします。

データを取り込む

取り込み __ 手順が表示され、ソースファイルとターゲットデータセットの詳細を確認できます。 「 取り込み 」をクリックして、CSVデータを取り込む開始を選択します。 CSVファイルのサイズによっては、処理に数分かかる場合があります。 取り込みが完了すると画面が更新され、成功または失敗を示します。 Click Finish to complete the workflow.

次の手順

このチュートリアルに従うと、フラットなCSVファイルをXDMスキーマに正常にマッピングし、プラットフォームに取り込むことができます。 このデータは、リアルタイム顧客プロファイルなどのダウンストリームプラットフォームサービスで使用できるようになりました。 詳しくは、 リアルタイム顧客プロファイルの概要 (英語)を参照してください。

付録

次の節では、CSV列をXDMフィールドにマッピングするための追加情報を示します。

マッピング関数

特定のマッピング関数を使用して、ソースフィールドに入力した値に基づいて値を計算および計算できます。 関数を使用するには、「 ソースフィールド 」に適切な構文と入力を入力して、関数を入力します。
例えば、 city country CSVフィールドを連結し、city XDMフィールドに割り当てるには、ソースフィールドを次のように設定し concat(city, ", ", county) ます。
次の表に、サンプル式とその結果生成される出力を含む、サポートされるすべてのマッピング関数をリストします。
関数
説明
サンプル式
サンプル出力
concat
指定した文字列を連結します。
concat("Hi, ", "there", "!")
"Hi, there!"
爆発する
正規表現に基づいて文字列を分割し、部分の配列を返します。
explode("Hi, there!", " ")
["Hi,", "there"]
instr
サブ文字列の位置/インデックスを返します。
instr("adobe .com", "com")
6
replacestr
元の文字列に検索文字列が存在する場合、その文字列を置き換えます。
replacestr("This is a string re test", "re", "replace")
"This is a string replace test"
substr
渡された長さのサブ文字列を返します。
substr("This is a substring test", 7, 8)
" a subst"
lower /
lcase
文字列を小文字に変換します。
lower("HeLLo")
lcase("HeLLo")
"hello"
upper /
ucase
文字列を大文字に変換します。
upper("HeLLo")
ucase("HeLLo")
"HELLO"
split
区切り文字の入力文字列を分割します。
split("Hello world", " ")
["Hello", "world"]
join
セパレータを使用してオブジェクトのリストを結合します。
join(" ", ["Hello", "world"] )
"Hello world"
合体
渡されたリスト内の最初のnull以外のオブジェクトを返します。
coalesce(null, null, null, "first", null, "second")
"first"
decode
キーとキーと値のペアを配列としてフラット化したリストを指定すると、キーが見つかった場合は値を返し、配列に存在する場合はデフォルト値を返します。
decode("k2", "k1", "v1", "k2", "v2", "default")
"v2"
if
渡されたブール値式を評価し、結果に基づいて指定された値を返します。
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"
min
渡された引数の最小値を返します。 自然順序を使用します。
min(3, 1, 4)
1
max
渡された引数の最大値を返します。 自然順序を使用します。
max(3, 1, 4)
4
first
最初の引数を取得します。
first("1", "2", "3")
"1"
last
最後に渡された引数を取得します。
last("1", "2", "3")
"3"
uuid /
guid
擬似ランダムIDを生成します。
uuid()
guid()
now
現在の時間を取得します。
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
timestamp
現在のUnix時間を取得します。
timestamp()
1571850624571
format
指定した形式に従って入力日を形式設定します。
format(, "yyyy-MM-dd HH:mm:ss")
"2019-10-23 11:24:35"
dformat
指定した形式に従ってタイムスタンプを日付文字列に変換します。
dformat(1571829875, "dd-MMM-yyyy hh:mm")
"2019年10月23日11:24"
date
日付文字列をZonedDateTimeオブジェクト(ISO 8601形式)に変換します。
date("23-Oct-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
日付の一部を取得します。 次のコンポーネント値がサポートされています。
"year"yy"
yy"
quarter"
"qquarte""
"qmonth"mm"mm""mm"mm""mm""dm"ym"dm"dy"yody"dy""yy"dy"y""dy"y"
day"day"day"day"d"day"day"day"d"dw"w""4"th"hh"12"hh""h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
指定した日付のコンポーネントを置き換えます。 次のコンポーネントを使用できます。
"year"
yy"yy"month"
"mm""mm"'m"day"
"dd""dd""dd""d""hd""h""h""mi"
"ni"n"n"n"n"s"n"n"s"s"
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
パーツから日付を作成します。
make_date_time(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
現在のタイムスタンプを返します。
current_timestamp()
1571850624571
current_date
時間コンポーネントを含まない現在の日付を返します。
current_date()
"2019年11月18日"