Audience Optimization 报表的数据文件以及可操作的日志文件

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

概述

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

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

数据文件的命名约定

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

语法:

事件类型_yyyymmdd

在文件名中:

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

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

  • 展示数据:
    impress_yyyymmdd.gz
  • 单击数据:
    clicks_yyyymmdd.gz
  • 转化数据:
    conversions_yyyymmdd.gz

数据文件的内容格式

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

语法:

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

在文件内容中:

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

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

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

  • 使用非打印ASCII 001字符来分隔文件头和内容。 如果不能使用ASCII 001,则使用制表符分隔标题和数据。 由于这些字符是非打印字符,因此上面的语法示例仅显示管道"|"以用于显示目的。

字段标签

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

标签 描述

时间戳

展示、点击或转化事件的UTC日期和时间。 使用 yyyy-MM-dd HH:mm:ss格式。

用户ID

网站访客的ID,也称为数据提供程序独特用户ID或DPUUID。

广告商ID

广告商的数据源ID或集成代码。

BU-ID

业务单位ID。

促销活动ID

促销活动 ID.

创作ID

创作 ID.

Site-ID

网站 ID.

版面ID

广告服务器中的数字版面ID。

Insertion-Order-ID

插入订单ID。

策略ID

战术ID。

垂直ID

垂直行业或类别的ID。

数量

转化事件中售出的项目数。

仅用于转换数据文件。

收入

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

仅用于转换数据文件。

其他数据

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

仅用于转换数据文件。

事件类型

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

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

仅用于转换数据文件。

版本

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

数据文件的提交方法

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

重要

请联系您的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

文件处理时间和更新

数据文件每天处理四次,间隔为定期。

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

后续步骤

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

在此页面上