Amazon S3 入站資料檔案的名稱和檔案大小要求 amazon-s-name-and-file-size-requirements-for-inbound-data-files

描述向發送資料時需要遵循的必填欄位、語法、命名約定和檔案大小 Audience Manager。 在將資料發送到 Audience Manager / Amazon S3 的子菜單。

NOTE
文字樣式 (monospaced text斜體、括號 [ ] ( ) 等)指明代碼元素和選項。 如需詳細資訊,請參閱程式碼與文字元素的樣式慣例

檔案名語法 file-name-syntax

S3 檔案名包含以下必需和可選元素:

  • S3前置詞: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

  • 檔案名元素: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

有關其他接受的檔案名格式,請參見 定制合作夥伴整合

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

名稱元素

表定義 S3 檔案名。

名稱元素
說明
AWS_directory
AmazonS3儲存桶的路徑和名稱。 請聯繫您的客戶經理,瞭解S3目錄名稱、路徑和憑據。
date=yyyy-mm-dd
將檔案發送到S3儲存段時的時間戳(基於UTC時間)。
DPID

一個LD Audience Manager 如果資料檔案包含您自己的用戶ID、Android ID、iOSID或屬於 全局資料源。 接受以下選項:

  • 資料源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 資料源。
  • iOSID(IDFA): 如果資料檔案名中包含iOSID,請使用ID 20915。 您需要使用該欄位 _DPID_TARGET_DATA_OWNER 用iOS身份證。 比如說, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync 告 Audience Manager 資料檔案僅包含iOSID,且ID應符合屬於 _DPID_TARGET_DATA_OWNER 資料源。
  • 屬於其他全局資料源的ID:您可以在Roku ID上安裝廣告RIDA、Microsoft廣告ID(MAID)和其他ID。 使用與每個資料源對應的ID,如 全局資料源文章

注:不要在資料檔案中混合使用ID類型。 例如,如果您的檔案名包括Android標識符,則不要將iOSID或您自己的ID放入資料檔案中。

_DPID_TARGET_DATA_OWNER

此欄位將告訴Audience Manager板載資料的資料源。 如果將DPID設定為Android ID或iOSID或屬於全局資料源的其他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的特徵。
  • iOSID(IDFA): ...ftp_dpm_20915_21_1234567890.sync 告 Audience Manager 資料檔案僅包含iOSID,ID應符合屬於資料源21的特徵。
  • 屬於其他全局資料源的ID: ...ftp_dpm_121963_21_1234567890.sync 告 Audience Manager 該資料檔案僅包含Roku ID且ID應符合屬於資料源21的特徵。 使用與每個資料源對應的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]

將檔案發送到AmazonS3時,僅使用gzip壓縮。 壓縮後,這些檔案 .gz 擴展。 不要使用.zip壓縮。

壓縮檔案必須為3 GB或更小。 如果您的檔案較大,請與客戶服務部聯繫。 儘管Audience Manager可以處理大檔案,但我們可能可以幫助您減小檔案大小,並提高資料傳輸的效率。 請參閱傳入資料傳輸檔案的檔案壓縮

檔案名示例 file-name-examples

以下示例顯示格式正確的檔案名。 您的檔案名可能看起來類似。

  • 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 檔案副檔名。 使用簡單的文本編輯器開啟它。

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

請考慮下圖,瞭解檔案的最快/最早處理,以及將資料發送到 Audience Manager / Amazon S3 的子菜單。

檔案類型
最佳大小
最大大小
壓縮
200-300 MB
3 GB
未壓縮
1 GB
5 GB
NOTE
入站資料驗證進程會將空檔案標籤為無效,並且不會處理它們。

行長限制 line-limits

入站資料檔案的行長度限制為102400位元組。 超過此限制的行將從轉移中排除。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695