Show Menu
トピック×

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

Audience Manager にデータを送信する際に従う必要がある必須フィールド、構文、命名規則、ファイルサイズについて説明します。データを Audience Manager または Amazon S3 ディレクトリに送信する際には、これらの仕様に従ってファイルの名前とサイズを設定してください。
テキストスタイル( 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 (DPID)は、データファイルにご自身のユーザー ID、または Android か iOS の ID が含まれているかどうかを Audience Manager に通知するための ID です。次のオプションを使用できます。
データパートナー ID
Audience Manager が会社や組織に割り当てる一意の ID です。ご自身のユーザー ID が含まれているデータを送信する場合に、この割り当て済みの ID をファイル名に入れます。例えば、「 ...ftp_dpm_21_123456789.sync 」は、ID が 21 であるパートナーがファイルの送信者で、このファイルにはそのパートナーが割り当てたユーザー ID が含まれていることを Audience Manager に通知します。
Android ID(GAID)
ファイルに Android ID が含まれている場合、データファイル名の DPID として ID 20914 を使用します。DPID として ID 20914 を使用する場合、 Audience Manager で会社を特定する必要があります。つまり、ファイル名で _DPID_TARGET_DATA_OWNER パラメーターを使用して会社 ID を含める必要があります。例えば、Android ID が含まれるファイルを渡そうとしていて、データプロバイダー ID が 21 であるとします。この場合、ファイル名は ...ftp_dpm_20914_21_123456789.sync のようになります。これにより、 Audience Manager は、ファイルに Android ID が含まれていること、およびこのファイルが ID 21 のパートナーからのものであることを認識します。
iOS ID(IDFA)
ファイルに iOS ID が含まれている場合、データファイル名の DPID として ID 20915 を使用します。DPID として ID 20915 を使用する場合、 Audience Manager で会社を特定する必要があります。つまり、ファイル名で _DPID_TARGET_DATA_OWNER パラメーターを使用して会社 ID を含める必要があります。例えば、Android ID が含まれるファイルを渡そうとしていて、データプロバイダー ID が 21 であるとします。この場合、ファイル名は ...ftp_dpm_20915_21_123456789.sync のようになります。これにより、 Audience Manager は、ファイルに iOS ID が含まれていること、およびこのファイルが ID 21 のパートナーからのものであることを認識します。
注意:データファイル内で ID タイプが混在しないようにしてください。例えば、ファイル名に Android の ID が含まれている場合、データファイル内に iOS の ID やご自身の ID を入れないでください。
詳しくは、「 グローバルデータソース 」を参照してください。
下記の _DPID_TARGET_DATA_OWNER エントリも参照してください。
_DPID_TARGET_DATA_OWNER
ID のプレースホルダー。例えば、DPID をデータソース ID か、Android または iOS の ID に設定した場合、これを Audience Manager ID に設定することができます。これにより、 Audience Manager はファイルデータを組織にリンクすることができます。
次に例を示します。
  • ...ftp_dpm_33_21_1234567890.sync 」は、ID が 21 であるパートナーが、ID が 33 であるデータソースからのデータを送信したことを示しています。
  • ...ftp_dpm_20914_21_1234567890.sync 」は、ID が 21 であるパートナーが、Android の ID を含むデータを送信したことを示しています。
  • ...ftp_dpm_20915_21_1234567890.sync 」は、ID が 21 であるパートナーが、iOS の 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
追加の例が必要であれば、サンプルを ダウンロード することもできます。このファイルは .overwrite ファイル拡張子で保存されます。これを普通のテキストエディターで開きます。

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

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