傳入資料檔案的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
Amazon S3 Bucket的路徑和名稱。 請連絡您的帳戶管理員,取得您的S3目錄名稱、路徑和認證。
date=yyyy-mm-dd
傳送檔案至S3儲存貯體的時間戳記(根據UTC時間)。
DPID

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

  • 資料Source識別碼(也稱為資料提供者識別碼): 這是Audience Manager指派給資料來源的唯一ID (請參閱ID 的Audience Manager索引)。 在傳送包含您自己的使用者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加入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,如全域資料來源文章所述。
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可以處理大型檔案,但我們或許能夠協助您縮減檔案大小,讓資料傳輸更有效率。 請參閱傳入資料傳輸檔案的檔案壓縮

檔案名稱範例 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