ファイル転送によるコンバージョンのインポート
Web SDK(Web SDK)、イベント API(Event API)、または手動インポートとの統合の代替として、Rokt Secure FTPを通じてコンバージョンデータをRoktプラットフォームに自動的にアップロードすることができます。まだ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を開き、
ファイル > サイトマネージャー
に移動します。
- 左側で新しいサイトをクリックし、以下の情報を入力します。
プロトコル: SFTP - SSHファイル転送プロトコル
ホスト: ftp.rokt.com
ポート: 22
キーファイル: ローカルのキーファイル(
.pem
)を参照し、ローカルドライブから選択します(下の画像を参照)。
- 接続をクリックします。接続が確立され、アップロードするフォルダが表示されるはずです。
ファイルパスと要件
コンバージョンイベントを含むファイルは、以下のファイルパス内に配置する必要があります:
ファイルパス | 目的 |
---|---|
/upload/conversions | Roktプラットフォームにコンバージョンデータをアップロードする |
いくつかの追加の注意点:
- アップロードされたファイルは、システムによって処理されると自動的にフォルダーから削除されます。
- 必要なファイル形式を使用して準備されたサンプルファイルを使用して、統合をテストすることをお勧めします。
必要なファイル形式
SFTPサーバーにアップロードされたファイルは、Roktデータプラットフォームで正しく処理されるために、以下の基準を満たす必要があります。
- ファイル形式は
.csv
または.txt
である必要があります。 - 文字セットはUTF-8(適切なバイトオーダーマーク付きのUTF-16またはUTF-32)
- メールアドレスのリストは次のようにフォーマットされている必要があります:
- 単一の列で
- 列ヘッダーなし
- メールアドレスはプレーンテキストまたはハッシュ化されたものであることができます。
- メールアドレスをハッシュ化する場合、以下を確実に行ってください:
- SHA256ハッシュアルゴリズムを使用する
- ハッシュ化が行われる前に小文字にし、トリム(空白を削除)する
- 同じフォーマットで全てハッシュ化される—各ファイルにプレーンとハッシュ化されたメールアドレスを混在させないこと(メールは全てプレーン、または全てSHA256でなければならない)
上記の形式に一致しないファイルは、Roktのシステムによって拒否されます。
一時ファイル
一時的な「ステージング」ファイルは、高度なタッチの SFTP統合 からアップロードできます。
"." プレフィックスで名付けられたファイルは、一時ファイルとして扱われ、処理されません。