Show Menu
主題×

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
傳入資料驗證程式會將空白檔案標示為無效,且不會處理這些檔案。