Audience Manager にデータを送信する際に従う必要がある必須フィールド、構文、命名規則、ファイルサイズについて説明します。データを Audience Manager FTP ディレクトリに送信する際に、これらの仕様に応じて、ファイルの名前およびサイズを設定します。
FTP 定のサポートは段階的に廃止されます。受信データファイルの取り込みは、既存の FTP り込みでサポートされますが、新しい取り込み用にオフラインデータをオンボードするには、Amazon S3 を使用することを強くお勧めします。詳細は、受信データファイルの Amazon S3 名とファイルサイズの要件を参照してください。
テキストスタイル(monospaced text
、斜体、括弧 [ ]
( )
、その他)コード要素およびオプションを表します。詳しくは、コードおよびテキスト要素のスタイル規則を参照してください。
FTP ファイル名は、次の必須要素とオプション要素で構成されています。
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
使用可能なその他のファイル名の形式については、カスタムパートナー統合を参照してください。
Audience Manager は、ASCII と UTF-8 でエンコードされたファイルのみを処理します。
次の表は、FTP ファイル名の要素の定義を示しています。
ファイル名要素 | 説明 |
---|---|
|
Audience Manager FTP ディレクトリのパスと名前。FTP ディレクトリと資格情報については、アカウントマネージャーにお問い合わせください。 |
|
データファイルに、独自のユーザー ID、Android ID、iOS ID またはグローバルデータソースに属する他の ID が含まれているかどうかを Audience Manager に伝える lD。次のオプションを使用できます。
注意:データファイル内で ID タイプが混在しないようにしてください。例えば、ファイル名に Android の ID が含まれている場合、データファイル内に iOS の ID やご自身の ID を入れないでください。 |
|
このフィールドは、データのオンボーディング先となるデータソースを Audience Manager に示します。このフィールドは、DPID を Android ID または iOS ID、またはグローバルデータソースに属する他の ID に設定した場合は必須です。これにより、Audience Manager はファイルデータを組織にリンクすることができます。 重要なメモ:既存のデータ共有関係については、マッピングをリクエストする必要はありません(2022年3月14日(PT)より以前にデータをオンボーディングした、他社に属するターゲットデータソースの場合)。また、PID に属するターゲットデータソースにデータをオンボーディングする場合も、マッピングは必要ありません。 例:
|
|
同期オプション。以下のものがあります。
|
|
整数。大きなファイルを複数に分割して処理時間を短縮する場合に使用します。数は、送信している元のファイルのどの部分かを示します。 ファイル処理を効率的に実行するために、データファイルを次のように分割します。
以下の 2 つのファイル名の例を参照してください。 |
|
10 桁の UTC UNIX タイムスタンプ(秒単位)。タイムスタンプは、各ファイル名を一意にするのに役立ちます。 |
|
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 |