メインコンテンツまでスキップ

トランザクションのエクスポート

APIのセットアップを開始するには、Roktにいくつかの情報が必要です。

以下の詳細をアカウントマネージャーに送信してください:

  1. システム内でサブスクライバーを作成するための完全なAPIドキュメント
  2. セットアップのクエリをトラブルシューティングするための技術的な連絡先情報
  3. 関連する環境（本番、テスト、ステージングなど）のエンドポイント
  4. メソッド（例: GET, POST, PUT）
  5. 認証（ある場合）
  6. リクエストボディのエンコーディング（例: JSON, XML, URLエンコード）
  7. 必要なAPIパラメータ（Roktが共有できる属性について学びます。）
  8. Roktがリードを正確に分類するための期待されるAPIレスポンス（成功したものと拒否されたもの）

API接続のセットアップ​

  1. my.rokt.com にログオンします

  2. アカウントに移動します。

  3. Integrationsをクリックします。

  4. Connectionsをクリックします。

  5. Add connectionをクリックします。

  6. Transactionsの下で、APIを選択します。

    1. 接続に名前を付けます。

      Transaction Export via API

    2. 接続のエンドポイントを入力します。

      Transaction Export via API

    3. Authorization、Headers、Bodyの下に必要な情報をすべて入力します。

      Transaction Export via API

    4. Response handlingのルールをすべて入力します。

      Transaction Export via API

    5. API接続（エンドポイント、認証、ヘッダー、ボディ、レスポンスハンドリング）がセットアップされたら、Settingsをクリックします。

      Transaction Export via API

    6. テスト基準に従ってテスト設定を編集します。

    Transaction Export via API

    1. Saveをクリックします。

    2. Testをクリックします。

      Transaction Export via API

    3. テスト結果を確認します。

    4. 望む結果が得られるまでテストを繰り返します。

API接続にプレースメントをリンクする​

  1. my.rokt.com にログオンします。

  2. アカウントに移動します。

  3. Integrations をクリックします。

  4. Connections をクリックします。

  5. 左のドロップダウンメニューから Real-time を選択し、右のドロップダウンメニューから Transactions を選択します。

  6. プレースメントをリンクしたい接続を展開します。

    Transaction Export via API

  7. Show unlinked をクリックします。

    Transaction Export via API

  8. All Placements に対して Link をクリックします。

    Transaction Export via API

  9. すべてのプレースメントが接続にリンクされました。

    Transaction Export via API

API接続からプレースメントをアンリンクする​

  1. my.rokt.com にログオンします。

  2. アカウントに移動します。

  3. Integrations をクリックします。

  4. Connections をクリックします。

  5. 左のドロップダウンメニューから Real-time を選択し、右のドロップダウンメニューから Transactions を選択します。

  6. プレースメントをアンリンクしたい接続を展開します。

    Transaction Export via API

  7. すべてのプレースメントをアンリンクするには Unlink をクリックします。

    Transaction Export via API

  8. すべてのプレースメントがアンリンクされました。

スケジュールされた配信​

ホストコンピュータ（例：ノートパソコン）から安全なFTPサーバーへの接続を確立するには、サードパーティのクライアントソフトウェアが必要です。このチュートリアルでは、Windows、Mac、Linuxオペレーティングシステムで利用可能な人気の無料クライアントFileZillaを推奨します。

  1. ブラウザで https://filezilla-project.org/ にアクセスし、Download FileZilla Client をクリックします。
  2. FileZillaをコンピュータにインストールします。すでにFileZillaがインストールされている場合は、最新バージョンを実行していることを確認してください。
  3. Roktのアカウントマネージャーに連絡して、Rokt SFTPへのアクセスをリクエストしてください。アクセスが許可されると、「You've been granted access to Rokt's SFTP server」という件名のメールがRoktから届きます。
  4. 添付ファイルをダウンロードし、「Email for password for file with instructions」という2通目のメールで提供されたパスワードを使用して暗号化されたファイルを解凍します。
  5. 解凍した暗号化ファイルには、RoktのSFTPフォルダにアクセスするためのキー・ファイルである.pemファイルが含まれています。
注記

以下の手順は、Windows、Mac、Linuxオペレーティングシステムで共通であり、最新バージョンのFileZillaに基づいています。

  1. FileZillaを開き、File > Site Manager に移動します

Rokt SFTP Setup

  1. 左側で New Site をクリックし、次の情報を入力します：

  • Protocol: SFTP – SSH File Transfer Protocol

  • Host: ftp.rokt.com

  • Port: 22

  • Key file: ローカルのキー・ファイル (.pem) を参照し、ローカルドライブから選択します（下の画像を参照）。

    Rokt SFTP Setup

  1. Connect をクリックします。接続され、ファイルをアップロードするためのアクセス可能なフォルダが表示されるはずです。

Secure File Transfer Protocol (SFTP) 接続は、データ配信を自動化し、設定にほとんど手間がかかりません。必要なのはSFTPの認証情報だけで、すぐに始められます！

SFTP接続を設定した後、任意の頻度でトランザクションデータを含むCSVファイルがメールで送信されます。

RoktのSFTP接続​

始める前に​

まだRokt SFTPへのアクセス権がない場合は、アカウントマネージャーに連絡してください。

以下の情報を手元に用意してください:

  1. 配信頻度—トランザクションがSFTPサーバーにアップロードされる頻度と時間。
  2. 必要なパラメータ—最も一般的なものはemail、first name、last name、source、stateです。利用可能なすべての属性については、トランザクションメタデータを参照してください。

ファイルパスと要件​

トランザクションデータファイルは以下のファイルパスに配置されます:

ファイルパス目的
/downloadsRoktが提供するトランザクションデータのダウンロード
注記

トランザクションファイルは14日後にこのフォルダから自動的に削除されます。

独自のFTP接続を使用する​

  1. my.rokt.com にログオンします

  2. アカウントに移動します。

  3. Integrations をクリックします。

  4. Connections をクリックします。

  5. Add connection をクリックします。

  6. Transactions の下で、FTP をクリックします。

  7. この接続のテンプレートを選択し、接続に名前を付けます。

    Transaction Export via Client SFTP

  8. ディレクトリとファイル名を入力します。

    Transaction Export via Client SFTP

  9. FTPサーバーホストの詳細とポートを入力します。

    Transaction Export via Client SFTP

  10. 希望するFTPメソッドを選択します。

Transaction Export via Client SFTP

  1. ユーザー名とパスワードを入力するか、ユーザー名を入力してキー・ファイルをアップロードします。

Transaction Export via Client SFTP

  1. スケジュールを選択して、Save をクリックします。

    Transaction Export via Client SFTP

  2. 接続が作成されました。

FTP接続の無効化​

  1. my.rokt.com にログインします

  2. アカウントに移動します。

  3. Integrations をクリックします。

  4. Connections をクリックします。

  5. 左のドロップダウンメニューから Scheduled を選択し、右のドロップダウンメニューから Transactions を選択します。

    Transaction Export via Client SFTP

  6. Pause をクリックします。

    Transaction Export via Client SFTP

  7. メール接続が無効になります。

    Transaction Export via Client SFTP

  8. これらの手順を逆にすることで、接続を再度有効にすることができます。

手動エクスポート​

取引データの受け取り方法に関わらず、すべてのデータは常にRoktプラットフォームでアクセス可能です。Transactions > Customer Data > Export に移動します。

APIの障害やメールの削除など、何か問題が発生した場合でも心配ありません！いつでもRoktにログインして、すべての取引データをダウンロードできます。

RoktはCSV形式でダウンロード可能なデータを提供しています。ダウンロードするには：

  1. my.rokt.com にログインします

  2. アカウントに移動します。

  3. Transactions をクリックします。

  4. Customer Data をクリックします。

  5. 取引データを表示したい配置を選択します。

  6. 上部のナビゲーションバーで日付範囲を調整します。

  7. Export をクリックします。

  8. エクスポートはすぐにコンピュータにダウンロードされ始めます。レポート内のレコード数に応じて、完了までに少し時間がかかることがあります。ほとんどの一般的なスプレッドシートアプリケーションでCSVファイルを開くことができるはずです。

注記

一度にダウンロードできる最大レコード数は100,000件です。

エクスポートデータフィールドのカスタマイズ​

エクスポートは、トランザクションの主要フィールドを含むデフォルトテンプレートを使用します。必要に応じて、列を追加、削除、並べ替えることで、エクスポートするデータをカスタマイズできます。

  1. my.rokt.com にログオンします

  2. アカウントに移動します。

  3. Transactions をクリックします。

  4. Customer Data をクリックします。

  5. Template ドロップダウンから、Create new template を選択します。

    Transaction Export Manually

  6. 表示される画面で、ドロップダウンメニューを使用してデータフィールドを追加または削除します。

    Transaction Export Manually

  7. フィールドをドラッグアンドドロップして、エクスポートファイル内の列の順序を更新します。

    Transaction Export Manually

  8. Save as をクリックし、テンプレート名を入力して、今後のエクスポートでこのテンプレートを使用する場合に備えます。

    Transaction Export Manually

  9. Export をクリックして、データをCSVファイルにダウンロードします。

    Transaction Export Manually

この記事は役に立ちましたか？
Last updated Oct 29, 2025