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

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

注意

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

檔案名語法

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

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

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

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

注意

Audience Manager 僅處理 ASCII 和編 UTF-8 碼檔案。

命名元素

該表定義了S3檔案名中的元素。

名稱元素 說明

AWS_directory

Amazon S3儲存貯體的路徑和名稱。 請連絡您的帳戶管理員,以取得S3目錄名稱、路徑和憑證。

date=yyyy-mm-dd

將檔案傳送至S3儲存貯體的時間戳記(以UTC時間為基準)。

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,如全域資料來源文章所述。

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可處理大型檔案,但我們可協助您縮減檔案大小,並提高資料傳輸的效率。 請參閱傳入資料傳輸檔案的檔案壓縮

檔案名示例

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

  • 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

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

接受的檔案大小

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

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

200-300 MB

3 GB

未壓縮

1 GB

5 GB

注意

傳入資料驗證程式會將空白檔案標示為無效,且不會處理這些檔案。

行長限制

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now