送信データファイル名:構文と例

送信データファイルの名前に使用される必須フィールド、構文および規則について説明します。

NOTE

スタイル要件(monospaced text斜体、括弧 [ ] ( )、など)コード要素およびオプションを表します。詳しくは、コードおよびテキスト要素のスタイル規則を参照してください。

構文およびファイル名要素

送信ファイル名には、次の要素が含まれています。以下の要素はすべてオプションです。

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

パラメーター

送信データファイル名の要素の定義を次の表に示します。

ファイル名要素 説明

SYNC_TYPE

データ転送方法を参照します。転送方法には以下が含まれます。

  • FTP - SFTP を使用した転送
  • Amazon S3 - Amazon AWS への転送

DID

宛先 ID。

Audience Manager では、宛先は、ターゲット設定可能なセグメントをマッピングできる統合のインスタンスです。顧客は、ビジネス要件に応じて、複数の宛先を持つことができます。

MASTER_DPID

データプロバイダーまたはデータソース ID。この ID は、ファイルコンテンツに存在するユーザー ID のタイプを識別します。最も一般的なユーザー ID キーを次に示します。

  • 20914 - Google 広告主 ID(raw、ハッシュ化されていない)
  • 20915 - 広告主用 Apple ID(raw、ハッシュ化されていない)
  • ベンダー ID - サードパーティユーザー ID(Web/Cookie)

詳しくは、「グローバルデータソース」を参照してください。

PID_ALIAS

サードパーティプラットフォームからの顧客識別子。

SYNC_MODE

同期モードは、同期タイプに基づいてファイル名にラベルを追加するマクロプレースホルダーです。同期タイプには、完全および増分があります。ファイル名に iter または full として現れます。

  • iter :「反復」または増分同期を示します。増分ファイルには、最後の同期以降に収集された新しいデータのみが含まれます。
  • full :「完全」同期を示します。完全に同期されたファイルには、古いデータと最後の同期以降に収集された新しいデータが含まれます。

TIMESTAMP

UTC タイムゾーンの 13 桁の UNIX タイムスタンプ(ミリ秒)。

SPLITNUM

整数。処理時間を向上するために複数の部分に分割されたファイルの部分を特定します。番号は、データが属する元のファイルのどの部分かを示します。

3 桁以上の整数にする必要があり、分割サイズが 100 よりも小さいは、前にゼロを付ける必要があります。

元のファイルには、分割番号はありません。最初の分割ファイルは、001 で終わります。後述の例を参照してください。

.gz (optional)

GZIP 圧縮。

ファイル名の例

シナリオ 1

Amazon S3 の場所に送信されたファイルで、PID_ALIAS="XYZCustomer" を満たし、かつファイルコンテンツに Google Advertiser IDs を含むもの。

例:増分ファイル:

  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz

例:完全ファイル:

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

シナリオ 2

FTP の場所に送信されたファイルで、PID_ALIAS がなく、ファイルコンテンツに Apple Advertiser IDs を含むもの:

例:増分ファイル:

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

例:完全ファイル:

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

シナリオ 3:FTPで PID_ALIAS="XYZCustomer" の場所に送信されたファイルで、ファイルコンテンツにサードパーティユーザー ID (Vendor ID=45454)を含むもの。

例:増分ファイル:

  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz

例:完全ファイル:

  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

送信データファイルコンテンツ:構文とパラメーター

送信データファイルの情報を編成するのに使用する必須フィールド、構文、規則について説明します。これらの仕様に従って、データの形式を設定します。

NOTE

スタイル要件(monospaced text斜体、括弧 [ ] ( )、など)コード要素およびオプションを表します。詳しくは、コードおよびテキスト要素のスタイル規則を参照してください。

構文

データファイルのフィールドの順序は次のとおりです。

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

パラメーター

データファイルのコンテンツを定義する変数を次の表に示します。

パラメーター 説明

UUID

Audience Manager により割り当てられた一意のユーザー ID。

<SPACE>

UUID とセグメントデータをスペースで区切ります。

SEGMENT_N

訪問者が属するセグメントの ID。複数のセグメントをコンマで区切ります。

REMOVED_SEGMENT_N

ユーザーが対象外だったセグメントの ID。複数のセグメントをコンマで区切ります。完全同期を使用すると、データファイルにはユーザーの現在のセグメントの完全なリストが含まれるので、削除されたセグメントを無視できます。通常、ユーザーが削除されたセグメントではなく、ユーザーが属するセグメントを知る必要があります。詳しくは、送信データファイル名:構文と例 を参照してください。

例:基本的なファイル形式

適切な形式のデータファイルは次のサンプルのようになります。このファイルエントリは、セグメント 24、26 および 27 の対象となるユーザーを示します。必要に応じて、スペースで UUID とセグメント ID を区切ります。もう 1 つのスペースで、セグメント ID のセットを区切ります。この例では、ユーザーは、セグメント 24、26 および 27 に属します。セグメント 25 および 28 からは削除されています。

59767559181262060060278870901087098252  24,26,27  25,28

このページ