SFTPオーディエンス統合ガイド

Rokt AdsのSFTP統合により、広告主や技術パートナーはオーディエンスセグメントを.csvファイルとしてフォーマットされたバッチでRoktに安全に送信し、キャンペーンのターゲティングや抑制に使用するためにユーザーデータを同期させることができます。Rokt Adsとオーディエンスを同期させることで、誤ったユーザーに配信される広告が減少し、無駄な支出が削減され、キャンペーン全体のパフォーマンスが向上します。

前提条件

始める前に、以下を確認してください:

• SFTPクライアントへのアクセス（例: FileZilla, WinSCP, またはコマンドラインsftp）
• セキュアな資格情報交換のためのKeybaseアカウント

1. CSVファイルの作成

オーディエンスデータをRoktに正常に送信するためには、以下のガイドラインに従ってCSVファイルとしてフォーマットしてください:

ファイルフォーマット要件

• ファイルはRFC 4180のCSVフォーマット標準に準拠している必要があります。
• サポートされているファイルフォーマット:
  • プレーンCSV (.csv)
  • 1つ以上のCSVファイルを含むZIPアーカイブ (.zip)
  • Gzip圧縮されたCSV (.csv.gz)
  • .gpg拡張子のPGP暗号化ファイル（例: .csv.gpgまたは.csv.gz.gpg）。Roktの公開鍵については、Roktアカウントマネージャーにお問い合わせください。
• ファイルサイズ: 5 MB – 2 GB（最適）。より大きなデータセットは、並列処理のために複数のファイルに分割してください。
• ファイルあたり最大50列。
• 最大行サイズ: 80 KB。
• すべての列名は一意でなければなりません。
• アップロード時にサブフォルダを使用しないでください。

ファイル命名

ファイルには以下の命名規則を使用してください:

ファイル名パターン	例
<name>-audience.csv	premium_users-audience.csv

注意

ファイル名の<name>部分にダッシュ(-)やドット(.)を避けてください。audienceの前のダッシュは必須です。

データ要件

各行には少なくとも1つの有効なユーザーが含まれている必要があります。

注記

有効な識別値が欠けている行は処理に失敗します。すべての行に少なくとも1つの識別列が値を含んでいることを確認してください。

ルートレベルフィールド

列名	例の値	備考
environment	production	環境識別子（例: development, production）。

ユーザー識別子

列名	例の値	備考
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 など。

デバイス識別子

カラム名	例の値	備考
device_info.android_advertising_id	38400000-8cf0-11bd-b23e-10b96e40000d	AndroidのGoogle Advertising ID (GAID)。
device_info.android_uuid	550e8400-e29b-41d4-a716-446655440000	AndroidデバイスのUUID。
device_info.ios_advertising_id	38400000-8cf0-11bd-b23e-10b96e40000d	iOSのAdvertising ID (IDFA)。
device_info.ios_idfv	550e8400-e29b-41d4-a716-446655440000	iOSのベンダー識別子 (IDFV)。

オーディエンス属性

オーディエンスデータには、以下の列を含めてください:

列名	例の値	必須	備考
external_audience_id	premium_users	はい	オーディエンスの名前です。
action	add	はい	許可される値: add または remove。ユーザーをオーディエンスに含めるには add を使用し、除外するには remove を使用します。
change_timestamp_ms	1713895200000	いいえ	オーディエンスメンバーシップの変更のUnixタイムスタンプ（ミリ秒単位）です。

CSVファイルの例

テンプレートとして使用するサンプルファイルをダウンロードしてください:

RoktSample-audience.csv

2. SFTP資格情報の取得

Roktは安全な資格情報交換のためにKeybaseを使用します。

SFTPサーバーの詳細:

• ホスト: sftp://sftp.us2.mparticle.com
• ポート: 4422

SFTPクライアント (例: FileZilla, WinSCP)

グラフィカルなSFTPクライアントを使用する場合、ホスト sftp.us2.mparticle.com、プロトコル SFTP、ポート 4422 を使用してください（またはクライアントがURL全体を受け入れる場合は sftp://sftp.us2.mparticle.com を貼り付けてください）。プロンプトが表示されたら、アカウントマネージャーから提供されたユーザー名とパスワードを入力してください。

資格情報を取得するには:

1. keybase.ioでKeybaseアカウントを作成またはログインします。
2. Keybaseのユーザー名をRoktのアカウントマネージャーと共有します。
3. アカウントマネージャーが暗号化されたKeybaseチャットを通じてSFTP資格情報を送信します。

ヒント

資格情報を安全に保管してください。メールやその他の暗号化されていないチャネルで共有しないでください。

3. CSVファイルのアップロード

1. SFTPサーバーに接続します:

sftp -P 4422 your_username@sftp.us2.mparticle.com

2. ドロップフォルダ構造に移動または作成します:

cd drop
mkdir US2-123456789123456789  # Use the folder name provided by your Account Manager
cd US2-123456789123456789

3. CSVファイルをアップロードします:

put premium_users-audience.csv

注意

フォルダ名に末尾のスペースがないことを確認してください。フォルダ名は大文字と小文字を区別します。

次に何が起こるか

ファイルはアップロード後すぐに処理キューに追加されます。処理が成功したか確認する必要がある場合や問題が発生した場合は、Roktのアカウントマネージャーに連絡してください。