SFTPイベント統合ガイド
Rokt AdsのSFTP統合により、広告主や技術パートナーは、変換データやイベントデータを一つまたは複数の.csvファイルとしてバッチ形式でRoktに安全に送信できます。変換データをRoktに送信することで、広告の露出とその後の成果の間のループを閉じ、Roktネットワーク内の広告主にとってキャンペーンの最適化と全体的なパフォーマンスの向上を可能にします。
前提条件前提条件 への直接リンク
始める前に、以下を確認してください:
- SFTPクライアントへのアクセス（例: FileZilla、WinSCP、またはコマンドライン
sftp） - 安全な資格情報交換のためのKeybaseアカウント
- Roktアカウントマネージャーの連絡先情報
1. CSVファイルの作成1. CSVファイルの作成 への直接リンク
以下のガイドラインに従ってCSVファイルを準備してください。
ファイル形式の要件ファイル形式の要件 への直接リンク
- ファイルはRFC 4180 CSV形式の標準に準拠している必要があります。
- サポートされているファイル形式:
- プレーンCSV (
.csv) - 一つまたは複数のCSVファイルを含むZIPアーカイブ (
.zip) - Gzip圧縮CSV (
.csv.gz) .gpg拡張子のPGP暗号化ファイル（例:.csv.gpgまたは.csv.gz.gpg）。Roktの公開鍵についてはRoktアカウントマネージャーにお問い合わせください。
- プレーンCSV (
- ファイルサイズ: 5 MB – 2 GB（最適）。大きなデータセットは複数のファイルに分割して並列処理を行ってください。
- ファイルごとに最大50列。
- 最大行サイズ: 80 KB。
- すべての列名は一意でなければなりません。
- アップロード時にサブフォルダを使用しないでください。
ファイル命名ファイル命名 への直接リンク
データタイプに基づいて次の命名規則を使用してください:
| ファイル名パターン | 例 |
|---|---|
<name>-custom_event.csv | purchases-custom_event.csv |
ファイル名の<name>部分にダッシュ(-)やドット(.)を避けてください。custom_eventの前のダッシュは必要です。
データ要件データ要件 への直接リンク
各行には少なくとも1つの有効なユーザーを含める必要があります。
有効なアイデンティティ値がない行は処理に失敗します。すべての行に少なくとも1つのアイデンティティ列に値が含まれていることを確認してください。
ルートレベルのフィールドルートレベルのフィールド への直接リンク
| 列名 | 例の値 | 備考 |
|---|---|---|
environment | production | 環境識別子（例: development, production）。 |
ip | 8.8.8.8 | ユーザーのIPアドレス。 |
イベント属性イベント属性 への直接リンク
変換/イベントデータの場合、以下の列を含めてください:
| 列名 | 例の値 | 必須 | 備考 |
|---|---|---|---|
events.data.timestamp_unixtime_ms | 1699123456789 | はい | イベントのタイムスタンプ（Unixミリ秒）。 |
events.data.event_name | conversion | はい | 常にconversionに設定。 |
events.data.custom_event_type | transaction | はい | 常にtransactionに設定。 |
events.data.custom_attributes.conversiontype | purchase | はい | ユーザーが行ったアクションのタイプ（例: signup, purchase, install）。 |
events.data.custom_attributes.confirmationref | ORD-54321 | はい | 重複排除のための一意の参照。 |
events.data.custom_attributes.amount | 99.99 | いいえ | トランザクション金額（数値）。該当する場合に含めてください。 |
ユーザーIDユーザーID への直接リンク
| 列名 | 例示値 | 備考 |
|---|---|---|
user_identities.email | j.smith@example.com | ユーザーのメールアドレス（プレーンテキスト）。 |
user_identities.other | fab1e2e699b3b927cbf875046a64f222 | ハッシュ化されたメールまたは他の識別子。SHA-256を使用します。ハッシュ化する前に小文字にし、末尾のスペースを削除します。 |
ユーザー属性ユーザー属性 への直接リンク
一致率を向上させるために、以下の属性を可能な限り多く含めてください:
| 列名 | 例示値 | 備考 |
|---|---|---|
user_attributes.FirstName | John | 顧客の名前。 |
user_attributes.FirstNameSha256 | fab1e2e699b3b927cbf875046a64f222 | 名前のSHA-256ハッシュ。ハッシュ化する前に小文字にし、スペースを削除します。 |
user_attributes.LastName | Doe | 顧客の姓。 |
user_attributes.LastNameSha256 | fab1e2e699b3b927cbf875046a64f222 | 姓のSHA-256ハッシュ。ハッシュ化する前に小文字にし、スペースを削除します。 |
user_attributes.Mobile | 3125551515 | 電話番号。1112345678 または +1 (222) 345-6789 の形式を受け入れます。 |
user_attributes.MobileSha256 | fab1e2e699b3b927cbf875046a64f222 | SHA-256ハッシュ。5551234567 の形式で（数字のみ、国コードなし）。 |
user_attributes.Age | 33 | 顧客の年齢。 |
user_attributes.Dob | 19900717 | YYYYMMDD 形式の生年月日。 |
user_attributes.Gender | M | 顧客の性別: M, Male, F, または Female. |
user_attributes.City | Brooklyn | 顧客の市区町村。 |
user_attributes.State | NY | 顧客の州（米国の場合は2文字コード）。 |
user_attributes.Zip | 11201 | 顧客の郵便番号。 |
user_attributes.Title | Mr | 顧客の敬称: Mr, Mrs, Ms, など。 |
user_attributes.Language | en | ISO 639-1 言語コード。 |
user_attributes.Value | 52.25 | 顧客の金銭的価値。 |
user_attributes.PredictedLtv | 136.23 | 顧客の予測生涯価値。 |
デバイス識別子デバイス識別子 への直接リンク
| 列名 | 例の値 | 備考 |
|---|---|---|
device_info.http_header_user_agent | Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) | ブラウザまたはデバイスのユーザーエージェント文字列。 |
device_info.android_advertising_id | 38400000-8cf0-11bd-b23e-10b96e40000d | Android用のGoogle広告ID (GAID)。 |
device_info.android_uuid | 550e8400-e29b-41d4-a716-446655440000 | AndroidデバイスのUUID。 |
device_info.ios_advertising_id | 38400000-8cf0-11bd-b23e-10b96e40000d | iOS広告ID (IDFA)。 |
device_info.ios_idfv | 550e8400-e29b-41d4-a716-446655440000 | iOSベンダー識別子 (IDFV)。 |
CSVファイルの例CSVファイルの例 への直接リンク
テンプレートとして使用するサンプルファイルをダウンロード:
2. SFTP資格情報の取得2. SFTP資格情報の取得 への直接リンク
Roktは安全な資格情報交換のためにKeybaseを使用します。
SFTPサーバーの詳細:
- ホスト:
sftp://sftp.us2.mparticle.com - ポート:
4422
グラフィカルなSFTPクライアントを使用する場合、ホスト sftp.us2.mparticle.com、プロトコル SFTP、ポート 4422 を使用します (またはクライアントがフルURLを受け入れる場合は sftp://sftp.us2.mparticle.com を貼り付けます)。プロンプトが表示されたら、アカウントマネージャーからのユーザー名とパスワードを入力してください。
資格情報を取得するには:
- keybase.io で職場のメールを使用してKeybaseアカウントを作成します。
- RoktアカウントマネージャーにKeybaseのユーザー名を共有します。
- アカウントマネージャーが暗号化されたKeybaseチャットを通じてSFTP資格情報を送信します。
資格情報を安全に保管してください。メールやその他の暗号化されていないチャネルで共有しないでください。
3. CSVファイルのアップロード3. CSVファイルのアップロード への直接リンク
- SFTPサーバーに接続します:
sftp -P 4422 your_username@sftp.us2.mparticle.com
- ドロップフォルダ構造に移動するか作成します:
cd drop
mkdir US2-123456789123456789 # Use the folder name provided by your Account Manager
cd US2-123456789123456789
- CSVファイルをアップロードします:
put purchases-custom_event.csv
フォルダ名に末尾のスペースがないことを確認してください。フォルダ名は大文字と小文字を区別します。
次に何が起こるか次に何が起こるか への直接リンク
ファイルはアップロード後すぐに処理キューに追加されます。処理が成功したか確認する必要がある場合や問題が発生した場合は、Roktのアカウントマネージャーに連絡してください。