FTP入站数据文件的 名称和文件大小要求 ftp-name-and-file-size-requirements-for-inbound-data-files

說明將資料傳送至時需要遵循的必要欄位、語法、命名慣例和檔案大小 Audience Manager. 將資料傳送至Audience Manager時,請依照這些規格設定檔案的名稱和大小 FTP 目錄。

WARNING
我們正在逐步淘汰對下列專案的支援 FTP 設定。 雖然現有系統仍支援傳入資料檔案擷取 FTP 整合,我們強烈建議使用 Amazon S3 載入離線資料以進行新整合。 有关详细信息,请参阅入站数据文件的 Amazon S3 名称和文件大小要求
NOTE
文本样式(monospaced text斜体、括号 [ ] ( ) 等)檔案中會指示程式碼元素和選項。 请参阅代码和文本元素的样式约定,以了解更多信息。

檔案名稱語法 file-name-syntax

FTP 檔案名稱包含下列必要和選用元素:

ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

如需其他接受的檔案名稱格式,請參閱 自訂合作夥伴整合.

NOTE
Audience Manager 僅限程式 ASCII 和 UTF-8 編碼檔案。

為元素命名

此表格會定義 FTP 檔案名稱。

檔案名稱元素
描述
ftp_dpm_
的路徑和名稱 Audience Manager ftp目錄。 請聯絡您的帳戶管理員,以取得FTP目錄和認證。
DPID

一個可以告知 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。 您需要使用欄位 _DPID_TARGET_DATA_OWNER 使用Android ID時。 例如, ...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。 您需要使用欄位 _DPID_TARGET_DATA_OWNER 當您使用iOS ID時。 例如, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync 告知 Audience Manager 資料檔案僅包含iOS ID,且這些ID應符合屬於以下類別的特徵: _DPID_TARGET_DATA_OWNER 資料來源。
  • 屬於其他全域資料來源的ID:您可以加入Roku ID for Advertising (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 將檔案資料連結回您的組織。
此目標資料來源必須由您的公司擁有。 出於第二方資料共用的目的,若要將資料擷取到屬於另一個公司的目標資料來源,您的公司與目標資料來源之間必須有存取對應。 若要設定對應,請聯絡您的Adobe顧問或客戶支援。

重要注意事項:不要 需要請求現有資料共用關係的對應(針對屬於您在2022年3月14日之前將資料上線到的其他公司的目標資料來源)。 將資料上線至屬於您的PID的目標資料來源時,也不一定需要對應。

例如:

  • ...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可以處理大型檔案,但我們或許可以協助您縮減檔案大小,並提高資料傳輸效率。 请参阅入站数据传输文件的文件压缩

檔案名稱範例 file-name-examples

下列範例顯示格式正確的檔案名稱。 您的檔案名稱可能類似。

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

下載 範例檔案(如果需要其他範例)。 此檔案會與 .overwrite 副檔名。 使用簡單的文字編輯器將其開啟。

接受的檔案大小 accepted-file-sizes

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

文件类型
最佳大小
大小上限
Compressed(已压缩)
200-300 MB
3 GB
未壓縮
1 GB
5 GB
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695