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

上次更新: 2023-05-20

說明將資料傳送至時需要遵循的必要欄位、語法、命名慣例和檔案大小 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 檔案名稱。

Name元素 描述

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 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 資料來源。
  • iOS ID (IDFA): 如果資料檔案包含iOS ID,請在資料檔案名稱中使用ID 20915。 您需要使用欄位 _DPID_TARGET_DATA_OWNER 當您使用iOS ID時。 例如, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync 告知 Audience Manager 資料檔案僅包含iOS ID,且這些ID應符合屬於以下類別的特徵: _DPID_TARGET_DATA_OWNER 資料來源。
  • 屬於其他全域資料來源的ID:您可以加入Roku ID for 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 Systems 顾问或客户支持。

重要说明: 需要请求现有数据共享关系的映射(对于属于您在3月14日2022之前载入数据的其他公司的目标数据源)。 將資料上線至屬於您的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可以處理大型檔案,但我們或許可以協助您縮減檔案大小,並提高資料傳輸效率。 请参阅入站数据传输文件的文件压缩

文件名称示例

以下示例显示格式正确的文件名称。 您的文件名看起来可能类似。

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

接受的檔案大小

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

文件类型 最佳大小 大小上限
Compressed(已压缩)

200-300 MB

3 GB

未壓縮

1 GB

5 GB

注意

入站数据验证过程会将空文件标记为无效,而不会处理它们。

行長度限制

傳入資料檔案的行長度限製為102400個位元組。 超出此限制的行會從傳輸中排除。

在此页面上