Show Menu
トピック×

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

Describes the required fields, syntax, naming conventions and file sizes you need to follow when sending data to Audience Manager. データを Audience Manager FTP ディレクトリに送信する際に、これらの仕様に応じて、ファイルの名前およびサイズを設定します。
We are gradually phasing out support for FTP configurations. While inbound data file ingestion is still supported in existing FTP integrations, we strongly recommend using Amazon S3 to onboard offline data for new integrations. 詳細は、 受信データファイルの Amazon S3 名とファイルサイズの要件 を参照してください。
テキストスタイル( monospaced text 斜体 、括弧 [ ] ( ) 、その他)コード要素およびオプションを表します。詳しくは、 コードおよびテキスト要素のスタイル規則 を参照してください。

ファイル名の構文

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

名前の要素

次の表は、FTP ファイル名の要素の定義を示しています。
ファイル名要素 説明
ftp_dpm_
Audience Manager FTP ディレクトリのパスと名前。FTP ディレクトリと資格情報については、アカウントマネージャーにお問い合わせください。
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 が含まれている場合、ファイル名に ID 20914 を使用します。例えば、「 ...ftp_dpm_20914_123456789.sync 」は、データファイルに Android の ID しか含まれていないことを Audience Manager に通知します。
  • iOS ID(IDFA): データファイルに iOS の ID が含まれている場合、ファイル名に ID 20915 を使用します。例えば、「 ...ftp_dpm_20915_123456789.sync .」は、データファイルに iOS の ID しか含まれていないことを Audience Manager に通知します。
注意:データファイル内で ID タイプが混在しないようにしてください。例えば、ファイル名に Android の ID が含まれている場合、データファイル内に iOS の ID やご自身の ID を入れないでください。
_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 を含むデータを送信したことを示しています。
(.sync |.overwrite)
同期オプション。以下のものがあります。
  • sync :通常のシナリオ。サードパーティデータプロバイダーが、Audience Manager システムで追加または削除するユーザー単位の特性を送信します。
  • overwrite :顧客とデータプロバイダーはユーザー単位の特性のリストを送信できます。これにより、Audience Manager で特定のデータソースについて当該ユーザーの既存の特性がすべて上書きされます。すべてのユーザーを上書きファイルに入れる必要はありません。変更するユーザーのみを入れるようにしてください。ターゲットデータソースに割り当てられていない特性は消去されません。
[ SPLIT_NUMBER ]
整数。大きなファイルを複数に分割して処理時間を短縮する場合に使用します。数は、送信している元のファイルのどの部分かを示します。
ファイル処理を効率的に実行するために、データファイルを次のように分割します。
  • 圧縮なし:1 GB
  • 圧縮済み:200~300 MB
以下の 2 つの ファイル名の例 を参照してください。
TIMESTAMP
10 桁の UTC UNIX タイムスタンプ(秒単位)。タイムスタンプは、各ファイル名を一意にするのに役立ちます。
[.gz]
Gzip は、FTP ファイル名として許可されている圧縮形式です。ファイル圧縮を使用する場合、ファイル名の拡張子が適切であることを確認します。
圧縮ファイルのサイズは 3 GB 以下である必要があります。ファイルがそれより大きい場合は、カスタマーケアにお問い合わせください。Audience Manager で大きなファイルを操作することは可能ですが、ファイルのサイズを小さくして、効率的にデータを転送できるようにすることもできます。詳しくは、 受信データ転送ファイルのファイル圧縮 を参照してください。

ファイル名の例

以下に、適切に書式設定されたファイル名の例を示します。ファイル名は、このようになります。
  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite
他の例が必要な場合は、サンプルファイルを ダウンロードします 。このファイルは .overwrite ファイル拡張子で保存されます。これを普通のテキストエディターで開きます。

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

データを Audience Manager や FTP ディレクトリに送信する際の最速/最短のファイル処理やファイルサイズの制限については、以下の数字を考慮してください。
ファイルタイプ 最適なサイズ 最大サイズ
圧縮済み
200~300 MB
3 GB
圧縮なし
1 GB
5 GB