トランザクションのエクスポート
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/にアクセスし、**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
)に移動し、ローカルドライブから選択します(下の画像を参照)。
- 接続をクリックします。接続が確立され、ファイルをアップロードするためのアクセス可能なフォルダが表示されるはずです。
セキュアファイル転送プロトコル(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プラットフォームには常にアクセスできます。取引 > 顧客データ > エクスポートに移動することで、いつでもデータにアクセスできます。
何か問題が発生した場合(APIの障害やメールの削除など)、心配しないでください!いつでもRoktにログインして、いつでも取引データをダウンロードできます。
RoktはCSV形式でダウンロード可能なデータを提供しています。ダウンロードするには、以下の手順を実行してください:
my.rokt.com にログインします。
アカウントに移動します。
取引をクリックします。
顧客データをクリックします。
取引データを表示したい配置を選択します。
上部ナビゲーションバーで日付範囲を調整します。
エクスポートをクリックします。
エクスポートはすぐにコンピュータにダウンロードされます。レポート内のレコード数によっては、完了までに少し時間がかかる場合があります。CSVファイルは、ほとんどの一般的なスプレッドシートアプリケーションで開くことができるはずです。
一度にダウンロードできるレコードの最大数は10万件です。
エクスポートデータフィールドのカスタマイズ
エクスポートは、取引のキーフィールドを含むデフォルトのテンプレートを使用します。必要に応じて、列を追加、削除、および並べ替えてエクスポートするデータをカスタマイズすることができます。
my.rokt.com にログインします。
アカウントに移動します。
取引 をクリックします。
顧客データ をクリックします。
テンプレート ドロップダウンから 新しいテンプレートを作成 を選択します。
表示される画面で、ドロップダウンメニューを使用してデータフィールドを追加または削除します。
フィールドをドラッグアンドドロップしてエクスポートファイルの列の順序を更新します。
名前を付けて保存 をクリックし、将来のエクスポートにこのテンプレートを使用する場合はテンプレート名を入力します。
データをCSVファイルとしてダウンロードするには、エクスポート をクリックします。