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

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

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位元組。 超過此限制的行將從轉移中排除。

本頁內容