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

說明將資料傳送至Audience Manager時需要遵循的必填欄位、語法、命名慣例和檔案大小。 將資料發送到Audience ManagerFTP目錄時,根據這些規範設定檔案的名稱和大小。

警告

我們正在逐步淘汰對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

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

  • 資料來源ID(也稱為資料提供者ID): 這是Audience Manager指派給資料來源的唯一ID(請參閱 Audience ManagerID索 引)。傳送包含您自己使用者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的客戶ID資格,取得資料來源21的特徵或訊號。
  • 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

本頁內容