Audience Optimization报表的数据文件以及可操作的日志文件 data-files-for-audience-optimization-reports

数据文件包含展示、点击或转化数据。 如果格式正确,您可以将此数据导入Audience Manager,以便在Audience Optimization报表中查看它,并通过可操作的日志文件使用这些数据创建特征。 根据本节中的这些规范格式化数据文件。

概述 overview

一个正确命名且格式化的数据文件可让您将展示次数、点击次数或转化数据导入Audience Optimization报表。 当与未与Audience Manager集成的合作伙伴合作,而您希望在该报表包中处理其数据时,此功能非常有用。 此过程需要单独的展示、点击和转化数据文件。 请勿在一个文件中混合使用这些事件。

数据文件必须附有元数据文件。 元数据文件内容将数据文件信息与报表菜单中人工可读的相关标签相匹配。 有关详细信息,请参阅元数据文件的概述和映射

数据文件的命名约定 naming-conventions

以下语法定义了格式正确的数据文件名的结构。 注意,斜体 ​表示根据文件内容而更改的变量占位符。

语法:

事件类型_yyyymmdd

在文件名中:

  • 事件类型指示文件包含展示次数、点击次数或转化次数。 为每个事件类型创建单独的文件。
  • 事件类型和年 — 月 — 日时间戳使用下划线分隔。
  • 在上载之前,请使用gzip压缩文件并使用.gz文件扩展名保存它们。

根据这些要求,根据数据文件的内容命名数据文件,如下所示:

  • 展示数据:

    code language-none
    展示次数_yyyymmdd.gz
    
  • 单击数据:

    code language-none
    点击_yyyymmdd.gz
    
  • 转化数据:

    code language-none
    转化_yyyymmdd.gz
    

数据文件的内容格式 content-format

以下语法定义格式正确的数据文件中的内容结构。 请注意,斜体 ​表示变量占位符,在实际数据文件中被替换为标签。

语法:

标题标签1 | 标头标签2 … 标头标签n | 版本

在文件内容中:

  • 标题标签必须按照下表所示的顺序显示。 展示和点击使用相同的标签。 转换文件包含额外的标头。

  • 如果没有特定列的数据,请用-1填充该字段。

  • 文件​ 必须 ​以版本号结尾。 当前版本为1.1。

  • 使用非打印ASCII 001字符分隔文件标题和内容。 如果您无法使用ASCII 001,请使用制表符分隔符分隔标头和数据。 由于它们是非打印字符,因此上述语法示例显示仅用于显示的管道"|"

字段标签

下表列出并描述了数据文件的列标题。 标头区分大小写,并且必须按表中的顺序显示。 除非另有说明,否则所有数据类型都是整数(INT)。

标签
描述
时间戳
展示、点击或转化事件的UTC日期和时间。 使用 yyyy-MM-dd HH:mm:ss格式。
用户ID
您的网站访客ID,也称为数据提供程序唯一用户ID或DPUUID。
Advertiser-ID
广告商的数据源ID或集成代码。
BU-ID
业务部门ID。
营销活动ID
营销活动ID。
Creative-ID
创作ID。
站点ID
站点ID。
Placement-ID
广告服务器上的数字版面ID。
Insertion-Order-ID
插入订单ID。
战术ID
策略ID。
Vertical-ID
垂直行业或类别的ID。
数量

转化事件中出售的物料数。

仅用于转换数据文件。

收入

购买或其他转化金额。 数据类型:浮点数。

仅用于转换数据文件。

其他数据

转化登陆页面的URL。 数据类型:字符串。

仅用于转换数据文件。

事件类型

转换类型。 指示转化是否匹配。 选项包括:

  • 0:展示
  • 1:单击
  • -1:未归因或未知

仅用于转换数据文件。

版本
在展示、点击或转化数据文件中每行的末尾显示的必需版本号。 当前版本为1.1。

数据文件的提交方法 delivery-methods

将您的展示、点击或转换数据文件上传到Audience Manager帐户的Amazon S3目录。 有关投放/目录路径、文件处理时间和更新的信息,请参阅此部分。

IMPORTANT
请联系您的Audience Manager顾问或客户关怀团队以开始使用并为数据文件设置Amazon S3目录。

投放路径语法和示例

在Amazon S3目录中为每个客户将数据存储在单独的命名空间中。 文件路径遵循如下所示的语法。 请注意,斜体 ​表示变量占位符。 其他元素为常量或键,不会更改。

语法:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 文件类型_yyyymmdd

下表定义了文件投放路径中的这些元素。

文件参数
描述
.../log_ingestion/
这是目录存储路径的开头。 一切设置完成后,您将收到完整路径。
pid=AAM ID
此键值对包含您的Audience Manager客户ID。
dpid=d_src
此键值对包含事件调用中传入的数据源ID。 它可以标识数据来自的代理,并将该数据绑定到支持的元数据文件。
logs
数据文件的更高级目录。
file type_yyyymmdd
指示其中包含的数据类型和投放时间戳的文件类型名称。

示例上载路径和文件名

上传文件时,路径将类似于以下内容:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

文件处理时间和更新

数据文件每天处理四次,每次都定期进行。

要更新数据,请发送一个文件,其中包含特定日期的所有展示次数、点击次数或转化次数。 在这种情况下,一天是从一个午夜到下一个午夜的24小时时段。 作为最佳实践,您可能希望使用UTC时间来定义日期间隔。

后续步骤 next-steps

查看命名和创建元数据文件的要求。 要开始操作,请参阅元数据文件的概述和映射

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695