SFTP 接続

宛先の変更ログ changelog

2023 年 7 月のExperience Platformリリースでは、以下に示すように、SFTP 宛先が新しい機能を提供します。

概要 overview

SFTP サーバーへのライブアウトバウンド接続を作成して、区切りデータファイルを定期的に Adobe Experience Platform から書き出します。

IMPORTANT
Experience Platform では SFTP サーバーへのデータの書き出しをサポートしていますが、データを書き出す際に推奨されるクラウドストレージの場所は Amazon S3 と Azure Blob です。

API または UI を使用した SFTP への接続 connect-api-or-ui

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Experience Platform セグメント化サービスを通じて生成されたオーディエンス。
カスタムアップロード
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
宛先のアクティベーションワークフローのプロファイル属性選択画面で選択した目的のスキーマフィールド(例:メールアドレス、電話番号、姓)と共に、セグメントのすべてのメンバーを書き出します。
書き出し頻度
バッチ
バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。 詳しくは、バッチ(ファイルベース)宛先を参照してください。

宛先カタログでハイライト表示された SFTP プロファイルベースの書き出しタイプ。

データセットを書き出し export-datasets

この宛先では、データセットの書き出しをサポートしています。 データセットの書き出しを設定する方法について詳しくは、次のチュートリアルを参照してください。

書き出されたデータのファイル形式 file-format

オーディエンスデータ を書き出す際、Platform は、指定されたストレージの場所に .csvparquet または .json ファイルを作成します。 ファイルについて詳しくは、Audience Activation チュートリアルの 書き出しでサポートされるファイル形式の節を参照してください。

データセット を書き出す際、Platform は、指定されたストレージの場所に .parquet または .json ファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの データセットの書き出しが成功したことを確認するの節を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先の表示 および 宛先の管理 アクセス制御権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

認証情報 authentication-information

パスワード付き SFTP 認証タイプを選択して SFTP ストレージの場所に接続する場合:

パスワードを使用した SFTP 宛先の基本認証。

  • ドメイン:SFTP ストレージの場所のアドレス

  • ユーザー名:SFTP ストレージの場所にログインするためのユーザー名

  • ポート:SFTP ストレージの場所で使用されるポート

  • パスワード:SFTP ストレージの場所にログインするためのパスワード

  • 暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。

    UI での正しい形式の PGP キーの例を示す画像。

SSH キーを使用した SFTP 認証タイプを選択して SFTP ストレージの場所に接続する場合:

SFTP 宛先の SSH キー認証。

  • ドメイン:SFTP アカウントの IP アドレスまたはドメイン名を入力します

  • ポート:SFTP ストレージの場所で使用されるポート

  • ユーザー名:SFTP ストレージの場所にログインするためのユーザー名

  • SSH キー:SFTP ストレージの場所へのログインに使用する SSH 秘密鍵。 この秘密鍵は、RSA 形式の Base64 エンコード文字列である必要があり、パスワードで保護しないでください。

  • 暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しい形式の暗号化キーの例については、以下の画像を参照してください。

    UI での正しい形式の PGP キーの例を示す画像。

宛先の詳細 destination-details

SFTP ストレージの場所への認証接続を確立したら、宛先の次の情報を指定します。

SFTP 宛先の宛先詳細フィールド。

  • 名前:Experience Platformユーザーインターフェイスでこの宛先を識別するのに役立つ名前を入力します。

  • 説明:この宛先の説明を入力します

  • フォルダーパス:SFTP でファイルを書き出す場所のフォルダーのパスを入力します。

  • ファイルの種類:書き出したファイルに使用するExperience Platformの形式を選択します。 CSV オプションを選択する場合、 ファイル形式オプションを設定することもできます。

  • 圧縮形式:書き出したファイルにExperience Platformで使用する圧縮タイプを選択します。

  • マニフェストファイルを含める:書き出しに、書き出しの場所や書き出しのサイズなどに関する情報を含んだマニフェスト JSON ファイルを含めたい場合は、このオプションをオンに切り替えます。 マニフェストには、形式 manifest-<<destinationId>>-<<dataflowRunId>>.json を使用して名前を付けます。 サンプル マニフェスト ファイルを表示します。 マニフェストファイルには、次のフィールドが含まれています。

    • flowRunId:書き出されたファイルを生成した データフロー実行
    • scheduledTime: ファイルが書き出された時間(UTC 単位)。
    • exportResults.sinkPath:書き出されたファイルが格納されるストレージの場所のパス。
    • exportResults.name:書き出すファイルの名前。
    • size:書き出されたファイルのサイズ(バイト単位)。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、宛先の表示宛先のアクティブ化プロファイルの表示 および セグメントの表示 アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

  • ID を書き出すには、ID グラフの表示 アクセス制御権限が必要です。

    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

この宛先に対してオーディエンスをアクティブ化する手順については、 プロファイル書き出しのバッチ宛先に対するオーディエンスデータのアクティブ化を参照してください。

データの正常な書き出しの検証 exported-data

データが正常に書き出されたかどうかを確認するには、SFTP ストレージを確認し、書き出されたファイルに、想定どおりのプロファイル母集団が含まれていることを確認してください。

IP アドレスの許可リスト ip-address-allow-list

許可リストにAdobe許可リストに加える IP を登録する必要がある場合は、IP アドレスを参照してください。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6