FTP傳入資料檔案的 名稱和檔案大小要求

說明將資料傳送至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檔案名中的元素。

檔案名稱元素 說明

ftp_dpm_

Audience Manager FTP目錄的路徑和名稱。 請連絡您的帳戶管理員以取得FTP目錄和認證。

DPID

此D會告訴 Audience Manager資料檔案是否包含您自己的使用者ID、Android ID、iOS ID或屬於全域資料來源的其他ID。 接受下列選項:

  • 資料來源ID(也稱為資料提供者ID): Audience Manager指派給資料來源的唯一ID(請參閱Audience Manager ID 索引 )。傳送包含您自己使用者ID的資料時,請在檔案名稱中使用此指派的ID。 例如,...ftp_dpm_21_123456789.sync會告訴 Audience Manager將資料載入屬於資料來源21的ID。
  • Android ID(GAID):如果 資料檔案名稱包含Android ID,請使用ID 20914。使用Android ID時,您必須使用欄位_DPID_TARGET_DATA_OWNER。 例如,...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync會告訴 Audience Manager資料檔案僅包含Android ID,且ID應符合_DPID_TARGET_DATA_OWNER資料來源的特徵資格。
  • iOS ID(IDFA):如 果資料檔案名稱包含iOS ID,請使用ID 20915。使用iOS ID時,您必須使用欄位_DPID_TARGET_DATA_OWNER。 例如,...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync會告訴 Audience Manager資料檔案僅包含iOS ID,且ID應符合屬於_DPID_TARGET_DATA_OWNER資料來源的特徵。
  • 屬於其他全域資料來源的ID:您可以在Roku ID上安裝廣告(RIDA)、Microsoft Advertising ID(MAID)和其他ID。使用與每個資料來源對應的ID,如全域資料來源文章所述。

注意: 請勿在資料檔案中混用ID類型。 例如,如果您的檔案名稱包含Android識別碼,請勿在資料檔案中放入iOS ID或您自己的ID。

_DPID_TARGET_DATA_OWNER

此欄位會告訴Audience Manager要將資料載入的資料來源。 如果您將DPID設為屬於全域資料來源的Android ID、iOS ID或其他ID,此欄位是必填欄位。 這可讓 Audience Manager將檔案資料連結回您的組織。

例如:

  • ...ftp_dpm_33_21_1234567890.sync 告訴Audience Manager,您要針對屬於資料來源33的特徵或訊號,確認屬於資料來源21的客戶ID。
  • Android ID(GAID):告 ...ftp_dpm_20914_21_1234567890.sync Audience Manager資料檔案僅包含Android ID,且ID應符合屬於資料來源21的特徵資格。
  • iOS ID(IDFA):告 ...ftp_dpm_20915_21_1234567890.sync Audience Manager資料檔案僅包含iOS ID,且ID應符合屬於資料來源21的特徵。
  • 屬於其他全域資料來源的ID: ...ftp_dpm_121963_21_1234567890.sync 告訴 Audience Manager資料檔案僅包含Roku ID,且ID應符合屬於資料來源21的特徵資格。使用與每個資料來源對應的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

[如果] (assets/ftp_dpm_1234_1445374061.overwrite) 您需要其他範例,請下載範例檔案。此檔案以.overwrite檔案副檔名保存。 使用簡單的文字編輯器開啟它。

接受的檔案大小

請考慮下圖,以便最快/最早地處理您的檔案,以及將資料傳送至Audience Manager / FTP目錄時的檔案大小限制。

檔案類型 最佳大小 最大大小
壓縮

200-300 MB

3 GB

未壓縮

1 GB

5 GB

本頁內容