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