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)。
yyyy-MM-dd HH:mm:ss
格式。转化事件中出售的物料数。
仅用于转换数据文件。
购买或其他转化金额。 数据类型:浮点数。
仅用于转换数据文件。
转化登陆页面的URL。 数据类型:字符串。
仅用于转换数据文件。
转换类型。 指示转化是否匹配。 选项包括:
0
:展示1
:单击-1
:未归因或未知
仅用于转换数据文件。
数据文件的提交方法 delivery-methods
将您的展示、点击或转换数据文件上传到Audience Manager帐户的Amazon S3目录。 有关投放/目录路径、文件处理时间和更新的信息,请参阅此部分。
投放路径语法和示例
在Amazon S3目录中为每个客户将数据存储在单独的命名空间中。 文件路径遵循如下所示的语法。 请注意,斜体 表示变量占位符。 其他元素为常量或键,不会更改。
语法:
…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 文件类型_yyyymmdd
下表定义了文件投放路径中的这些元素。
.../log_ingestion/
pid=AAM ID
dpid=d_src
logs
file type_yyyymmdd
示例上载路径和文件名
上传文件时,路径将类似于以下内容:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
文件处理时间和更新
数据文件每天处理四次,每次都定期进行。
要更新数据,请发送一个文件,其中包含特定日期的所有展示次数、点击次数或转化次数。 在这种情况下,一天是从一个午夜到下一个午夜的24小时时段。 作为最佳实践,您可能希望使用UTC时间来定义日期间隔。
后续步骤 next-steps
查看命名和创建元数据文件的要求。 要开始操作,请参阅元数据文件的概述和映射。