セキュアファイル転送
Web SDKとの統合、Event APIの使用、または手動インポートの代わりに、Roktプラットフォームへの変換データのアップロードを自動化するために、RoktセキュアFTPを使用することもできます。Rokt SFTPへのアクセス権がまだない場合は、以下の手順に従う前にアカウントマネージャーに連絡してください。
Rokt SFTPへの接続
ホストコンピュータ（例：ラップトップ）からセキュアFTPサーバーへの接続を確立するには、サードパーティのクライアントソフトウェアが必要です。このチュートリアルでは、Windows、Mac、Linuxオペレーティングシステムで利用可能な人気のある無料クライアントソフトウェアであるFileZillaを使用することをおすすめします。
- ブラウザで、https://filezilla-project.org/ にアクセスし、FileZilla Clientをダウンロードをクリックします。
- FileZillaをコンピュータにインストールします。すでにFileZillaをインストールしている場合は、最新バージョンを実行していることを確認してください。
- Roktアカウントマネージャーに連絡して、Rokt SFTPへのアクセスをリクエストします。アクセスが許可されると、Roktから「RoktのSFTPサーバーへのアクセスが許可されました」という件名のメールが届きます。
- 添付ファイルをダウンロードし、2番目のメール「ファイルのパスワードに関するメール」で提供されたパスワードを使用して暗号化されたファイルを解凍します。
- 解凍した暗号化されたファイルには、RoktのSFTPフォルダにアクセスするためのキーファイルである
.pemファイルが含まれています。
注記
以下の手順は、Windows、Mac、Linuxオペレーティングシステムに対して同じであり、最新バージョンのFileZillaを基にしています。
- FileZillaを開き、
File > Site Managerに移動します。
- 左側で、新しいサイトをクリックし、以下を入力します:
プロトコル: SFTP – SSHファイル転送プロトコル
ホスト: ftp.rokt.com
ポート: 22
キーファイル: ローカルのキーファイル（
.pem）に移動し、ローカルドライブから選択します（以下の画像を参照）。
- 接続をクリックします。接続が確立され、アップロードするフォルダが表示されるはずです。
ファイルパスと要件
変換イベントを含むファイルは、次のファイルパスに配置する必要があります:
| ファイルパス | 目的 |
|---|---|
| /upload/conversion | Roktプラットフォームに変換データをアップロードする |
いくつかの追加の注意点:
- アップロードされたファイルは、システムによって処理されると自動的にフォルダから削除されます。
- 必要なファイル形式を使用して準備されたサンプルファイルを使用して、統合をテストすることをお勧めします。
必要なファイル形式
SFTPサーバーにアップロードされるファイルは、Roktデータプラットフォームで正しく処理されるために、次の基準を満たす必要があります。
- ファイル形式は
.csvまたは.txtである必要があります。 - 文字セットはUTF-8 (UTF-16またはUTF-32で適切なバイトオーダーマークを使用)
- メールアドレスのリストは次のようにフォーマットする必要があります:
- 単一の列に
- 列見出しはなし
- メールアドレスはプレーンテキストまたはハッシュ化されている必要があります。
- メールアドレスをハッシュ化する場合は、次のことを確認してください:
- SHA256ハッシュアルゴリズムを使用する
- ハッシュ化が行われる前に、小文字に変換され、トリムされている（ホワイトスペースが削除されている）
- ファイルごとにプレーンテキストとハッシュ化されたメールアドレスを混在させないでください（メールはすべてプレーンテキストまたはすべてSHA256である必要があります）
上記の形式に一致しないファイルは、Roktのシステムによって拒否されます。