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

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

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. 添付ファイルをダウンロードし、2通目のメール「Email for password for file with instructions」で提供されたパスワードを使用して暗号化されたファイルを解凍します。
  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. 必要なパラメータ—最も一般的なのはメール、名前、姓、ソース、および州です。利用可能なすべての属性については、取引メタデータを参照してください。

ファイルパスと要件​

取引データファイルは以下のファイルパスに配置されます:

ファイルパス目的
/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

この記事は役に立ちましたか？