安全なファイル転送
Web SDKと統合する、Event APIを使用する、または手動でインポートする代わりに、Rokt Secure FTPを通じてRoktプラットフォームに変換データを自動的にアップロードすることができます。まだRokt SFTPへのアクセスがない場合は、以下の指示に従う前にアカウントマネージャーに連絡してください。
Rokt SFTPへの接続
ホストコンピュータ（例：ノートパソコン）から安全なFTPサーバーへの接続を確立するには、サードパーティのクライアントソフトウェアが必要です。このチュートリアルでは、Windows、Mac、Linuxオペレーティングシステムで利用可能な人気の無料クライアントFileZillaを推奨します。
- ブラウザでhttps://filezilla-project.org/にアクセスし、**Download FileZilla Client**をクリックします。
- FileZillaをコンピュータにインストールします。すでにFileZillaがインストールされている場合は、最新バージョンを実行していることを確認してください。
- Roktアカウントマネージャーに連絡してRokt SFTPへのアクセスをリクエストします。アクセスが許可されると、Roktから「You've been granted access to Rokt's SFTP server」という件名のメールが届くはずです。
- 添付ファイルをダウンロードし、2通目のメール「Email for password for file with instructions」で提供されたパスワードを使用して暗号化されたファイルを解凍します。
- 解凍した暗号化ファイルには、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のシステムによって拒否されます。