Show Menu
トピック×

Amazon S3受信データファイルの 名とファイルサイズの要件

Describes the required fields, syntax, naming conventions and file sizes you need to follow when sending data to Audience Manager. Set the names and sizes of your files according to these specifications when you send data to an Audience Manager / Amazon S3 directory.
テキストスタイル( monospaced text 斜体 、括弧 [ ] ( ) 、その他)コード要素およびオプションを表します。詳しくは、 コードおよびテキスト要素のスタイル規則 を参照してください。

ファイル名の構文

S3 ファイル名は、次の必須要素とオプション要素で構成されています。
  • S3プレフィックス: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
  • ファイル名要素: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
使用可能なその他のファイル名の形式については、 カスタムパートナー統合 を参照してください。
Audience Manager は、ASCII と UTF-8 でエンコードされたファイルのみを処理します。

名前の要素

次の表は、S3 ファイル名の要素の定義を示しています。
名前の要素 説明
AWS_directory
Amazon S3 バケットのパスと名前。S3 ディレクトリの名前、パス、資格情報については、担当のアカウントマネージャーにお問い合わせください。
date= yyyy-mm-dd
ファイルを S3 バケットに送信した時点を示すタイムスタンプ(UTC 時間に基づく)。
DPID
データファイルに独自のユーザーID、Android ID、iOS IDまたはグロー バルデータソースに属する他のIDが含まれているかどうかをAudience Managerに通知するlD グローバルデータソース 。 次のオプションを使用できます。
  • データソースID(データプロバイダーIDとも呼ばれます): これは、Audience Managerがデータソースに割り当てる一意のIDです(IDのAudience Manager インデックスを参照 )。 ご自身のユーザー ID が含まれているデータを送信する場合に、この割り当て済みの ID をファイル名に入れます。例えば、 ...ftp_dpm_21_123456789.sync Audience Managerに対して、データソース21に属するIDに対して車載データを通知する
  • Android ID(GAID): Android IDが含まれる場合は、データファイル名にID 20914を使用します。 Android IDを使用する場合は、このフィールド _DPID_TARGET_DATA_OWNER を使用する必要があります。 例えば、 ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync データファイルにAndroid IDのみが含まれ、そのIDはデー _DPID_TARGET_DATA_OWNER タソースに属する特性に適合する必要があるとAudience Managerに伝えます。
  • iOS ID(IDFA): データファイルに iOS の ID が含まれている場合、ファイル名に ID 20915 を使用します。iOS IDを使用する場合は、このフィールドを使用す _DPID_TARGET_DATA_OWNER る必要があります。 例えば、 ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync データファイルにはiOS IDのみが含まれ、IDはデータ _DPID_TARGET_DATA_OWNER ソースに属する特性に適合する必要があるとAudience Managerに伝えます。
  • 他のグローバルデータソースに属するID :広告用のRoku ID(RIDA)、Microsoft広告用ID(MAID)、その他のIDを搭載できます。 各データソースに対応するIDを使用します。詳しくは、「 グローバルデータソース」の記事を参照
注意:データファイル内で ID タイプが混在しないようにしてください。例えば、ファイル名に Android の ID が含まれている場合、データファイル内に iOS の ID やご自身の ID を入れないでください。
_DPID_TARGET_DATA_OWNER
このフィールドは、どのデータソースにオンボードデータを送るかをAudience Managerに示します。 このフィールドは、DPIDをAndroid IDまたはiOS ID、またはグローバルデータソースに属する他のIDに設定した場合は必須です。 これにより、 Audience Manager はファイルデータを組織にリンクすることができます。
次に例を示します。
  • ...ftp_dpm_33_21_1234567890.sync データソース33に属する顧客IDを、データソース21に属する特性またはシグナルに対して承認していることをAudience Managerに通知します。
  • Android ID(GAID): ...ftp_dpm_20914_21_1234567890.sync データファイルにAndroid IDのみが含まれ、そのIDがデータソース21に属する特性に適合することを Audience Managerに通知します。
  • iOS ID(IDFA): ...ftp_dpm_20915_21_1234567890.sync データファイルにiOS IDのみが含まれ、 Audience Managerに対して、そのIDがデータソース21に属する特性に該当することを通知します。
  • 他のグローバルデータソースに属するID : ...ftp_dpm_121963_21_1234567890.sync データファイルにはRoku IDのみが含まれ 、IDはデータソース21に属する特性に適合する必要があることを Audience Managerに通知します。 各データソースに対応するIDを使用します。詳しくは、「 グローバルデータソース」の記事を参照
partner_name
Audience Manager で使用する会社または組織の名前。
TIMESTAMP
10 桁の UTC UNIX タイムスタンプ(秒単位)。タイムスタンプは、各ファイル名を一意にするのに役立ちます。
(.sync|.overwrite)
同期オプション。以下のものがあります。
  • sync :通常のシナリオ。サードパーティデータプロバイダーが、Audience Manager システムで追加または削除するユーザー単位の特性を送信します。
  • overwrite :データプロバイダーはユーザー単位の特性のリストを送信できます。これにより、Audience Manager で特定のデータプロバイダーについて当該ユーザーの既存のサードパーティ特性がすべて上書きされます。すべてのユーザーを上書きファイルに入れる必要はありません。変更するユーザーのみを入れるようにしてください。
[ SPLIT_NUMBER ]
整数。大きなファイルを複数に分割して処理時間を短縮する場合に使用します。数は、送信している元のファイルのどの部分かを示します。
ファイル処理を効率的に実行するために、データファイルを次のように分割します。
  • 圧縮なし:1 GB
  • 圧縮済み:200~300 MB
以下の 2 つの ファイル名の例 を参照してください。
[.gz]
ファイルを Amazon S3 に送信する場合、gzip 圧縮のみを使用します。これらのファイルを圧縮すると、拡張子は .gz になります。.zip 圧縮は使用しないでください。
圧縮ファイルのサイズは 3 GB 以下である必要があります。ファイルがそれより大きい場合は、カスタマーケアにお問い合わせください。Audience Manager で大きなファイルを操作することは可能ですが、ファイルのサイズを小さくして、効率的にデータを転送できるようにすることもできます。詳しくは、 受信データ転送ファイルのファイル圧縮 を参照してください。

ファイル名の例

以下に、適切に書式設定されたファイル名の例を示します。ファイル名は、このようになります。
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
追加の例が必要であれば、サンプルを # (assets/ftp_dpm_1234_1445374061.overwrite)することもできます。このファイルは .overwrite ファイル拡張子で保存されます。これを普通のテキストエディターで開きます。

許容されるファイルサイズ

データを Audience Manager や Amazon S3 ディレクトリに送信する際の最速/最短のファイル処理やファイルサイズの制限については、以下の数字を考慮してください。
ファイルタイプ 最適なサイズ 最大サイズ
圧縮済み
200~300 MB
3 GB
圧縮なし
1 GB
5 GB
受信データの検証プロセスでは、空のファイルは無効としてマークされます。