トランザクションのエクスポート
API設定を開始するには、Roktにいくつかの情報が必要です。
以下の詳細をアカウントマネージャーに送信してください:
- システム内でサブスクライバーを作成する方法に関する完全なAPIドキュメント。
- 設定のトラブルシューティングを支援するための技術連絡先情報。
- 関連する環境（本番、テスト、ステージングなど）のエンドポイント。
- メソッド（例：GET、POST、PUT）
- 認証（ある場合）
- リクエストボディのエンコーディング（例：JSON、XML、URLエンコード）
- 必要なAPIパラメータ（Roktが共有できる属性について学びます。）
- Roktが正常に配信されたリードと拒否されたリードを正確に分類するための期待されるAPIレスポンス。
API接続の設定
my.rokt.com にログオンします。
アカウントに移動します。
Integrationsをクリックします。
Connectionsをクリックします。
Add connectionをクリックします。
Transactionsの下で、APIを選択します。
接続に名前を付けます。
接続のエンドポイントを入力します。
Authorization、Headers、およびBodyの下に必要な情報をすべて入力します。
すべてのResponse handlingルールを入力します。
API接続（エンドポイント、認証、ヘッダー、ボディ、およびレスポンス処理）が設定されたら、Settingsをクリックします。
テスト基準に従ってテスト設定を編集します。
Saveをクリックします。
Testをクリックします。
テスト結果を確認します。
望ましい結果が得られるまでテストを繰り返します。
API接続へのプレースメントのリンク
my.rokt.com にログオンします。
アカウントに移動します。
Integrations をクリックします。
Connections をクリックします。
左のドロップダウンメニューから Real-time を、右のドロップダウンメニューから Transactions を選択します。
リンクしたい接続を展開します。
Show unlinked をクリックします。
All Placements の Link をクリックします。
すべてのプレースメントが接続にリンクされました。
API接続からプレースメントのリンクを解除
my.rokt.com にログオンします。
アカウントに移動します。
Integrations をクリックします。
Connections をクリックします。
左のドロップダウンメニューから Real-time を、右のドロップダウンメニューから Transactions を選択します。
リンクを解除したい接続を展開します。
すべてのプレースメントのリンクを解除するには Unlink をクリックします。
すべてのプレースメントのリンクが解除されました。
定期配送
ホストコンピュータ（例：ノートパソコン）から安全なFTPサーバーへの接続を確立するには、サードパーティのクライアントソフトウェアが必要です。このチュートリアルでは、Windows、Mac、およびLinuxオペレーティングシステムで利用可能な人気の無料クライアントFileZillaを推奨します。
- ブラウザで https://filezilla-project.org/ にアクセスし、Download FileZilla Client をクリックします。
- FileZillaをコンピュータにインストールします。すでにFileZillaがインストールされている場合は、最新バージョンを実行していることを確認してください。
- Roktのアカウントマネージャーに連絡して、Rokt SFTPへのアクセスをリクエストします。アクセスが許可されると、「You've been granted access to Rokt's SFTP server」という件名のメールがRoktから届くはずです。
- 添付ファイルをダウンロードし、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 をクリックします。接続され、ファイルをアップロードするためのアクセス可能なフォルダが表示されるはずです。
Secure File Transfer Protocol (SFTP) 接続は、データ配送を自動化し、設定にほとんど手間がかかりません。必要なのはSFTPの資格情報だけで、すぐに始められます！
SFTP接続を設定した後、任意の頻度でトランザクションデータを含むCSVファイルがメールで届きます。
RoktのSFTP接続
始める前に
まだRoktのSFTPにアクセスできない場合は、アカウントマネージャーに連絡してください。
以下の情報を手元に用意してください:
- 配信頻度—取引がSFTPサーバーにアップロードされる頻度と時間。
- 必要なパラメータ—最も一般的なのはメール、名前、姓、ソース、および州です。利用可能なすべての属性については、取引メタデータを参照してください。
ファイルパスと要件
取引データファイルは以下のファイルパスに配置されます:
| ファイルパス | 目的 |
|---|---|
| /downloads | Roktが提供する取引データのダウンロード |
取引ファイルは14日後にこのフォルダから自動的に削除されます。
独自のFTP接続を使用する
my.rokt.com にログインします
アカウントに移動します。
Integrations をクリックします。
Connections をクリックします。
Add connection をクリックします。
Transactions の下で、FTP をクリックします。
この接続のテンプレートを選択し、接続に名前を付けます。
ディレクトリとファイル名を入力します。
FTPサーバーホストの詳細とポートを入力します。
希望するFTPメソッドを選択します。
ユーザー名とパスワードを入力するか、ユーザー名を入力してキー ファイルをアップロードします。
スケジュールを選択し、Save をクリックします。
接続が作成されました。
FTP接続を無効にする
my.rokt.com にログインします。
アカウントに移動します。
Integrations をクリックします。
Connections をクリックします。
左のドロップダウンメニューから Scheduled を選択し、右のドロップダウンメニューから Transactions を選択します。
Pause をクリックします。
メール接続が無効になります。
これらの手順を逆にして接続を有効にすることができます。
手動エクスポート
トランザクションデータをどのように受け取りたいかに関わらず、すべてのデータは常にRoktプラットフォームで Transactions > Customer Data > Export にアクセスすることで利用可能です。
APIの障害やメールの削除など、何か問題が発生した場合でも心配いりません！いつでもRoktにログインして、すべてのトランザクションデータをダウンロードできます。
RoktはCSV形式でのデータダウンロードを提供しています。ダウンロードするには：
my.rokt.com にログインします。
アカウントに移動します。
Transactions をクリックします。
Customer Data をクリックします。
トランザクションデータを表示したい配置を選択します。
上部のナビゲーションバーで日付範囲を調整します。
Export をクリックします。
エクスポートがすぐにコンピュータにダウンロードされ始めます。レポートのレコード数によっては、完了までに少し時間がかかる場合があります。ほとんどの一般的なスプレッドシートアプリケーションでCSVファイルを開くことができるはずです。
一度にダウンロードできるレコードの最大数は100,000です。
エクスポートデータフィールドのカスタマイズ
エクスポートは、トランザクションの主要フィールドを含むデフォルトテンプレートを使用します。必要に応じて、列を追加、削除、および並べ替えることで、エクスポートするデータをカスタマイズできます。
my.rokt.com にログインします。
アカウントに移動します。
Transactions をクリックします。
Customer Data をクリックします。
Template ドロップダウンから、Create new template を選択します。
表示される画面で、ドロップダウンメニューを使用してデータフィールドを追加または削除します。
フィールドをドラッグアンドドロップして、エクスポートファイルの列の順序を更新します。
Save as をクリックし、テンプレート名を入力して、将来のエクスポートにこのテンプレートを使用する場合に備えます。
Export をクリックして、データをCSVファイルにダウンロードします。
