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)是識別碼,可告訴 Audience Manager (資料檔案是否包含您自己的使用者ID、Android或iOS ID)。 接受下列選項:
資料合作夥伴ID
這是Audience manager指派給您公司或組織的唯一ID。 傳送包含您自己使用者ID的資料時,請在檔案名稱中使用此指派的ID。 例如,告 ...ftp_dpm_21_123456789.sync Audience Manager ,ID為21的合作夥伴傳送了檔案,並包含該合作夥伴指派的使用者ID。
Android ID(GAID)
如果檔案包含Android ID,請在資料檔案名稱中使用ID 20914做為DPID。 當您使用ID 20914做為DPID時,仍需要向 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,請在資料檔案名稱中使用ID 20915做為DPID。 當您使用ID 20915做為DPID時,仍需要向 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識別碼,請勿在資料檔案中放入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
傳入資料驗證程式會將空白檔案標示為無效,且不會處理這些檔案。