SFTP 接続
宛先の変更ログ changelog
2023 年 7 月のExperience Platformリリースでは、以下に示すように、SFTP 宛先が新しい機能を提供します。
- データセット書き出しのサポート。
- 追加のファイル命名オプション。
- 書き出されたファイルにカスタムファイルヘッダーを設定する機能(マッピングステップの改善による)
- 書き出された CSV データファイルの形式をカスタマイズする機能。
概要 overview
SFTP サーバーへのライブアウトバウンド接続を作成して、区切りデータファイルを定期的に Adobe Experience Platform から書き出します。
API または UI を使用した SFTP への接続 connect-api-or-ui
- Platform ユーザーインターフェイスを使用して SFTP ストレージの場所に接続するには、以下の 宛先への接続および この宛先に対するオーディエンスのアクティブ化の節を参照してください。
- プログラムによって SFTP ストレージの場所に接続するには、Flow Service API チュートリアルを使用した、ファイルベースの宛先に対するオーディエンスのアクティブ化を参照してください。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
データセットを書き出し export-datasets
この宛先では、データセットの書き出しをサポートしています。 データセットの書き出しを設定する方法について詳しくは、次のチュートリアルを参照してください。
書き出されたデータのファイル形式 file-format
オーディエンスデータ を書き出す際、Platform は、指定されたストレージの場所に .csv
、parquet
または .json
ファイルを作成します。 ファイルについて詳しくは、Audience Activation チュートリアルの 書き出しでサポートされるファイル形式の節を参照してください。
データセット を書き出す際、Platform は、指定されたストレージの場所に .parquet
または .json
ファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの データセットの書き出しが成功したことを確認するの節を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
認証情報 authentication-information
パスワード付き SFTP 認証タイプを選択して SFTP ストレージの場所に接続する場合:
-
ドメイン:SFTP ストレージの場所のアドレス
-
ユーザー名:SFTP ストレージの場所にログインするためのユーザー名
-
ポート:SFTP ストレージの場所で使用されるポート
-
パスワード:SFTP ストレージの場所にログインするためのパスワード
-
暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
SSH キーを使用した SFTP 認証タイプを選択して SFTP ストレージの場所に接続する場合:
-
ドメイン:SFTP アカウントの IP アドレスまたはドメイン名を入力します
-
ポート:SFTP ストレージの場所で使用されるポート
-
ユーザー名:SFTP ストレージの場所にログインするためのユーザー名
-
SSH キー:SFTP ストレージの場所へのログインに使用する SSH 秘密鍵。 この秘密鍵は、RSA 形式の Base64 エンコード文字列である必要があり、パスワードで保護しないでください。
-
暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しい形式の暗号化キーの例については、以下の画像を参照してください。
宛先の詳細 destination-details
SFTP ストレージの場所への認証接続を確立したら、宛先の次の情報を指定します。
-
名前:Experience Platformユーザーインターフェイスでこの宛先を識別するのに役立つ名前を入力します。
-
説明:この宛先の説明を入力します
-
フォルダーパス:SFTP でファイルを書き出す場所のフォルダーのパスを入力します。
-
ファイルの種類:書き出したファイルに使用するExperience Platformの形式を選択します。 CSV オプションを選択する場合、 ファイル形式オプションを設定することもできます。
-
圧縮形式:書き出したファイルにExperience Platformで使用する圧縮タイプを選択します。
-
マニフェストファイルを含める:書き出しに、書き出しの場所や書き出しのサイズなどに関する情報を含んだマニフェスト JSON ファイルを含めたい場合は、このオプションをオンに切り替えます。 マニフェストには、形式
manifest-<<destinationId>>-<<dataflowRunId>>.json
を使用して名前を付けます。 サンプル マニフェスト ファイルを表示します。 マニフェストファイルには、次のフィールドが含まれています。flowRunId
:書き出されたファイルを生成した データフロー実行。scheduledTime
: ファイルが書き出された時間(UTC 単位)。exportResults.sinkPath
:書き出されたファイルが格納されるストレージの場所のパス。exportResults.name
:書き出すファイルの名前。size
:書き出されたファイルのサイズ(バイト単位)。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先に対してオーディエンスをアクティブ化する手順については、 プロファイル書き出しのバッチ宛先に対するオーディエンスデータのアクティブ化を参照してください。
データの正常な書き出しの検証 exported-data
データが正常に書き出されたかどうかを確認するには、SFTP ストレージを確認し、書き出されたファイルに、想定どおりのプロファイル母集団が含まれていることを確認してください。
IP アドレスの許可リスト ip-address-allow-list
許可リストにAdobe許可リストに加える IP を登録する必要がある場合は、IP アドレスを参照してください。